openafs/doc/xml/UserGuide/book1.html
Chas Williams 52557c982e xml-docbook-documentation-first-pass-20060915
needs more massaging to make it fit the tree, but, get it here first
2006-09-16 01:13:22 +00:00

1210 lines
17 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML
><HEAD
><TITLE
>AFS User Guide</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK
REL="NEXT"
TITLE="About This Guide"
HREF="f24.html"></HEAD
><BODY
CLASS="book"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="BOOK"
><A
NAME="AEN1"
></A
><DIV
CLASS="TITLEPAGE"
><H1
CLASS="title"
><A
NAME="AEN2"
>AFS User Guide</A
></H1
><H2
CLASS="subtitle"
>Version 3.6</H2
><P
CLASS="copyright"
>Copyright &copy; 2000 IBM Corporation. All Rights Reserved</P
><DIV
><DIV
CLASS="abstract"
><A
NAME="AEN14"
></A
><P
>This edition applies to: <TABLE
BORDER="0"
><TBODY
><TR
><TD
>IBM AFS for AIX, Version 3.6</TD
></TR
><TR
><TD
>IBM AFS for Digital Unix, Version 3.6</TD
></TR
><TR
><TD
>IBM AFS for HP-UX, Version 3.6</TD
></TR
><TR
><TD
>IBM AFS for Linux, Version 3.6</TD
></TR
><TR
><TD
>IBM AFS for SGI IRIX, Version 3.6</TD
></TR
><TR
><TD
>IBM AFS for Solaris, Version 3.6</TD
></TR
></TBODY
></TABLE
></P
><P
>and to all subsequent releases and modifications until otherwise
indicated in new editions.This softcopy version is based on the printed
edition of this book. Some formatting amendments have been made to make
this information more suitable for softcopy.</P
></DIV
></DIV
><HR></DIV
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
><A
HREF="f24.html"
>About This Guide</A
></DT
><DD
><DL
><DT
><A
HREF="f24.html#HDRPREFAUDPUR"
>Audience and Purpose</A
></DT
><DT
><A
HREF="f24.html#HDRPREFORGAN"
>Document Organization</A
></DT
><DT
><A
HREF="f24.html#HDRUSERFRONTHOWTO"
>How To Use This Document</A
></DT
><DT
><A
HREF="f24.html#HDRPREFRELATE"
>Related Documents</A
></DT
><DT
><A
HREF="f24.html#HDRTYPO_CONV"
>Typographical Conventions</A
></DT
></DL
><BR></DD
><DT
>1. <A
HREF="c113.html"
>An Introduction to AFS</A
></DT
><DD
><DL
><DT
><A
HREF="c113.html#HDRWQ3"
>AFS Concepts</A
></DT
><DD
><DL
><DT
><A
HREF="c113.html#Header_9"
>Client/Server Computing</A
></DT
><DT
><A
HREF="c113.html#Header_10"
>Distributed File Systems</A
></DT
><DT
><A
HREF="c113.html#HDRWQ4"
>AFS Filespace and Local Filespace</A
></DT
><DT
><A
HREF="c113.html#HDRWQ5"
>Cells and Sites</A
></DT
><DT
><A
HREF="c113.html#HDRWQ6"
>Volumes and Mount Points</A
></DT
><DT
><A
HREF="c113.html#HDRWQ7"
>Volume Quotas</A
></DT
></DL
><BR></DD
><DT
><A
HREF="c113.html#HDRWQ8"
>Using Files in AFS</A
></DT
><DD
><DL
><DT
><A
HREF="c113.html#HDRWQ9"
>The Cache Manager</A
></DT
><DT
><A
HREF="c113.html#HDRWQ10"
>Updating Copies of Cached Files</A
></DT
><DT
><A
HREF="c113.html#Header_18"
>Multiple Users Modifying Files</A
></DT
></DL
><BR></DD
><DT
><A
HREF="c113.html#HDRWQ11"
>AFS Security</A
></DT
><DD
><DL
><DT
><A
HREF="c113.html#HDRWQ12"
>Passwords and Mutual Authentication</A
></DT
><DT
><A
HREF="c113.html#Header_21"
>Access Control Lists</A
></DT
></DL
><BR></DD
><DT
><A
HREF="c113.html#HDRWQ13"
>Differences Between UNIX and AFS</A
></DT
><DD
><DL
><DT
><A
HREF="c113.html#HDRWQ14"
>File Sharing</A
></DT
><DT
><A
HREF="c113.html#HDRWQ15"
>Login and Authentication</A
></DT
><DT
><A
HREF="c113.html#HDRWQ16"
>File and Directory Protection</A
></DT
><DT
><A
HREF="c113.html#HDRWQ17"
>Machine Outages</A
></DT
><DT
><A
HREF="c113.html#HDRWQ18"
>Remote Commands</A
></DT
><DT
><A
HREF="c113.html#Header_28"
>Differences in the Semantics of Standard UNIX Commands</A
></DT
></DL
><BR></DD
><DT
><A
HREF="c113.html#HDRWQ19"
>Using AFS with NFS</A
></DT
></DL
><BR></DD
><DT
>2. <A
HREF="c569.html"
>Using AFS</A
></DT
><DD
><DL
><DT
><A
HREF="c569.html#HDRWQ21"
>Logging in and Authenticating with AFS</A
></DT
><DD
><DL
><DT
><A
HREF="c569.html#HDRWQ22"
>Logging In</A
></DT
><DT
><A
HREF="c569.html#Header_33"
>To Log In Using an AFS-modified Login Utility</A
></DT
><DT
><A
HREF="c569.html#HDRWQ23"
>To Log In Using a Two-Step Login Procedure</A
></DT
><DT
><A
HREF="c569.html#HDRWQ24"
>Authenticating with AFS</A
></DT
><DT
><A
HREF="c569.html#HDRWQ29"
>To Authenticate with AFS</A
></DT
><DT
><A
HREF="c569.html#HDRWQ30"
>To Display Your Tokens</A
></DT
><DT
><A
HREF="c569.html#Header_44"
>Example: Authenticating in the Local Cell</A
></DT
><DT
><A
HREF="c569.html#Header_45"
>Example: Authenticating as a Another User</A
></DT
><DT
><A
HREF="c569.html#Header_46"
>Example: Authenticating in a Foreign Cell</A
></DT
><DT
><A
HREF="c569.html#HDRWQ31"
>Limits on Failed Authentication Attempts</A
></DT
><DT
><A
HREF="c569.html#HDRWQ32"
>To Display Your Failed Authentication Limit and Lockout Time</A
></DT
></DL
><BR></DD
><DT
><A
HREF="c569.html#HDRWQ33"
>Exiting an AFS Session</A
></DT
><DD
><DL
><DT
><A
HREF="c569.html#Header_50"
>To Discard Tokens</A
></DT
><DT
><A
HREF="c569.html#Header_51"
>Example: Unauthenticating from a Specific Cell</A
></DT
><DT
><A
HREF="c569.html#Header_52"
>To Log Out</A
></DT
></DL
><BR></DD
><DT
><A
HREF="c569.html#HDRWQ34"
>Accessing the AFS Filespace</A
></DT
><DD
><DL
><DT
><A
HREF="c569.html#Header_54"
>AFS Pathnames</A
></DT
><DT
><A
HREF="c569.html#Header_55"
>Example: Displaying the Contents of Another User's Directory</A
></DT
><DT
><A
HREF="c569.html#HDRWQ35"
>Accessing Foreign Cells</A
></DT
></DL
><BR></DD
><DT
><A
HREF="c569.html#HDRWQ36"
>Changing Your Password</A
></DT
><DD
><DL
><DT
><A
HREF="c569.html#HDRWQ37"
>To Display Password Expiration Date and Reuse Policy</A
></DT
><DT
><A
HREF="c569.html#Header_59"
>To Change Your AFS Password</A
></DT
><DT
><A
HREF="c569.html#Header_60"
>To Change Your UNIX Password</A
></DT
></DL
><BR></DD
></DL
><BR></DD
><DT
>3. <A
HREF="c1095.html"
>Displaying Information about AFS</A
></DT
><DD
><DL
><DT
><A
HREF="c1095.html#HDRWQ39"
>Displaying Volume Quota</A
></DT
><DD
><DL
><DT
><A
HREF="c1095.html#Header_63"
>To Display Percentage of Quota Used</A
></DT
><DT
><A
HREF="c1095.html#Header_64"
>Example: Displaying Percentage of Quota Used</A
></DT
><DT
><A
HREF="c1095.html#Header_65"
>To Display Quota and Other Information about a Volume</A
></DT
><DT
><A
HREF="c1095.html#Header_66"
>Example: Display Quota and Other Information about a Volume</A
></DT
><DT
><A
HREF="c1095.html#Header_67"
>To Display Quota and Other Information about a Volume and Partition</A
></DT
><DT
><A
HREF="c1095.html#Header_68"
>Example: Displaying Quota and Other Information about a Volume and Partition</A
></DT
></DL
><BR></DD
><DT
><A
HREF="c1095.html#HDRWQ40"
>Locating Files and Directories</A
></DT
><DD
><DL
><DT
><A
HREF="c1095.html#Header_70"
>To Display a File or Directory's Location</A
></DT
><DT
><A
HREF="c1095.html#Header_71"
>Example: Displaying Directory Location</A
></DT
></DL
><BR></DD
><DT
><A
HREF="c1095.html#HDRWQ41"
>Checking the Status of Server Machines</A
></DT
><DD
><DL
><DT
><A
HREF="c1095.html#Header_73"
>To Check File Server Machine Status</A
></DT
><DT
><A
HREF="c1095.html#Header_74"
>Example: Checking Server Machine Status</A
></DT
></DL
><BR></DD
><DT
><A
HREF="c1095.html#HDRWQ42"
>Determining Access to Foreign Cells</A
></DT
><DD
><DL
><DT
><A
HREF="c1095.html#Header_76"
>To Display Foreign Cells</A
></DT
></DL
><BR></DD
><DT
><A
HREF="c1095.html#HDRWQ43"
>Displaying Server Preference Ranks</A
></DT
><DD
><DL
><DT
><A
HREF="c1095.html#Header_78"
>To Display Server Preference Ranks</A
></DT
></DL
><BR></DD
></DL
><BR></DD
><DT
>4. <A
HREF="c1444.html"
>Protecting Your Directories and Files</A
></DT
><DD
><DL
><DT
><A
HREF="c1444.html#HDRWQ45"
>Access Control Lists</A
></DT
><DD
><DL
><DT
><A
HREF="c1444.html#Header_81"
>Directory Level Access Control</A
></DT
></DL
><BR></DD
><DT
><A
HREF="c1444.html#HDRWQ46"
>The AFS ACL Permissions</A
></DT
><DD
><DL
><DT
><A
HREF="c1444.html#HDRWQ47"
>The Four Directory Permissions</A
></DT
><DT
><A
HREF="c1444.html#HDRWQ48"
>The Three File Permissions</A
></DT
><DT
><A
HREF="c1444.html#Header_85"
>The Eight Auxiliary Permissions</A
></DT
><DT
><A
HREF="c1444.html#Header_86"
>Shorthand Notation for Sets of Permissions</A
></DT
><DT
><A
HREF="c1444.html#HDRWQ49"
>About Normal and Negative Permissions</A
></DT
><DT
><A
HREF="c1444.html#Header_88"
>Setting DFS ACLs</A
></DT
></DL
><BR></DD
><DT
><A
HREF="c1444.html#HDRWQ50"
>Using the System Groups on ACLs</A
></DT
><DD
><DL
><DT
><A
HREF="c1444.html#Header_90"
>Enabling Access to Subdirectories</A
></DT
><DT
><A
HREF="c1444.html#Header_91"
>Extending Access to Service Processes</A
></DT
><DT
><A
HREF="c1444.html#HDRWQ51"
>Extending Access to Users from Foreign Cells</A
></DT
></DL
><BR></DD
><DT
><A
HREF="c1444.html#HDRWQ52"
>Displaying an ACL</A
></DT
><DD
><DL
><DT
><A
HREF="c1444.html#HDRWQ53"
>To display an ACL</A
></DT
><DT
><A
HREF="c1444.html#Header_95"
>Example: Displaying the ACL on One Directory</A
></DT
><DT
><A
HREF="c1444.html#Header_96"
>Example: Displaying the ACLs on Multiple Directories</A
></DT
></DL
><BR></DD
><DT
><A
HREF="c1444.html#HDRWQ54"
>Changing an ACL</A
></DT
><DD
><DL
><DT
><A
HREF="c1444.html#HDRWQ55"
>To Add, Remove, or Edit Normal ACL Permissions</A
></DT
><DT
><A
HREF="c1444.html#Header_99"
>Example: Adding a Single ACL Entry</A
></DT
><DT
><A
HREF="c1444.html#Header_100"
>Example: Setting Several ACL Entries on One Directory</A
></DT
><DT
><A
HREF="c1444.html#HDRWQ56"
>To Add, Remove, or Edit Negative ACL Permissions</A
></DT
><DT
><A
HREF="c1444.html#Header_102"
>Example: Setting an Entry in the Negative Permissions Section</A
></DT
><DT
><A
HREF="c1444.html#Header_103"
>Example: Restoring Access by Removing an Entry from the Negative Permissions Section</A
></DT
></DL
><BR></DD
><DT
><A
HREF="c1444.html#HDRWQ57"
>Completely Replacing an ACL</A
></DT
><DD
><DL
><DT
><A
HREF="c1444.html#Header_105"
>To Replace an ACL Completely</A
></DT
><DT
><A
HREF="c1444.html#Header_106"
>Example: Replacing an ACL</A
></DT
></DL
><BR></DD
><DT
><A
HREF="c1444.html#HDRWQ58"
>Copying ACLs Between Directories</A
></DT
><DD
><DL
><DT
><A
HREF="c1444.html#Header_108"
>To Copy an ACL Between Directories</A
></DT
><DT
><A
HREF="c1444.html#Header_109"
>Example: Copying an ACL from One Directory to Another</A
></DT
></DL
><BR></DD
><DT
><A
HREF="c1444.html#HDRWQ59"
>How AFS Uses the UNIX Mode Bits</A
></DT
><DD
><DL
><DT
><A
HREF="c1444.html#Header_111"
>Example: Disabling Write Access for a File</A
></DT
></DL
><BR></DD
></DL
><BR></DD
><DT
>5. <A
HREF="c2454.html"
>Using Groups</A
></DT
><DD
><DL
><DT
><A
HREF="c2454.html#HDRWQ61"
>About Groups</A
></DT
><DD
><DL
><DT
><A
HREF="c2454.html#HDRWQ62"
>Suggestions for Using Groups Effectively</A
></DT
><DT
><A
HREF="c2454.html#HDRWQ63"
>Group Names</A
></DT
><DT
><A
HREF="c2454.html#Header_116"
>Group-creation Quota</A
></DT
></DL
><BR></DD
><DT
><A
HREF="c2454.html#HDRWQ64"
>Displaying Group Information</A
></DT
><DD
><DL
><DT
><A
HREF="c2454.html#HDRWQ65"
>To Display Group Membership</A
></DT
><DT
><A
HREF="c2454.html#Header_119"
>Example: Displaying the Members of a Group</A
></DT
><DT
><A
HREF="c2454.html#Header_120"
>Example: Displaying the Groups to Which a User Belongs</A
></DT
><DT
><A
HREF="c2454.html#HDRWQ66"
>To Display the Groups a User or Group Owns</A
></DT
><DT
><A
HREF="c2454.html#Header_122"
>Example: Displaying the Groups a Group Owns</A
></DT
><DT
><A
HREF="c2454.html#Header_123"
>Example: Displaying the Groups a User Owns</A
></DT
><DT
><A
HREF="c2454.html#HDRWQ67"
>To Display A Group Entry</A
></DT
><DT
><A
HREF="c2454.html#Header_125"
>Example: Listing Information about a Group</A
></DT
><DT
><A
HREF="c2454.html#Header_126"
>Example: Listing Group Information about a User</A
></DT
></DL
><BR></DD
><DT
><A
HREF="c2454.html#HDRWQ68"
>Creating Groups and Adding Members</A
></DT
><DD
><DL
><DT
><A
HREF="c2454.html#HDRWQ69"
>To Create a Group</A
></DT
><DT
><A
HREF="c2454.html#Header_129"
>Example: Creating a Group</A
></DT
><DT
><A
HREF="c2454.html#HDRWQ70"
>To Add Members to a Group</A
></DT
><DT
><A
HREF="c2454.html#Header_131"
>Example: Adding Members to a Group</A
></DT
></DL
><BR></DD
><DT
><A
HREF="c2454.html#HDRWQ71"
>Removing Users from a Group and Deleting a Group</A
></DT
><DD
><DL
><DT
><A
HREF="c2454.html#Header_133"
>To Remove Members from a Group</A
></DT
><DT
><A
HREF="c2454.html#Header_134"
>Example: Removing Group Members</A
></DT
><DT
><A
HREF="c2454.html#Header_135"
>To Delete a Group</A
></DT
><DT
><A
HREF="c2454.html#Header_136"
>Example: Deleting a Group</A
></DT
><DT
><A
HREF="c2454.html#Header_137"
>To Remove Obsolete ACL Entries</A
></DT
><DT
><A
HREF="c2454.html#Header_138"
>Example: Removing an Obsolete ACL Entry</A
></DT
></DL
><BR></DD
><DT
><A
HREF="c2454.html#HDRWQ72"
>Changing a Group's Owner or Name</A
></DT
><DD
><DL
><DT
><A
HREF="c2454.html#HDRWQ73"
>To Change a Group's Owner</A
></DT
><DT
><A
HREF="c2454.html#Header_141"
>Example: Changing a Group's Owner to Another User</A
></DT
><DT
><A
HREF="c2454.html#Header_142"
>Example: Changing a Group's Owner to Itself</A
></DT
><DT
><A
HREF="c2454.html#Header_143"
>Example: Changing a Group's Owner to a Group</A
></DT
><DT
><A
HREF="c2454.html#Header_144"
>To Change a Group's Name</A
></DT
><DT
><A
HREF="c2454.html#Header_145"
>Example: Changing a Group's <VAR
CLASS="replaceable"
>group_name</VAR
> Suffix</A
></DT
><DT
><A
HREF="c2454.html#Header_146"
>Example: Changing a Group's <VAR
CLASS="replaceable"
>owner_name</VAR
> Prefix</A
></DT
></DL
><BR></DD
><DT
><A
HREF="c2454.html#HDRWQ74"
>Protecting Group-Related Information</A
></DT
><DD
><DL
><DT
><A
HREF="c2454.html#HDRPRIVACY-FLAGS"
>Interpreting the Privacy Flags</A
></DT
><DT
><A
HREF="c2454.html#HDRWQ75"
>To Set a Group's Privacy Flags</A
></DT
><DT
><A
HREF="c2454.html#Header_150"
>Example: Setting a Group's Privacy Flags</A
></DT
></DL
><BR></DD
></DL
><BR></DD
><DT
>6. <A
HREF="c3402.html"
>Troubleshooting</A
></DT
><DD
><DL
><DT
><A
HREF="c3402.html#HDRWQ77"
>Problem: Cannot Access, Copy, or Save File</A
></DT
><DT
><A
HREF="c3402.html#HDRWQ78"
>Problem: Accidentally Removed Your Entry from an ACL</A
></DT
><DT
><A
HREF="c3402.html#HDRWQ79"
>Error Message: "afs: Lost contact with fileserver"</A
></DT
><DT
><A
HREF="c3402.html#Header_155"
>Error Message: "<VAR
CLASS="replaceable"
>command</VAR
>: Connection timed out"</A
></DT
><DT
><A
HREF="c3402.html#Header_156"
>Error Message: "fs: You don't have the required access rights on '<VAR
CLASS="replaceable"
>file</VAR
>'"</A
></DT
><DT
><A
HREF="c3402.html#Header_157"
>Error Message: "afs: failed to store file"</A
></DT
></DL
><BR></DD
><DT
>A. <A
HREF="a3632.html"
>Using the NFS/AFS Translator</A
></DT
><DD
><DL
><DT
><A
HREF="a3632.html#HDRWQ81"
>Requirements for Using the NFS/AFS Translator</A
></DT
><DT
><A
HREF="a3632.html#Header_160"
>Accessing AFS via the Translator</A
></DT
><DD
><DL
><DT
><A
HREF="a3632.html#HDRWQ82"
>To Authenticate on a Supported Operating System</A
></DT
><DT
><A
HREF="a3632.html#HDRWQ83"
>To Authenticate on an Unsupported Operating System</A
></DT
></DL
><BR></DD
><DT
><A
HREF="a3632.html#HDRWQ84"
>Troubleshooting the NFS/AFS Translator</A
></DT
><DD
><DL
><DT
><A
HREF="a3632.html#HDRWQ85"
>Your NFS Client Machine is Frozen</A
></DT
><DT
><A
HREF="a3632.html#Header_165"
>NFS/AFS Translator Reboots</A
></DT
><DT
><A
HREF="a3632.html#Header_166"
>System Error Messages</A
></DT
></DL
><BR></DD
></DL
><BR></DD
><DT
>B. <A
HREF="a3812.html"
>AFS Command Syntax and Online Help</A
></DT
><DD
><DL
><DT
><A
HREF="a3812.html#HDRWQ87"
>AFS Command Syntax</A
></DT
><DD
><DL
><DT
><A
HREF="a3812.html#Header_169"
>Command Syntax Example</A
></DT
></DL
><BR></DD
><DT
><A
HREF="a3812.html#HDRWQ88"
>Rules for Using AFS Commands</A
></DT
><DD
><DL
><DT
><A
HREF="a3812.html#Header_171"
>Spaces and Lines</A
></DT
><DT
><A
HREF="a3812.html#Header_172"
>Abbreviations and Aliases for Operation Codes</A
></DT
><DT
><A
HREF="a3812.html#Header_173"
>Omitting Argument Switches</A
></DT
><DT
><A
HREF="a3812.html#Header_174"
>Shortening Switches and Flags</A
></DT
><DT
><A
HREF="a3812.html#Header_175"
>Shortening Directory References</A
></DT
></DL
><BR></DD
><DT
><A
HREF="a3812.html#Header_176"
>Commonly Used fs and pts Commands</A
></DT
><DD
><DL
><DT
><A
HREF="a3812.html#Header_177"
>About the fs Commands</A
></DT
><DT
><A
HREF="a3812.html#Header_178"
>About the pts Commands</A
></DT
></DL
><BR></DD
><DT
><A
HREF="a3812.html#HDRWQ89"
>Getting Help in AFS</A
></DT
><DD
><DL
><DT
><A
HREF="a3812.html#Header_180"
>Displaying Command Syntax and Aliases</A
></DT
><DT
><A
HREF="a3812.html#Header_181"
>Displaying Operation Code Descriptions</A
></DT
></DL
><BR></DD
></DL
><BR></DD
><DT
><A
HREF="g4153.html"
>Glossary</A
></DT
><DT
><A
HREF="i4608.html"
>Index</A
></DT
></DL
><BR></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>&nbsp;</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
>&nbsp;</TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="f24.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>&nbsp;</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
>&nbsp;</TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>About This Guide</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>