3 1. The uss Commands and Template Lines
5 ------------------------------------------------------------
7 The uss commands help administrators create user accounts in
8 their system more easily and efficiently. Without them,
9 administering accounts can become time consuming. Creating
10 an account "by hand" requires issuing at least six separate
11 commands to five different AFS servers, whereas a single
12 uss add command can accomplish all the equivalent actions
13 once the issuer sets up the necessary template. Even
14 better, a single issue of the the uss bulk command can
15 create multiple accounts at once, after the necessary
16 preparations have been made.
18 Refer to chapter 11 in the Reference Manual for a complete
19 summary list of uss commands and their syntax.
21 1.1 Common Arguments and Flags
22 Most uss commands accept the following optional arguments
23 and flags. They are listed in the command descriptions
24 where they apply, and are described here in detail:
28 This argument specifies that the command should be run in
29 the cell specified by cell name. By default, commands are
30 executed in the local cell, as defined in
31 /usr/vice/etc/ThisCell on the client machine on which the
32 command is issued. The issuer may abbreviate cell name to
33 the shortest form that distinguishes it from the other cells
34 listed in /usr/vice/etc/CellServDB on the client machine on
35 which the command is issued.
37 [-admin <administrator to authenticate>]
39 This argument names the user name whom the Authentication
40 Servers should authenticate for purposes of creating an
41 Authentication Database entry. If the issuer does not
42 provide it, the authentication is attempted for the
43 effective user name (the one under which the issuer is
44 logged into the local machine's UNIX file system). With or
45 without this argument, UNIX commands invoked by this command
46 (for instance, /etc/chown) are executed under the effective
49 AFS Command Reference ManuaThe uss Commands and Template Li
54 This flag indicates that the command interpreter should not
55 actually execute the command, but should report all the
56 actions it would perform if executing it. This flag is
57 useful for verifying that the account will be configured as
58 the issuer wishes. It does not, however, necessarily reveal
59 failures that will result if the uss command interpreter
60 encounters any circumstances that make it impossible to
61 carry out a requested action. Combining this flag with
62 -verbose yields more information.
66 This flag has the same function as the bos help command: it
67 prints the command's online help message on the screen. No
68 other arguments or flags should be provided at the same
69 time. Even if they are, this flag overrides them, and the
70 only effect of issuing the command is that the help message
75 1.1.1 The Privilege Required for uss Commands
76 The issuer of a uss command must have all the rights
77 required for performing the equivalent actions individually.
78 See the PRIVILEGE REQUIRED section of each command
79 description for details.