converted man page
[unix-history] / usr / src / old / man / vadvise.2v
CommitLineData
d6ee9320
KM
1.\" Copyright (c) 1980 Regents of the University of California.
2.\" All rights reserved. The Berkeley software License Agreement
3.\" specifies the terms and conditions for redistribution.
4.\"
5.\" @(#)vadvise.2v 4.1 (Berkeley) %G%
6.\"
7.TH VADVISE 2V
8.UC 4
9.SH NAME
10vadvise \- give advice to paging system
11.SH SYNOPSIS
12.B vadvise(param)
13.SH DESCRIPTION
14.I Vadvise
15is used to inform the system that process paging behavior merits special
16consideration. Parameters to
17.I vadvise
18are defined in the file
19.B <vadvise.h> .
20Currently, two calls to
21.I vadvise
22are implemented:
23.PP
24The call
25.IP
26.B "vadvise(VA_ANOM);"
27.LP
28advises that the paging behavior is not likely to
29be well handled by the system's default algorithm, since reference information
30collected over macroscopic intervals (e.g. 10-20 seconds)
31will not serve to indicate future page references. The system in this case
32will choose to replace pages with little emphasis placed on recent usage,
33and more emphasis on referenceless circular behavior. It is \fIessential\fR
34that processes which have very random paging behavior (such as
35LISP during garbage collection of very large address spaces) call
36.I vadvise,
37as otherwise the system has great difficulty dealing with their
38page-consumptive demands.
39.PP
40The call
41.IP
42.B "vadvise(VA_NORM);"
43.LP
44restores default paging replacement behavior after a call to
45.IP
46.B "vadvise(VA_ANOM);"
47.SH BUGS
48This call is peculiar to this version of UNIX.
49The options and specifications of this system call and even the call itself
50are expected to change. It is expected to be extended with additional
51facilities in future versions of the system. In particular it is expected
52that this call will be particular to a segment, and that other behaviors
53such as sequential behavior will be specifiable.