openafs/doc/html/AdminReference/auarf242.htm

111 lines
6.1 KiB
HTML
Raw Normal View History

<!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 &lt;<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 &lt;<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>&#169; <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>