--- /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="auarf241.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="auarf243.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="HDRUSS_INTRO" HREF="auarf002.htm#ToC_256">uss</A></H2>
+<A NAME="IDX5508"></A>
+<A NAME="IDX5509"></A>
+<A NAME="IDX5510"></A>
+<A NAME="IDX5511"></A>
+<A NAME="IDX5512"></A>
+<A NAME="IDX5513"></A>
+<A NAME="IDX5514"></A>
+<A NAME="IDX5515"></A>
+<A NAME="IDX5516"></A>
+<P><STRONG>Purpose</STRONG>
+<P>Introduction to the <B>uss</B> command suite
+<P><STRONG>Description</STRONG>
+<P>The commands in the <B>uss</B> command suite help administrators to
+create AFS user accounts more easily and efficiently. If <B>uss</B>
+commands are not used, creating an account requires issuing at least six
+separate commands to five different AFS servers.
+<P>There are three main commands in the suite:
+<UL>
+<P><LI>The <B>uss add</B> command creates a single complete user account,
+based on command line arguments and instructions in a template file.
+<P><LI>The <B>uss bulk</B> command creates multiple complete accounts at
+once, based on command line arguments, instructions in a template file and a
+bulk input file.
+<P><LI>the <B>uss delete</B> command removes most parts of a user
+account.
+</UL>
+<P>To obtain help, issue the <B>uss apropos</B> and <B>uss help</B>
+commands.
+<P><STRONG>Options</STRONG>
+<P>The following arguments and flags are available on many commands in the
+<B>uss</B> suite. The reference page for each command also lists
+them, but they are described here in greater detail.
+<DL>
+<P><DT><B>-admin <<VAR>administrator to authenticate</VAR>>
+</B><DD>Specifies the AFS user name under which to establish a connection to the
+AFS server processes that administer the various parts of a user
+account. If it is omitted, the connection is established under the
+issuer's effective user ID (his or her identity in the local file
+system). Even when this argument is included, UNIX commands that run
+during the <B>uss</B> operation (for instance, the UNIX
+<B>/etc/chown</B> command) run under the effective user ID.
+<P><DT><B>-cell <<VAR>cell name</VAR>>
+</B><DD>Names the cell in which to run the command. It is acceptable to
+abbreviate the cell name to the shortest form that distinguishes it from the
+other entries in the <B>/usr/vice/etc/CellServDB</B> file on the local
+machine. If the <B>-cell</B> argument is omitted, the command
+interpreter determines the name of the local cell by reading the following in
+order:
+<OL TYPE=1>
+<P><LI>The value of the AFSCELL environment variable
+<P><LI>The local <B>/usr/vice/etc/ThisCell</B> file
+</OL>
+<P><DT><B>-dryrun
+</B><DD>Reports actions that the command interpreter needs to perform when
+executing the <B>uss</B> operation, without actually performing
+them. Include this flag to verify that the command produces the desired
+account configuration. Combine it with the <B>-verbose</B> flag to
+yield even more detailed information. Note that the output does not
+necessarily reveal all possible problems that can prevent successful execution
+of the command, especially those that result from transient server or network
+outages.
+<P><DT><B>-help
+</B><DD>Prints a command's online help message on the standard output
+stream. Do not combine this flag with any of the command's other
+options; when it is provided, the command interpreter ignores all other
+options, and only prints the help message.
+<P><DT><B>-skipauth
+</B><DD>Bypasses mutual authentication with the AFS Authentication Server,
+allowing a site that uses Kerberos instead of the AFS Authentication Server to
+substitute that form of authentication.
+</DL>
+<P><STRONG>Privilege Required</STRONG>
+<P>The issuer of a <B>uss</B> command must have all the rights required
+for performing the equivalent actions individually. See each
+<B>uss</B> command's reference page.
+<P><STRONG>Related Information</STRONG>
+<P><A HREF="auarf054.htm#HDRUSSBULKINPUT">uss Bulk Input File</A>
+<P><A HREF="auarf055.htm#HDRUSSFILE">uss Template File</A>
+<P><A HREF="auarf243.htm#HDRUSS_ADD">uss add</A>
+<P><A HREF="auarf244.htm#HDRUSS_APROPOS">uss apropos</A>
+<P><A HREF="auarf245.htm#HDRUSS_BULK">uss bulk</A>
+<P><A HREF="auarf246.htm#HDRUSS_DELETE">uss delete</A>
+<P><A HREF="auarf247.htm#HDRUSS_HELP">uss help</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="auarf241.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="auarf243.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