openafs/doc/html/UserGuide/auusg003.htm
Derrick Brashear d7da1acc31 initial-html-documentation-20010606
pull in all documentation from IBM
2001-06-06 19:09:07 +00:00

125 lines
7.9 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
<HTML><HEAD>
<TITLE>User Guide</TITLE>
<!-- Begin Header Records ========================================== -->
<!-- /tmp/idwt3629/auusg000.scr converted by idb2h R4.2 (359) ID -->
<!-- Workbench Version (AIX) on 2 Oct 2000 at 14:38:44 -->
<META HTTP-EQUIV="updated" CONTENT="Mon, 02 Oct 2000 14:38:42">
<META HTTP-EQUIV="review" CONTENT="Tue, 02 Oct 2001 14:38:42">
<META HTTP-EQUIV="expires" CONTENT="Wed, 02 Oct 2002 14:38:42">
</HEAD><BODY>
<!-- (C) IBM Corporation 2000. All Rights Reserved -->
<BODY bgcolor="ffffff">
<!-- End Header Records ============================================ -->
<A NAME="Top_Of_Page"></A>
<H1>User Guide</H1>
<HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auusg002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auusg002.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="auusg004.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auusg013.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
<P>
<HR><H1><A NAME="HDRWQ1" HREF="auusg002.htm#ToC_1">About This Guide</A></H1>
<P>This section describes the purpose, organization, and conventions of this
document.
<HR><H2><A NAME="HDRPREFAUDPUR" HREF="auusg002.htm#ToC_2">Audience and Purpose</A></H2>
<P>This guide describes concepts and procedures for
accessing information stored in the AFS filespace. It is intended for
AFS users who are familiar with UNIX but not necessarily AFS.
<P>The first chapter describes basic AFS concepts and guidelines for using it,
and summarizes some of the differences between the UNIX file system and
AFS. The remaining chapters explain how to perform basic AFS functions,
including logging in, changing a password, listing information, protecting
files, creating groups, and troubleshooting. Concepts important to a
specific task or group of related tasks are presented in context, just prior
to the procedures. Many examples are provided.
<P>Instructions generally include only the commands and command options
necessary for a specific task. For a complete list of AFS commands and
description of all options available on every command, see the <I>IBM AFS
Administration Reference</I>.
<HR><H2><A NAME="HDRPREFORGAN" HREF="auusg002.htm#ToC_3">Document Organization</A></H2>
<P>This document is divided into the following
chapters.
<P><A HREF="auusg004.htm#HDRWQ2">An Introduction to AFS</A> introduces the basic concepts and functions of AFS.
To use AFS successfully, it is important to be familiar with the terms and
concepts described in this chapter.
<P><A HREF="auusg005.htm#HDRWQ20">Using AFS</A> describes how to use AFS's basic features: how to
log in and authenticate, unlog, log out, access AFS files and directories in
AFS, and change your password.
<P><A HREF="auusg006.htm#HDRWQ38">Displaying Information about AFS</A> describes how to display information about AFS volume quota
and location, file server machine status, and the foreign cells you can
access.
<P><A HREF="auusg007.htm#HDRWQ44">Protecting Your Directories and Files</A> describes how to protect your data using AFS access control
lists (ACLs).
<P><A HREF="auusg008.htm#HDRWQ60">Using Groups</A> describes how to create and manage groups.
<P><A HREF="auusg009.htm#HDRWQ76">Troubleshooting</A> outlines step-by-step diagnostic and corrective steps for
specific problems.
<P><A HREF="auusg010.htm#HDRWQ80">Appendix A, Using the NFS/AFS Translator</A> describes how to use the NFS/AFS Translator to access the
AFS filespace from an NFS client machine.
<P><A HREF="auusg011.htm#HDRWQ86">Appendix B, AFS Command Syntax and Online Help</A> describes AFS command syntax and how to obtain online
information about commands.
<P><A HREF="auusg012.htm#HDRWQ90">Appendix C, Glossary</A> defines terms used in the <I>IBM AFS User
Guide</I>.
<HR><H2><A NAME="HDRUSERFRONTHOWTO" HREF="auusg002.htm#ToC_4">How To Use This Document</A></H2>
<P>Before you begin using AFS, read <A HREF="auusg004.htm#HDRWQ2">An Introduction to AFS</A>. Next, follow the procedures
outlined in <A HREF="auusg005.htm#HDRWQ20">Using AFS</A> to get started using AFS as an authenticated user. It
describes how to access files in the AFS filespace and how to end an AFS
session. Consult the other chapters as you need to perform the tasks
they describe.
<HR><H2><A NAME="HDRPREFRELATE" HREF="auusg002.htm#ToC_5">Related Documents</A></H2>
<P>The AFS Documentation Kit also includes the following
documents:
<UL>
<P><LI>The <I>IBM AFS Administration Reference</I> details the syntax of each
AFS command and is intended for the experienced AFS administrator, programmer,
or user. For each AFS command, the <I>IBM AFS Administration
Reference</I> lists the command syntax, aliases and abbreviations,
description, arguments, warnings, output, examples, and related topics.
Commands are organized alphabetically.
<P><LI>The <I>IBM AFS Administration Guide</I> describes concepts and
procedures necessary for administering an AFS cell, as well as more extensive
coverage of the topics in the <I>IBM AFS User Guide</I>.
<P><LI>The <I>IBM AFS Quick Beginnings</I> provides instructions for
installing AFS server and client machines.
</UL>
<HR><H2><A NAME="HDRTYPO_CONV" HREF="auusg002.htm#ToC_6">Typographical Conventions</A></H2>
<P>This document uses the following typographical
conventions:
<UL>
<P><LI>Command and option names appear in <B>bold type</B> in syntax
definitions, examples, and running text. Names of directories, files,
machines, partitions, volumes, and users also appear in <B>bold
type</B>.
<P><LI>Variable information appears in <I>italic type</I>. This
includes user-supplied information on command lines and the parts of prompts
that differ depending on who issues the command. New terms also appear
in <I>italic type</I>.
<P><LI>Examples of screen output and file contents appear in <TT>monospace
type</TT>.
</UL>
<P>In addition, the following symbols appear in command syntax definitions,
both in the documentation and in AFS online help statements. When
issuing a command, do not type these symbols.
<UL>
<P><LI>Square brackets <B>[ ]</B> surround optional items.
<P><LI>Angle brackets <B>&lt; ></B> surround user-supplied values in AFS
commands.
<P><LI>A superscripted plus sign <B>+</B> follows an argument that accepts
more than one value.
<P><LI>The percent sign <TT>%</TT> represents the regular command shell
prompt. Some operating systems possibly use a different character for
this prompt.
<P><LI>The number sign <TT>#</TT> represents the command shell prompt for the
local superuser <B>root</B>. Some operating systems possibly use a
different character for this prompt.
<P><LI>The pipe symbol <B> |</B> in a command syntax statement separates
mutually exclusive values for an argument.
</UL>
<P>For additional information on AFS commands, including a description of
command string components, acceptable abbreviations and aliases, and how to
get online help for commands, see <A HREF="auusg011.htm#HDRWQ86">Appendix B, AFS Command Syntax and Online Help</A>.
<HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auusg002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auusg002.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="auusg004.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auusg013.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>