|
|
1.1 root 1: .TH PWINTF 1 SHARE
2: .SH NAME
3: pwintf \- print selected limits file entries using printf formats
4: .SH SYNOPSIS
5: .B pwintf
6: [-p shares_file] expression format [identifier..]
7: .SH DESCRIPTION
8: For each entry in the system shares file the expression
9: argument is evaluated.
10: If the result is non zero
11: the remaining arguments are treated as if they were arguments
12: to
13: .I printf
14: (see
15: .IR printf (3S)).
16: An alternative shares file may be specified with the
17: .I -p
18: option.
19: .PP
20: Expression elements are:
21: .TP "\w'identifierXXXX'u"
22: ||
23: Binary or. Non zero if the left hand side or the right hand side
24: evaluates to a non zero value.
25: .TP
26: &&
27: Binary and. Non zero if the left hand side and the right hand
28: side are both non zero.
29: .TP
30: == !=
31: Equal/not equal to. Non zero if the left hand side
32: and the right hand side
33: are equal/not equal.
34: .TP
35: > <
36: Greater/less than. Non zero is the left hand side is
37: greater/less than the right hand side.
38: .TP
39: >= <=
40: Greater/less than or equal to. Non zero if the left hand side
41: is greater/less than or equal to the right hand side.
42: .TP
43: ~
44: Regular expression matching. Non zero if the string on the left
45: hand side matches the regular expression given by the string
46: on the right hand side. Regular expressions are given in the
47: style of
48: .I ed
49: (see
50: .IR ed (1)).
51: .TP
52: !
53: Unary not. Non zero if the right hand side evaluates to zero.
54: .TP
55: ".."
56: A string of characters.
57: .TP
58: {..}
59: A date.
60: Date specifications are in the style:
61: .B {[[[[[yy]mm]dd]hh]mm][.ss]}.
62: For example
63: .B {01271200}
64: would be noon on the 27th of January in the current year.
65: .TP
66: (..)
67: A sub-expression.
68: .TP
69: identifier
70: Any one of the identifiers described below.
71: .TP
72: number
73: A decimal digit string.
74: .PP
75: Note that the expression may have to be quoted
76: to stop the shell from interpreting symbols such as
77: \fB&\fR
78: as symbols having special meaning.
79: .SH FORMATS
80: All
81: .I printf
82: format specifications and modifiers are allowed except the
83: \&'*' modifier. To facilitate the printing of dates
84: which are stored as the number of seconds since
85: 1st January 1970,
86: \fB%t\fR
87: may be used. This will cause the corresponding integral
88: argument to be interpreted as a time and given in the style
89: of
90: .I ctime
91: (see
92: .IR ctime (3C)).
93: All modifiers will be ignored in such a time specification.
94: .SH IDENTIFIERS
95: In the following list words printed in
96: .B "this font"
97: are as defined in the include files <shares.h> and <sys/lnode.h>.
98: .PD 0
99: .TP "\w'assumeddisconXX'u"
100: activelnode
101: 1 if the account has the
102: .B ACTIVELNODE
103: flag set.
104: .TP
105: changed
106: 1 if the account has the
107: .B CHANGED
108: flag set.
109: .TP
110: charge
111: The long term accumulated costs of the account as a floating point number.
112: .TP
113: deadgroup
114: 1 if the account has the
115: .B DEADGROUP
116: flag set.
117: .TP
118: dirpath
119: The initial directory of the account as a string.
120: .TP
121: flags
122: A string containing the names of the flags set for this account.
123: .TP
124: gecos
125: The ``gecos'' field of the account as a string.
126: .TP
127: gid
128: The integral gid of this account.
129: .TP
130: lastref
131: 1 if the account has the
132: .B LASTREF
133: flag set.
134: .TP
135: lastused
136: The time the account last did anything.
137: .TP
138: lname
139: The login name of the account as a string.
140: .TP
141: notshared
142: 1 if the account has a
143: .B NOTSHARED
144: flag.
145: .TP
146: now
147: The current time.
148: .TP
149: pword
150: The encrypted password of the account as a string.
151: .TP
152: sgroup
153: The uid of the scheduling group of this account.
154: .TP
155: sgroupname
156: The lname of the scheduling group of this account.
157: .TP
158: shares
159: The integral number of shares the account has.
160: .TP
161: shellpath
162: The initial shell of the account as a string.
163: .TP
164: usage
165: The usage of the account as a floating point number.
166: .TP
167: uid
168: The integral uid of this account.
169: .PD
170: .SH FILES
171: /etc/passwd
172: .br
173: /etc/shares
174: .SH SEE ALSO
175: printf(3S), ctime(3C), shares(5).
176: .SH DIAGNOSTICS
177: Yes. A summary of usage is given when pwintf
178: is invoked with no arguments.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.