1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
|
.TH LIMITS 2 SHARE-deprecated
.SH NAME
limits \- return or set limits structure
.SH SYNOPSIS
.B #include <sys/types.h>
.br
.B #include <sys/lnode.h>
.br
.B #include <sys/retlim.h>
.br
.B #include <sys/share.h>
.P
.B limits(address, function)
.br
.B struct lnode *address;
.br
.B int function;
.SH DESCRIPTION
This system call manipulates a kernel limits structure
according to the value of
.IR function .
Except where indicated below,
.I address
points to an
.I lnode
or an array of
.IR lnodes .
.LP
.RS 2
.nf
.ta \w'\s-1L_DEADGROUP\s0XX'u +\w'ValueXX'u
Function Value Meaning
\s-1L_MYLIM\s0 0 Get user's own limits structure.
\s-1L_OTHLIM\s0 1 Get limits associated with uid in lnode.
\s-1L_ALLLIM\s0 2 All active limits structures are returned.
\s-1L_SETLIM\s0 3* Connect to a new limits structure.
\s-1L_DEADLIM\s0 4 Wait for dead limits belonging to child.
\s-1L_CHNGLIM\s0 5* Changes limits fields in existing limits.
\s-1L_DEADGROUP\s0 6* Pick up a dead limits structure.
\s-1L_GETCOSTS\s0 7 Get contents of system ``shconsts'' table.
\s-1L_SETCOSTS\s0 8* Set contents of system ``shconsts'' table.
\s-1L_MYKN\s0 9 Get user's own ``kern_lnode'' structure.
\s-1L_OTHKN\s0 10 Get structure associated with uid.
\s-1L_ALLKN\s0 11 All active structures are returned.
.fi
.RE
.P
The starred functions in the list are super\-user only.
.P
For
.SM L_MYKN,
.SM L_OTHKN,
and
.SM L_ALLKN
.I address
should point to a ``struct kern_lnode''
defined in
.IR <sys/lnode.h> .
For
.SM L_SETCOSTS
and
.SM L_GETCOSTS
.I address
should point to a ``struct shconsts''
defined in
.IR <sys/share.h> .
For
.SM L_DEADLIM
.I address
should point to a ``struct retlim'' defined in
.IR <sys/retlim.h> .
.P
.SM L_OTHLIM
and
.SM L_CHNGLIM
require that the lnode pointed to by
.I address
contains the correct uid.
.SM L_OTHKN
requires that the kern_lnode pointed to by
.I address
contains the correct uid.
.SM L_MYLIM,
.SM L_MYKN,
.SM L_OTHLIM,
and
.SM L_OTHKN
all return the number of processes currently attached to the node.
.SM L_ALLLIM
and
.SM L_ALLKN
both return the number of active nodes returned.
.P
.SM L_SETLIM
initialises a new limits structure with the passed lnode,
and attaches the calling process to it.
All children of that process will inherit the new structure.
.P
.SM L_DEADGROUP
looks for a dead limits structure,
removes it from the list of active limits,
and returns the lnode.
.P
.SM L_DEADLIM
performs a
.IR wait (2)
system call,
then returns a structure containing both the limits and process zombie structures.
The value returned is the number of processes still attached to the node.
.P
.SM L_SETCOST
and
.SM L_GETCOST
deal with the constants structure for the scheduling algorithm.
.P
Any other function is illegal, and will return an error of EINVAL.
Unless otherwise specified the
call returns the number of limits structures returned.
.SH DIAGNOSTICS
.B ESRCH
can be returned in
.I errno
by functions
.SM L_DEADGROUP,
.SM L_OTHKN,
.SM L_OTHLIM
and
.SM L_CHNGLIM
to indicate that
the desired limits structure does not exist.
.B ESRCH
can also be returned by
.SM L_SETLIM
to indicate that this lnode's group has not been set-up.
.P
.B ETOOMANYU
is returned in errno for
.SM L_SETLIM
if there is no space left in the kernel limits table.
.P
Any error causes a \-1 to be returned.
.SH "SEE ALSO"
setlimits(3),
lnode(5),
share(5).
|
