+++ /dev/null
-<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
-<HTML><HEAD>
-<TITLE>Administration Reference</TITLE>
-<!-- Begin Header Records ========================================== -->
-<!-- /tmp/idwt3672/auarf000.scr converted by idb2h R4.2 (359) ID -->
-<!-- Workbench Version (AIX) on 3 Oct 2000 at 16:18:30 -->
-<META HTTP-EQUIV="updated" CONTENT="Tue, 03 Oct 2000 16:18:29">
-<META HTTP-EQUIV="review" CONTENT="Wed, 03 Oct 2001 16:18:29">
-<META HTTP-EQUIV="expires" CONTENT="Thu, 03 Oct 2002 16:18:29">
-</HEAD><BODY>
-<!-- (C) IBM Corporation 2000. All Rights Reserved -->
-<BODY bgcolor="ffffff">
-<!-- End Header Records ============================================ -->
-<A NAME="Top_Of_Page"></A>
-<H1>Administration Reference</H1>
-<HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf203.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Bot_Of_Page"><IMG SRC="../bot.gif" BORDER="0" ALT="[Bottom of Topic]"></A> <A HREF="auarf205.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
-<P>
-<H2><A NAME="HDRPACKAGE" HREF="auarf002.htm#ToC_218">package</A></H2>
-<A NAME="IDX5197"></A>
-<A NAME="IDX5198"></A>
-<A NAME="IDX5199"></A>
-<A NAME="IDX5200"></A>
-<A NAME="IDX5201"></A>
-<A NAME="IDX5202"></A>
-<A NAME="IDX5203"></A>
-<P><STRONG>Purpose</STRONG>
-<P>Configures files and directories on the local disk
-<P><STRONG>Synopsis</STRONG>
-<PRE><B>package</B> [<B>initcmd</B>] [<B>-config</B> <<VAR>base name of configuration file</VAR>>]
- [<B>-fullconfig</B> <<VAR>full name of configuration file, or stdin for standard input</VAR>>]
- [<B>-overwrite</B>] [<B>-noaction</B>] [<B>-verbose</B>] [<B>-silent</B>] [<B>-rebootfiles</B>]
- [<B>-debug</B>] [<B>-help</B>]
-
-<B>package</B> [<B>i</B>] [<B>-c</B> <<VAR>base name of configuration file</VAR>>]
- [<B>-f</B> <<VAR>full name of configuration file, or stdin for standard input</VAR>>]
- [<B>-o</B>] [<B>-n</B>] [<B>-v</B>] [<B>-s</B>] [<B>-r</B>] [<B>-d</B>] [<B>-h</B>]
-</PRE>
-<P><STRONG>Description</STRONG>
-<P>The <B>package</B> command configures the machine's local disk to
-comply with the instructions in the configuration file named by the
-<B>-config</B> or <B>-fullconfig</B> argument.
-<P>By default, the <B>package</B> command alters any existing local disk
-element whose contents or configuration does not match the element defined in
-the configuration file. For example, if a configuration file
-<B>D</B> instruction defines a directory that has the same name as a
-symbolic link on the local disk, the <B>package</B> command replaces the
-symbolic link with the directory. The <B>F</B> and <B>L</B>
-instructions include an optional <VAR>update_code</VAR> field that alters this
-behavior.
-<P>Also by default, the <B>package</B> command takes no action on elements
-on the local disk that are not mentioned in the configuration file. Use
-the <B>D</B> instruction's <B>R</B> update code to remove files
-from the disk directory that are not mentioned in the configuration
-file.
-<P>Before running the <B>package</B> command, the administrator must
-create the template file and other files on the local disk. For
-instructions, see the <I>IBM AFS Administration Guide</I>.
-<P>It is not possible to configure a remote client machine's disk using
-this command.
-<P><STRONG>Cautions</STRONG>
-<P>The <B>package</B> command interpreter exits without executing any
-instruction if there are any syntax errors or incorrect values in the
-configuration file.
-<P><STRONG>Options</STRONG>
-<DL>
-<P><DT><B>initcmd
-</B><DD>Accommodates the command's use of the AFS command parser, and is
-optional.
-<P><DT><B>-config
-</B><DD>Specifies the pathname of the configuration file to use, ending in the
-file's base name, which omits the suffix that indicates the machine
-type. The <B>package</B> command determines the machine's
-system type name and automatically appends it to the base name. An
-example of the proper value for this argument is <B>staff</B> rather than
-<B>staff.rs_aix42</B>. Partial pathnames are interpreted
-relative to the current working directory.
-<P>Provide this argument or the <B>-fullconfig</B> argument.
-<P><DT><B>-fullconfig
-</B><DD>Specifies the configuration file to use. Two types of values are
-acceptable:
-<UL>
-<P><LI>The full pathname of the configuration file to use, complete with an
-extension indicating the machine type (examples:
-<B>staff.rs_aix42</B>, <B>admin.sun4x_56</B>).
-<P><LI>The string <B>stdin</B> to indicate that the issuer is providing
-configuration information via the standard input stream, either by piping in
-the contents of a file, or by typing configuration lines at the shell.
-In the latter case, type <B><Ctrl-d></B> to conclude the input.
-</UL>
-<P>Provide this argument or the <B>-config</B> argument.
-<P><DT><B>-overwrite
-</B><DD>Overwrites elements on the local disk with the source version indicated in
-the configuration file, even if the owner <B>write</B> (<B>w</B>) mode
-bit is turned on the disk element. Files protected by the <B>I</B>
-update code on an <B>F</B> line in the configuration file are not
-overwritten.
-<P><DT><B>-noaction
-</B><DD>Checks the sequence of operations to be performed when the command
-actually runs and reports any problems that the <B>package</B> command
-interpreter expects to encounter. No elements on the local disk or in
-AFS are changed. If the <B>-verbose</B> flag is also provided, the
-trace includes all actions to be performed as well as anticipated
-errors.
-<P><DT><B>-silent
-</B><DD>Suppresses some of the trace messages sent to the standard output stream
-by default. The output still reports major problems.
-<P><DT><B>-verbose
-</B><DD>Produces on the standard output stream a detailed trace of the
-command's execution. If this argument is omitted, only warnings
-and error messages appear.
-<P><DT><B>-rebootfiles
-</B><DD>Prevents overwriting of any file marked with the <B>Q</B> update code
-on an <B>F</B> line in the configuration file. This effectively
-prevents the machine from rebooting automatically again when the
-<B>package</B> command is invoked in the machine's AFS initialization
-file.
-<P><DT><B>-debug
-</B><DD>Enables debugging output, which is directed to the standard output stream
-by default. By default, no debugging output is produced.
-<P><DT><B>-help
-</B><DD>Prints the online help for this command. All other valid options
-are ignored.
-</DL>
-<P><STRONG>Examples</STRONG>
-<P>This command is usually invoked in a client machine's AFS
-initialization file (<B>/etc/rc</B> or equivalent), rather than issued at
-the command shell prompt.
-<P>The following command invokes the version of the <B>staff</B>
-configuration file appropriate for this machine's system type, and
-produces verbose output.
-<PRE> # <B>/etc/package -c staff -v</B>
-
-</PRE>
-<P>The following example uses the configuration file whose basename is defined
-in the <B>/.package</B> file on the local machine. This
-method enables the administrator to use the same <B>package</B> command in
-every machine's AFS initialization file but still customize configuration
-by putting the appropriate basename in the <B>/.package</B>
-file.
-<PRE> # <B>/etc/package -c `cat /.package` -v</B>
-
-</PRE>
-<P><STRONG>Privilege Required</STRONG>
-<P>The issuer must be logged in as the local superuser <B>root</B>.
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf053.htm#HDRPACKAGECONFIG">package Configuration File</A>
-<P>
-<HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf203.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Top_Of_Page"><IMG SRC="../top.gif" BORDER="0" ALT="[Top of Topic]"></A> <A HREF="auarf205.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
-<!-- Begin Footer Records ========================================== -->
-<P><HR><B>
-<br>© <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A> All Rights Reserved
-</B>
-<!-- End Footer Records ============================================ -->
-<A NAME="Bot_Of_Page"></A>
-</BODY></HTML>