mirror of
https://git.openafs.org/openafs.git
synced 2025-01-21 00:10:15 +00:00
d7da1acc31
pull in all documentation from IBM
111 lines
6.1 KiB
HTML
111 lines
6.1 KiB
HTML
<!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>
|