3 package - Configures files and directories on the local disk
7 B<package> [B<initcmd>] [-config <I<base name of configuration file>>]
8 [B<-fullconfig> <I<full name of configuration file, or stdin for standard input>>]
9 [B<-overwrite>] [B<-noaction>] [B<-verbose>] [B<-silent>] [-rebootfiles]
12 B<package> [B<i>] [-c <I<base name of configuration file>>]
13 [B<-f> <I<full name of configuration file, or stdin for standard input>>]
14 [B<-o>] [B<-n>] [B<-v>] [B<-s>] [B<-r>] [B<-d>] [-h]
18 The package command configures the machine's local disk to
19 comply with the instructions in the configuration file named by the
20 B<-config> or B<-fullconfig> argument.
22 By default, the package command alters any existing local disk
23 element whose contents or configuration does not match the element defined in
24 the configuration file. For example, if a configuration file
25 B<D> instruction defines a directory that has the same name as a
26 symbolic link on the local disk, the B<package> command replaces the
27 symbolic link with the directory. The B<F> and B<L>
28 instructions include an optional I<update_code> field that alters this
31 Also by default, the package command takes no action on elements
32 on the local disk that are not mentioned in the configuration file. Use
33 the B<D> instruction's B<R> update code to remove files
34 from the disk directory that are not mentioned in the configuration
37 Before running the package command, the administrator must
38 create the template file and other files on the local disk. For
39 instructions, see the I<IBM AFS Administration Guide>.
41 It is not possible to configure a remote client machine's disk using
46 The package command interpreter exits without executing any
47 instruction if there are any syntax errors or incorrect values in the
56 Accommodates the command's use of the AFS command parser, and is
61 Specifies the pathname of the configuration file to use, ending in the
62 file's base name, which omits the suffix that indicates the machine
63 type. The B<package> command determines the machine's
64 system type name and automatically appends it to the base name. An
65 example of the proper value for this argument is B<staff> rather than
66 B<staff.rs_aix42>. Partial pathnames are interpreted
67 relative to the current working directory.
69 Provide this argument or the -fullconfig argument.
73 Specifies the configuration file to use. Two types of values are
80 The full pathname of the configuration file to use, complete with an
81 extension indicating the machine type (examples:
82 B<staff.rs_aix42>, B<admin.sun4x_56>).
87 The string stdin to indicate that the issuer is providing
88 configuration information via the standard input stream, either by piping in
89 the contents of a file, or by typing configuration lines at the shell.
90 In the latter case, type B<<Ctrl-d>> to conclude the input.
95 Provide this argument or the -config argument.
99 Overwrites elements on the local disk with the source version indicated in
100 the configuration file, even if the owner B<write> (B<w>) mode
101 bit is turned on the disk element. Files protected by the B<I>
102 update code on an B<F> line in the configuration file are not
107 Checks the sequence of operations to be performed when the command
108 actually runs and reports any problems that the B<package> command
109 interpreter expects to encounter. No elements on the local disk or in
110 AFS are changed. If the B<-verbose> flag is also provided, the
111 trace includes all actions to be performed as well as anticipated
116 Suppresses some of the trace messages sent to the standard output stream
117 by default. The output still reports major problems.
121 Produces on the standard output stream a detailed trace of the
122 command's execution. If this argument is omitted, only warnings
123 and error messages appear.
127 Prevents overwriting of any file marked with the Q update code
128 on an B<F> line in the configuration file. This effectively
129 prevents the machine from rebooting automatically again when the
130 B<package> command is invoked in the machine's AFS initialization
135 Enables debugging output, which is directed to the standard output stream
136 by default. By default, no debugging output is produced.
140 Prints the online help for this command. All other valid options
147 This command is usually invoked in a client machine's AFS
148 initialization file (B</etc/rc> or equivalent), rather than issued at
149 the command shell prompt.
151 The following command invokes the version of the staff
152 configuration file appropriate for this machine's system type, and
153 produces verbose output.
155 # /etc/package -c staff -v
157 The following example uses the configuration file whose basename is defined
158 in the B</.package> file on the local machine. This
159 method enables the administrator to use the same B<package> command in
160 every machine's AFS initialization file but still customize configuration
161 by putting the appropriate basename in the B</.package>
164 # /etc/package -c `cat /.package` -v
166 =head1 PRIVILEGE REQUIRED
168 The issuer must be logged in as the local superuser root.
172 L<package Configuration File(1)>
176 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
178 This documentation is covered by the IBM Public License Version 1.0. It was
179 converted from HTML to POD by software written by Chas Williams and Russ
180 Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.