Annotation of researchv10dc/man/manx/pwintf.1, revision 1.1.1.1

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.

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.