--- /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>
git://git.openafs.org / openafs.git / blobdiff