DEVEL15-remove-administration-reference-20080627
authorRuss Allbery <rra@stanford.edu>
Sat, 28 Jun 2008 07:38:00 +0000 (07:38 +0000)
committerRuss Allbery <rra@stanford.edu>
Sat, 28 Jun 2008 07:38:00 +0000 (07:38 +0000)
LICENSE IPL10

Purge the old AFS Administration Reference documentation.  This has now
been completely replaced by the manual pages.

(cherry picked from commit 62ffbc2a464521eeee4c244d2555c316dfae180f)

285 files changed:
doc/html/AdminReference/auarf000.htm [deleted file]
doc/html/AdminReference/auarf002.htm [deleted file]
doc/html/AdminReference/auarf003.htm [deleted file]
doc/html/AdminReference/auarf004.htm [deleted file]
doc/html/AdminReference/auarf005.htm [deleted file]
doc/html/AdminReference/auarf006.htm [deleted file]
doc/html/AdminReference/auarf007.htm [deleted file]
doc/html/AdminReference/auarf008.htm [deleted file]
doc/html/AdminReference/auarf009.htm [deleted file]
doc/html/AdminReference/auarf010.htm [deleted file]
doc/html/AdminReference/auarf011.htm [deleted file]
doc/html/AdminReference/auarf012.htm [deleted file]
doc/html/AdminReference/auarf013.htm [deleted file]
doc/html/AdminReference/auarf014.htm [deleted file]
doc/html/AdminReference/auarf015.htm [deleted file]
doc/html/AdminReference/auarf016.htm [deleted file]
doc/html/AdminReference/auarf017.htm [deleted file]
doc/html/AdminReference/auarf018.htm [deleted file]
doc/html/AdminReference/auarf019.htm [deleted file]
doc/html/AdminReference/auarf020.htm [deleted file]
doc/html/AdminReference/auarf021.htm [deleted file]
doc/html/AdminReference/auarf022.htm [deleted file]
doc/html/AdminReference/auarf023.htm [deleted file]
doc/html/AdminReference/auarf024.htm [deleted file]
doc/html/AdminReference/auarf025.htm [deleted file]
doc/html/AdminReference/auarf026.htm [deleted file]
doc/html/AdminReference/auarf027.htm [deleted file]
doc/html/AdminReference/auarf028.htm [deleted file]
doc/html/AdminReference/auarf029.htm [deleted file]
doc/html/AdminReference/auarf030.htm [deleted file]
doc/html/AdminReference/auarf031.htm [deleted file]
doc/html/AdminReference/auarf032.htm [deleted file]
doc/html/AdminReference/auarf033.htm [deleted file]
doc/html/AdminReference/auarf034.htm [deleted file]
doc/html/AdminReference/auarf035.htm [deleted file]
doc/html/AdminReference/auarf036.htm [deleted file]
doc/html/AdminReference/auarf037.htm [deleted file]
doc/html/AdminReference/auarf038.htm [deleted file]
doc/html/AdminReference/auarf039.htm [deleted file]
doc/html/AdminReference/auarf040.htm [deleted file]
doc/html/AdminReference/auarf041.htm [deleted file]
doc/html/AdminReference/auarf042.htm [deleted file]
doc/html/AdminReference/auarf043.htm [deleted file]
doc/html/AdminReference/auarf044.htm [deleted file]
doc/html/AdminReference/auarf045.htm [deleted file]
doc/html/AdminReference/auarf046.htm [deleted file]
doc/html/AdminReference/auarf047.htm [deleted file]
doc/html/AdminReference/auarf048.htm [deleted file]
doc/html/AdminReference/auarf049.htm [deleted file]
doc/html/AdminReference/auarf050.htm [deleted file]
doc/html/AdminReference/auarf051.htm [deleted file]
doc/html/AdminReference/auarf052.htm [deleted file]
doc/html/AdminReference/auarf053.htm [deleted file]
doc/html/AdminReference/auarf054.htm [deleted file]
doc/html/AdminReference/auarf055.htm [deleted file]
doc/html/AdminReference/auarf056.htm [deleted file]
doc/html/AdminReference/auarf057.htm [deleted file]
doc/html/AdminReference/auarf058.htm [deleted file]
doc/html/AdminReference/auarf059.htm [deleted file]
doc/html/AdminReference/auarf060.htm [deleted file]
doc/html/AdminReference/auarf061.htm [deleted file]
doc/html/AdminReference/auarf062.htm [deleted file]
doc/html/AdminReference/auarf063.htm [deleted file]
doc/html/AdminReference/auarf064.htm [deleted file]
doc/html/AdminReference/auarf065.htm [deleted file]
doc/html/AdminReference/auarf066.htm [deleted file]
doc/html/AdminReference/auarf067.htm [deleted file]
doc/html/AdminReference/auarf068.htm [deleted file]
doc/html/AdminReference/auarf069.htm [deleted file]
doc/html/AdminReference/auarf070.htm [deleted file]
doc/html/AdminReference/auarf071.htm [deleted file]
doc/html/AdminReference/auarf072.htm [deleted file]
doc/html/AdminReference/auarf073.htm [deleted file]
doc/html/AdminReference/auarf074.htm [deleted file]
doc/html/AdminReference/auarf075.htm [deleted file]
doc/html/AdminReference/auarf076.htm [deleted file]
doc/html/AdminReference/auarf077.htm [deleted file]
doc/html/AdminReference/auarf078.htm [deleted file]
doc/html/AdminReference/auarf079.htm [deleted file]
doc/html/AdminReference/auarf080.htm [deleted file]
doc/html/AdminReference/auarf081.htm [deleted file]
doc/html/AdminReference/auarf082.htm [deleted file]
doc/html/AdminReference/auarf083.htm [deleted file]
doc/html/AdminReference/auarf084.htm [deleted file]
doc/html/AdminReference/auarf085.htm [deleted file]
doc/html/AdminReference/auarf086.htm [deleted file]
doc/html/AdminReference/auarf087.htm [deleted file]
doc/html/AdminReference/auarf088.htm [deleted file]
doc/html/AdminReference/auarf089.htm [deleted file]
doc/html/AdminReference/auarf090.htm [deleted file]
doc/html/AdminReference/auarf091.htm [deleted file]
doc/html/AdminReference/auarf092.htm [deleted file]
doc/html/AdminReference/auarf093.htm [deleted file]
doc/html/AdminReference/auarf094.htm [deleted file]
doc/html/AdminReference/auarf095.htm [deleted file]
doc/html/AdminReference/auarf096.htm [deleted file]
doc/html/AdminReference/auarf097.htm [deleted file]
doc/html/AdminReference/auarf098.htm [deleted file]
doc/html/AdminReference/auarf099.htm [deleted file]
doc/html/AdminReference/auarf100.htm [deleted file]
doc/html/AdminReference/auarf101.htm [deleted file]
doc/html/AdminReference/auarf102.htm [deleted file]
doc/html/AdminReference/auarf103.htm [deleted file]
doc/html/AdminReference/auarf104.htm [deleted file]
doc/html/AdminReference/auarf105.htm [deleted file]
doc/html/AdminReference/auarf106.htm [deleted file]
doc/html/AdminReference/auarf107.htm [deleted file]
doc/html/AdminReference/auarf108.htm [deleted file]
doc/html/AdminReference/auarf109.htm [deleted file]
doc/html/AdminReference/auarf110.htm [deleted file]
doc/html/AdminReference/auarf111.htm [deleted file]
doc/html/AdminReference/auarf112.htm [deleted file]
doc/html/AdminReference/auarf113.htm [deleted file]
doc/html/AdminReference/auarf114.htm [deleted file]
doc/html/AdminReference/auarf115.htm [deleted file]
doc/html/AdminReference/auarf116.htm [deleted file]
doc/html/AdminReference/auarf117.htm [deleted file]
doc/html/AdminReference/auarf118.htm [deleted file]
doc/html/AdminReference/auarf119.htm [deleted file]
doc/html/AdminReference/auarf120.htm [deleted file]
doc/html/AdminReference/auarf121.htm [deleted file]
doc/html/AdminReference/auarf122.htm [deleted file]
doc/html/AdminReference/auarf123.htm [deleted file]
doc/html/AdminReference/auarf124.htm [deleted file]
doc/html/AdminReference/auarf125.htm [deleted file]
doc/html/AdminReference/auarf126.htm [deleted file]
doc/html/AdminReference/auarf127.htm [deleted file]
doc/html/AdminReference/auarf128.htm [deleted file]
doc/html/AdminReference/auarf129.htm [deleted file]
doc/html/AdminReference/auarf130.htm [deleted file]
doc/html/AdminReference/auarf131.htm [deleted file]
doc/html/AdminReference/auarf132.htm [deleted file]
doc/html/AdminReference/auarf133.htm [deleted file]
doc/html/AdminReference/auarf134.htm [deleted file]
doc/html/AdminReference/auarf135.htm [deleted file]
doc/html/AdminReference/auarf136.htm [deleted file]
doc/html/AdminReference/auarf137.htm [deleted file]
doc/html/AdminReference/auarf138.htm [deleted file]
doc/html/AdminReference/auarf139.htm [deleted file]
doc/html/AdminReference/auarf140.htm [deleted file]
doc/html/AdminReference/auarf141.htm [deleted file]
doc/html/AdminReference/auarf142.htm [deleted file]
doc/html/AdminReference/auarf143.htm [deleted file]
doc/html/AdminReference/auarf144.htm [deleted file]
doc/html/AdminReference/auarf145.htm [deleted file]
doc/html/AdminReference/auarf146.htm [deleted file]
doc/html/AdminReference/auarf147.htm [deleted file]
doc/html/AdminReference/auarf148.htm [deleted file]
doc/html/AdminReference/auarf149.htm [deleted file]
doc/html/AdminReference/auarf150.htm [deleted file]
doc/html/AdminReference/auarf151.htm [deleted file]
doc/html/AdminReference/auarf152.htm [deleted file]
doc/html/AdminReference/auarf153.htm [deleted file]
doc/html/AdminReference/auarf154.htm [deleted file]
doc/html/AdminReference/auarf155.htm [deleted file]
doc/html/AdminReference/auarf156.htm [deleted file]
doc/html/AdminReference/auarf157.htm [deleted file]
doc/html/AdminReference/auarf158.htm [deleted file]
doc/html/AdminReference/auarf159.htm [deleted file]
doc/html/AdminReference/auarf160.htm [deleted file]
doc/html/AdminReference/auarf161.htm [deleted file]
doc/html/AdminReference/auarf162.htm [deleted file]
doc/html/AdminReference/auarf163.htm [deleted file]
doc/html/AdminReference/auarf164.htm [deleted file]
doc/html/AdminReference/auarf165.htm [deleted file]
doc/html/AdminReference/auarf166.htm [deleted file]
doc/html/AdminReference/auarf167.htm [deleted file]
doc/html/AdminReference/auarf168.htm [deleted file]
doc/html/AdminReference/auarf169.htm [deleted file]
doc/html/AdminReference/auarf170.htm [deleted file]
doc/html/AdminReference/auarf171.htm [deleted file]
doc/html/AdminReference/auarf172.htm [deleted file]
doc/html/AdminReference/auarf173.htm [deleted file]
doc/html/AdminReference/auarf174.htm [deleted file]
doc/html/AdminReference/auarf175.htm [deleted file]
doc/html/AdminReference/auarf176.htm [deleted file]
doc/html/AdminReference/auarf177.htm [deleted file]
doc/html/AdminReference/auarf178.htm [deleted file]
doc/html/AdminReference/auarf179.htm [deleted file]
doc/html/AdminReference/auarf180.htm [deleted file]
doc/html/AdminReference/auarf181.htm [deleted file]
doc/html/AdminReference/auarf182.htm [deleted file]
doc/html/AdminReference/auarf183.htm [deleted file]
doc/html/AdminReference/auarf184.htm [deleted file]
doc/html/AdminReference/auarf185.htm [deleted file]
doc/html/AdminReference/auarf186.htm [deleted file]
doc/html/AdminReference/auarf187.htm [deleted file]
doc/html/AdminReference/auarf188.htm [deleted file]
doc/html/AdminReference/auarf189.htm [deleted file]
doc/html/AdminReference/auarf190.htm [deleted file]
doc/html/AdminReference/auarf191.htm [deleted file]
doc/html/AdminReference/auarf192.htm [deleted file]
doc/html/AdminReference/auarf193.htm [deleted file]
doc/html/AdminReference/auarf194.htm [deleted file]
doc/html/AdminReference/auarf195.htm [deleted file]
doc/html/AdminReference/auarf196.htm [deleted file]
doc/html/AdminReference/auarf197.htm [deleted file]
doc/html/AdminReference/auarf198.htm [deleted file]
doc/html/AdminReference/auarf199.htm [deleted file]
doc/html/AdminReference/auarf200.htm [deleted file]
doc/html/AdminReference/auarf201.htm [deleted file]
doc/html/AdminReference/auarf202.htm [deleted file]
doc/html/AdminReference/auarf203.htm [deleted file]
doc/html/AdminReference/auarf204.htm [deleted file]
doc/html/AdminReference/auarf205.htm [deleted file]
doc/html/AdminReference/auarf206.htm [deleted file]
doc/html/AdminReference/auarf207.htm [deleted file]
doc/html/AdminReference/auarf208.htm [deleted file]
doc/html/AdminReference/auarf209.htm [deleted file]
doc/html/AdminReference/auarf210.htm [deleted file]
doc/html/AdminReference/auarf211.htm [deleted file]
doc/html/AdminReference/auarf212.htm [deleted file]
doc/html/AdminReference/auarf213.htm [deleted file]
doc/html/AdminReference/auarf214.htm [deleted file]
doc/html/AdminReference/auarf215.htm [deleted file]
doc/html/AdminReference/auarf216.htm [deleted file]
doc/html/AdminReference/auarf217.htm [deleted file]
doc/html/AdminReference/auarf218.htm [deleted file]
doc/html/AdminReference/auarf219.htm [deleted file]
doc/html/AdminReference/auarf220.htm [deleted file]
doc/html/AdminReference/auarf221.htm [deleted file]
doc/html/AdminReference/auarf222.htm [deleted file]
doc/html/AdminReference/auarf223.htm [deleted file]
doc/html/AdminReference/auarf224.htm [deleted file]
doc/html/AdminReference/auarf225.htm [deleted file]
doc/html/AdminReference/auarf226.htm [deleted file]
doc/html/AdminReference/auarf227.htm [deleted file]
doc/html/AdminReference/auarf228.htm [deleted file]
doc/html/AdminReference/auarf229.htm [deleted file]
doc/html/AdminReference/auarf230.htm [deleted file]
doc/html/AdminReference/auarf231.htm [deleted file]
doc/html/AdminReference/auarf232.htm [deleted file]
doc/html/AdminReference/auarf233.htm [deleted file]
doc/html/AdminReference/auarf234.htm [deleted file]
doc/html/AdminReference/auarf235.htm [deleted file]
doc/html/AdminReference/auarf236.htm [deleted file]
doc/html/AdminReference/auarf237.htm [deleted file]
doc/html/AdminReference/auarf238.htm [deleted file]
doc/html/AdminReference/auarf239.htm [deleted file]
doc/html/AdminReference/auarf240.htm [deleted file]
doc/html/AdminReference/auarf241.htm [deleted file]
doc/html/AdminReference/auarf242.htm [deleted file]
doc/html/AdminReference/auarf243.htm [deleted file]
doc/html/AdminReference/auarf244.htm [deleted file]
doc/html/AdminReference/auarf245.htm [deleted file]
doc/html/AdminReference/auarf246.htm [deleted file]
doc/html/AdminReference/auarf247.htm [deleted file]
doc/html/AdminReference/auarf248.htm [deleted file]
doc/html/AdminReference/auarf249.htm [deleted file]
doc/html/AdminReference/auarf250.htm [deleted file]
doc/html/AdminReference/auarf251.htm [deleted file]
doc/html/AdminReference/auarf252.htm [deleted file]
doc/html/AdminReference/auarf253.htm [deleted file]
doc/html/AdminReference/auarf254.htm [deleted file]
doc/html/AdminReference/auarf255.htm [deleted file]
doc/html/AdminReference/auarf256.htm [deleted file]
doc/html/AdminReference/auarf257.htm [deleted file]
doc/html/AdminReference/auarf258.htm [deleted file]
doc/html/AdminReference/auarf259.htm [deleted file]
doc/html/AdminReference/auarf260.htm [deleted file]
doc/html/AdminReference/auarf261.htm [deleted file]
doc/html/AdminReference/auarf262.htm [deleted file]
doc/html/AdminReference/auarf263.htm [deleted file]
doc/html/AdminReference/auarf264.htm [deleted file]
doc/html/AdminReference/auarf265.htm [deleted file]
doc/html/AdminReference/auarf266.htm [deleted file]
doc/html/AdminReference/auarf267.htm [deleted file]
doc/html/AdminReference/auarf268.htm [deleted file]
doc/html/AdminReference/auarf269.htm [deleted file]
doc/html/AdminReference/auarf270.htm [deleted file]
doc/html/AdminReference/auarf271.htm [deleted file]
doc/html/AdminReference/auarf272.htm [deleted file]
doc/html/AdminReference/auarf273.htm [deleted file]
doc/html/AdminReference/auarf274.htm [deleted file]
doc/html/AdminReference/auarf275.htm [deleted file]
doc/html/AdminReference/auarf276.htm [deleted file]
doc/html/AdminReference/auarf277.htm [deleted file]
doc/html/AdminReference/auarf278.htm [deleted file]
doc/html/AdminReference/auarf279.htm [deleted file]
doc/html/AdminReference/auarf280.htm [deleted file]
doc/html/AdminReference/auarf281.htm [deleted file]
doc/html/AdminReference/auarf282.htm [deleted file]
doc/html/AdminReference/auarf283.htm [deleted file]
doc/html/AdminReference/auarf284.htm [deleted file]
doc/html/index.htm

diff --git a/doc/html/AdminReference/auarf000.htm b/doc/html/AdminReference/auarf000.htm
deleted file mode 100644 (file)
index 91e952f..0000000
+++ /dev/null
@@ -1,48 +0,0 @@
-<!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="[Table of Contents]"></A> <A HREF="#Bot_Of_Page"><IMG SRC="../bot.gif" BORDER="0" ALT="[Bottom of Topic]"></A> <A HREF="auarf002.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><HR> 
-AFS<BR>
-Administration Reference<BR>
-<P>Version 3.6 
-<P>Document Number GC09-4562-00
-<P>
-<BR>
-<P><B>First Edition (April 2000)</B>
-<P>This edition applies to:
-<DL COMPACT>
-<DD>IBM AFS for AIX, Version 3.6
-<DD>IBM AFS for Digital Unix, Version 3.6
-<DD>IBM AFS for HP-UX, Version 3.6
-<DD>IBM AFS for Linux, Version 3.6
-<DD>IBM AFS for SGI IRIX, Version 3.6
-<DD>IBM AFS for Solaris, Version 3.6
-</DL>
-<P>and to all subsequent releases and modifications until otherwise indicated
-in new editions.
-<P>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>Order publications through your IBM representative or through the IBM
-branch office serving your locality.
-<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="[Table of Contents]"></A> <A HREF="#Top_Of_Page"><IMG SRC="../top.gif" BORDER="0" ALT="[Top of Topic]"></A> <A HREF="auarf002.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>
diff --git a/doc/html/AdminReference/auarf002.htm b/doc/html/AdminReference/auarf002.htm
deleted file mode 100644 (file)
index 82f7c3c..0000000
+++ /dev/null
@@ -1,314 +0,0 @@
-<!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="#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf000.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="auarf003.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> 
-<H2><A NAME="ToC">Table of Contents</A></H2>
-<P><B><A NAME="ToC_1" HREF="auarf003.htm#HDRTLIST_START">Tables</A></B><BR>
-<P><B><A NAME="ToC_2" HREF="auarf004.htm#Header_2">About This Manual</A></B><BR>
-<MENU>
-<LI><A NAME="ToC_3" HREF="auarf005.htm#HDRWQ1">Audience and Purpose</A>
-<LI><A NAME="ToC_4" HREF="auarf006.htm#HDRWQ2">Organization</A>
-<LI><A NAME="ToC_5" HREF="auarf007.htm#HDRWQ3">How to Use This Document</A>
-<LI><A NAME="ToC_6" HREF="auarf008.htm#HDRWQ4">Related Documents</A>
-<LI><A NAME="ToC_7" HREF="auarf009.htm#HDRTYPO_CONV">Typographical Conventions</A>
-</MENU>
-<P><B><A NAME="ToC_8" HREF="auarf010.htm#Header_8">AFS System Files</A></B><BR>
-<MENU>
-<LI><A NAME="ToC_9" HREF="auarf011.htm#HDRFILESINTRO">afs_file_intro</A>
-<LI><A NAME="ToC_10" HREF="auarf012.htm#HDRAUTHLOG">AuthLog</A>
-<LI><A NAME="ToC_11" HREF="auarf013.htm#HDRWQ5">AuthLog.dir, AuthLog.pag</A>
-<LI><A NAME="ToC_12" HREF="auarf014.htm#HDRBACKUPLOG">BackupLog</A>
-<LI><A NAME="ToC_13" HREF="auarf015.htm#HDRBOSLOG">BosLog</A>
-<LI><A NAME="ToC_14" HREF="auarf016.htm#HDRBOSCONFIG">BosConfig</A>
-<LI><A NAME="ToC_15" HREF="auarf017.htm#HDRCACHEITEMS">CacheItems</A>
-<LI><A NAME="ToC_16" HREF="auarf018.htm#HDRCFG">CFG_<I>device_name</I></A>
-<LI><A NAME="ToC_17" HREF="auarf019.htm#HDRCLI_CSDB">CellServDB (client version)</A>
-<LI><A NAME="ToC_18" HREF="auarf020.htm#HDRSV_CSDB">CellServDB (server version)</A>
-<LI><A NAME="ToC_19" HREF="auarf021.htm#HDRFILELOG">FileLog</A>
-<LI><A NAME="ToC_20" HREF="auarf022.htm#HDRFORCESALVAGE">FORCESALVAGE</A>
-<LI><A NAME="ToC_21" HREF="auarf023.htm#HDRKEYFILE">KeyFile</A>
-<LI><A NAME="ToC_22" HREF="auarf024.htm#HDRCLI_NETINFO">NetInfo (client version)</A>
-<LI><A NAME="ToC_23" HREF="auarf025.htm#HDRSV_NETINFO">NetInfo (server version)</A>
-<LI><A NAME="ToC_24" HREF="auarf026.htm#HDRCLI_NETRESTRICT">NetRestrict (client version)</A>
-<LI><A NAME="ToC_25" HREF="auarf027.htm#HDRSV_NETRESTRICT">NetRestrict (server version)</A>
-<LI><A NAME="ToC_26" HREF="auarf028.htm#HDRNOAUTH">NoAuth</A>
-<LI><A NAME="ToC_27" HREF="auarf029.htm#HDRSALVAGEFS">SALVAGE.fs</A>
-<LI><A NAME="ToC_28" HREF="auarf030.htm#HDRSALVAGELOG">SalvageLog</A>
-<LI><A NAME="ToC_29" HREF="auarf031.htm#HDRTE">TE_<I>device_name</I></A>
-<LI><A NAME="ToC_30" HREF="auarf032.htm#HDRCLI_THISCELL">ThisCell (client version)</A>
-<LI><A NAME="ToC_31" HREF="auarf033.htm#HDRSV_THISCELL">ThisCell (server version)</A>
-<LI><A NAME="ToC_32" HREF="auarf034.htm#HDRTL">TL_<I>device_name</I></A>
-<LI><A NAME="ToC_33" HREF="auarf035.htm#HDRUSERLIST">UserList</A>
-<LI><A NAME="ToC_34" HREF="auarf036.htm#HDRVN">V<I>n</I></A>
-<LI><A NAME="ToC_35" HREF="auarf037.htm#HDRVVOLID">V<I>vol_ID</I>.vol</A>
-<LI><A NAME="ToC_36" HREF="auarf038.htm#HDRVLLOG">VLLog</A>
-<LI><A NAME="ToC_37" HREF="auarf039.htm#HDRVOLSERLOG">VolserLog</A>
-<LI><A NAME="ToC_38" HREF="auarf040.htm#HDRVOLUMEITEMS">VolumeItems</A>
-<LI><A NAME="ToC_39" HREF="auarf041.htm#HDRAFSZCM">afszcm.cat</A>
-<LI><A NAME="ToC_40" HREF="auarf042.htm#HDRBDBDB">bdb.DB0 and bdb.DBSYS1</A>
-<LI><A NAME="ToC_41" HREF="auarf043.htm#HDRCACHEINFO">cacheinfo</A>
-<LI><A NAME="ToC_42" HREF="auarf044.htm#HDRFMSLOG">fms.log</A>
-<LI><A NAME="ToC_43" HREF="auarf045.htm#HDRKASERVERDB">kaserver.DB0 and kaserver.DBSYS1</A>
-<LI><A NAME="ToC_44" HREF="auarf046.htm#HDRKASERVERAUXDB">kaserverauxdb</A>
-<LI><A NAME="ToC_45" HREF="auarf047.htm#HDRPRDBDB">prdb.DB0 and prdb.DBSYS1</A>
-<LI><A NAME="ToC_46" HREF="auarf048.htm#HDRSALVAGELOCK">salvage.lock</A>
-<LI><A NAME="ToC_47" HREF="auarf049.htm#HDRSYSID">sysid</A>
-<LI><A NAME="ToC_48" HREF="auarf050.htm#HDRTAPECONFIG">tapeconfig</A>
-<LI><A NAME="ToC_49" HREF="auarf051.htm#HDRVLDBDB">vldb.DB0 and vldb.DBSYS1</A>
-<LI><A NAME="ToC_50" HREF="auarf052.htm#HDRAFSMONCONFIG">afsmonitor Configuration File</A>
-<LI><A NAME="ToC_51" HREF="auarf053.htm#HDRPACKAGECONFIG">package Configuration File</A>
-<LI><A NAME="ToC_52" HREF="auarf054.htm#HDRUSSBULKINPUT">uss Bulk Input File</A>
-<LI><A NAME="ToC_53" HREF="auarf055.htm#HDRUSSFILE">uss Template File</A>
-</MENU>
-<P><B><A NAME="ToC_54" HREF="auarf056.htm#Header_54">AFS System Commands</A></B><BR>
-<MENU>
-<LI><A NAME="ToC_55" HREF="auarf057.htm#HDRAFSINTRO">afs_intro</A>
-<LI><A NAME="ToC_72" HREF="auarf058.htm#HDRAFSD">afsd</A>
-<LI><A NAME="ToC_73" HREF="auarf059.htm#HDRAFSMONITOR">afsmonitor</A>
-<LI><A NAME="ToC_74" HREF="auarf060.htm#HDRBK_INTRO">backup</A>
-<LI><A NAME="ToC_75" HREF="auarf061.htm#HDRBK_ADDDUMP">backup adddump</A>
-<LI><A NAME="ToC_76" HREF="auarf062.htm#HDRBK_ADDHOST">backup addhost</A>
-<LI><A NAME="ToC_77" HREF="auarf063.htm#HDRBK_ADDVOLENTRY">backup addvolentry</A>
-<LI><A NAME="ToC_78" HREF="auarf064.htm#HDRBK_ADDVOLSET">backup addvolset</A>
-<LI><A NAME="ToC_79" HREF="auarf065.htm#HDRBK_APROPOS">backup apropos</A>
-<LI><A NAME="ToC_80" HREF="auarf066.htm#HDRBK_DBVERIFY">backup dbverify</A>
-<LI><A NAME="ToC_81" HREF="auarf067.htm#HDRBK_DELDUMP">backup deldump</A>
-<LI><A NAME="ToC_82" HREF="auarf068.htm#HDRBK_DELETEDUMP">backup deletedump</A>
-<LI><A NAME="ToC_83" HREF="auarf069.htm#HDRBK_DELHOST">backup delhost</A>
-<LI><A NAME="ToC_84" HREF="auarf070.htm#HDRBK_DELVOLENTRY">backup delvolentry</A>
-<LI><A NAME="ToC_85" HREF="auarf071.htm#HDRBK_DELVOLSET">backup delvolset</A>
-<LI><A NAME="ToC_86" HREF="auarf072.htm#HDRBK_DISKRESTORE">backup diskrestore</A>
-<LI><A NAME="ToC_87" HREF="auarf073.htm#HDRBK_DUMP">backup dump</A>
-<LI><A NAME="ToC_88" HREF="auarf074.htm#HDRBK_DUMPINFO">backup dumpinfo</A>
-<LI><A NAME="ToC_89" HREF="auarf075.htm#HDRBK_HELP">backup help</A>
-<LI><A NAME="ToC_90" HREF="auarf076.htm#HDRBK_INTERACTIVE">backup interactive</A>
-<LI><A NAME="ToC_91" HREF="auarf077.htm#HDRBK_JOBS">backup jobs</A>
-<LI><A NAME="ToC_92" HREF="auarf078.htm#HDRBK_KILL">backup kill</A>
-<LI><A NAME="ToC_93" HREF="auarf079.htm#HDRBK_LABELTAPE">backup labeltape</A>
-<LI><A NAME="ToC_94" HREF="auarf080.htm#HDRBK_LISTDUMPS">backup listdumps</A>
-<LI><A NAME="ToC_95" HREF="auarf081.htm#HDRBK_LISTHOSTS">backup listhosts</A>
-<LI><A NAME="ToC_96" HREF="auarf082.htm#HDRBK_LISTVOLSETS">backup listvolsets</A>
-<LI><A NAME="ToC_97" HREF="auarf083.htm#HDRBK_QUIT">backup quit</A>
-<LI><A NAME="ToC_98" HREF="auarf084.htm#HDRBK_READLABEL">backup readlabel</A>
-<LI><A NAME="ToC_99" HREF="auarf085.htm#HDRBK_RESTOREDB">backup restoredb</A>
-<LI><A NAME="ToC_100" HREF="auarf086.htm#HDRBK_SAVEDB">backup savedb</A>
-<LI><A NAME="ToC_101" HREF="auarf087.htm#HDRBK_SCANTAPE">backup scantape</A>
-<LI><A NAME="ToC_102" HREF="auarf088.htm#HDRBK_SETEXP">backup setexp</A>
-<LI><A NAME="ToC_103" HREF="auarf089.htm#HDRBK_STATUS">backup status</A>
-<LI><A NAME="ToC_104" HREF="auarf090.htm#HDRBK_VOLINFO">backup volinfo</A>
-<LI><A NAME="ToC_105" HREF="auarf091.htm#HDRBK_VOLRESTORE">backup volrestore</A>
-<LI><A NAME="ToC_106" HREF="auarf092.htm#HDRBK_VOLSETRESTORE">backup volsetrestore</A>
-<LI><A NAME="ToC_107" HREF="auarf093.htm#HDRBOS_INTRO">bos</A>
-<LI><A NAME="ToC_108" HREF="auarf094.htm#HDRBOS_ADDHOST">bos addhost</A>
-<LI><A NAME="ToC_109" HREF="auarf095.htm#HDRBOS_ADDKEY">bos addkey</A>
-<LI><A NAME="ToC_110" HREF="auarf096.htm#HDRBOS_ADDUSER">bos adduser</A>
-<LI><A NAME="ToC_111" HREF="auarf097.htm#HDRBOS_APROPOS">bos apropos</A>
-<LI><A NAME="ToC_112" HREF="auarf098.htm#HDRBOS_CREATE">bos create</A>
-<LI><A NAME="ToC_113" HREF="auarf099.htm#HDRBOS_DELETE">bos delete</A>
-<LI><A NAME="ToC_114" HREF="auarf100.htm#HDRBOS_EXEC">bos exec</A>
-<LI><A NAME="ToC_115" HREF="auarf101.htm#HDRBOS_GETDATE">bos getdate</A>
-<LI><A NAME="ToC_116" HREF="auarf102.htm#HDRBOS_GETLOG">bos getlog</A>
-<LI><A NAME="ToC_117" HREF="auarf103.htm#HDRBOS_GETRESTART">bos getrestart</A>
-<LI><A NAME="ToC_118" HREF="auarf104.htm#HDRBOS_HELP">bos help</A>
-<LI><A NAME="ToC_119" HREF="auarf105.htm#HDRBOS_INSTALL">bos install</A>
-<LI><A NAME="ToC_120" HREF="auarf106.htm#HDRBOS_LISTHOSTS">bos listhosts</A>
-<LI><A NAME="ToC_121" HREF="auarf107.htm#HDRBOS_LISTKEYS">bos listkeys</A>
-<LI><A NAME="ToC_122" HREF="auarf108.htm#HDRBOS_LISTUSERS">bos listusers</A>
-<LI><A NAME="ToC_123" HREF="auarf109.htm#HDRBOS_PRUNE">bos prune</A>
-<LI><A NAME="ToC_124" HREF="auarf110.htm#HDRBOS_REMOVEHOST">bos removehost</A>
-<LI><A NAME="ToC_125" HREF="auarf111.htm#HDRBOS_REMOVEKEY">bos removekey</A>
-<LI><A NAME="ToC_126" HREF="auarf112.htm#HDRBOS_REMOVEUSER">bos removeuser</A>
-<LI><A NAME="ToC_127" HREF="auarf113.htm#HDRBOS_RESTART">bos restart</A>
-<LI><A NAME="ToC_128" HREF="auarf114.htm#HDRBOS_SALVAGE">bos salvage</A>
-<LI><A NAME="ToC_129" HREF="auarf115.htm#HDRBOS_SETAUTH">bos setauth</A>
-<LI><A NAME="ToC_130" HREF="auarf116.htm#HDRBOS_SETCELLNAME">bos setcellname</A>
-<LI><A NAME="ToC_131" HREF="auarf117.htm#HDRBOS_SETRESTART">bos setrestart</A>
-<LI><A NAME="ToC_132" HREF="auarf118.htm#HDRBOS_SHUTDOWN">bos shutdown</A>
-<LI><A NAME="ToC_133" HREF="auarf119.htm#HDRBOS_START">bos start</A>
-<LI><A NAME="ToC_134" HREF="auarf120.htm#HDRBOS_STARTUP">bos startup</A>
-<LI><A NAME="ToC_135" HREF="auarf121.htm#HDRBOS_STATUS">bos status</A>
-<LI><A NAME="ToC_136" HREF="auarf122.htm#HDRBOS_STOP">bos stop</A>
-<LI><A NAME="ToC_137" HREF="auarf123.htm#HDRBOS_UNINSTALL">bos uninstall</A>
-<LI><A NAME="ToC_138" HREF="auarf124.htm#HDRBOSSERVER">bosserver</A>
-<LI><A NAME="ToC_139" HREF="auarf125.htm#HDRBUSERVER">buserver</A>
-<LI><A NAME="ToC_140" HREF="auarf126.htm#HDRBUTC">butc</A>
-<LI><A NAME="ToC_141" HREF="auarf127.htm#HDRDLOG">dlog</A>
-<LI><A NAME="ToC_142" HREF="auarf128.htm#HDRDPASS">dpass</A>
-<LI><A NAME="ToC_143" HREF="auarf129.htm#HDRFILESERVER">fileserver</A>
-<LI><A NAME="ToC_144" HREF="auarf130.htm#HDRFMS">fms</A>
-<LI><A NAME="ToC_145" HREF="auarf131.htm#HDRFS_INTRO">fs</A>
-<LI><A NAME="ToC_146" HREF="auarf132.htm#HDRFS_APROPOS">fs apropos</A>
-<LI><A NAME="ToC_147" HREF="auarf133.htm#HDRFS_CHECKSERVERS">fs checkservers</A>
-<LI><A NAME="ToC_148" HREF="auarf134.htm#HDRFS_CHECKVOLUMES">fs checkvolumes</A>
-<LI><A NAME="ToC_149" HREF="auarf135.htm#HDRFS_CLEANACL">fs cleanacl</A>
-<LI><A NAME="ToC_150" HREF="auarf136.htm#HDRFS_COPYACL">fs copyacl</A>
-<LI><A NAME="ToC_151" HREF="auarf137.htm#HDRFS_DISKFREE">fs diskfree</A>
-<LI><A NAME="ToC_152" HREF="auarf138.htm#HDRFS_EXAMINE">fs examine</A>
-<LI><A NAME="ToC_153" HREF="auarf139.htm#HDRFS_EXPORTAFS">fs exportafs</A>
-<LI><A NAME="ToC_154" HREF="auarf140.htm#HDRFS_FLUSH">fs flush</A>
-<LI><A NAME="ToC_155" HREF="auarf141.htm#HDRFS_FLUSHMOUNT">fs flushmount</A>
-<LI><A NAME="ToC_156" HREF="auarf142.htm#HDRFS_FLUSHVOLUME">fs flushvolume</A>
-<LI><A NAME="ToC_157" HREF="auarf143.htm#HDRFS_GETCACHEPARMS">fs getcacheparms</A>
-<LI><A NAME="ToC_158" HREF="auarf144.htm#HDRFS_GETCELLSTATUS">fs getcellstatus</A>
-<LI><A NAME="ToC_159" HREF="auarf145.htm#HDRFS_GETCLIENTADDRS">fs getclientaddrs</A>
-<LI><A NAME="ToC_160" HREF="auarf146.htm#HDRFS_GETSERVERPREFS">fs getserverprefs</A>
-<LI><A NAME="ToC_161" HREF="auarf147.htm#HDRFS_HELP">fs help</A>
-<LI><A NAME="ToC_162" HREF="auarf148.htm#HDRFS_LISTACL">fs listacl</A>
-<LI><A NAME="ToC_163" HREF="auarf149.htm#HDRFS_LISTCELLS">fs listcells</A>
-<LI><A NAME="ToC_164" HREF="auarf150.htm#HDRFS_LISTQUOTA">fs listquota</A>
-<LI><A NAME="ToC_165" HREF="auarf151.htm#HDRFS_LSMOUNT">fs lsmount</A>
-<LI><A NAME="ToC_166" HREF="auarf152.htm#HDRFS_MESSAGES">fs messages</A>
-<LI><A NAME="ToC_167" HREF="auarf153.htm#HDRFS_MKMOUNT">fs mkmount</A>
-<LI><A NAME="ToC_168" HREF="auarf154.htm#HDRFS_NEWCELL">fs newcell</A>
-<LI><A NAME="ToC_169" HREF="auarf155.htm#HDRFS_QUOTA">fs quota</A>
-<LI><A NAME="ToC_170" HREF="auarf156.htm#HDRFS_RMMOUNT">fs rmmount</A>
-<LI><A NAME="ToC_171" HREF="auarf157.htm#HDRFS_SETACL">fs setacl</A>
-<LI><A NAME="ToC_172" HREF="auarf158.htm#HDRFS_SETCACHESIZE">fs setcachesize</A>
-<LI><A NAME="ToC_173" HREF="auarf159.htm#HDRFS_SETCELL">fs setcell</A>
-<LI><A NAME="ToC_174" HREF="auarf160.htm#HDRFS_SETCLIENTADDRS">fs setclientaddrs</A>
-<LI><A NAME="ToC_175" HREF="auarf161.htm#HDRFS_SETQUOTA">fs setquota</A>
-<LI><A NAME="ToC_176" HREF="auarf162.htm#HDRFS_SETSERVERPREFS">fs setserverprefs</A>
-<LI><A NAME="ToC_177" HREF="auarf163.htm#HDRFS_SETVOL">fs setvol</A>
-<LI><A NAME="ToC_178" HREF="auarf164.htm#HDRFS_STOREBEHIND">fs storebehind</A>
-<LI><A NAME="ToC_179" HREF="auarf165.htm#HDRFS_SYSNAME">fs sysname</A>
-<LI><A NAME="ToC_180" HREF="auarf166.htm#HDRFS_WHEREIS">fs whereis</A>
-<LI><A NAME="ToC_181" HREF="auarf167.htm#HDRFS_WHICHCELL">fs whichcell</A>
-<LI><A NAME="ToC_182" HREF="auarf168.htm#HDRFS_WSCELL">fs wscell</A>
-<LI><A NAME="ToC_183" HREF="auarf169.htm#HDRFSTRACE_INTRO">fstrace</A>
-<LI><A NAME="ToC_184" HREF="auarf170.htm#HDRFSTRACE_APROPOS">fstrace apropos</A>
-<LI><A NAME="ToC_185" HREF="auarf171.htm#HDRFSTRACE_CLEAR">fstrace clear</A>
-<LI><A NAME="ToC_186" HREF="auarf172.htm#HDRFSTRACE_DUMP">fstrace dump</A>
-<LI><A NAME="ToC_187" HREF="auarf173.htm#HDRFSTRACE_HELP">fstrace help</A>
-<LI><A NAME="ToC_188" HREF="auarf174.htm#HDRFSTRACE_LSLOG">fstrace lslog</A>
-<LI><A NAME="ToC_189" HREF="auarf175.htm#HDRFSTRACE_LSSET">fstrace lsset</A>
-<LI><A NAME="ToC_190" HREF="auarf176.htm#HDRFSTRACE_SETLOG">fstrace setlog</A>
-<LI><A NAME="ToC_191" HREF="auarf177.htm#HDRFSTRACE_SETSET">fstrace setset</A>
-<LI><A NAME="ToC_192" HREF="auarf178.htm#HDRFTPD">ftpd (AFS version)</A>
-<LI><A NAME="ToC_193" HREF="auarf179.htm#HDRINETD">inetd (AFS version)</A>
-<LI><A NAME="ToC_194" HREF="auarf180.htm#HDRKADB_CHECK">kadb_check</A>
-<LI><A NAME="ToC_195" HREF="auarf181.htm#HDRKAS_INTRO">kas</A>
-<LI><A NAME="ToC_196" HREF="auarf182.htm#HDRKAS_APROPOS">kas apropos</A>
-<LI><A NAME="ToC_197" HREF="auarf183.htm#HDRKAS_CREATE">kas create</A>
-<LI><A NAME="ToC_198" HREF="auarf184.htm#HDRKAS_DELETE">kas delete</A>
-<LI><A NAME="ToC_199" HREF="auarf185.htm#HDRKAS_EXAMINE">kas examine</A>
-<LI><A NAME="ToC_200" HREF="auarf186.htm#HDRKAS_FORGETTICKET">kas forgetticket</A>
-<LI><A NAME="ToC_201" HREF="auarf187.htm#HDRKAS_HELP">kas help</A>
-<LI><A NAME="ToC_202" HREF="auarf188.htm#HDRKAS_INTERACTIVE">kas interactive</A>
-<LI><A NAME="ToC_203" HREF="auarf189.htm#HDRKAS_LIST">kas list</A>
-<LI><A NAME="ToC_204" HREF="auarf190.htm#HDRKAS_LISTTICKETS">kas listtickets</A>
-<LI><A NAME="ToC_205" HREF="auarf191.htm#HDRKAS_NOAUTH">kas noauthentication</A>
-<LI><A NAME="ToC_206" HREF="auarf192.htm#HDRKAS_QUIT">kas quit</A>
-<LI><A NAME="ToC_207" HREF="auarf193.htm#HDRKAS_SETFIELDS">kas setfields</A>
-<LI><A NAME="ToC_208" HREF="auarf194.htm#HDRKAS_SETPASSWORD">kas setpassword</A>
-<LI><A NAME="ToC_209" HREF="auarf195.htm#HDRKAS_STATISTICS">kas statistics</A>
-<LI><A NAME="ToC_210" HREF="auarf196.htm#HDRKAS_STRINGTOKEY">kas stringtokey</A>
-<LI><A NAME="ToC_211" HREF="auarf197.htm#HDRKAS_UNLOCK">kas unlock</A>
-<LI><A NAME="ToC_212" HREF="auarf198.htm#HDRKASERVER">kaserver</A>
-<LI><A NAME="ToC_213" HREF="auarf199.htm#HDRKDB">kdb</A>
-<LI><A NAME="ToC_214" HREF="auarf200.htm#HDRKLOG">klog</A>
-<LI><A NAME="ToC_215" HREF="auarf201.htm#HDRKNFS">knfs</A>
-<LI><A NAME="ToC_216" HREF="auarf202.htm#HDRKPASSWD">kpasswd</A>
-<LI><A NAME="ToC_217" HREF="auarf203.htm#HDRKPWVALID">kpwvalid</A>
-<LI><A NAME="ToC_218" HREF="auarf204.htm#HDRPACKAGE">package</A>
-<LI><A NAME="ToC_219" HREF="auarf205.htm#HDRPACKAGE_APROPOS">package apropos</A>
-<LI><A NAME="ToC_220" HREF="auarf206.htm#HDRPACKAGE_HELP">package help</A>
-<LI><A NAME="ToC_221" HREF="auarf207.htm#HDRPACKAGE_TEST">package_test</A>
-<LI><A NAME="ToC_222" HREF="auarf208.htm#HDRPAGSH">pagsh</A>
-<LI><A NAME="ToC_223" HREF="auarf209.htm#HDRPRDB_CHECK">prdb_check</A>
-<LI><A NAME="ToC_224" HREF="auarf210.htm#HDRPTS_INTRO">pts</A>
-<LI><A NAME="ToC_225" HREF="auarf211.htm#HDRPTS_ADDUSER">pts adduser</A>
-<LI><A NAME="ToC_226" HREF="auarf212.htm#HDRPTS_APROPOS">pts apropos</A>
-<LI><A NAME="ToC_227" HREF="auarf213.htm#HDRPTS_CHOWN">pts chown</A>
-<LI><A NAME="ToC_228" HREF="auarf214.htm#HDRPTS_CREATEGROUP">pts creategroup</A>
-<LI><A NAME="ToC_229" HREF="auarf215.htm#HDRPTS_CREATEUSER">pts createuser</A>
-<LI><A NAME="ToC_230" HREF="auarf216.htm#HDRPTS_DELETE">pts delete</A>
-<LI><A NAME="ToC_231" HREF="auarf217.htm#HDRPTS_EXAMINE">pts examine</A>
-<LI><A NAME="ToC_232" HREF="auarf218.htm#HDRPTS_HELP">pts help</A>
-<LI><A NAME="ToC_233" HREF="auarf219.htm#HDRPTS_LISTENTRIES">pts listentries</A>
-<LI><A NAME="ToC_234" HREF="auarf220.htm#HDRPTS_LISTMAX">pts listmax</A>
-<LI><A NAME="ToC_235" HREF="auarf221.htm#HDRPTS_LISTOWNED">pts listowned</A>
-<LI><A NAME="ToC_236" HREF="auarf222.htm#HDRPTS_MEMBERSHIP">pts membership</A>
-<LI><A NAME="ToC_237" HREF="auarf223.htm#HDRPTS_REMOVEUSER">pts removeuser</A>
-<LI><A NAME="ToC_238" HREF="auarf224.htm#HDRPTS_RENAME">pts rename</A>
-<LI><A NAME="ToC_239" HREF="auarf225.htm#HDRPTS_SETFIELDS">pts setfields</A>
-<LI><A NAME="ToC_240" HREF="auarf226.htm#HDRPTS_SETMAX">pts setmax</A>
-<LI><A NAME="ToC_241" HREF="auarf227.htm#HDRPTSERVER">ptserver</A>
-<LI><A NAME="ToC_242" HREF="auarf228.htm#HDRRCP">rcp (AFS version)</A>
-<LI><A NAME="ToC_243" HREF="auarf229.htm#HDRRSH">rsh (AFS version)</A>
-<LI><A NAME="ToC_244" HREF="auarf230.htm#HDRRUNNTP">runntp</A>
-<LI><A NAME="ToC_245" HREF="auarf231.htm#HDRRXDEBUG">rxdebug</A>
-<LI><A NAME="ToC_246" HREF="auarf232.htm#HDRSALVAGER">salvager</A>
-<LI><A NAME="ToC_247" HREF="auarf233.htm#HDRSCOUT">scout</A>
-<LI><A NAME="ToC_248" HREF="auarf234.htm#HDRSYS">sys</A>
-<LI><A NAME="ToC_249" HREF="auarf235.htm#HDRTOKENS">tokens</A>
-<LI><A NAME="ToC_250" HREF="auarf236.htm#HDRTRANSLATE_ET">translate_et</A>
-<LI><A NAME="ToC_251" HREF="auarf237.htm#HDRUDEBUG">udebug</A>
-<LI><A NAME="ToC_252" HREF="auarf238.htm#HDRUNLOG">unlog</A>
-<LI><A NAME="ToC_253" HREF="auarf239.htm#HDRUP">up</A>
-<LI><A NAME="ToC_254" HREF="auarf240.htm#HDRUPCLIENT">upclient</A>
-<LI><A NAME="ToC_255" HREF="auarf241.htm#HDRUPSERVER">upserver</A>
-<LI><A NAME="ToC_256" HREF="auarf242.htm#HDRUSS_INTRO">uss</A>
-<LI><A NAME="ToC_257" HREF="auarf243.htm#HDRUSS_ADD">uss add</A>
-<LI><A NAME="ToC_258" HREF="auarf244.htm#HDRUSS_APROPOS">uss apropos</A>
-<LI><A NAME="ToC_259" HREF="auarf245.htm#HDRUSS_BULK">uss bulk</A>
-<LI><A NAME="ToC_260" HREF="auarf246.htm#HDRUSS_DELETE">uss delete</A>
-<LI><A NAME="ToC_261" HREF="auarf247.htm#HDRUSS_HELP">uss help</A>
-<LI><A NAME="ToC_262" HREF="auarf248.htm#HDRVLDB_CHECK">vldb_check</A>
-<LI><A NAME="ToC_263" HREF="auarf249.htm#HDRVLSERVER">vlserver</A>
-<LI><A NAME="ToC_264" HREF="auarf250.htm#HDRVOLINFO">volinfo</A>
-<LI><A NAME="ToC_265" HREF="auarf251.htm#HDRVOLSERVER">volserver</A>
-<LI><A NAME="ToC_266" HREF="auarf252.htm#HDRVOS_INTRO">vos</A>
-<LI><A NAME="ToC_267" HREF="auarf253.htm#HDRVOS_ADDSITE">vos addsite</A>
-<LI><A NAME="ToC_268" HREF="auarf254.htm#HDRVOS_APROPOS">vos apropos</A>
-<LI><A NAME="ToC_269" HREF="auarf255.htm#HDRVOS_BACKUP">vos backup</A>
-<LI><A NAME="ToC_270" HREF="auarf256.htm#HDRVOS_BACKUPSYS">vos backupsys</A>
-<LI><A NAME="ToC_271" HREF="auarf257.htm#HDRVOS_CHANGEADDR">vos changeaddr</A>
-<LI><A NAME="ToC_272" HREF="auarf258.htm#HDRVOS_CREATE">vos create</A>
-<LI><A NAME="ToC_273" HREF="auarf259.htm#HDRVOS_DELENTRY">vos delentry</A>
-<LI><A NAME="ToC_274" HREF="auarf260.htm#HDRVOS_DUMP">vos dump</A>
-<LI><A NAME="ToC_275" HREF="auarf261.htm#HDRVOS_EXAMINE">vos examine</A>
-<LI><A NAME="ToC_276" HREF="auarf262.htm#HDRVOS_HELP">vos help</A>
-<LI><A NAME="ToC_277" HREF="auarf263.htm#HDRVOS_LISTADDRS">vos listaddrs</A>
-<LI><A NAME="ToC_278" HREF="auarf264.htm#HDRVOS_LISTPART">vos listpart</A>
-<LI><A NAME="ToC_279" HREF="auarf265.htm#HDRVOS_LISTVLDB">vos listvldb</A>
-<LI><A NAME="ToC_280" HREF="auarf266.htm#HDRVOS_LISTVOL">vos listvol</A>
-<LI><A NAME="ToC_281" HREF="auarf267.htm#HDRVOS_LOCK">vos lock</A>
-<LI><A NAME="ToC_282" HREF="auarf268.htm#HDRVOS_MOVE">vos move</A>
-<LI><A NAME="ToC_283" HREF="auarf269.htm#HDRVOS_PARTINFO">vos partinfo</A>
-<LI><A NAME="ToC_284" HREF="auarf270.htm#HDRVOS_RELEASE">vos release</A>
-<LI><A NAME="ToC_285" HREF="auarf271.htm#HDRVOS_REMOVE">vos remove</A>
-<LI><A NAME="ToC_286" HREF="auarf272.htm#HDRVOS_REMSITE">vos remsite</A>
-<LI><A NAME="ToC_287" HREF="auarf273.htm#HDRVOS_RENAME">vos rename</A>
-<LI><A NAME="ToC_288" HREF="auarf274.htm#HDRVOS_RESTORE">vos restore</A>
-<LI><A NAME="ToC_289" HREF="auarf275.htm#HDRVOS_STATUS">vos status</A>
-<LI><A NAME="ToC_290" HREF="auarf276.htm#HDRVOS_SYNCSERV">vos syncserv</A>
-<LI><A NAME="ToC_291" HREF="auarf277.htm#HDRVOS_SYNCVLDB">vos syncvldb</A>
-<LI><A NAME="ToC_292" HREF="auarf278.htm#HDRVOS_UNLOCK">vos unlock</A>
-<LI><A NAME="ToC_293" HREF="auarf279.htm#HDRVOS_UNLOCKVLDB">vos unlockvldb</A>
-<LI><A NAME="ToC_294" HREF="auarf280.htm#HDRVOS_ZAP">vos zap</A>
-<LI><A NAME="ToC_295" HREF="auarf281.htm#HDRXFS_SIZE_CHECK">xfs_size_check</A>
-<LI><A NAME="ToC_296" HREF="auarf282.htm#HDRXSTAT_CM_TEST">xstat_cm_test</A>
-<LI><A NAME="ToC_297" HREF="auarf283.htm#HDRXSTAT_FS_TEST">xstat_fs_test</A>
-</MENU>
-<P><B><A NAME="ToC_298" HREF="auarf284.htm#HDRINDEX">Index</A></B><BR>
-<P>
-<HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf000.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="auarf003.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>
diff --git a/doc/html/AdminReference/auarf003.htm b/doc/html/AdminReference/auarf003.htm
deleted file mode 100644 (file)
index d747b3a..0000000
+++ /dev/null
@@ -1,29 +0,0 @@
-<!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="auarf002.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="auarf004.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>
-<HR><H1><A NAME="HDRTLIST_START" HREF="auarf002.htm#ToC_1">Tables</A></H1>
-<OL>
-<LI><A NAME="FT_TBLFILESERVER-ARGS" HREF="auarf129.htm#TBLFILESERVER-ARGS" >File Server configuration parameters</A></LI>
-</OL>
-<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="auarf002.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="auarf004.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>
diff --git a/doc/html/AdminReference/auarf004.htm b/doc/html/AdminReference/auarf004.htm
deleted file mode 100644 (file)
index 7a2b088..0000000
+++ /dev/null
@@ -1,28 +0,0 @@
-<!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="auarf003.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="auarf005.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>
-<HR><H1><A NAME="Header_2" HREF="auarf002.htm#ToC_2">About This Manual</A></H1>
-<P>This chapter describes the purpose, organization, and conventions of this
-document.
-<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="auarf003.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="auarf005.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>
diff --git a/doc/html/AdminReference/auarf005.htm b/doc/html/AdminReference/auarf005.htm
deleted file mode 100644 (file)
index 09e908a..0000000
+++ /dev/null
@@ -1,32 +0,0 @@
-<!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="auarf004.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="auarf006.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> 
-<HR><H2><A NAME="HDRWQ1" HREF="auarf002.htm#ToC_3">Audience and Purpose</A></H2>
-<P>This reference manual details the syntax of each
-AFS<SUP><SUP>(R)</SUP></SUP> command and is intended for the experienced AFS
-administrator, programmer, or user.
-<P>In general, this document does not explain when to use a command or its
-place in the sequence of commands that make up a complete procedure.
-For that type of information, refer to the <I>IBM AFS Administration
-Guide</I>.
-<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="auarf004.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="auarf006.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>
diff --git a/doc/html/AdminReference/auarf006.htm b/doc/html/AdminReference/auarf006.htm
deleted file mode 100644 (file)
index b8cf388..0000000
+++ /dev/null
@@ -1,55 +0,0 @@
-<!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="auarf005.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="auarf007.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> 
-<HR><H2><A NAME="HDRWQ2" HREF="auarf002.htm#ToC_4">Organization</A></H2>
-<P>This document presents AFS files and commands in separate
-sections, with the files or commands in alphabetical order.
-<P>The following sections of each reference page provide the indicated type of
-information:
-<UL>
-<P><LI><B>Purpose</B> briefly describes the command's function.
-<P><LI><B>Synopsis</B> displays the complete syntax statement for a command,
-which specifies the required order for all options, using the same notation as
-the AFS online help. If abbreviating the command name and option names
-is acceptable, as it is for most commands, a second statement specifies the
-shortest acceptable abbreviation of each name. If the command has an
-alias, it also appears in this section.
-<P><LI><B>Description</B> describes the file or command's function in
-detail.
-<P><LI><B>Cautions</B> describes restrictions, requirements, and potential
-complications in use of the command. It appears only when
-necessary.
-<P><LI><B>Options</B> describes the function and required form of each
-argument and flag.
-<P><LI><B>Output</B> describes any output the command writes to the standard
-output stream. This section does not appear if the command does not
-produce output or if the only output is a message confirming the
-command's success.
-<P><LI><B>Examples</B> provides one or more sample commands and resulting
-output.
-<P><LI><B>Privilege Required</B> lists each privilege required to perform the
-command.
-<P><LI><B>Related Information</B> lists related commands and files, if
-any.
-</UL>
-<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="auarf005.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="auarf007.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>
diff --git a/doc/html/AdminReference/auarf007.htm b/doc/html/AdminReference/auarf007.htm
deleted file mode 100644 (file)
index 6a0db0b..0000000
+++ /dev/null
@@ -1,28 +0,0 @@
-<!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="auarf006.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="auarf008.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> 
-<HR><H2><A NAME="HDRWQ3" HREF="auarf002.htm#ToC_5">How to Use This Document</A></H2>
-<P>Refer to this document when you need detailed information
-about a specific command. For a description of all the steps in a
-procedure, refer to the <I>IBM AFS Administration Guide</I>.
-<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="auarf006.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="auarf008.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>
diff --git a/doc/html/AdminReference/auarf008.htm b/doc/html/AdminReference/auarf008.htm
deleted file mode 100644 (file)
index be5907d..0000000
+++ /dev/null
@@ -1,56 +0,0 @@
-<!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="auarf007.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="auarf009.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> 
-<HR><H2><A NAME="HDRWQ4" HREF="auarf002.htm#ToC_6">Related Documents</A></H2>
-<P>The following documents are included in the AFS documentation
-set.
-<P><I>IBM AFS Administration Guide</I>
-<P>This guide describes the concepts and procedures that a system
-administrator must know to manage an AFS cell. It assumes familiarity
-with UNIX, but requires no previous knowledge of AFS.
-<P>The first chapters of the <I>IBM AFS Administration Guide</I> present
-basic concepts and guidelines. Understanding them is crucial to
-successful administration of an AFS cell. The remaining chapters in the
-guide provide step-by-step instructions for specific administrative tasks,
-along with discussions of the concepts important to that particular
-task.
-<P><I>IBM AFS Quick Beginnings</I>
-<P>This guide provides instructions for installing AFS server and client
-machines. It is assumed that the installer is an experienced UNIX<SUP>
-<SUP>(R)</SUP></SUP> system administrator.
-<P>For predictable performance, machines must be installed and configured in
-accordance with the instructions in this guide.
-<P><I>IBM AFS Release Notes</I>
-<P>This document provides information specific to each release of AFS, such as
-a list of new features and commands, a list of requirements and limitations,
-and instructions for upgrading server and client machines.
-<P><I>IBM AFS User Guide</I>
-<P>This guide presents the basic concepts and procedures necessary for using
-AFS effectively. It assumes that the reader has some experience with
-UNIX, but does not require familiarity with networking or AFS.
-<P>The guide explains how to perform basic functions, including
-authenticating, changing a password, protecting AFS data, creating groups, and
-troubleshooting. It provides illustrative examples for each function
-and describes some of the differences between the UNIX file system and
-AFS.
-<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="auarf007.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="auarf009.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>
diff --git a/doc/html/AdminReference/auarf009.htm b/doc/html/AdminReference/auarf009.htm
deleted file mode 100644 (file)
index e192dce..0000000
+++ /dev/null
@@ -1,57 +0,0 @@
-<!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="auarf008.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="auarf010.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> 
-<HR><H2><A NAME="HDRTYPO_CONV" HREF="auarf002.htm#ToC_7">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>
-<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="auarf008.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="auarf010.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>
diff --git a/doc/html/AdminReference/auarf010.htm b/doc/html/AdminReference/auarf010.htm
deleted file mode 100644 (file)
index c7ab21a..0000000
+++ /dev/null
@@ -1,26 +0,0 @@
-<!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="auarf009.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="auarf011.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> 
-<HR><H1><A NAME="Header_8" HREF="auarf002.htm#ToC_8">AFS System Files</A></H1>
-<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="auarf009.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="auarf011.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>
diff --git a/doc/html/AdminReference/auarf011.htm b/doc/html/AdminReference/auarf011.htm
deleted file mode 100644 (file)
index 68416fe..0000000
+++ /dev/null
@@ -1,124 +0,0 @@
-<!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="auarf010.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="auarf012.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="HDRFILESINTRO" HREF="auarf002.htm#ToC_9">afs_file_intro</A></H2>
-<P><STRONG>Purpose</STRONG>
-<P>Introduction to AFS files
-<P><STRONG>Description</STRONG>
-<P>A number of files must reside on the local disk of AFS server and client
-machines. They belong to the following general categories:
-<UL>
-<P><LI><I>Configuration files</I> define configuration parameters for
-specific server and kernel processes such as the Backup System Tape
-Coordinator or the Cache Manager
-<P><LI><I>Administrative files</I> list information used in administration of
-server machines, such as a list of privileged users or server encryption keys
-<P><LI><I>Cache-related files</I> contain cached data or information about
-cached data, on client machines
-<P><LI><I>Log files</I> contain tracing messages about the operation of a
-specific process
-<P><LI><I>Database files</I> contain database records used to administer the
-AFS cell
-<P><LI><I>Controller files</I> control the behavior of a process
-<P><LI><I>Volume header files</I> represent AFS volumes on server partitions
-</UL>
-<P>For a description of the format and contents of each file, see its
-reference page.
-<P><B>Note for Windows users:</B> Some files described in this
-document possibly do not exist on machines that run a Windows operating
-system. Also, Windows uses a backslash
-(&nbsp;<B>\</B>&nbsp;) rather than a forward slash
-(&nbsp;<B>/</B>&nbsp;) to separate the elements in a
-pathname.
-<P><STRONG>Related Information</STRONG>
-<P><B>Configuration files:</B>
-<A NAME="IDX3862"></A>
-<DL>
-<DD><P><A HREF="auarf016.htm#HDRBOSCONFIG">BosConfig</A>
-<DD><P><A HREF="auarf018.htm#HDRCFG">CFG_<I>device_name</I></A>
-<DD><P><A HREF="auarf019.htm#HDRCLI_CSDB">CellServDB (client version)</A>
-<DD><P><A HREF="auarf020.htm#HDRSV_CSDB">CellServDB (server version)</A>
-<DD><P><A HREF="auarf024.htm#HDRCLI_NETINFO">NetInfo (client version)</A>
-<DD><P><A HREF="auarf025.htm#HDRSV_NETINFO">NetInfo (server version)</A>
-<DD><P><A HREF="auarf026.htm#HDRCLI_NETRESTRICT">NetRestrict (client version)</A>
-<DD><P><A HREF="auarf027.htm#HDRSV_NETRESTRICT">NetRestrict (server version)</A>
-<DD><P><A HREF="auarf032.htm#HDRCLI_THISCELL">ThisCell (client version)</A>
-<DD><P><A HREF="auarf033.htm#HDRSV_THISCELL">ThisCell (server version)</A>
-<DD><P><A HREF="auarf043.htm#HDRCACHEINFO">cacheinfo</A>
-<DD><P><A HREF="auarf049.htm#HDRSYSID">sysid</A>
-<DD><P><A HREF="auarf050.htm#HDRTAPECONFIG">tapeconfig</A>
-<DD><P><A HREF="auarf053.htm#HDRPACKAGECONFIG">package Configuration File</A>
-<DD><P><A HREF="auarf055.htm#HDRUSSFILE">uss Template File</A>
-<DD><P><A HREF="auarf054.htm#HDRUSSBULKINPUT">uss Bulk Input File</A>
-</DL>
-<P><B>Administrative files:</B>
-<A NAME="IDX3863"></A>
-<DL>
-<DD><P><A HREF="auarf023.htm#HDRKEYFILE">KeyFile</A>
-<DD><P><A HREF="auarf035.htm#HDRUSERLIST">UserList</A>
-</DL>
-<P><B>Cache-related files:</B>
-<A NAME="IDX3864"></A>
-<DL>
-<DD><P><A HREF="auarf017.htm#HDRCACHEITEMS">CacheItems</A>
-<DD><P><A HREF="auarf036.htm#HDRVN">V<I>n</I></A>
-<DD><P><A HREF="auarf040.htm#HDRVOLUMEITEMS">VolumeItems</A>
-</DL>
-<P><B>Log files:</B>
-<A NAME="IDX3865"></A>
-<DL>
-<DD><P><A HREF="auarf012.htm#HDRAUTHLOG">AuthLog</A>
-<DD><P><A HREF="auarf014.htm#HDRBACKUPLOG">BackupLog</A>
-<DD><P><A HREF="auarf015.htm#HDRBOSLOG">BosLog</A>
-<DD><P><A HREF="auarf021.htm#HDRFILELOG">FileLog</A>
-<DD><P><A HREF="auarf030.htm#HDRSALVAGELOG">SalvageLog</A>
-<DD><P><A HREF="auarf031.htm#HDRTE">TE_<I>device_name</I></A>
-<DD><P><A HREF="auarf034.htm#HDRTL">TL_<I>device_name</I></A>
-<DD><P><A HREF="auarf038.htm#HDRVLLOG">VLLog</A>
-<DD><P><A HREF="auarf039.htm#HDRVOLSERLOG">VolserLog</A>
-<DD><P><A HREF="auarf044.htm#HDRFMSLOG">fms.log</A>
-</DL>
-<P><B>Database files:</B>
-<A NAME="IDX3866"></A>
-<DL>
-<DD><P><A HREF="auarf042.htm#HDRBDBDB">bdb.DB0 and bdb.DBSYS1</A>
-<DD><P><A HREF="auarf045.htm#HDRKASERVERDB">kaserver.DB0 and kaserver.DBSYS1</A>
-<DD><P><A HREF="auarf046.htm#HDRKASERVERAUXDB">kaserverauxdb</A>
-<DD><P><A HREF="auarf047.htm#HDRPRDBDB">prdb.DB0 and prdb.DBSYS1</A>
-<DD><P><A HREF="auarf051.htm#HDRVLDBDB">vldb.DB0 and vldb.DBSYS1</A>
-</DL>
-<A NAME="IDX3867"></A>
-<P><B>Controller files:</B>
-<DL>
-<DD><P><A HREF="auarf022.htm#HDRFORCESALVAGE">FORCESALVAGE</A>
-<DD><P><A HREF="auarf028.htm#HDRNOAUTH">NoAuth</A>
-<DD><P><A HREF="auarf029.htm#HDRSALVAGEFS">SALVAGE.fs</A>
-<DD><P><A HREF="auarf048.htm#HDRSALVAGELOCK">salvage.lock</A>
-</DL>
-<P><B>Volume header files:</B>
-<DL>
-<DD><P><A HREF="auarf037.htm#HDRVVOLID">V<I>vol_ID</I>.vol</A>
-</DL>
-<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="auarf010.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="auarf012.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>
diff --git a/doc/html/AdminReference/auarf012.htm b/doc/html/AdminReference/auarf012.htm
deleted file mode 100644 (file)
index 3912009..0000000
+++ /dev/null
@@ -1,57 +0,0 @@
-<!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="auarf011.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="auarf013.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="HDRAUTHLOG" HREF="auarf002.htm#ToC_10">AuthLog</A></H2>
-<P><STRONG>Purpose</STRONG>
-<A NAME="IDX3868"></A>
-<A NAME="IDX3869"></A>
-<A NAME="IDX3870"></A>
-<P>Traces Authentication Server operations
-<P><STRONG>Description</STRONG>
-<P>The <B>AuthLog</B> file records a trace of Authentication Server
-(<B>kaserver</B> process) operations on the local machine and describes
-any error conditions it encounters.
-<P>If the <B>AuthLog</B> file does not exist in the
-<B>/usr/afs/logs</B> directory when the Authentication Server starts, the
-server process creates it and writes initial start-up messages to it.
-If there is an existing file, the Authentication Server renames it to
-<B>AuthLog.old</B>, overwriting the existing
-<B>AuthLog.old</B> file if it exists.
-<P>The file is in ASCII format. Administrators listed in the
-<B>/usr/afs/etc/UserList</B> file can use the <B>bos getlog</B>
-command to display its contents. Alternatively, log onto the server
-machine and use a text editor or a file display command such as the UNIX
-<B>cat</B> command. By default, the mode bits on the
-<B>AuthLog</B> file grant the required <B>r</B> (<B>read</B>)
-permission to all users.
-<P>The Authentication Server records operations only as it completes them, and
-cannot recover from failures by reviewing the file. The log contents
-are useful for administrative evaluation of process failures and other
-problems.
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf035.htm#HDRUSERLIST">UserList</A>
-<P><A HREF="auarf102.htm#HDRBOS_GETLOG">bos getlog</A>
-<P><A HREF="auarf198.htm#HDRKASERVER">kaserver</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="auarf011.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="auarf013.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>
diff --git a/doc/html/AdminReference/auarf013.htm b/doc/html/AdminReference/auarf013.htm
deleted file mode 100644 (file)
index 92d7192..0000000
+++ /dev/null
@@ -1,49 +0,0 @@
-<!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="auarf012.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="auarf014.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="HDRWQ5" HREF="auarf002.htm#ToC_11">AuthLog.dir, AuthLog.pag</A></H2>
-<P><STRONG>Purpose</STRONG>
-<A NAME="IDX3871"></A>
-<A NAME="IDX3872"></A>
-<A NAME="IDX3873"></A>
-<P>Records privileged operations performed by the Authentication Server
-<P><STRONG>Description</STRONG>
-<P>The <B>AuthLog.dir</B> and <B>AuthLog.pag</B> files
-record a trace of privileged operations performed by the Authentication Server
-(<B>kaserver</B> process) on the local machine. If the files do not
-exist when the Authentication Server starts, it creates them in the
-<B>/usr/afs/logs</B> directory as necessary.
-<P>The files are in binary format. To display their contents, use the
-<B>kdb</B> command, which requires being logged in to the local machine as
-the local superuser <B>root</B>.
-<P><STRONG>Cautions</STRONG>
-<P>The Authentication Server is possibly unable to create these files on some
-operating systems that AFS otherwise supports, making the <B>kdb</B>
-command inoperative. See the <I>IBM AFS Release Notes</I> for
-details.
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf198.htm#HDRKASERVER">kaserver</A>
-<P><A HREF="auarf199.htm#HDRKDB">kdb</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="auarf012.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="auarf014.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>
diff --git a/doc/html/AdminReference/auarf014.htm b/doc/html/AdminReference/auarf014.htm
deleted file mode 100644 (file)
index b8565b3..0000000
+++ /dev/null
@@ -1,57 +0,0 @@
-<!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="auarf013.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="auarf015.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="HDRBACKUPLOG" HREF="auarf002.htm#ToC_12">BackupLog</A></H2>
-<P><STRONG>Purpose</STRONG>
-<A NAME="IDX3874"></A>
-<A NAME="IDX3875"></A>
-<A NAME="IDX3876"></A>
-<P>Traces Backup Server operations
-<P><STRONG>Description</STRONG>
-<P>The <B>BackupLog</B> file records a trace of Backup Server
-(<B>buserver</B> process) operations on the local machine and describes
-any error conditions it encounters.
-<P>If the <B>BackupLog</B> file does not already exist in the
-<B>/usr/afs/logs</B> directory when the Backup Server starts, the server
-process creates it and writes initial start-up messages to it. If there
-is an existing file, the Backup Server renames it to
-<B>BackupLog.old</B>, overwriting the existing
-<B>BackupLog.old</B> file if it exists.
-<P>The file is in ASCII format. Administrators listed in the
-<B>/usr/afs/etc/UserList</B> file can use the <B>bos getlog</B>
-command to display its contents. Alternatively, log on to the machine
-and use a text editor or a file display command such as the UNIX
-<B>cat</B> command. By default, the mode bits on the
-<B>BackupLog</B> file grant the required <B>r</B> (<B>read</B>)
-permission to all users.
-<P>The Backup Server records operations only as it completes them, and so
-cannot recover from failures by reviewing the file. The log contents
-are useful for administrative evaluation of process failures and other
-problems.
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf035.htm#HDRUSERLIST">UserList</A>
-<P><A HREF="auarf102.htm#HDRBOS_GETLOG">bos getlog</A>
-<P><A HREF="auarf125.htm#HDRBUSERVER">buserver</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="auarf013.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="auarf015.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>
diff --git a/doc/html/AdminReference/auarf015.htm b/doc/html/AdminReference/auarf015.htm
deleted file mode 100644 (file)
index d440166..0000000
+++ /dev/null
@@ -1,57 +0,0 @@
-<!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="auarf014.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="auarf016.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="HDRBOSLOG" HREF="auarf002.htm#ToC_13">BosLog</A></H2>
-<P><STRONG>Purpose</STRONG>
-<A NAME="IDX3877"></A>
-<A NAME="IDX3878"></A>
-<A NAME="IDX3879"></A>
-<P>Traces BOS Server operations
-<P><STRONG>Description</STRONG>
-<P>The <B>BosLog</B> file records a trace of Basic OverSeer (BOS) Server
-(<B>bosserver</B> process) operations on the local machine and describes
-any error conditions it encounters.
-<P>If the <B>BosLog</B> file does not already exist in the
-<B>/usr/afs/logs</B> directory when the BOS Server starts, the server
-process creates it and writes initial start-up messages to it. If there
-is an existing file, the BOS server renames it to
-<B>BosLog.old</B>, overwriting the existing
-<B>BosLog.old</B> file if it exists.
-<P>The file is in ASCII format. Administrators listed in the
-<B>/usr/afs/etc/UserList</B> file can use the <B>bos getlog</B>
-command to display its contents. Alternatively, log onto the server
-machine and use a text editor or a file display command such as the UNIX
-<B>cat</B> command. By default, the mode bits on the
-<B>BosLog</B> file grant the required <B>r</B> (<B>read</B>)
-permission to all users.
-<P>The BOS Server records operations only as it completes them, and cannot
-recover from failures by reviewing the file. The log contents are
-useful for administrative evaluation of process failures and other
-problems.
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf035.htm#HDRUSERLIST">UserList</A>
-<P><A HREF="auarf102.htm#HDRBOS_GETLOG">bos getlog</A>
-<P><A HREF="auarf124.htm#HDRBOSSERVER">bosserver</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="auarf014.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="auarf016.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>
diff --git a/doc/html/AdminReference/auarf016.htm b/doc/html/AdminReference/auarf016.htm
deleted file mode 100644 (file)
index e1b4f7e..0000000
+++ /dev/null
@@ -1,179 +0,0 @@
-<!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="auarf015.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="auarf017.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="HDRBOSCONFIG" HREF="auarf002.htm#ToC_14">BosConfig</A></H2>
-<P><STRONG>Purpose</STRONG>
-<A NAME="IDX3880"></A>
-<A NAME="IDX3881"></A>
-<A NAME="IDX3882"></A>
-<A NAME="IDX3883"></A>
-<P>Defines server processes for the BOS Server to monitor
-<P><STRONG>Description</STRONG>
-<P>The <B>BosConfig</B> file lists the processes that the Basic OverSeer
-(BOS) Server monitors on its server machine, and thus defines which AFS server
-processes run on the machine. It specifies how the BOS Server reacts
-when a process fails, and also defines the times at which the BOS Server
-automatically restarts processes as part of performance maintenance.
-The file must reside in the <B>/usr/afs/local</B> directory on each AFS
-server machine.
-<P>A server process entry in the <B>BosConfig</B> file records the
-following information:
-<UL>
-<P><LI>The<VAR> entry type</VAR>, which is one of the following: 
-<A NAME="IDX3884"></A>
-<A NAME="IDX3885"></A>
-<DL>
-<P><DT><B>cron
-<A NAME="IDX3886"></A>
-</B><DD>Designates a server process that runs periodically instead of
-continuously. The BOS Server starts a cron process only at specified
-times, not whenever it fails. All standard AFS process entries except
-<B>fs</B> are simple (there are no standard cron processes).
-<P><DT><B>fs
-<A NAME="IDX3887"></A>
-<A NAME="IDX3888"></A>
-<A NAME="IDX3889"></A>
-<A NAME="IDX3890"></A>
-</B><DD>Designates a group of interdependent server processes. If one of
-the processes fails, the BOS Server must coordinate its restart with the
-restart of the other processes in the group, possibly by stopping them
-first. 
-<P>There is only one standard entry of this type, for which the conventional
-name is <B>fs</B>. It combines three server processes: the
-File Server (<B>fileserver</B> process), the Volume Server
-(<B>volserver</B> process), and the Salvager (<B>salvager</B>
-process). These processes all operate on the same data--the AFS
-data stored on an AFS server machine's <B>/vicep</B> partitions and
-mounted in the AFS filespace--but in different ways. Grouping the
-processes prevents them from attempting to access the same data
-simultaneously, which can cause corruption. 
-<P>During normal operation, the Salvager process is not active. If the
-File Server process fails, however, the BOS Server stops the Volume Server
-process and runs the Salvager process to correct any corruption that resulted
-from the failure. (The administrator can also issue the <B>bos
-salvage</B> command to invoke the Salvager process.) If the Volume
-Server fails, the BOS Server can restart it without stopping the File Server
-or running the Salvager.
-<P><DT><B>simple
-<A NAME="IDX3891"></A>
-</B><DD>Designates a server process that runs independently of any other on the
-server machine. If a simple process fails, the BOS Server does not have
-to coordinate its restart with any other process.
-</DL>
-<P><LI>The <VAR>entry name</VAR>. The conventional name for an entry in the
-<B>BosConfig</B> file and the associated process matches the binary
-filename. When issuing any <B>bos</B> command that takes the
-<B>-instance</B> argument, identify each process by the name used in the
-<B>BosConfig</B> file. For a list of the names, see the <B>bos
-create</B> reference page.
-<P><LI>The process's <VAR>status flag</VAR>, which determines whether the BOS
-Server attempts to start the process in two cases: each time the BOS
-Server itself restarts, and when the process fails. The
-<B>BosConfig</B> file currently uses a binary notation to indicate whether
-the BOS Server attempts to restart the process as necessary or does not
-monitor it at all. For the sake of clarity, the AFS documentation
-refers to the flags as <B>Run</B> and <B>NotRun</B> instead.
-Only a system administrator, not the BOS Server, can change the flag.
-<A NAME="IDX3892"></A>
-<A NAME="IDX3893"></A>
-<P><LI>One or more <VAR>command parameters</VAR> which the BOS Server invokes to
-start the process or processes associated with the entry: 
-<UL>
-<P><LI>A <B>cron</B> entry has two command parameters, the first the complete
-pathname to the program, and the second the time at which the BOS Server
-invokes the program.
-<P><LI>The <B>fs</B> entry has three command parameters, each the complete
-pathname to the <B>fileserver</B>, <B>volserver</B>, and
-<B>salvager</B> programs, in that order.
-<P><LI>A <B>simple</B> entry has only one command parameter, the complete
-pathname to the program.
-</UL>
-</UL>
-<P>In addition to server process entries, the <B>BosConfig</B> file
-specifies the times at which the BOS Server performs two types of automatic
-process restarts:
-<UL>
-<P><LI>The <VAR>general restart</VAR> time at which the BOS Server restarts itself
-and then each process for which the entry in the <B>BosConfig</B> file has
-status flag <B>Run</B>. The default setting is Sunday at 4:00
-a.m.
-<P><LI>The <VAR>binary restart</VAR> time at which the BOS Server restarts any
-server process for which the time stamp on the binary file in the
-<B>/usr/afs/bin</B> directory is later than the last restart time for the
-process. The default is 5:00 a.m.
-</UL>
-<P>Although the <B>BosConfig</B> file is in ASCII format, do not use a
-text editor to alter it. Its format is subject to change and
-incorrectly formatted entries can prevent server startup in ways that are
-difficult to diagnose. Instead always use the appropriate commands from
-the <B>bos</B> command suite:
-<UL>
-<P><LI>The <B>bos create</B> command to create an entry in the file and start
-the associated process
-<P><LI>The <B>bos delete</B> command to remove an entry from the file after
-the <B>bos stop</B> command is used to stop the associated process
-<P><LI>The <B>bos getrestart</B> command to display the times at which the
-BOS Server performs automatic restarts
-<P><LI>The <B>bos setrestart</B> command to set the times at which the BOS
-Server performs automatic process restarts
-<P><LI>The <B>bos start</B> command to change an entry's status flag to
-<B>Run</B> and start the associated process
-<P><LI>The <B>bos status</B> command to display all processes listed in the
-file
-<P><LI>The <B>bos stop</B> command to change an entry's status flag to
-<B>NotRun</B> and stop the associated process
-</UL>
-<P>There are also <B>bos</B> commands that start and stop processes
-without changing entries in the <B>BosConfig</B> file. The BOS
-Server reads the <B>BosConfig</B> file only when it starts, transferring
-the information into its memory. Thus a process's status as
-represented in the BOS Server's memory can diverge from its status in the
-<B>BosConfig</B> file. The following commands change a
-process's status in the BOS Server's memory only:
-<A NAME="IDX3894"></A>
-<A NAME="IDX3895"></A>
-<A NAME="IDX3896"></A>
-<UL>
-<P><LI>The <B>bos restart</B> command restarts a specified set of processes,
-all processes, or all processes other than the BOS Server
-<P><LI>The <B>bos shutdown</B> command stops a process
-<P><LI>The <B>bos startup</B> command starts a process
-</UL>
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf098.htm#HDRBOS_CREATE">bos create</A>
-<P><A HREF="auarf099.htm#HDRBOS_DELETE">bos delete</A>
-<P><A HREF="auarf103.htm#HDRBOS_GETRESTART">bos getrestart</A>
-<P><A HREF="auarf113.htm#HDRBOS_RESTART">bos restart</A>
-<P><A HREF="auarf117.htm#HDRBOS_SETRESTART">bos setrestart</A>
-<P><A HREF="auarf118.htm#HDRBOS_SHUTDOWN">bos shutdown</A>
-<P><A HREF="auarf119.htm#HDRBOS_START">bos start</A>
-<P><A HREF="auarf120.htm#HDRBOS_STARTUP">bos startup</A>
-<P><A HREF="auarf121.htm#HDRBOS_STATUS">bos status</A>
-<P><A HREF="auarf122.htm#HDRBOS_STOP">bos stop</A>
-<P><A HREF="auarf114.htm#HDRBOS_SALVAGE">bos salvage</A>
-<P><A HREF="auarf129.htm#HDRFILESERVER">fileserver</A>
-<P><A HREF="auarf232.htm#HDRSALVAGER">salvager</A>
-<P><A HREF="auarf251.htm#HDRVOLSERVER">volserver</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="auarf015.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="auarf017.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>
diff --git a/doc/html/AdminReference/auarf017.htm b/doc/html/AdminReference/auarf017.htm
deleted file mode 100644 (file)
index 5e74b04..0000000
+++ /dev/null
@@ -1,59 +0,0 @@
-<!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="auarf016.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="auarf018.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="HDRCACHEITEMS" HREF="auarf002.htm#ToC_15">CacheItems</A></H2>
-<P><STRONG>Purpose</STRONG>
-<A NAME="IDX3897"></A>
-<A NAME="IDX3898"></A>
-<A NAME="IDX3899"></A>
-<P>Records information about each <B>V</B><VAR>n</VAR> file in a disk cache
-<P><STRONG>Description</STRONG>
-<P>The <B>CacheItems</B> file records information about each file in the
-disk cache on a client machine (each <B>V</B><VAR>n</VAR> file). The
-information includes the file ID number and associated volume version number
-of the AFS file currently stored in the <B>V</B><VAR>n</VAR> file, which
-enables the Cache Manager to determine which <B>V</B><VAR>n</VAR> file
-contains the AFS data it needs to present to an application.
-<P>As it initializes, the Cache Manager creates the binary-format
-<B>CacheItems</B> file in the same local disk cache directory as the
-<B>V</B><VAR>n</VAR> files that the <B>CacheItems</B> file describes,
-and it must always remain there. The conventional directory name is
-<B>/usr/vice/cache</B>, but it is acceptable to use a directory on a
-partition with more available space.
-<P><STRONG>Cautions</STRONG>
-<P>Editing or removing the <B>CacheItems</B> file can cause a kernel
-panic. If the contents of <B>V</B><VAR>n</VAR> files seem out of
-date, clear the files by using the <B>fs flush</B> or <B>fs
-flushvolume</B> command. If the <B>CacheItems</B> file is
-accidentally modified or deleted, rebooting the machine usually restores
-normal performance.
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf036.htm#HDRVN">V<I>n</I></A>
-<P><A HREF="auarf040.htm#HDRVOLUMEITEMS">VolumeItems</A>
-<P><A HREF="auarf043.htm#HDRCACHEINFO">cacheinfo</A>
-<P><A HREF="auarf058.htm#HDRAFSD">afsd</A>
-<P><A HREF="auarf140.htm#HDRFS_FLUSH">fs flush</A>
-<P><A HREF="auarf142.htm#HDRFS_FLUSHVOLUME">fs flushvolume</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="auarf016.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="auarf018.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>
diff --git a/doc/html/AdminReference/auarf018.htm b/doc/html/AdminReference/auarf018.htm
deleted file mode 100644 (file)
index ef3cc76..0000000
+++ /dev/null
@@ -1,565 +0,0 @@
-<!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="auarf017.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="auarf019.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="HDRCFG" HREF="auarf002.htm#ToC_16">CFG_<I>device_name</I></A></H2>
-<P><STRONG>Purpose</STRONG>
-<A NAME="IDX3900"></A>
-<A NAME="IDX3901"></A>
-<A NAME="IDX3902"></A>
-<A NAME="IDX3903"></A>
-<A NAME="IDX3904"></A>
-<P>Defines Tape Coordinator configuration instructions for automated tape
-devices
-<P><STRONG>Description</STRONG>
-<P>The <B>CFG_</B><VAR>device_name</VAR> file includes instructions that
-configure a Tape Coordinator for use with automated backup devices such as
-tape stackers and jukeboxes, enable the Tape Coordinator to dump and restore
-data to a <I>backup data file</I> on a local disk device, and enable
-greater automation of other aspects of the backup process.
-<P>There is a separate configuration file for each tape device or backup data
-file. Creating the file is optional, and unnecessary if none of the
-instructions it can include pertain to a given tape device. The
-ASCII-format file must reside in the <B>/usr/afs/backup</B> directory on
-the Tape Coordinator machine if it exists.
-<P>The <B>CFG_</B><VAR>device_name</VAR> file does not replace the
-<B>/usr/afs/backup/tapeconfig</B> file, a single copy of which still must
-exist on every Tape Coordinator machine.
-<P>To enable the Tape Coordinator to locate the configuration file, construct
-the variable part of the filename, <VAR>device_name</VAR>, as follows:
-<UL>
-<P><LI>For a tape device, strip off the initial <B>/dev/</B> string from the
-device name, and replace any other slashes in the name with
-underscores. For example, <B>CFG_rmt_4m</B> is the appropriate
-filename for a device called <B>/dev/rmt/4m</B>.
-<P><LI>For a backup data file, strip off the initial slash (/) and replace any
-other slashes in the name with underscores. For example,
-<B>CFG_var_tmp_FILE</B> is the appropriate filename for a backup data file
-called <B>/var/tmp/FILE</B>.
-</UL>
-<P>The <B>CFG_</B><VAR>device_name</VAR> file lists one or more of the
-following instructions, each on its own line. All are optional, and
-they can appear in any order. A more detailed description of each
-instruction follows the list:
-<DL>
-<P><DT><B>ASK
-</B><DD>Controls whether the Tape Coordinator prompts for guidance when it
-encounters error conditions
-<P><DT><B>AUTOQUERY
-</B><DD>Controls whether the Tape Coordinator prompts for the first tape
-<P><DT><B>BUFFERSIZE
-</B><DD>Sets the size of the memory buffer the Tape Coordinator uses when
-transferring data
-<P><DT><B>FILE
-</B><DD>Controls whether the dump is written to a tape device or a file
-<P><DT><B>MOUNT
-</B><DD>Identifies the file that contains routines for inserting tapes into the
-device's drive
-<P><DT><B>NAME_CHECK
-</B><DD>Controls whether the Tape Coordinator verifies that a tape's AFS tape
-name matches the dump being written
-<P><DT><B>UNMOUNT
-</B><DD>Identifies the file that contains routines for removing tapes from the
-device's drive
-</DL>
-<A NAME="IDX3905"></A>
-<P><B>The ASK Instruction</B>
-<P>The <B>ASK</B> instruction takes a boolean value as its argument, in
-the following format:
-<PRE>   ASK {<B>YES</B> | <B>NO</B>}
-   
-</PRE>
-<P>When the value is <B>YES</B>, the Tape Coordinator generates a prompt
-in its window, requesting a response to the error cases described in the
-following list. This is the default behavior if the ASK instruction
-does not appear in the <B>CFG_</B><VAR>device_name</VAR> file.
-<P>When the value is <B>NO</B>, the Tape Coordinator does not prompt in
-error cases, but instead uses the automatic default responses described in the
-following list. The Tape Coordinator also logs the error in the
-<B>TE_</B><VAR>device_name</VAR> file. Suppressing the prompts
-enables the Tape Coordinator to run unattended, though it still prompts for
-insertion of tapes unless the <B>MOUNT</B> instruction is used.
-<P>The error cases controlled by this instruction are the following:
-<UL>
-<P><LI>The Backup System is unable to dump a volume while running the <B>backup
-dump</B> command. With a <B>YES</B> value, the Tape Coordinator
-prompts to offer three choices: try to dump the volume again
-immediately, omit the volume from the dump but continue the operation, or
-terminate the operation. With a <B>NO</B> value, the Tape
-Coordinator omits the volume from the dump and continues the operation.
-<P><LI>The Backup System is unable to restore a volume while running the
-<B>backup diskrestore</B>, <B>backup volrestore</B>, or <B>backup
-volsetrestore</B> command. With a <B>YES</B> value, the Tape
-Coordinator prompts to offer two choices: omit the volume and continue
-restoring the other volumes, or terminate the operation. With a
-<B>NO</B> value, it continues the operation without prompting, omitting
-the problematic volume but restoring the remaining ones.
-<P><LI>The Backup System cannot determine if the dump set includes any more
-tapes, while running the <B>backup scantape</B> command (the reference
-page for that command discusses possible reasons for this problem).
-With a <B>YES</B> value, the Tape Coordinator prompts to ask if there are
-more tapes to scan. With a <B>NO</B> value, it proceeds as though
-there are more tapes and invokes the routine named by the <B>MOUNT</B>
-instruction in the configuration file, or prompts the operator to insert the
-next tape.
-<P><LI>The Backup System determines that the tape contains an unexpired dump
-while running the <B>backup labeltape</B> command. With a
-<B>YES</B> value, the Tape Coordinator prompts to offer two choices:
-continue or terminate the labeling operation. With a <B>NO</B>
-value, it terminates the operation without relabeling the tape.
-</UL>
-<A NAME="IDX3906"></A>
-<P><B>The AUTOQUERY Instruction</B>
-<P>The <B>AUTOQUERY</B> instruction takes a boolean value as its argument,
-in the following format:
-<PRE>   AUTOQUERY {<B>YES</B> | <B>NO</B>}
-   
-</PRE>
-<P>When the value is <B>YES</B>, the Tape Coordinator checks for the
-<B>MOUNT</B> instruction in the configuration file when it needs to read
-the first tape involved in an operation. As described for that
-instruction, it then either prompts for the tape or invokes the specified
-routine to mount the tape. This is the default behavior if the
-<B>AUTOQUERY</B> instruction does not appear in the configuration
-file.
-<P>When the value is <B>NO</B>, the Tape Coordinator assumes that the
-first tape required for an operation is already in the drive. It does
-not prompt the operator or invoke the <B>MOUNT</B> routine unless there is
-an error in accessing the first tape. This setting is equivalent in
-effect to including the <B>-noautoquery</B> flag to the <B>butc</B>
-command.
-<P>Note that the setting of the <B>AUTOQUERY</B> instruction controls the
-Tape Coordinator's behavior only with respect to the first tape required
-for an operation. For subsequent tapes, the Tape Coordinator always
-checks for the <B>MOUNT</B> instruction. It also refers to the
-<B>MOUNT</B> instruction if it encounters an error while attempting to
-access the first tape.
-<A NAME="IDX3907"></A>
-<P><B>The BUFFERSIZE Instruction</B>
-<P>The <B>BUFFERSIZE</B> instruction takes an integer value, and
-optionally units, in the following format:
-<PRE>   BUFFERSIZE <VAR>size</VAR>[{<B>k</B> | <B>K</B> | <B>m</B> | <B>M</B> | <B>g</B> | <B>G</B>}]
-   
-</PRE>
-<P>where<VAR> size</VAR> specifies the amount of memory the Tape Coordinator
-allocates to use as a buffer during both dump and restore operations.
-The default unit is bytes, but use <B>k</B> or <B>K</B> to specify
-kilobytes, <B>m</B> or <B>M</B> for megabytes, and <B>g</B> or
-<B>G</B> for gigabytes. There is no space between the
-<VAR>size</VAR>value and the units letter.
-<P>By default, the Tape Coordinator uses a 16 KB buffer during dump
-operations. As it receives volume data from the Volume Server, the Tape
-Coordinator gathers 16 KB of data in the buffer before transferring the entire
-16 KB to the tape device or backup data file. Similarly, during a
-restore operation the Tape Coordinator by default buffers 32 KB of data from
-the tape device or backup data file before transferring the entire 32 KB to
-the Volume Server for restoration into the file system. Buffering makes
-the volume of data flowing to and from a tape device more even and so promotes
-tape streaming, which is the most efficient way for a tape device to
-operate.
-<P>In a normal network configuration, the default buffer sizes are usually
-large enough to promote tape streaming. If the network between the Tape
-Coordinator machine and file server machines is slow, it can help to increase
-the buffer size.
-<A NAME="IDX3908"></A>
-<P><B>The FILE Instruction</B>
-<P>The <B>FILE</B> instruction takes a boolean value as its argument, in
-the following format:
-<PRE>   FILE {<B>NO</B> | <B>YES</B>}
-   
-</PRE>
-<P>When the value is <B>NO</B>, the Tape Coordinator writes to a tape
-device during a dump operation and reads from one during a restore
-operation. This is the default behavior if the <B>FILE</B>
-instruction does not appear in the configuration file.
-<P>When the value is <B>YES</B>, the Tape Coordinator writes volume data
-to a backup data file on the local disk during a dump operation and reads
-volume data from a file during a restore operation. If the file does
-not exist when the Tape Coordinator attempts to access it to write a dump, the
-Tape Coordinator creates it. For a restore operation to succeed, the
-file must exist and contain volume data previously written to it by a
-<B>backup dump</B> operation.
-<P>When the value is <B>YES</B>, the backup data file's complete
-pathname must appear (instead of a tape drive device name) in the third field
-of the corresponding port offset entry in the local
-<B>/usr/afs/backup/tapeconfig</B> file. If the field instead refers
-to a tape device, dump operations appear to succeed but are
-inoperative. It is not possible to restore data that was accidently
-dumped to a tape device while the <B>FILE</B> instruction was set to
-<B>YES</B>. (In the same way, if the <B>FILE</B> instruction is
-set to <B>NO</B>, the <B>tapeconfig</B> entry must refer to an actual
-tape device.)
-<P>Rather than put an actual file pathname in the third field of the
-<B>tapeconfig</B> file, however, the recommended configuration is to
-create a symbolic link in the <B>/dev</B> directory that points to the
-actual file pathname, and record the symbolic link in this field. This
-configuration has a couple of advantages:
-<UL>
-<P><LI>It makes the <VAR>device_name</VAR> portion of the
-<B>CFG_</B><VAR>device_name</VAR>, <B>TE_</B><VAR>device_name</VAR>, and
-<B>TL_</B><VAR>device_name</VAR> names as short as possible. Because
-the symbolic link is in the <B>/dev</B> directory as though it were a tape
-device, the device configuration file's name is constructed by stripping
-off the entire <B>/dev/</B> prefix, instead of just the initial
-slash. If, for example, the symbolic link is called
-<B>/dev/FILE</B>, the device configuration file name is
-<B>CFG_FILE</B>, whereas if the actual pathname <B>/var/tmp/FILE</B>
-appears in the <B>tapeconfig</B> file, the file's name must be
-<B>CFG_var_tmp_FILE</B>.
-<P><LI>It provides for a more graceful, and potentially automated, recovery if
-the Tape Coordinator cannot write a complete dump into the backup data file
-(because the partition housing the backup data file becomes full, for
-example). The Tape Coordinator's reaction to this problem is to
-invoke the <B>MOUNT</B> script, or to prompt the operator if the
-<B>MOUNT</B> instruction does not appear in the configuration file.
-<UL>
-<P><LI>If there is a <B>MOUNT</B> routine, the operator can prepare for this
-situation by adding a subroutine that changes the symbolic link to point to
-another backup data file on a partition where there is space available.
-<P><LI>If there is no <B>MOUNT</B> instruction, the prompt enables the
-operator manually to change the symbolic link to point to another backup data
-file, then press &lt;<B>Return</B>> to signal that the Tape Coordinator
-can continue the operation.
-</UL>
-</UL>
-<P>If the third field in the <B>tapeconfig</B> file names the actual file,
-there is no way to recover from exhausting the space on the partition that
-houses the backup data file. It is not possible to change the
-<B>tapeconfig</B> file in the middle of an operation.
-<P>When writing to a backup data file, the Tape Coordinator writes data at 16
-KB offsets. If a given block of data (such as the marker that signals
-the beginning or end of a volume) does not fill the entire 16 KB, the Tape
-Coordinator still skips to the next offset before writing the next
-block. In the output of a <B>backup dumpinfo</B> command issued
-with the <B>-id</B> option, the value in the <TT>Pos</TT> column is the
-ordinal of the 16-KB offset at which the volume data begins, and so is not
-generally only one higher than the position number on the previous line, as it
-is for dumps to tape.
-<A NAME="IDX3909"></A>
-<P><B>The MOUNT Instruction</B>
-<P>The <B>MOUNT</B> instruction takes a pathname as its argument, in the
-following format:
-<PRE>   
-   MOUNT <VAR>filename</VAR>
-   
-</PRE>
-<P>The referenced executable file must reside on the local disk and contain a
-shell script or program that directs an automated tape device, such as a
-jukebox or stacker, to mount a tape (insert it into the tape reader).
-The operator must write the routine to invoke the mount command specified by
-the device's manufacturer; AFS does not include any scripts,
-although an example appears in the following <B>Examples</B>
-section. The script or program inherits the Tape Coordinator's AFS
-authentication status.
-<P>When the Tape Coordinator needs to mount a tape, it checks the
-configuration file for a <B>MOUNT</B> instruction. If there is no
-<B>MOUNT</B> instruction, the Tape Coordinator prompts the operator to
-insert a tape before it attempts to open the tape device. If there is a
-<B>MOUNT</B> instruction, the Tape Coordinator executes the routine in the
-referenced file. The routine invoked by the <B>MOUNT</B>
-instruction inherits the local identity (UNIX UID) and AFS tokens of the
-<B>butc</B> command's issuer.
-<P>There is an exception to this sequence: if the <B>AUTOQUERY
-NO</B> instruction appears in the configuration file, or the
-<B>-noautoquery</B> flag was included on the <B>butc</B> command, then
-the Tape Coordinator assumes that the operator has already inserted the first
-tape needed for a given operation. It attempts to read the tape
-immediately, and only checks for the <B>MOUNT</B> instruction or prompts
-the operator if the tape is missing or is not the required one.
-<P>When the Tape Coordinator invokes the routine indicated by the
-<B>MOUNT</B> instruction, it passes the following parameters to the
-routine in the indicated order:
-<OL TYPE=1>
-<P><LI>The tape device or backup data file's pathname, as recorded in the
-<B>/usr/afs/backup/tapeconfig</B> file.
-<P><LI>The tape operation, which (except for the exceptions noted in the
-following list) matches the <B>backup</B> command operation code used to
-initiate the operation: 
-<UL>
-<P><LI><B>appenddump</B> (when a <B>backup dump</B> command includes the
-<B>-append</B> flag)
-<P><LI><B>dump</B> (when a <B>backup dump</B> command does not include
-the <B>-append</B> flag)
-<P><LI><B>labeltape</B>
-<P><LI><B>readlabel</B>
-<P><LI><B>restore</B> (for a <B>backup diskrestore</B>, <B>backup
-volrestore</B>, or <B>backup volsetrestore</B> command)
-<P><LI><B>restoredb</B>
-<P><LI><B>savedb</B>
-<P><LI><B>scantape</B>
-</UL>
-<P><LI>The number of times the Tape Coordinator has attempted to open the tape
-device or backup data file. If the open attempt returns an error, the
-Tape Coordinator increments this value by one and again invokes the
-<B>MOUNT</B> instruction.
-<P><LI>The tape name. For some operations, the Tape Coordinator passes the
-string <TT>none</TT>, because it does not know the tape name (when running
-the <B>backup scantape</B> or <B>backup readlabel</B>, for example),
-or because the tape does not necessarily have a name (when running the
-<B>backup labeltape</B> command, for example).
-<P><LI>The tape ID recorded in the Backup Database. As with the tape name,
-the Backup System passes the string <TT>none</TT> for operations where it
-does not know the tape ID or the tape does not necessarily have an ID.
-</OL>
-<P>The routine invoked by the <B>MOUNT</B> instruction must return an exit
-code to the Tape Coordinator:
-<UL>
-<P><LI>Code <B>0</B> (zero) indicates that the routine successfully mounted
-the tape. The Tape Coordinator continues the backup operation.
-If the routine invoked by the <B>MOUNT</B> instruction does not return
-this exit code, the Tape Coordinator never calls the <B>UNMOUNT</B>
-instruction.
-<P><LI>Code <B>1</B> (one) indicates that the routine failed to mount the
-tape. The Tape Coordinator terminates the operation.
-<P><LI>Any other code indicates that the routine was not able to access the
-correct tape. The Tape Coordinator prompts the operator to insert the
-correct tape.
-</UL>
-<P>If the <B>backup</B> command was issued in interactive mode and the
-operator issues the <B>(backup) kill</B> command while the
-<B>MOUNT</B> routine is running, the Tape Coordinator passes the
-termination signal to the routine; the entire operation
-terminates.
-<A NAME="IDX3910"></A>
-<P><B>The NAME_CHECK Instruction</B>
-<P>The <B>NAME_CHECK</B> instruction takes a boolean value as its
-argument, in the following format:
-<PRE>   NAME_CHECK {<B>YES</B> | <B>NO</B>}
-   
-</PRE>
-<P>When the value is <B>YES</B> and the tape does not have a permanent
-name, the Tape Coordinator checks the AFS tape name when dumping a volume in
-response to the <B>backup dump</B> command. The AFS tape name must
-be <TT>&lt;NULL></TT> or match the tape name that the <B>backup dump</B>
-operation assigns based on the volume set and dump level names. This is
-the default behavior if the <B>NAME_CHECK</B> instruction does not appear
-in the configuration file.
-<P>When the value is <B>NO</B>, the Tape Coordinator does not check the
-AFS tape name before writing to the tape.
-<P>The Tape Coordinator always checks that all dumps on the tape are expired,
-and refuses to write to a tape that contains unexpired dumps.
-<A NAME="IDX3911"></A>
-<P><B>The UNMOUNT Instruction</B>
-<P>The <B>UNMOUNT</B> instruction takes a pathname as its argument, in the
-following format:
-<PRE>   UNMOUNT <VAR>filename</VAR>
-   
-</PRE>
-<P>The referenced executable file must reside on the local disk and contain a
-shell script or program that directs an automated tape device, such as a
-jukebox or stacker, to unmount a tape (remove it from the tape reader).
-The operator must write the routine to invoke the unmount command specified by
-the device's manufacturer; AFS does not include any scripts,
-although an example appears in the following <B>Examples</B>
-section. The script or program inherits the Tape Coordinator's AFS
-authentication status.
-<P>After closing a tape device, the Tape Coordinator checks the configuration
-file for an <B>UNMOUNT</B> instruction, whether or not the
-<B>close</B> operation succeeds. If there is no <B>UNMOUNT</B>
-instruction, the Tape Coordinator takes no action, in which case the operator
-must take the action necessary to remove the current tape from the drive
-before another can be inserted. If there is an <B>UNMOUNT</B>
-instruction, the Tape Coordinator executes the referenced file. It
-invokes the routine only once, passing in the following parameters:
-<UL>
-<P><LI>The tape device pathname (as specified in the
-<B>/usr/afs/backup/tapeconfig</B> file)
-<P><LI>The tape operation (always <B>unmount</B>)
-</UL>
-<P><STRONG>Privilege Required</STRONG>
-<P>The file is protected by UNIX mode bits. Creating the file requires
-the <B>w</B> (<B>write</B>) and <B>x</B> (<B>execute</B>)
-permissions on the <B>/usr/afs/backup</B> directory. Editing the
-file requires the <B>w</B> (<B>write</B>) permission on the
-file.
-<P><STRONG>Examples</STRONG>
-<P>The following example configuration files demonstrate one way to structure
-a configuration file for a stacker or backup dump file. The examples
-are not necessarily appropriate for a specific cell; if using them as
-models, be sure to adapt them to the cell's needs and equipment.
-<P><B>Example</B> <B>CFG_</B><VAR>device_name</VAR> <B>File for
-Stackers</B>
-<P>In this example, the administrator creates the following entry for a tape
-stacker called <B>stacker0.1</B> in the
-<B>/usr/afs/backup/tapeconfig</B> file. It has port offset
-0.
-<PRE>   2G   5K   /dev/stacker0.1   0
-   
-</PRE>
-<P>The administrator includes the following five lines in the
-<B>/usr/afs/backup/CFG_stacker0.1</B> file. To review the
-meaning of each instruction, see the preceding <B>Description</B>
-section.
-<PRE>   MOUNT /usr/afs/backup/stacker0.1
-   UNMOUNT /usr/afs/backup/stacker0.1
-   AUTOQUERY NO
-   ASK NO
-   NAME_CHECK NO
-   
-</PRE>
-<P>Finally, the administrator writes the following executable routine in the
-<B>/usr/afs/backup/stacker0.1</B> file referenced by the
-<B>MOUNT</B> and <B>UNMOUNT</B> instructions in the
-<B>CFG_stacker0.1</B> file.
-<PRE>   #! /bin/csh -f
-     
-   set devicefile = $1
-   set operation = $2
-   set tries = $3
-   set tapename = $4
-   set tapeid = $5
-     
-   set exit_continue = 0
-   set exit_abort = 1
-   set exit_interactive = 2
-    
-   #--------------------------------------------
-     
-   if (${tries} > 1) then
-      echo "Too many tries"
-      exit ${exit_interactive}
-   endif
-     
-   if (${operation} == "unmount") then
-      echo "UnMount: Will leave tape in drive"
-      exit ${exit_continue}
-   endif
-     
-   if ((${operation} == "dump")     |\
-       (${operation} == "appenddump")     |\
-       (${operation} == "savedb"))  then
-     
-       stackerCmd_NextTape ${devicefile}
-       if (${status} != 0)exit${exit_interactive}
-       echo "Will continue"
-       exit ${exit_continue}
-   endif
-     
-   if ((${operation} == "labeltape")    |\
-       (${operation} == "readlabel")) then
-      echo "Will continue"
-      exit ${exit_continue}
-   endif
-     
-   echo "Prompt for tape"
-   exit ${exit_interactive}
-   
-</PRE>
-<P>This routine uses two of the parameters passed to it by the Backup
-System: <TT>tries</TT> and <TT>operation</TT>. It follows the
-recommended practice of prompting for a tape if the value of the
-<TT>tries</TT> parameter exceeds one, because that implies that the stacker
-is out of tapes.
-<P>For a <B>backup dump</B> or <B>backup savedb</B> operation, the
-routine calls the example <B>stackerCmd_NextTape</B> function provided by
-the stacker's manufacturer. Note that the final lines in the file
-return the exit code that prompts the operator to insert a tape; these
-lines are invoked when either the stacker cannot load a tape or a the
-operation being performed is not one of those explicitly mentioned in the file
-(such as a restore operation).
-<P><B>Example CFG_</B><VAR>device_name</VAR> <B>File for Dumping to a
-Backup Data File</B>
-<P>In this example, the administrator creates the following entry for a backup
-data file called <B>HSM_device</B> in the
-<B>/usr/afs/backup/tapeconfig</B> file. It has port offset
-20.
-<PRE>   1G   0K   /dev/HSM_device   20
-   
-</PRE>
-<P>The administrator includes the following lines in the
-<B>/usr/afs/backup/CFG_HSM_device</B> file. To review the meaning
-of each instruction, see the preceding <B>Description</B> section.
-<PRE>   MOUNT /usr/afs/backup/file
-   FILE YES
-   ASK NO
-   
-</PRE>
-<P>Finally, the administrator writes the following executable routine in the
-<B>/usr/afs/backup/file</B> file referenced by the <B>MOUNT</B>
-instruction in the <B>CFG_HSM_device</B> file, to control how the Tape
-Coordinator handles the file.
-<PRE>   #! /bin/csh -f
-   set devicefile = $1
-   set operation = $2
-   set tries = $3
-   set tapename = $4
-   set tapeid = $5
-     
-   set exit_continue = 0
-   set exit_abort = 1
-   set exit_interactive = 2
-     
-   #--------------------------------------------
-     
-   if (${tries} > 1) then
-      echo "Too many tries"
-      exit ${exit_interactive}
-   endif
-     
-   if (${operation} == "labeltape") then
-      echo "Won't label a tape/file"
-      exit ${exit_abort}
-   endif
-     
-   if ((${operation} == "dump")   |\
-       (${operation} == "appenddump")   |\
-       (${operation} == "restore")   |\
-       (${operation} == "savedb")    |\
-       (${operation} == "restoredb")) then
-     
-      /bin/rm -f ${devicefile}
-      /bin/ln -s /hsm/${tapename}_${tapeid} ${devicefile}
-      if (${status} != 0) exit ${exit_abort}
-   endif
-     
-   exit ${exit_continue}
-   
-</PRE>
-<P>Like the example routine for a tape stacker, this routine uses the
-<TT>tries</TT> and <TT>operation</TT> parameters passed to it by the
-Backup System. The <TT>tries</TT> parameter tracks how many times the
-Tape Coordinator has attempted to access the file. A value greater than
-one indicates that the Tape Coordinator cannot access it, and the routine
-returns exit code 2 (<TT>exit_interactive</TT>), which results in a prompt
-for the operator to load a tape. The operator can use this opportunity
-to change the name of the backup data file specified in the
-<B>tapeconfig</B> file.
-<P>The primary function of this routine is to establish a link between the
-device file and the file to be dumped or restored. When the Tape
-Coordinator is executing a <B>backup dump</B>, <B>backup restore</B>,
-<B>backup savedb</B>, or <B>backup restoredb</B> operation, the
-routine invokes the UNIX <B>ln -s</B> command to create a symbolic link
-from the backup data file named in the <B>tapeconfig</B> file to the
-actual file to use (this is the recommended method). It uses the value
-of the <TT>tapename</TT> and <TT>tapeid</TT> parameters to construct the
-file name.
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf050.htm#HDRTAPECONFIG">tapeconfig</A>
-<P><A HREF="auarf072.htm#HDRBK_DISKRESTORE">backup diskrestore</A>
-<P><A HREF="auarf073.htm#HDRBK_DUMP">backup dump</A>
-<P><A HREF="auarf085.htm#HDRBK_RESTOREDB">backup restoredb</A>
-<P><A HREF="auarf086.htm#HDRBK_SAVEDB">backup savedb</A>
-<P><A HREF="auarf091.htm#HDRBK_VOLRESTORE">backup volrestore</A>
-<P><A HREF="auarf092.htm#HDRBK_VOLSETRESTORE">backup volsetrestore</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="auarf017.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="auarf019.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>
diff --git a/doc/html/AdminReference/auarf019.htm b/doc/html/AdminReference/auarf019.htm
deleted file mode 100644 (file)
index 6438249..0000000
+++ /dev/null
@@ -1,120 +0,0 @@
-<!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="auarf018.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="auarf020.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="HDRCLI_CSDB" HREF="auarf002.htm#ToC_17">CellServDB (client version)</A></H2>
-<P><STRONG>Purpose</STRONG>
-<A NAME="IDX3912"></A>
-<A NAME="IDX3913"></A>
-<A NAME="IDX3914"></A>
-<A NAME="IDX3915"></A>
-<A NAME="IDX3916"></A>
-<A NAME="IDX3917"></A>
-<A NAME="IDX3918"></A>
-<A NAME="IDX3919"></A>
-<P>Lists the database server machines in all cells accessible from the machine
-<P><STRONG>Description</STRONG>
-<P>The client version of the <B>CellServDB</B> file lists the database
-server machines in the local cell and any foreign cell that is to be
-accessible from the local client machine. Database server machines run
-the Authentication Server, Backup Server, Protection Server, and Volume
-Location (VL) Server (the <B>kaserver</B>, <B>buserver</B>,
-<B>ptserver</B>, and <B>vlserver</B>) processes, which maintain the
-cell's administrative AFS databases.
-<P>The Cache Manager and other processes running on a client machine use the
-list of a cell's database server machines when performing several common
-functions, including:
-<UL>
-<P><LI>Fetching files. The Cache Manager contacts the VL Server to learn
-the location of the volume containing a requested file or directory.
-<P><LI>Authenticating users. Client-side authentication programs (such as
-an AFS-modified login utility or the <B>klog</B> command interpreter)
-contact the Authentication Server to obtain a server ticket, which the AFS
-server processes accept as proof that the user is authenticated.
-<P><LI>Creating protection groups. The <B>pts</B> command interpreter
-contacts the Protection Server when users create protection groups or request
-information from the Protection Database.
-</UL>
-<P>The Cache Manager reads the <B>CellServDB</B> file into kernel memory
-as it initializes, and not again until the machine next reboots. To
-enable users on the local machine to continue accessing the cell correctly,
-update the file whenever a database server machine is added to or removed from
-a cell. To update the kernel-resident list of database server machines
-without rebooting, use the <B>fs newcell</B> command.
-<P>The <B>CellServDB</B> file is in ASCII format and must reside in the
-<B>/usr/vice/etc</B> directory on each AFS client machine. Use a
-text editor to create and maintain it. Each cell's entry must have
-the following format:
-<UL>
-<P><LI>The first line begins at the left margin with the greater-than character
-(<B>></B>), followed immediately by the cell's name without an
-intervening space. Optionally, a comment can follow any number of
-spaces and a number sign (<B>#</B>), perhaps to identify the organization
-associated with the cell.
-<P><LI>Each subsequent line in the entry identifies one of the cell's
-database server machines, with the indicated information in order: 
-<UL>
-<P><LI>The database server machine's IP address in dotted-decimal
-format.
-<P><LI>One or more spaces.
-<P><LI>A number sign (<B>#</B>), followed by the machine's fully
-qualified hostname without an intervening space. This number sign does
-not indicate that the hostname is a comment. It is a required
-field.
-</UL>
-</UL>
-<P>No extra blank lines or newline characters are allowed in the file, even
-after the last entry. Their presence can prevent the Cache Manager from
-reading the file into kernel memory, resulting in an error message.
-<P>The AFS Product Support group maintains a list of the database server
-machines in all cells that have registered themselves as receptive to access
-from foreign cells. When a cell's administrators change its
-database server machines, it is customary to register the change with the AFS
-Product Support group for inclusion in this file. The file conforms to
-the required <B>CellServDB</B> format, and so is a suitable basis for the
-<B>CellServDB</B> file on a client machine. Contact the AFS Product
-Support group for directions on accessing the file.
-<P>The client version of the <B>CellServDB</B> file is distinct from the
-server version, which resides in the <B>/usr/afs/etc</B> directory on each
-AFS server machine. The client version lists the database server
-machines in every AFS cell that the cell administrator wants the
-machine's users to be able to access, whereas the server version lists
-only the local cell's database server machines.
-<P><STRONG>Examples</STRONG>
-<P>The following example shows entries for two cells in a client
-<B>CellServDB</B> file and illustrates the required format.
-<PRE>   >abc.com        # ABC Corporation
-   192.12.105.2                #db1.abc.com
-   192.12.105.3                #db2.abc.com
-   192.12.107.3                #db3.abc.com
-   >test.abc.com   # ABC Corporation Test Cell
-   192.12.108.57        #testdb1.abc.com
-   192.12.108.55        #testdb2.abc.com
-   
-</PRE>
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf020.htm#HDRSV_CSDB">CellServDB (server version)</A>
-<P><A HREF="auarf154.htm#HDRFS_NEWCELL">fs newcell</A>
-<P><A HREF="auarf200.htm#HDRKLOG">klog</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="auarf018.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="auarf020.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>
diff --git a/doc/html/AdminReference/auarf020.htm b/doc/html/AdminReference/auarf020.htm
deleted file mode 100644 (file)
index f627a2b..0000000
+++ /dev/null
@@ -1,91 +0,0 @@
-<!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="auarf019.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="auarf021.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="HDRSV_CSDB" HREF="auarf002.htm#ToC_18">CellServDB (server version)</A></H2>
-<P><STRONG>Purpose</STRONG>
-<A NAME="IDX3920"></A>
-<A NAME="IDX3921"></A>
-<A NAME="IDX3922"></A>
-<A NAME="IDX3923"></A>
-<A NAME="IDX3924"></A>
-<A NAME="IDX3925"></A>
-<A NAME="IDX3926"></A>
-<A NAME="IDX3927"></A>
-<P>Lists the local cell's database server machines
-<P><STRONG>Description</STRONG>
-<P>The server version of the <B>CellServDB</B> file lists the local
-cell's database server machines. These machines run the
-Authentication Server, Backup Server, Protection Server, and Volume Location
-(VL) Server (the <B>kaserver</B>, <B>buserver</B>,
-<B>ptserver</B>, and <B>vlserver</B>) processes, which maintain the
-cell's administrative AFS databases. The initial version of the
-file is created with the <B>bos setcellname</B> command during the
-installation of the cell's server machine, which is automatically
-recorded as the cell's first database server machine. When adding
-or removing database server machines, be sure to update this file
-appropriately. It must reside in the <B>/usr/afs/etc</B> directory
-on each AFS server machine.
-<P>The database server processes consult the <B>CellServDB</B> file to
-learn about their peers, with which they must maintain constant connections in
-order to coordinate replication of changes across the multiple copies of each
-database. The other AFS server processes consult the file to learn
-which machines to contact for information from the databases when they need
-it.
-<P>Although the <B>CellServDB</B> file is in ASCII format, do not use a
-text editor to alter it. Instead always use the appropriate commands
-from the <B>bos</B> command suite:
-<UL>
-<P><LI>The <B>bos addhost</B> command to add a machine to the file
-<P><LI>The <B>bos listhosts</B> command to display the list of machines from
-the file
-<P><LI>The <B>bos removehost</B> command to remove a machine from the file
-</UL>
-<P>In cells that run the United States edition of AFS and use the Update
-Server to distribute the contents of the <B>/usr/afs/etc</B> directory, it
-is customary to edit only the copy of the file stored on the system control
-machine. In cells that run the international version of AFS, edit the
-file on each server machine individually. For instructions on adding
-and removing database server machine, see the <I>IBM AFS Quick
-Beginnings</I> chapter on installing additional server machines.
-<P>The server version of the <B>CellServDB</B> file is distinct from the
-client version, which resides in the <B>/usr/vice/etc</B> directory on
-each AFS client machine. The server version lists only the local
-cell's database server machines, whereas the client version lists the
-database server machines in every AFS cell that the cell administrator wants
-the machine's users to be able to access.
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf019.htm#HDRCLI_CSDB">CellServDB (client version)</A>
-<P><A HREF="auarf094.htm#HDRBOS_ADDHOST">bos addhost</A>
-<P><A HREF="auarf106.htm#HDRBOS_LISTHOSTS">bos listhosts</A>
-<P><A HREF="auarf110.htm#HDRBOS_REMOVEHOST">bos removehost</A>
-<P><A HREF="auarf116.htm#HDRBOS_SETCELLNAME">bos setcellname</A>
-<P><A HREF="auarf125.htm#HDRBUSERVER">buserver</A>
-<P><A HREF="auarf198.htm#HDRKASERVER">kaserver</A>
-<P><A HREF="auarf227.htm#HDRPTSERVER">ptserver</A>
-<P><A HREF="auarf249.htm#HDRVLSERVER">vlserver</A>
-<P><A HREF="auarf240.htm#HDRUPCLIENT">upclient</A>
-<P><A HREF="auarf241.htm#HDRUPSERVER">upserver</A>
-<P><I>IBM AFS Quick Beginnings</I>
-<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="auarf019.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="auarf021.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>
diff --git a/doc/html/AdminReference/auarf021.htm b/doc/html/AdminReference/auarf021.htm
deleted file mode 100644 (file)
index afdfa2f..0000000
+++ /dev/null
@@ -1,57 +0,0 @@
-<!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="auarf020.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="auarf022.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="HDRFILELOG" HREF="auarf002.htm#ToC_19">FileLog</A></H2>
-<P><STRONG>Purpose</STRONG>
-<A NAME="IDX3928"></A>
-<A NAME="IDX3929"></A>
-<A NAME="IDX3930"></A>
-<P>Traces File Server operations
-<P><STRONG>Description</STRONG>
-<P>The <B>FileLog</B> file records a trace of File Server
-(<B>fileserver</B> process) operations on the local machine and describes
-any error conditions it encounters.
-<P>If the <B>FileLog</B> file does not already exist in the
-<B>/usr/afs/logs</B> directory when the File Server starts, the server
-process creates it and writes initial start-up messages to it. If there
-is an existing file, the File Server renames it to
-<B>FileLog.old</B>, overwriting the existing
-<B>FileLog.old</B> file if it exists.
-<P>The file is in ASCII format. Administrators listed in the
-<B>/usr/afs/etc/UserList</B> file can use the <B>bos getlog</B>
-command to display its contents. Alternatively, log onto the file
-server machine and use a text editor or a file display command such as the
-UNIX <B>cat</B> command. By default, the mode bits on the
-<B>FileLog</B> file grant the required <B>r</B> (<B>read</B>)
-permission to all users.
-<P>The File Server records operations only as it completes them, and cannot
-recover from failures by reviewing the file. The log contents are
-useful for administrative evaluation of process failures and other
-problems.
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf035.htm#HDRUSERLIST">UserList</A>
-<P><A HREF="auarf102.htm#HDRBOS_GETLOG">bos getlog</A>
-<P><A HREF="auarf129.htm#HDRFILESERVER">fileserver</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="auarf020.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="auarf022.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>
diff --git a/doc/html/AdminReference/auarf022.htm b/doc/html/AdminReference/auarf022.htm
deleted file mode 100644 (file)
index d7672ec..0000000
+++ /dev/null
@@ -1,49 +0,0 @@
-<!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="auarf021.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="auarf023.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="HDRFORCESALVAGE" HREF="auarf002.htm#ToC_20">FORCESALVAGE</A></H2>
-<P><STRONG>Purpose</STRONG>
-<A NAME="IDX3931"></A>
-<A NAME="IDX3932"></A>
-<A NAME="IDX3933"></A>
-<P>Forces salvage of entire partition
-<P><STRONG>Description</STRONG>
-<P>The <B>FORCESALVAGE</B> file, if present on an AFS server partition
-(that is, in a <B>/vicep</B> directory), signals that the Salvager must
-salvage the entire partition. The AFS-modified version of the
-<B>fsck</B> program creates the empty (zero-length) file when it discovers
-corruption on the partition. The Salvager removes the file when it
-completes the salvage operation.
-<P>When the File Server detects the presence of the file on a partition on
-which it is attaching volumes, it stops, detaches any volumes that are already
-attached, and exits after recording a message in the
-<B>/usr/afs/logs/FileLog</B> file. The Bos Server then invokes the
-Salvager to salvage the partition.
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf021.htm#HDRFILELOG">FileLog</A>
-<P><A HREF="auarf124.htm#HDRBOSSERVER">bosserver</A>
-<P><A HREF="auarf129.htm#HDRFILESERVER">fileserver</A>
-<P><A HREF="auarf232.htm#HDRSALVAGER">salvager</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="auarf021.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="auarf023.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>
diff --git a/doc/html/AdminReference/auarf023.htm b/doc/html/AdminReference/auarf023.htm
deleted file mode 100644 (file)
index 5a453fc..0000000
+++ /dev/null
@@ -1,73 +0,0 @@
-<!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="auarf022.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="auarf024.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="HDRKEYFILE" HREF="auarf002.htm#ToC_21">KeyFile</A></H2>
-<P><STRONG>Purpose</STRONG>
-<A NAME="IDX3934"></A>
-<A NAME="IDX3935"></A>
-<A NAME="IDX3936"></A>
-<A NAME="IDX3937"></A>
-<A NAME="IDX3938"></A>
-<A NAME="IDX3939"></A>
-<A NAME="IDX3940"></A>
-<A NAME="IDX3941"></A>
-<P>Defines AFS server encryption keys
-<P><STRONG>Description</STRONG>
-<P>The <B>KeyFile</B> file defines the server encryption keys that the AFS
-server processes running on the machine use to decrypt the tickets presented
-by clients during the mutual authentication process. AFS server
-processes perform privileged actions only for clients that possess a ticket
-encrypted with one of the keys from the file. The file must reside in
-the <B>/usr/afs/etc</B> directory on every server machine. For more
-detailed information on mutual authentication and server encryption keys, see
-the <I>IBM AFS Administration Guide</I>.
-<P>Each key has a corresponding a key version number that distinguishes it
-from the other keys. The tickets that clients present are also marked
-with a key version number to tell the server process which key to use to
-decrypt it. The <B>KeyFile</B> file must always include a key with
-the same key version number and contents as the key currently listed for the
-<B>afs</B> entry in the Authentication Database.
-<P>The <B>KeyFile</B> file is in binary format, so always use the
-appropriate commands from the <B>bos</B> command suite to administer
-it:
-<UL>
-<P><LI>The <B>bos addkey</B> command to define a new key
-<P><LI>The <B>bos listkeys</B> command to display the keys
-<P><LI>The <B>bos removekey</B> command to remove a key from the file
-</UL>
-<P>In cells that run the United States edition of AFS and use the Update
-Server to distribute the contents of the <B>/usr/afs/etc</B> directory, it
-is customary to edit only the copy of the file stored on the system control
-machine. In cells that run the international version of AFS, edit the
-file on each server machine individually.
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf095.htm#HDRBOS_ADDKEY">bos addkey</A>
-<P><A HREF="auarf107.htm#HDRBOS_LISTKEYS">bos listkeys</A>
-<P><A HREF="auarf111.htm#HDRBOS_REMOVEKEY">bos removekey</A>
-<P><A HREF="auarf194.htm#HDRKAS_SETPASSWORD">kas setpassword</A>
-<P><A HREF="auarf240.htm#HDRUPCLIENT">upclient</A>
-<P><A HREF="auarf241.htm#HDRUPSERVER">upserver</A>
-<P><I>IBM AFS Administration Guide</I>
-<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="auarf022.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="auarf024.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>
diff --git a/doc/html/AdminReference/auarf024.htm b/doc/html/AdminReference/auarf024.htm
deleted file mode 100644 (file)
index cbf4430..0000000
+++ /dev/null
@@ -1,70 +0,0 @@
-<!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="auarf023.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="auarf025.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="HDRCLI_NETINFO" HREF="auarf002.htm#ToC_22">NetInfo (client version)</A></H2>
-<P><STRONG>Purpose</STRONG>
-<A NAME="IDX3942"></A>
-<A NAME="IDX3943"></A>
-<A NAME="IDX3944"></A>
-<A NAME="IDX3945"></A>
-<A NAME="IDX3946"></A>
-<A NAME="IDX3947"></A>
-<P>Defines client machine interfaces to register with the File Server
-<P><STRONG>Description</STRONG>
-<P>The <B>NetInfo</B> file lists the IP addresses of one or more of the
-local machine's network interfaces. If it exists in the
-<B>/usr/vice/etc</B> directory when the Cache Manager initializes, the
-Cache Manager uses its contents as the basis for a list of local
-interfaces. Otherwise, the Cache Manager uses the list of interfaces
-configured with the operating system. It then removes from the list any
-addresses that appear in the <B>/usr/vice/etc/NetRestrict</B> file, if it
-exists. The Cache Manager records the resulting list in kernel
-memory. The first time it establishes a connection to a File Server, it
-registers the list with the File Server.
-<P>The File Server uses the addresses when it initiates a remote procedure
-call (RPC) to the Cache Manager (as opposed to responding to an RPC sent by
-the Cache Manager). There are two common circumstances in which the
-File Server initiates RPCs: when it breaks callbacks and when it pings
-the client machine to verify that the Cache Manager is still
-accessible.
-<P>The <B>NetInfo</B> file is in ASCII format. One of the
-machine's IP addresses appears on each line, in dotted decimal
-format. The File Server initially uses the address that appears first
-in the list. The order of the remaining addresses is not
-significant: if an RPC to the first interface fails, the File Server
-simultaneously sends RPCs to all of the other interfaces in the list.
-Whichever interface replies first is the one to which the File Server then
-sends pings and RPCs to break callbacks.
-<P>To prohibit the Cache Manager absolutely from using one or more addresses,
-list them in the <B>NetRestrict</B> file. To display the addresses
-the Cache Manager is currently registering with File Servers, use the <B>fs
-getclientaddrs</B> command. To replace the current list of interfaces
-with a new one between reboots of the client machine, use the <B>fs
-setclientaddrs</B> command.
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf026.htm#HDRCLI_NETRESTRICT">NetRestrict (client version)</A>
-<P><A HREF="auarf145.htm#HDRFS_GETCLIENTADDRS">fs getclientaddrs</A>
-<P><A HREF="auarf160.htm#HDRFS_SETCLIENTADDRS">fs setclientaddrs</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="auarf023.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="auarf025.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>
diff --git a/doc/html/AdminReference/auarf025.htm b/doc/html/AdminReference/auarf025.htm
deleted file mode 100644 (file)
index 8cbc6cd..0000000
+++ /dev/null
@@ -1,67 +0,0 @@
-<!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="auarf024.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="auarf026.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="HDRSV_NETINFO" HREF="auarf002.htm#ToC_23">NetInfo (server version)</A></H2>
-<P><STRONG>Purpose</STRONG>
-<A NAME="IDX3948"></A>
-<A NAME="IDX3949"></A>
-<A NAME="IDX3950"></A>
-<A NAME="IDX3951"></A>
-<A NAME="IDX3952"></A>
-<P>Defines interfaces that File Server registers in VLDB and Ubik uses for
-database server machines
-<P><STRONG>Description</STRONG>
-<P>The <B>NetInfo</B> file, if present in the <B>/usr/afs/local</B>
-directory, defines the following:
-<UL>
-<P><LI>On a file server machine, the local interfaces that the File Server
-(<B>fileserver</B> process) can register in the Volume Location Database
-(VLDB) at initialization time
-<P><LI>On a database server machine, the local interfaces that the Ubik database
-synchronization library uses when communicating with the database server
-processes running on other database server machines
-</UL>
-<P>If the <B>NetInfo</B> file exists when the File Server initializes, the
-File Server uses its contents as the basis for a list of interfaces to
-register in the VLDB. Otherwise, it uses the list of network interfaces
-configured with the operating system. It then removes from the list any
-addresses that appear in the <B>/usr/vice/etc/NetRestrict</B> file, if it
-exists. The File Server records the resulting list in the
-<B>/usr/afs/local/sysid</B> file and registers the interfaces in the
-VLDB. The database server processes use a similar procedure when
-initializing, to determine which interfaces to use for communication with the
-peer processes on other database machines in the cell.
-<P>The <B>NetInfo</B> file is in ASCII format. One of the
-machine's IP addresses appears on each line, in dotted decimal
-format. The order of the addresses is not significant.
-<P>To display the File Server interface addresses registered in the VLDB, use
-the <B>vos listaddrs</B> command.
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf027.htm#HDRSV_NETRESTRICT">NetRestrict (server version)</A>
-<P><A HREF="auarf049.htm#HDRSYSID">sysid</A>
-<P><A HREF="auarf051.htm#HDRVLDBDB">vldb.DB0 and vldb.DBSYS1</A>
-<P><A HREF="auarf129.htm#HDRFILESERVER">fileserver</A>
-<P><A HREF="auarf263.htm#HDRVOS_LISTADDRS">vos listaddrs</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="auarf024.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="auarf026.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>
diff --git a/doc/html/AdminReference/auarf026.htm b/doc/html/AdminReference/auarf026.htm
deleted file mode 100644 (file)
index 2c65fc7..0000000
+++ /dev/null
@@ -1,60 +0,0 @@
-<!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="auarf025.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="auarf027.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="HDRCLI_NETRESTRICT" HREF="auarf002.htm#ToC_24">NetRestrict (client version)</A></H2>
-<P><STRONG>Purpose</STRONG>
-<A NAME="IDX3953"></A>
-<A NAME="IDX3954"></A>
-<A NAME="IDX3955"></A>
-<A NAME="IDX3956"></A>
-<A NAME="IDX3957"></A>
-<A NAME="IDX3958"></A>
-<P>Defines client interfaces not to register with the File Server
-<P><STRONG>Description</STRONG>
-<P>The <B>NetRestrict</B> file, if present in a client machine's
-<B>/usr/vice/etc</B> directory, defines the IP addresses of the interfaces
-that the local Cache Manager does not register with a File Server when first
-establishing a connection to it. For an explanation of how the File
-Server uses the registered interfaces, see the reference page for the client
-version of the <B>NetInfo</B> file.
-<P>As it initializes, the Cache Manager constructs a list of interfaces to
-register, from the <B>/usr/vice/etc/NetInfo</B> file if it exists, or from
-the list of interfaces configured with the operating system otherwise.
-The Cache Manager then removes from the list any addresses that appear in the
-<B>NetRestrict</B> file, if it exists. The Cache Manager records
-the resulting list in kernel memory.
-<P>The <B>NetRestrict</B> file is in ASCII format. One IP address
-appears on each line, in dotted decimal format. The order of the
-addresses is not significant. The value <B>255</B> is a wildcard
-that represents all possible addresses in that field. For example, the
-value <B>192.12.105.255</B> indicates that the Cache
-Manager does not register any of the addresses in the
-<B>192.12.105</B> subnet.
-<P>To display the addresses the Cache Manager is currently registering with
-File Servers, use the <B>fs getclientaddrs</B> command.
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf024.htm#HDRCLI_NETINFO">NetInfo (client version)</A>
-<P><A HREF="auarf145.htm#HDRFS_GETCLIENTADDRS">fs getclientaddrs</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="auarf025.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="auarf027.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>
diff --git a/doc/html/AdminReference/auarf027.htm b/doc/html/AdminReference/auarf027.htm
deleted file mode 100644 (file)
index d808177..0000000
+++ /dev/null
@@ -1,71 +0,0 @@
-<!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="auarf026.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="auarf028.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="HDRSV_NETRESTRICT" HREF="auarf002.htm#ToC_25">NetRestrict (server version)</A></H2>
-<P><STRONG>Purpose</STRONG>
-<A NAME="IDX3959"></A>
-<A NAME="IDX3960"></A>
-<A NAME="IDX3961"></A>
-<A NAME="IDX3962"></A>
-<A NAME="IDX3963"></A>
-<P>Defines interfaces that File Server does not register in VLDB and Ubik does
-not use for database server machines
-<P><STRONG>Description</STRONG>
-<P>The <B>NetRestrict</B> file, if present in the
-<B>/usr/afs/local</B> directory, defines the following:
-<UL>
-<P><LI>On a file server machine, the local interfaces that the File Server
-(<B>fileserver</B> process) does not register in the Volume Location
-Database (VLDB) at initialization time
-<P><LI>On a database server machine, the local interfaces that the Ubik
-synchronization library does not use when communicating with the database
-server processes running on other database server machines
-</UL>
-<P>As it initializes, the File Server constructs a list of interfaces to
-register, from the <B>/usr/afs/local/NetInfo</B> file if it exists, or
-from the list of interfaces configured with the operating system
-otherwise. The File Server then removes from the list any addresses
-that appear in the <B>NetRestrict</B> file, if it exists. The File
-Server records the resulting list in the <B>/usr/afs/local/sysid</B> file
-and registers the interfaces in the VLDB. The database server processes
-use a similar procedure when initializing, to determine which interfaces to
-use for communication with the peer processes on other database machines in
-the cell.
-<P>The <B>NetRestrict</B> file is in ASCII format. One IP address
-appears on each line, in dotted decimal format. The order of the
-addresses is not significant. The value <B>255</B> is a wildcard
-that represents all possible addresses in that field. For example, the
-value <B>192.12.105.255</B> indicates that the Cache
-Manager does not register any of the addresses in the
-<B>192.12.105</B> subnet.
-<P>To display the File Server interface addresses registered in the VLDB, use
-the <B>vos listaddrs</B> command.
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf025.htm#HDRSV_NETINFO">NetInfo (server version)</A>
-<P><A HREF="auarf049.htm#HDRSYSID">sysid</A>
-<P><A HREF="auarf051.htm#HDRVLDBDB">vldb.DB0 and vldb.DBSYS1</A>
-<P><A HREF="auarf129.htm#HDRFILESERVER">fileserver</A>
-<P><A HREF="auarf263.htm#HDRVOS_LISTADDRS">vos listaddrs</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="auarf026.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="auarf028.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>
diff --git a/doc/html/AdminReference/auarf028.htm b/doc/html/AdminReference/auarf028.htm
deleted file mode 100644 (file)
index a8b1534..0000000
+++ /dev/null
@@ -1,67 +0,0 @@
-<!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="auarf027.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="auarf029.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="HDRNOAUTH" HREF="auarf002.htm#ToC_26">NoAuth</A></H2>
-<P><STRONG>Purpose</STRONG>
-<A NAME="IDX3964"></A>
-<A NAME="IDX3965"></A>
-<A NAME="IDX3966"></A>
-<P>Disables authorization checking
-<P><STRONG>Description</STRONG>
-<P>The <B>NoAuth</B> file, if present in a server machine's
-<B>/usr/afs/local</B> directory, indicates to the AFS server processes
-running on the machine that it is not necessary to perform authorization
-checking. They perform any action for any user who logs into the
-machine's local file system or issues a remote command that affects the
-machine's AFS server functioning, such as commands from the AFS command
-suites. Because failure to check authorization exposes the
-machine's AFS server functionality to attack, there are normally only two
-circumstances in which the file is present:
-<UL>
-<P><LI>During installation of the machine, as instructed in the <I>IBM AFS
-Quick Beginnings</I>
-<P><LI>During correction of a server encryption key emergency, as discussed in
-the <I>IBM AFS Administration Guide</I>
-</UL>
-<P>In all other circumstances, the absence of the file means that the AFS
-server processes perform authorization checking, verifying that the issuer of
-a command has the required privilege.
-<P>Create the file in one of the following ways:
-<UL>
-<P><LI>By issuing the <B>bosserver</B> initialization command with the
-<B>-noauth</B> flag, if the Basic OverSeer (BOS) Server is not already
-running
-<P><LI>By issuing the <B>bos setauth</B> command with <B>off</B> as the
-value for the <B>-authrequired</B> argument, if the BOS Server is already
-running
-</UL>
-<P>To remove the file, issue the <B>bos setauth</B> command with
-<B>on</B> as the value for the <B>-authrequired</B> argument.
-<P>The file's contents, if any, are ignored; an empty (zero-length)
-file is effective.
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf115.htm#HDRBOS_SETAUTH">bos setauth</A>
-<P><A HREF="auarf124.htm#HDRBOSSERVER">bosserver</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="auarf027.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="auarf029.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>
diff --git a/doc/html/AdminReference/auarf029.htm b/doc/html/AdminReference/auarf029.htm
deleted file mode 100644 (file)
index 15d50b5..0000000
+++ /dev/null
@@ -1,58 +0,0 @@
-<!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="auarf028.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="auarf030.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="HDRSALVAGEFS" HREF="auarf002.htm#ToC_27">SALVAGE.fs</A></H2>
-<P><STRONG>Purpose</STRONG>
-<A NAME="IDX3967"></A>
-<A NAME="IDX3968"></A>
-<A NAME="IDX3969"></A>
-<A NAME="IDX3970"></A>
-<A NAME="IDX3971"></A>
-<P>Triggers salvaging of AFS server partitions
-<P><STRONG>Description</STRONG>
-<P>The <B>SALVAGE.fs</B> file, if present in a file server
-machine's <B>/usr/afs/local</B> directory, indicates to the Basic
-OverSeer (BOS) Server (<B>bosserver</B> process) that it must invoke the
-Salvager (<B>salvager</B> process) during recovery from a failure of the
-File Server (<B>fileserver</B> process).
-<P>The BOS Server creates the zero-length file each time it starts or restarts
-the <B>fs</B> process. When the File Server exits normally (for
-example, in response to the <B>bos shutdown</B> or <B>bos stop</B>
-command), the BOS Server removes the file. However, if the File Server
-exits unexpectedly, the file remains in the <B>/usr/afs/local</B>
-directory as a signal that the BOS Server must invoke the Salvager process to
-repair any file system inconsistencies possibly introduced during the failure,
-before restarting the File Server and Volume Server processes.
-<P>Do not create or remove this file. To invoke the Salvager process
-directly, use the <B>bos salvage</B> command or log onto the file server
-machine as the local superuser <B>root</B> and issue the
-<B>salvager</B> command.
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf114.htm#HDRBOS_SALVAGE">bos salvage</A>
-<P><A HREF="auarf124.htm#HDRBOSSERVER">bosserver</A>
-<P><A HREF="auarf129.htm#HDRFILESERVER">fileserver</A>
-<P><A HREF="auarf232.htm#HDRSALVAGER">salvager</A>
-<P><A HREF="auarf251.htm#HDRVOLSERVER">volserver</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="auarf028.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="auarf030.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>
diff --git a/doc/html/AdminReference/auarf030.htm b/doc/html/AdminReference/auarf030.htm
deleted file mode 100644 (file)
index 8568920..0000000
+++ /dev/null
@@ -1,57 +0,0 @@
-<!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="auarf029.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="auarf031.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="HDRSALVAGELOG" HREF="auarf002.htm#ToC_28">SalvageLog</A></H2>
-<P><STRONG>Purpose</STRONG>
-<A NAME="IDX3972"></A>
-<A NAME="IDX3973"></A>
-<A NAME="IDX3974"></A>
-<P>Traces Salvager operations
-<P><STRONG>Description</STRONG>
-<P>The <B>SalvageLog</B> file records a trace of Salvager
-(<B>salvager</B> process) operations on the local machine and describes
-any error conditions it encounters.
-<P>If the <B>SalvageLog</B> file does not already exist in the
-<B>/usr/afs/logs</B> directory when the Salvager starts, the process
-creates it and writes initial start-up messages to it. If there is an
-existing file, the Salvager renames is to <B>SalvageLog.old</B>,
-overwriting the existing <B>SalvageLog.old</B> file if it
-exists.
-<P>The file is in ASCII format. Administrators listed in the
-<B>/usr/afs/etc/UserList</B> file can use the <B>bos getlog</B>
-command to display its contents. Alternatively, log onto the file
-server machine and use a text editor or a file display command such as the
-UNIX <B>cat</B> command. By default, the mode bits on the
-<B>SalvageLog</B> file grant the required <B>r</B> (<B>read</B>)
-permission to all users.
-<P>The Salvager records operations only as it completes them, and cannot
-recover from failures by reviewing the file. The log contents are
-useful for administrative evaluation of process failures and other
-problems.
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf035.htm#HDRUSERLIST">UserList</A>
-<P><A HREF="auarf102.htm#HDRBOS_GETLOG">bos getlog</A>
-<P><A HREF="auarf232.htm#HDRSALVAGER">salvager</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="auarf029.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="auarf031.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>
diff --git a/doc/html/AdminReference/auarf031.htm b/doc/html/AdminReference/auarf031.htm
deleted file mode 100644 (file)
index 26304b4..0000000
+++ /dev/null
@@ -1,59 +0,0 @@
-<!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="auarf030.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="auarf032.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="HDRTE" HREF="auarf002.htm#ToC_29">TE_<I>device_name</I></A></H2>
-<P><STRONG>Purpose</STRONG>
-<P>Logs error messages from the Tape Coordinator process
-<P><STRONG>Description</STRONG>
-<P>The <B>TE_</B><VAR>device_name</VAR> file logs error messages generated
-by the Backup System Tape Coordinator (<B>butc</B> process) that controls
-the tape device or backup data file indicated by <VAR>device_name</VAR>.
-<P>As the Tape Coordinator initializes, it creates the file in ASCII format in
-the <B>/usr/afs/backup</B> directory. If there is an existing file,
-the Tape Coordinator renames it to
-<B>TE_</B><VAR>device_name</VAR><B>.old</B>, overwriting the
-existing <B>TE_</B><VAR>device_name</VAR><B>.old</B> file if it
-exists.
-<P>For a tape device, the Tape Coordinator derives the variable
-<VAR>device_name</VAR> portion of the filename from the device pathname listed
-in the local <B>/usr/afs/backup/tapeconfig</B> file, by stripping off the
-initial <B>/dev/</B> string and replacing any other slashes in the name
-with underscores. For example, the filename for a device called
-<B>/dev/rmt/4m</B> is <B>TE_rmt_4m</B>. Similarly, for a backup
-data file the Tape Coordinator strips off the initial slash (/) and replaces
-any other slashes in the name with underscores. For example, the
-filename for a backup data file called <B>/var/tmp/FILE</B> is
-<B>TE_var_tmp_FILE</B>.
-<P>The messages in the file describe the error and warning conditions the Tape
-Coordinator encounters as it operates. For instance, a message can list
-the volumes that are inaccessible during a dump operation, or warn that the
-Tape Coordinator is overwriting a tape or backup data file. The
-messages also appear in the <B>/usr/afs/backup/TL_</B><VAR>device_name</VAR>
-file, which traces most of the Tape Coordinator's actions.
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf034.htm#HDRTL">TL_<I>device_name</I></A>
-<P><A HREF="auarf050.htm#HDRTAPECONFIG">tapeconfig</A>
-<P><A HREF="auarf126.htm#HDRBUTC">butc</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="auarf030.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="auarf032.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>
diff --git a/doc/html/AdminReference/auarf032.htm b/doc/html/AdminReference/auarf032.htm
deleted file mode 100644 (file)
index 7fc27a1..0000000
+++ /dev/null
@@ -1,79 +0,0 @@
-<!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="auarf031.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="auarf033.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="HDRCLI_THISCELL" HREF="auarf002.htm#ToC_30">ThisCell (client version)</A></H2>
-<P><STRONG>Purpose</STRONG>
-<A NAME="IDX3975"></A>
-<A NAME="IDX3976"></A>
-<A NAME="IDX3977"></A>
-<A NAME="IDX3978"></A>
-<A NAME="IDX3979"></A>
-<P>Defines client machine's cell membership
-<P><STRONG>Description</STRONG>
-<P>The client version of the <B>ThisCell</B> file defines the complete
-Internet domain-style name (for example, <B>abc.com</B>) of the
-cell to which the local client machine belongs. It must reside in the
-<B>/usr/vice/etc</B> directory on every AFS client machine. To
-change a client machine's cell membership, edit the file and reboot the
-machine.
-<P>The file is in ASCII format and contains a character string on a single
-line. The <I>IBM AFS Quick Beginnings</I> instructs the
-administrator to create it during the installation of each client
-machine.
-<P>The client machine's cell membership determines three defaults
-important to its functioning:
-<UL>
-<P><LI>The cell in which the machine's users authenticate by default.
-The effect is two-fold: 
-<UL>
-<P><LI>The AFS-modified login utilities and the <B>klog</B> command
-interpreter contact an Authentication Server in the cell named in the
-<B>ThisCell</B> file (unless <B>-cell</B> argument to the
-<B>klog</B> command specifies an alternate cell).
-<P><LI>The command interpreters combine the cell name with the password that the
-user provides, generating an encryption key from the combination. For
-authentication to succeed, both the cell name and password must match the ones
-used to generate the user's encryption key stored in the Authentication
-Database.
-</UL>
-<P><LI>The cell the Cache Manager considers its local, or home, cell. By
-default, the Cache Manager allows programs that reside in its home cell to run
-with setuid permission, but not programs from foreign cells. For more
-details, see the <B>fs getcellstatus</B> and <B>fs setcell</B>
-reference pages.
-<P><LI>Which AFS server processes the local AFS command interpreters contact by
-default as they execute commands issued on the machine.
-</UL>
-<P>The client version of the <B>ThisCell</B> file is distinct from the
-server version, which resides in the <B>/usr/afs/etc</B> directory on each
-AFS server machine. If a server machine also runs as a client, it is
-acceptable for the server and client versions of the file on the same machine
-to name different cells. However, the behavior that results from this
-configuration can be more confusing than useful.
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf033.htm#HDRSV_THISCELL">ThisCell (server version)</A>
-<P><A HREF="auarf144.htm#HDRFS_GETCELLSTATUS">fs getcellstatus</A>
-<P><A HREF="auarf159.htm#HDRFS_SETCELL">fs setcell</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="auarf031.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="auarf033.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>
diff --git a/doc/html/AdminReference/auarf033.htm b/doc/html/AdminReference/auarf033.htm
deleted file mode 100644 (file)
index 38902a8..0000000
+++ /dev/null
@@ -1,61 +0,0 @@
-<!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="auarf032.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="auarf034.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="HDRSV_THISCELL" HREF="auarf002.htm#ToC_31">ThisCell (server version)</A></H2>
-<P><STRONG>Purpose</STRONG>
-<A NAME="IDX3980"></A>
-<A NAME="IDX3981"></A>
-<A NAME="IDX3982"></A>
-<A NAME="IDX3983"></A>
-<A NAME="IDX3984"></A>
-<P>Defines server machine's cell membership
-<P><STRONG>Description</STRONG>
-<P>The server version of the <B>ThisCell</B> file defines the complete
-Internet domain-style name (for example, <B>abc.com</B>) of the
-cell to which the server machine belongs. It must reside in the
-<B>/usr/afs/etc</B> directory on every AFS server machine.
-<P>The file is in ASCII format and contains a character string on a single
-line. The initial version of the file is created with the <B>bos
-setcellname</B> command during the installation of the cell's first
-file server machine, and the <I>IBM AFS Quick Beginnings</I> includes
-instructions for copying it over to additional server machine during their
-installation.
-<P>The only reason to edit the file is as part of changing the cell's
-name, which is strongly discouraged because of the large number of
-configuration changes involved. In particular, changing the cell name
-requires rebuilding the entire Authentication Database, because the
-Authentication Server combines the cell name it finds in this file with each
-user and server password and converts the combination into an encryption key
-before recording it in the Database.
-<P>The server version of the <B>ThisCell</B> file is distinct from the
-client version, which resides in the <B>/usr/vice/etc</B> directory on
-each AFS client machine. If a server machine also runs as a client, it
-is acceptable for the server and client versions of the file on the same
-machine to name different cells. However, the behavior that results
-from this configuration can be more confusing than useful.
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf032.htm#HDRCLI_THISCELL">ThisCell (client version)</A>
-<P><A HREF="auarf116.htm#HDRBOS_SETCELLNAME">bos setcellname</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="auarf032.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="auarf034.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>
diff --git a/doc/html/AdminReference/auarf034.htm b/doc/html/AdminReference/auarf034.htm
deleted file mode 100644 (file)
index c737918..0000000
+++ /dev/null
@@ -1,55 +0,0 @@
-<!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="auarf033.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="auarf035.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="HDRTL" HREF="auarf002.htm#ToC_32">TL_<I>device_name</I></A></H2>
-<P><STRONG>Purpose</STRONG>
-<P>Traces Tape Coordinator operations and logs errors
-<P><STRONG>Description</STRONG>
-<P>The <B>TL_</B><VAR>device_name</VAR> file logs the actions performed by
-the Backup System Tape Coordinator (<B>butc</B> process) that controls the
-tape device or backup data file indicated by <VAR>device_name</VAR>. It
-also records the same error and warning messages written to the
-<B>TE_</B><VAR>device_name</VAR> file.
-<P>As the Tape Coordinator initializes, it creates the file in ASCII format in
-the <B>/usr/afs/backup</B> directory. If there is an existing file,
-the Tape Coordinator renames it to
-<B>TL_</B><VAR>device_name</VAR><B>.old</B>, overwriting the
-existing <B>TL_</B><VAR>device_name</VAR><B>.old</B> file if it
-exists.
-<P>For a tape device, the Tape Coordinator derives the variable
-<VAR>device_name</VAR> portion of the filename from the device pathname listed
-in the local <B>/usr/afs/backup/tapeconfig</B> file, by stripping off the
-initial <B>/dev/</B> string and replacing any other slashes in the name
-with underscores. For example, the filename for a device called
-<B>/dev/rmt/4m</B> is <B>TL_rmt_4m</B>. Similarly, for a backup
-data file the Tape Coordinator strips off the initial slash (/) and replaces
-any other slashes in the name with underscores. For example, the
-filename for a backup data file called <B>/var/tmp/FILE</B> is
-<B>TL_var_tmp_FILE</B>.
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf031.htm#HDRTE">TE_<I>device_name</I></A>
-<P><A HREF="auarf050.htm#HDRTAPECONFIG">tapeconfig</A>
-<P><A HREF="auarf126.htm#HDRBUTC">butc</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="auarf033.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="auarf035.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>
diff --git a/doc/html/AdminReference/auarf035.htm b/doc/html/AdminReference/auarf035.htm
deleted file mode 100644 (file)
index 3f7fcd2..0000000
+++ /dev/null
@@ -1,59 +0,0 @@
-<!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="auarf034.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="auarf036.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="HDRUSERLIST" HREF="auarf002.htm#ToC_33">UserList</A></H2>
-<P><STRONG>Purpose</STRONG>
-<A NAME="IDX3985"></A>
-<A NAME="IDX3986"></A>
-<P>Defines privileged administrators
-<P><STRONG>Description</STRONG>
-<P>The <B>UserList</B> file lists the AFS usernames of the system
-administrators authorized to issue privileged <B>bos</B>, <B>vos</B>,
-and <B>backup</B> commands that affect the local server machine or the
-volumes housed on it. It must reside in the <B>/usr/afs/etc</B>
-directory on every server machine.
-<P>Although the <B>UserList</B> file is in ASCII format, do not use a text
-editor to alter it. Instead always use the appropriate commands from
-the <B>bos</B> command suite: 
-<UL>
-<P><LI>The <B>bos adduser</B> command to add a user to the file
-<P><LI>The <B>bos listusers</B> command to display the contents of the file
-<P><LI>The <B>bos removeuser</B> command to remove a user from the file
-</UL>
-<P>Although it is theoretically possible to list different administrators in
-the <B>UserList</B> files on different server machines, doing so can cause
-unanticipated authorization failures and is not recommended. In cells
-that run the United States edition of AFS and use the Update Server to
-distribute the contents of the <B>/usr/afs/etc</B> directory, it is
-customary to edit only the copy of the file stored on the system control
-machine. In cells that run the international version of AFS, edit the
-file on each server machine individually.
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf096.htm#HDRBOS_ADDUSER">bos adduser</A>
-<P><A HREF="auarf108.htm#HDRBOS_LISTUSERS">bos listusers</A>
-<P><A HREF="auarf112.htm#HDRBOS_REMOVEUSER">bos removeuser</A>
-<P><A HREF="auarf240.htm#HDRUPCLIENT">upclient</A>
-<P><A HREF="auarf241.htm#HDRUPSERVER">upserver</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="auarf034.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="auarf036.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>
diff --git a/doc/html/AdminReference/auarf036.htm b/doc/html/AdminReference/auarf036.htm
deleted file mode 100644 (file)
index 2c207df..0000000
+++ /dev/null
@@ -1,94 +0,0 @@
-<!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="auarf035.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="auarf037.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="HDRVN" HREF="auarf002.htm#ToC_34">V<I>n</I></A></H2>
-<P><STRONG>Purpose</STRONG>
-<A NAME="IDX3987"></A>
-<A NAME="IDX3988"></A>
-<A NAME="IDX3989"></A>
-<P>Houses a chunk of AFS data in the disk cache
-<P><STRONG>Description</STRONG>
-<P>A <B>V</B><VAR>n</VAR> file can store a chunk of cached AFS data on a
-client machine that is using a disk cache. As the Cache Manager
-initializes, it verifies that the local disk cache directory houses a number
-of <B>V</B><VAR>n</VAR> files equal to the largest of the following:
-<UL>
-<P><LI>100
-<P><LI>One and a half times the result of dividing the cache size by the chunk
-size (cachesize/chunksize * 1.5)
-<P><LI>The result of dividing the cache size by 10 MB (10,240)
-</UL>
-<P>The Cache Manager determines the cache size from the <B>-blocks</B>
-argument to the <B>afsd</B> command, or if the argument is not included,
-from the third field of the <B>/usr/vice/etc/cacheinfo</B> file.
-The default chunk size is 64 KB; use the <B>-chunksize</B> argument
-to the <B>afsd</B> command to override it. To override the default
-number of chunks resulting from the calculation, include the <B>-files</B>
-argument to the <B>afsd</B> command. The <B>afsd</B> reference
-page describes the restrictions on acceptable values for each of the
-arguments.
-<P>If the disk cache directory houses fewer <B>V</B><VAR>n</VAR> files than
-necessary, the Cache Manager creates new ones, assigning each a unique integer
-<VAR>n</VAR> that distinguishes it from the other files; the integers start
-with 1 and increment by one for each <B>V</B><VAR>n</VAR> file
-created. The Cache Manager removes files if there are more than
-necessary. The Cache Manager also adds and removes
-<B>V</B><VAR>n</VAR> files in response to the <B>fs setcachesize</B>
-command, which can be used to alter the cache size between reboots.
-<P>The standard disk cache directory name is <B>/usr/vice/cache</B>, but
-it is acceptable to use a directory on a partition with more available
-space. To designate a different directory, change the value in the
-second field of the <B>/usr/vice/etc/cacheinfo</B> file before issuing the
-<B>afsd</B> command, or include the <B>-cachedir</B> argument to the
-<B>afsd</B> command.
-<P><B>V</B><VAR>n</VAR> files expand and contract to accommodate the size of
-the AFS directory listing or file they temporarily house. As mentioned,
-by default each <B>V</B><VAR>n</VAR> file holds up to 64 KB (65,536 bytes)
-of a cached AFS element. AFS elements larger than 64 KB are divided
-among multiple <B>V</B><VAR>n</VAR> files. If an element is smaller
-than 64 KB, the <B>V</B><VAR>n</VAR> file expands only to the required
-size. A <B>V</B><VAR>n</VAR> file accommodates only a single element,
-so if there many small cached elements, it is possible to exhaust the
-available <B>V</B><VAR>n</VAR> files without reaching the maximum cache
-size.
-<P><STRONG>Cautions</STRONG>
-<P>Editing or removing a <B>V</B><VAR>n</VAR> file can cause a kernel
-panic. To alter cache size (and thus the number of
-<B>V</B><VAR>n</VAR> files) between reboots, use the <B>fs
-setcachesize</B> command. Alternatively, alter the value of the
-<B>-blocks</B>, <B>-files</B> or <B>-chunksize</B> arguments to
-the <B>afsd</B> command invoked in the machine's AFS initialization
-file, and reboot. To refresh the contents of one or more
-<B>V</B><VAR>n</VAR> files, use the <B>fs flush</B> or <B>fs
-flushvolume</B> command. If a <B>V</B><VAR>n</VAR> file is
-accidentally modified or deleted, rebooting the machine usually restores
-normal performance.
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf043.htm#HDRCACHEINFO">cacheinfo</A>
-<P><A HREF="auarf058.htm#HDRAFSD">afsd</A>
-<P><A HREF="auarf140.htm#HDRFS_FLUSH">fs flush</A>
-<P><A HREF="auarf142.htm#HDRFS_FLUSHVOLUME">fs flushvolume</A>
-<P><A HREF="auarf158.htm#HDRFS_SETCACHESIZE">fs setcachesize</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="auarf035.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="auarf037.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>
diff --git a/doc/html/AdminReference/auarf037.htm b/doc/html/AdminReference/auarf037.htm
deleted file mode 100644 (file)
index db6d6d7..0000000
+++ /dev/null
@@ -1,46 +0,0 @@
-<!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="auarf036.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="auarf038.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="HDRVVOLID" HREF="auarf002.htm#ToC_35">V<I>vol_ID</I>.vol</A></H2>
-<P><STRONG>Purpose</STRONG>
-<A NAME="IDX3990"></A>
-<A NAME="IDX3991"></A>
-<A NAME="IDX3992"></A>
-<A NAME="IDX3993"></A>
-<P>Represents an AFS volume
-<P><STRONG>Description</STRONG>
-<P>The <B>V</B><VAR>vol_ID</VAR><B>.vol</B> file is the header
-file for the AFS volume with volume ID <VAR>vol_ID</VAR>. There is one
-such file for each volume stored on an AFS server (<B>/vicep</B>)
-partition. The header file stores information that includes the
-volume's name, ID number, type (read/write, read-only, or backup), size
-and status (online, offline, or busy). To display information from the
-header file, use the <B>vos listvol</B> or <B>vos examine</B>
-command.
-<P>The header file points to, but does not contain, the actual data in the
-volume. It is not possible to access the AFS data except by mounting
-the volume in the AFS filespace and reading its contents through the Cache
-Manager.
-<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="auarf036.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="auarf038.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>
diff --git a/doc/html/AdminReference/auarf038.htm b/doc/html/AdminReference/auarf038.htm
deleted file mode 100644 (file)
index 8f9a893..0000000
+++ /dev/null
@@ -1,75 +0,0 @@
-<!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="auarf037.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="auarf039.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="HDRVLLOG" HREF="auarf002.htm#ToC_36">VLLog</A></H2>
-<P><STRONG>Purpose</STRONG>
-<A NAME="IDX3994"></A>
-<A NAME="IDX3995"></A>
-<A NAME="IDX3996"></A>
-<P>Traces Volume Location Server operations
-<P><STRONG>Description</STRONG>
-<P>The <B>VLLog</B> file records a trace of Volume Location (VL) Server
-(<B>vlserver</B> process) operations on the local machine and describes
-any error conditions it encounters.
-<P>If the <B>VLLog</B> file does not already exist in the
-<B>/usr/afs/logs</B> directory when the VL Server starts, the server
-process creates it and writes initial start-up messages to it. If there
-is an existing file, the VL Server renames it to <B>VLLog.old</B>,
-overwriting the existing <B>VLLog.old</B> file if it exists.
-<P>The file is in ASCII format. Administrators listed in the
-<B>/usr/afs/etc/UserList</B> file can use the <B>bos getlog</B>
-command to display its contents. Alternatively, log onto the server
-machine and use a text editor or a file display command such as the UNIX
-<B>cat</B> command. By default, the mode bits on the
-<B>VLLog</B> file grant the required <B>r</B> (<B>read</B>)
-permission to all users.
-<P>The VL Server records operations only as it completes them, and cannot
-recover from failures by reviewing the file. The log contents are
-useful for administrative evaluation of process failures and other
-problems.
-<P>The VL Server can record messages at three levels of detail. By
-default, it records only very rudimentary messages. To increase logging
-to the first level of detail, issue the following command while logged onto
-the database server machine as the local superuser <B>root</B>.
-<PRE>   # <B>kill -TSTP</B> <VAR>vlserver_pid</VAR>
-   
-</PRE>
-<P>where <VAR>vlserver_pid</VAR> is the process ID of the <B>vlserver</B>
-process, as reported in the output from the standard UNIX <B>ps</B>
-command. To increase to the second and third levels of detail, repeat
-the command.
-<P>To disable logging, issue the following command.
-<PRE> 
-   # <B>kill -HUP</B> <VAR>vlserver_pid</VAR>
-   
-</PRE>
-<P>To decrease the level of logging, first completely disable it and then
-issue the <B>kill -TSTP</B> command as many times as necessary to reach
-the desired level.
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf035.htm#HDRUSERLIST">UserList</A>
-<P><A HREF="auarf102.htm#HDRBOS_GETLOG">bos getlog</A>
-<P><A HREF="auarf249.htm#HDRVLSERVER">vlserver</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="auarf037.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="auarf039.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>
diff --git a/doc/html/AdminReference/auarf039.htm b/doc/html/AdminReference/auarf039.htm
deleted file mode 100644 (file)
index 818a7b4..0000000
+++ /dev/null
@@ -1,57 +0,0 @@
-<!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="auarf038.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="auarf040.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="HDRVOLSERLOG" HREF="auarf002.htm#ToC_37">VolserLog</A></H2>
-<P><STRONG>Purpose</STRONG>
-<A NAME="IDX3997"></A>
-<A NAME="IDX3998"></A>
-<A NAME="IDX3999"></A>
-<P>Traces Volume Server operations
-<P><STRONG>Description</STRONG>
-<P>The <B>VolserLog</B> file records a trace of Volume Server
-(<B>volserver</B> process) operations on the local machine and describes
-any error conditions it encounters.
-<P>If the <B>VolserLog</B> file does not already exist in the
-<B>/usr/afs/logs</B> directory when the Volume Server starts, the server
-process creates it and writes initial start-up messages to it. If there
-is an existing file, the Volume Server renames it to
-<B>VolserLog.old</B>, overwriting the existing
-<B>VolserLog.old</B> file if it exists.
-<P>The file is in ASCII format. Administrators listed in the
-<B>/usr/afs/etc/UserList</B> file can use the <B>bos getlog</B>
-command to display its contents. Alternatively, log onto the file
-server machine and use a text editor or a file display command such as the
-UNIX <B>cat</B> command. By default, the mode bits on the
-<B>VolserLog</B> file grant the required <B>r</B> (<B>read</B>)
-permission to all users.
-<P>The Volume Server records operations only as it completes them, and so
-cannot recover from failures by reviewing the file. The log contents
-are useful for administrative evaluation of process failures and other
-problems.
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf035.htm#HDRUSERLIST">UserList</A>
-<P><A HREF="auarf102.htm#HDRBOS_GETLOG">bos getlog</A>
-<P><A HREF="auarf251.htm#HDRVOLSERVER">volserver</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="auarf038.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="auarf040.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>
diff --git a/doc/html/AdminReference/auarf040.htm b/doc/html/AdminReference/auarf040.htm
deleted file mode 100644 (file)
index 9ca5624..0000000
+++ /dev/null
@@ -1,56 +0,0 @@
-<!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="auarf039.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="auarf041.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="HDRVOLUMEITEMS" HREF="auarf002.htm#ToC_38">VolumeItems</A></H2>
-<P><STRONG>Purpose</STRONG>
-<A NAME="IDX4000"></A>
-<A NAME="IDX4001"></A>
-<A NAME="IDX4002"></A>
-<A NAME="IDX4003"></A>
-<P>Records location mappings for volumes accessed by a Cache Manager using a
-disk cache
-<P><STRONG>Description</STRONG>
-<P>The <B>VolumeItems</B> file records the mapping between volume name and
-mount point for each volume that the Cache Manager has accessed since it
-initialized on a client machine using a disk cache. The Cache Manager
-uses the mappings to respond correctly to queries about the current working
-directory, which can come from the operating system or commands such as the
-UNIX <B>pwd</B> command.
-<P>As it initializes, the Cache Manager creates the binary-format
-<B>VolumeItems</B> file in the local disk cache directory, and it must
-always remain there. The conventional directory name is
-<B>/usr/vice/cache</B>.
-<P><STRONG>Cautions</STRONG>
-<P>Editing or removing the <B>VolumeItems</B> file can cause a kernel
-panic. To refresh the contents of the file, instead use the <B>fs
-checkvolumes</B> command. If the <B>VolumeItems</B> file is
-accidentally modified or deleted, rebooting the machine usually restores
-normal performance.
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf017.htm#HDRCACHEITEMS">CacheItems</A>
-<P><A HREF="auarf043.htm#HDRCACHEINFO">cacheinfo</A>
-<P><A HREF="auarf058.htm#HDRAFSD">afsd</A>
-<P><A HREF="auarf134.htm#HDRFS_CHECKVOLUMES">fs checkvolumes</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="auarf039.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="auarf041.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>
diff --git a/doc/html/AdminReference/auarf041.htm b/doc/html/AdminReference/auarf041.htm
deleted file mode 100644 (file)
index ddfd57e..0000000
+++ /dev/null
@@ -1,43 +0,0 @@
-<!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="auarf040.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="auarf042.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="HDRAFSZCM" HREF="auarf002.htm#ToC_39">afszcm.cat</A></H2>
-<P><STRONG>Purpose</STRONG>
-<A NAME="IDX4004"></A>
-<A NAME="IDX4005"></A>
-<P>Error message catalog for debugging the Cache Manager
-<P><STRONG>Description</STRONG>
-<P>The <B>afszcm.cat</B> file is a message catalog for the Cache
-Manager. The <B>fstrace dump</B> command interpreter uses it in
-conjunction with the standard UNIX catalog utilities to translate Cache
-Manager operation codes into character strings as it writes traces in the
-<B>fstrace</B> trace log, which makes the log more readable.
-<P>The conventional location for the file is the <B>/usr/vice/etc/C/</B>
-directory. It can be placed in another directory if the NLSPATH and
-LANG environment variables are set appropriately.
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf058.htm#HDRAFSD">afsd</A>
-<P><A HREF="auarf172.htm#HDRFSTRACE_DUMP">fstrace dump</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="auarf040.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="auarf042.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>
diff --git a/doc/html/AdminReference/auarf042.htm b/doc/html/AdminReference/auarf042.htm
deleted file mode 100644 (file)
index e947816..0000000
+++ /dev/null
@@ -1,59 +0,0 @@
-<!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="auarf041.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="auarf043.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="HDRBDBDB" HREF="auarf002.htm#ToC_40">bdb.DB0 and bdb.DBSYS1</A></H2>
-<P><STRONG>Purpose</STRONG>
-<A NAME="IDX4006"></A>
-<A NAME="IDX4007"></A>
-<A NAME="IDX4008"></A>
-<A NAME="IDX4009"></A>
-<A NAME="IDX4010"></A>
-<P>Contain the Backup Database and associated log
-<P><STRONG>Description</STRONG>
-<P>The <B>bdb.DB0</B> file contains the Backup Database, which
-records configuration information used by the AFS Backup System along with
-cross-indexed records of the tapes created and volumes dumped using the Backup
-System commands.
-<P>The <B>bdb.DBSYS1</B> file is a log file in which the Backup
-Server (<B>buserver</B> process) logs each database operation before
-performing it. When an operation is interrupted, the Backup Server
-replays the log to complete the operation.
-<P>Both files are in binary format and reside in the <B>/usr/afs/db</B>
-directory on each database server machine that runs the Backup Server.
-When the Backup Server starts or restarts on a given machine, it establishes a
-connection with its peers and verifies that its copy of the
-<B>bdb.DB0</B> file matches the copy on the other database server
-machines. If not, the Backup Servers use AFS's distributed
-database technology, Ubik, to distribute to all of the machines the copy of
-the database with the highest version number.
-<P>Use the commands in the <B>backup</B> suite to administer the Backup
-Database. It is advisable to create a backup copy of the
-<B>bdb.DB0</B> file on tape on a regular basis, using the UNIX
-<B>tar</B> command or another local disk backup utility.
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf060.htm#HDRBK_INTRO">backup</A>
-<P><A HREF="auarf086.htm#HDRBK_SAVEDB">backup savedb</A>
-<P><A HREF="auarf125.htm#HDRBUSERVER">buserver</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="auarf041.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="auarf043.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>
diff --git a/doc/html/AdminReference/auarf043.htm b/doc/html/AdminReference/auarf043.htm
deleted file mode 100644 (file)
index db56a71..0000000
+++ /dev/null
@@ -1,79 +0,0 @@
-<!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="auarf042.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="auarf044.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="HDRCACHEINFO" HREF="auarf002.htm#ToC_41">cacheinfo</A></H2>
-<P><STRONG>Purpose</STRONG>
-<P>Defines configuration parameters for the Cache Manager
-<P><STRONG>Description</STRONG>
-<P>The <B>cacheinfo</B> file defines configuration parameters for the
-Cache Manager, which reads the file as it initializes.
-<P>The file contains a single line of ASCII text and must reside in the
-<B>/usr/vice/etc</B> directory. Use a text editor to create it
-during initial configuration of the client machine; the required format
-is as follows:
-<PRE>   <VAR>mount_dir</VAR>:<VAR>cache_dir</VAR>:<VAR>cache_size</VAR>
-    
-</PRE>
-<P>where
-<DL>
-<P><DT><B><VAR>mount_dir</VAR>
-</B><DD>Names the local disk directory at which the Cache Manager mounts the AFS
-namespace. It must exist before the <B>afsd</B> program
-runs. The conventional value is <B>/afs</B>. Using any other
-value prevents traversal of pathnames that begin with <B>/afs</B> (such as
-pathnames to files in foreign cells that do use the conventional name).
-The <B>-mountdir</B> argument to the <B>afsd</B> command overrides
-this value.
-<P><DT><B><VAR>cache_dir</VAR>
-</B><DD>Names the local disk directory to use as a cache. It must exist
-before the <B>afsd</B> program runs. The standard value is
-<B>/usr/vice/cache</B>, but it is acceptable to substitute a directory on
-a partition with more available space. Although the Cache Manager
-ignores this field when configuring a memory cache, a value must always appear
-in it. The <B>-cachedir</B> argument to the <B>afsd</B> command
-overrides this value.
-<P><DT><B><VAR>cache_size</VAR>
-</B><DD>Specifies the cache size as a number of 1-kilobyte blocks. Larger
-caches generally yield better performance, but a disk cache must not exceed
-90% of the space available on the cache partition (85% for AIX systems), and a
-memory cache must use no more than 25% of available machine memory. 
-<P>The <B>-blocks</B> argument to the <B>afsd</B> command overrides
-this value. To reset cache size without rebooting on a machine that
-uses disk caching, use the <B>fs setcachesize</B> command. To
-display the current size of a disk or memory cache between reboots, use the
-<B>fs getcacheparms</B> command.
-</DL>
-<P><STRONG>Examples</STRONG>
-<P>The following example <B>cacheinfo</B> file mounts the AFS namespace at
-<B>/afs</B>, establishes a disk cache in the <B>/usr/vice/cache</B>
-directory, and defines cache size as 50,000 1-kilobyte blocks.
-<PRE>   /afs:/usr/vice/cache:50000
-   
-</PRE>
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf058.htm#HDRAFSD">afsd</A>
-<P><A HREF="auarf143.htm#HDRFS_GETCACHEPARMS">fs getcacheparms</A>
-<P><A HREF="auarf158.htm#HDRFS_SETCACHESIZE">fs setcachesize</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="auarf042.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="auarf044.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>
diff --git a/doc/html/AdminReference/auarf044.htm b/doc/html/AdminReference/auarf044.htm
deleted file mode 100644 (file)
index 64e4aba..0000000
+++ /dev/null
@@ -1,82 +0,0 @@
-<!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="auarf043.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="auarf045.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="HDRFMSLOG" HREF="auarf002.htm#ToC_42">fms.log</A></H2>
-<P><STRONG>Purpose</STRONG>
-<P>Records output from the <B>fms</B> command
-<P><STRONG>Description</STRONG>
-<P>The <B>fms.log</B> file records the output generated by the
-<B>fms</B> command. The output includes two numbers that can appear
-in a tape device's entry in the <B>/usr/afs/backup/tapeconfig</B>
-file on the Tape Coordinator machine to which the tape device is
-attached:
-<UL>
-<P><LI>The capacity in bytes of the tape in the device
-<P><LI>The size in bytes of the end-of-file (EOF) marks (often referred to simply
-as <I>filemarks</I>) that the tape device writes
-</UL>
-<P>When transferring the numbers recorded in this file to the
-<B>tapeconfig</B> file, adjust them as specified on the reference page for
-the <B>tapeconfig</B> file, to improve Tape Coordinator performance during
-dump operations.
-<P>If the <B>fms.log</B> file does not already exist in the current
-working directory, the <B>fms</B> command interpreter creates it.
-In this case, the directory's mode bits must grant the <B>rwx</B>
-(<B>read</B>, <B>write</B>, and <B>execute</B>) permissions to the
-issuer of the command. If there is an existing file, the command
-interpreter overwrites it, so the file's mode bits need to grant only the
-<B>w</B> permission to the issuer of the <B>fms</B> command.
-The <B>fms</B> command interpreter also writes similar information to the
-standard output stream as it runs.
-<P>The file is in ASCII format. To display its contents, log onto the
-client machine and use a text editor or a file display command such as the
-UNIX <B>cat</B> command. By default, the mode bits on the
-<B>fms.log</B> file grant the required <B>r</B> permission only
-to the owner (which is the local superuser <B>root</B> by default).
-<P><STRONG>Output</STRONG>
-<P>The first few lines of the file provide a simple trace of the
-<B>fms</B> command interpreter's actions, specifying (for example)
-how many blocks it wrote on the tape. The final two lines in the file
-specify tape capacity and filemark size in bytes, using the following
-format:
-<PRE>   Tape capacity is <VAR>tape_size</VAR> bytes
-   File marks are <VAR>filemark_size</VAR> bytes
-   
-</PRE>
-<P><STRONG>Examples</STRONG>
-<P>The following example of the <B>fms.log</B> file specifies that
-the tape used during the execution of the <B>fms</B> command had a
-capacity of 2,136,604,672 bytes, and that the tape device writes filemarks of
-size 1,910,220 bytes.
-<PRE>   fms test started
-   wrote 130408 blocks
-   Tape capacity is 2136604672 bytes
-   File marks are 1910220 bytes
-   
-</PRE>
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf050.htm#HDRTAPECONFIG">tapeconfig</A>
-<P><A HREF="auarf130.htm#HDRFMS">fms</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="auarf043.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="auarf045.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>
diff --git a/doc/html/AdminReference/auarf045.htm b/doc/html/AdminReference/auarf045.htm
deleted file mode 100644 (file)
index 2087261..0000000
+++ /dev/null
@@ -1,60 +0,0 @@
-<!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="auarf044.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="auarf046.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="HDRKASERVERDB" HREF="auarf002.htm#ToC_43">kaserver.DB0 and kaserver.DBSYS1</A></H2>
-<P><STRONG>Purpose</STRONG>
-<A NAME="IDX4011"></A>
-<A NAME="IDX4012"></A>
-<A NAME="IDX4013"></A>
-<A NAME="IDX4014"></A>
-<A NAME="IDX4015"></A>
-<P>Contain the Authentication Database and associated log
-<P><STRONG>Description</STRONG>
-<P>The <B>kaserver.DB0</B> file contains the Authentication
-Database, which records server encryption keys and an encrypted form of all
-user passwords. The Authentication Server (<B>kaserver</B> process)
-uses the information in the database to enable secured communications between
-AFS server and client processes.
-<P>The <B>kaserver.DBSYS1</B> file is a log file in which the
-Authentication Server logs each database operation before performing
-it. When an operation is interrupted, the Authentication Server replays
-the log to complete the operation.
-<P>Both files are in binary format and reside in the <B>/usr/afs/db</B>
-directory on each of the cell's database server machines. When the
-Authentication Server starts or restarts on a given machine, it establishes a
-connection with its peers and verifies that its copy of the database matches
-the copy on the other database server machines. If not, the
-Authentication Servers call on AFS's distributed database technology,
-Ubik, to distribute to all of the machines the copy of the database with the
-highest version number.
-<P>Always use the commands in the <B>kas</B> suite to administer the
-Authentication Database. It is advisable to create an archive copy of
-the database on a regular basis, using a tool such as the UNIX <B>tar</B>
-command.
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf180.htm#HDRKADB_CHECK">kadb_check</A>
-<P><A HREF="auarf181.htm#HDRKAS_INTRO">kas</A>
-<P><A HREF="auarf198.htm#HDRKASERVER">kaserver</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="auarf044.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="auarf046.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>
diff --git a/doc/html/AdminReference/auarf046.htm b/doc/html/AdminReference/auarf046.htm
deleted file mode 100644 (file)
index bec1391..0000000
+++ /dev/null
@@ -1,55 +0,0 @@
-<!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="auarf045.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="auarf047.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="HDRKASERVERAUXDB" HREF="auarf002.htm#ToC_44">kaserverauxdb</A></H2>
-<P><STRONG>Purpose</STRONG>
-<A NAME="IDX4016"></A>
-<A NAME="IDX4017"></A>
-<P>Records failed authentication attempts
-<P><STRONG>Description</STRONG>
-<P>The file <B>kaserverauxdb</B> records failed authentication attempts
-for the local Authentication Server. The server creates it
-automatically in the <B>/usr/afs/local</B> directory by default; use
-the <B>-localfiles</B> argument to the <B>kaserver</B> command to
-specify an alternate directory.
-<P>The <B>kaserverauxdb</B> file is an internal database used by the
-Authentication Server to prevent access by users who have exceeded the limit
-on failed authentication attempts defined in their Authentication Database
-entry. The Authentication Server refuses further attempts to
-authenticate to an account listed in the database until either an AFS system
-administrator issues the <B>kas unlock</B> command to unlock the account,
-or the timeout period defined in the user's Authentication Database entry
-passes.
-<P>The <B>kaserverauxdb</B> file is in binary format, so its contents are
-not directly accessible. However, the output from the <B>kas
-examine</B> command reports an account's maximum number of failed
-attempts, the lockout time, and whether the account is currently
-locked.
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf045.htm#HDRKASERVERDB">kaserver.DB0 and kaserver.DBSYS1</A>
-<P><A HREF="auarf185.htm#HDRKAS_EXAMINE">kas examine</A>
-<P><A HREF="auarf197.htm#HDRKAS_UNLOCK">kas unlock</A>
-<P><A HREF="auarf198.htm#HDRKASERVER">kaserver</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="auarf045.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="auarf047.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>
diff --git a/doc/html/AdminReference/auarf047.htm b/doc/html/AdminReference/auarf047.htm
deleted file mode 100644 (file)
index 8ffa0fb..0000000
+++ /dev/null
@@ -1,60 +0,0 @@
-<!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="auarf046.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="auarf048.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="HDRPRDBDB" HREF="auarf002.htm#ToC_45">prdb.DB0 and prdb.DBSYS1</A></H2>
-<P><STRONG>Purpose</STRONG>
-<A NAME="IDX4018"></A>
-<A NAME="IDX4019"></A>
-<A NAME="IDX4020"></A>
-<A NAME="IDX4021"></A>
-<A NAME="IDX4022"></A>
-<P>Contain the Protection Database and associated log
-<P><STRONG>Description</STRONG>
-<P>The <B>prdb.DB0</B> file contains the Protection Database, which
-maps AFS user, machine, and group names to their respective IDs (AFS UIDs and
-GIDs) and tracks group memberships. The Protection Server
-(<B>ptserver</B> process) uses the information in the database to help the
-File Server grant data access to authorized users.
-<P>The <B>prdb.DBSYS1</B> file is a log file in which the
-Protection Server logs each database operation before performing it.
-When an operation is interrupted, the Protection Server replays the log to
-complete the operation.
-<P>Both files are in binary format and reside in the <B>/usr/afs/db</B>
-directory on each of the cell's database server machines. When the
-Protection Server starts or restarts on a given machine, it establishes a
-connection with its peers and verifies that its copy of the database matches
-the copy on the other database server machines. If not, the Protection
-Servers call on AFS's distributed database technology, Ubik, to
-distribute to all of the machines the copy of the database with the highest
-version number.
-<P>Always use the commands in the <B>pts</B> suite to administer the
-Protection Database. It is advisable to create an archive copy of the
-database on a regular basis, using a tool such as the UNIX <B>tar</B>
-command.
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf209.htm#HDRPRDB_CHECK">prdb_check</A>
-<P><A HREF="auarf210.htm#HDRPTS_INTRO">pts</A>
-<P><A HREF="auarf227.htm#HDRPTSERVER">ptserver</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="auarf046.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="auarf048.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>
diff --git a/doc/html/AdminReference/auarf048.htm b/doc/html/AdminReference/auarf048.htm
deleted file mode 100644 (file)
index ca8ae53..0000000
+++ /dev/null
@@ -1,40 +0,0 @@
-<!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="auarf047.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="auarf049.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="HDRSALVAGELOCK" HREF="auarf002.htm#ToC_46">salvage.lock</A></H2>
-<P><STRONG>Purpose</STRONG>
-<P>Prevents multiple simultaneous salvage operations on a partition
-<P><STRONG>Description</STRONG>
-<P>The <B>salvage.lock</B> file guarantees that only one Salvager
-(<B>salvager</B> process) runs at a time on a file server machine (the
-single process can fork multiple subprocesses to salvage multiple partitions
-in parallel). As the Salvager initializes, it creates the empty
-(zero-length) file in the <B>/usr/afs/local</B> directory and invokes the
-<B>flock</B> system call on it. It removes the file when it
-completes the salvage operation. Because the Salvager must lock the
-file to run, only one Salvager can run at a time.
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf232.htm#HDRSALVAGER">salvager</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="auarf047.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="auarf049.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>
diff --git a/doc/html/AdminReference/auarf049.htm b/doc/html/AdminReference/auarf049.htm
deleted file mode 100644 (file)
index 4be0431..0000000
+++ /dev/null
@@ -1,66 +0,0 @@
-<!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="auarf048.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="auarf050.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="HDRSYSID" HREF="auarf002.htm#ToC_47">sysid</A></H2>
-<P><STRONG>Purpose</STRONG>
-<A NAME="IDX4023"></A>
-<A NAME="IDX4024"></A>
-<A NAME="IDX4025"></A>
-<A NAME="IDX4026"></A>
-<P>Lists file server machine interface addresses registered in VLDB
-<P><STRONG>Description</STRONG>
-<P>The <B>sysid</B> file records the network interface addresses that the
-File Server (<B>fileserver</B> process) registers in the Volume Location
-Database (VLDB) for the local file server machine.
-<P>Each time the File Server restarts, it builds a list of interfaces on the
-local machine by reading the <B>/usr/afs/local/NetInfo</B> file, if it
-exists. If the file does not exist, the File Server uses the list of
-network interfaces configured with the operating system. It then
-removes from the list any addresses that appear in the
-<B>/usr/afs/local/NetRestrict</B> file, if it exists. The File
-Server records the resulting list in the binary-format <B>sysid</B> file
-and registers the interfaces in the VLDB.
-<P>When the Cache Manager requests volume location information, the Volume
-Location (VL) Server provides all of the interfaces registered for each server
-machine that houses the volume. This enables the Cache Manager to make
-use of multiple addresses when accessing AFS data stored on a multihomed file
-server machine.
-<P><STRONG>Cautions</STRONG>
-<P>The <B>sysid</B> file is unique to each file server machine, and must
-not be copied from one machine to another. If it is a common practice
-in the cell to copy the contents of the <B>/usr/afs/local</B> directory
-from an existing file server machine to a newly installed one, be sure to
-remove the <B>sysid</B> file from the new machine before starting the
-<B>fs</B> trio of processes, which includes the <B>fileserver</B>
-process.
-<P>Some versions of AFS limit how many of a file server machine's
-interface addresses that can be registered. Consult the <I>IBM AFS
-Release Notes</I>.
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf025.htm#HDRSV_NETINFO">NetInfo (server version)</A>
-<P><A HREF="auarf027.htm#HDRSV_NETRESTRICT">NetRestrict (server version)</A>
-<P><A HREF="auarf051.htm#HDRVLDBDB">vldb.DB0 and vldb.DBSYS1</A>
-<P><A HREF="auarf129.htm#HDRFILESERVER">fileserver</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="auarf048.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="auarf050.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>
diff --git a/doc/html/AdminReference/auarf050.htm b/doc/html/AdminReference/auarf050.htm
deleted file mode 100644 (file)
index 46ee43c..0000000
+++ /dev/null
@@ -1,165 +0,0 @@
-<!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="auarf049.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="auarf051.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="HDRTAPECONFIG" HREF="auarf002.htm#ToC_48">tapeconfig</A></H2>
-<P><STRONG>Purpose</STRONG>
-<A NAME="IDX4027"></A>
-<A NAME="IDX4028"></A>
-<A NAME="IDX4029"></A>
-<P>Defines configuration parameters for all tape devices and backup data files
-on a Tape Coordinator machine
-<P><STRONG>Description</STRONG>
-<P>The <B>tapeconfig</B> file defines basic configuration parameters for
-all of the tape devices or backup data files available for backup operations
-on a Tape Coordinator machine. The file is in ASCII format and must
-reside in the local <B>/usr/afs/backup</B> directory. The
-instruction for each tape device or backup data file appears on its own line
-and each has the following format:
-<PRE>   [<VAR>capacity</VAR>    <VAR>filemark_size</VAR>]    <VAR>device_name</VAR>    <VAR>port_offset</VAR>
-   
-</PRE>
-<P>where
-<DL>
-<P><DT><B><VAR>capacity</VAR>
-</B><DD>Specifies the capacity of the tapes used with a tape device, or the amount
-of data to write into a backup data file. The Tape Coordinator refers
-to this value in two circumstances: 
-<UL>
-<P><LI>When the capacity field of a tape or backup data file's label is
-empty (because the tape has never been labeled). The Tape Coordinator
-records this value on the label and uses it when determining how much data it
-can write to the tape or file during a <B>backup dump</B> or <B>backup
-savedb</B> operation. If there is already a capacity value on the
-label, the Tape Coordinator uses it instead.
-<P><LI>When the <B>-size</B> argument is omitted the first time the
-<B>backup labeltape</B> command is used on a given tape or file.
-The Tape Coordinator copies this value into the label's capacity
-field.
-</UL>
-<P>
-<P>The Tape Coordinator uses this capacity value or the one on the Backup
-System tape label to track how much space remains as it writes data to a tape
-or backup data file. The appropriate value to record for a tape depends
-on the size of the tapes usually used in the device and whether it has a
-compression mode; for suggested values, see the <I>IBM AFS
-Administration Guide</I> chapter on configuring the Backup System. If
-using a value obtained from the <B>fms</B> command, reduce it by 10% to
-15% before recording it in the file.
-<P>For a backup data file, it is best to provide a value that helps the Tape
-Coordinator avoid reaching the end-of-file (EOF) unexpectedly. Make it
-at least somewhat smaller than the amount of space available on the partition
-housing the file when the dump operation begins, and never larger than the
-maximum file size allowed by the operating system.
-<P>Specify a (positive) integer or decimal value followed by a letter than
-indicates units, with no intervening space. In a decimal number, the
-number of digits after the decimal point must not translate to fractions of
-bytes. The maximum acceptable value is 2048 GB (2 TB). The
-acceptable units letters are as follows; if the letter is omitted, the
-default is kilobytes.
-<P>
-<UL>
-<P><LI><B>k</B>or <B>K</B> for kilobytes (KB)
-<P><LI><B>m</B> or <B>M</B> for megabytes (MB)
-<P><LI><B>g</B> or <B>G</B> for gigabytes (GB)
-<P><LI><B>t</B> or <B>T</B> for terabytes (TB)
-</UL>
-<P>If this field is omitted, the Tape Coordinator uses the maximum acceptable
-value (2048 GB or 2 TB). Either leave both this field and the
-<VAR>filemark_size</VAR> field empty, or provide a value in both of them.
-<P><DT><B><VAR>filemark_size</VAR>
-</B><DD>Specifies the size of a tape device's filemarks (also called
-end-of-file or EOF marks), which is set by the device's
-manufacturer. In a dump to tape, the Tape Coordinator inserts filemarks
-at the boundary between the data from each volume, so the filemark size
-affects how much space is available for actual data. 
-<P>The appropriate value to record for a tape depends on the size of the tapes
-usually used in the device and whether it has a compression mode; for
-suggested values, see the <I>IBM AFS Administration Guide</I> chapter on
-configuring the Backup System. If using a value obtained from the
-<B>fms</B> command, increase it by 10% to 15% before recording it in the
-file.
-<P>For backup data files, record a value of <B>0</B> (zero). The
-Tape Coordinator actually ignores this field for backup data files, because it
-does not use filemarks when writing to a file.
-<P>Use the same notation as for the <VAR>capacity</VAR> field, but note that the
-default units is bytes rather than kilobytes. The maximum acceptable
-value is 2048 GB.
-<P>If this field is empty, the Tape Coordinator uses the value <B>0</B>
-(zero). Either leave both this field and the <VAR>capacity</VAR> field
-empty, or provide a value in both of them.
-<P><DT><B><VAR>device_name</VAR>
-</B><DD>Specifies the complete pathname of the tape device or backup data
-file. The format of tape device names depends on the operating system,
-but on UNIX systems device names generally begin with the string
-<B>/dev/</B>. For a backup data file, this field defines the
-complete pathname; for a discussion of suggested naming conventions see
-the description of the <B>FILE</B> instruction in <A HREF="auarf018.htm#HDRCFG">CFG_<I>device_name</I></A>.
-<P><DT><B><VAR>port_offset</VAR>
-</B><DD>Specifies the port offset number associated with this combination of Tape
-Coordinator and tape device or backup data file. 
-<P>Acceptable values are the integers <B>0</B> through <B>58510</B>
-(the Backup System can track a maximum of 58,511 port offset numbers).
-Each value must be unique among the cell's Tape Coordinators, but any
-number of them can be associated with a single machine. Port offset
-numbers need not be assigned sequentially, and can appear in any order in the
-<B>tapeconfig</B> file. Assign port offset <B>0</B> to the Tape
-Coordinator for the tape device or backup data file used most often for backup
-operations; doing so will allow the operator to omit the
-<B>-portoffset</B> argument from the largest possible number of
-<B>backup</B> commands.
-</DL>
-<P><STRONG>Privilege Required</STRONG>
-<P>Creating the file requires UNIX <B>w</B> (<B>write</B>) and
-<B>x</B> (<B>execute</B>) permissions on the
-<B>/usr/afs/backup</B> directory. Editing the file requires UNIX
-<B>w</B> (<B>write</B>) permission on the file.
-<P><STRONG>Examples</STRONG>
-<P>The following example <B>tapeconfig</B> file configures three tape
-devices and a backup data file. The first device has device name
-<B>/dev/rmt/0h</B>, and is assigned port offset <B>0</B> because it
-will be the most frequently used device for all backup operations in the
-cell. Its default tape capacity is 2 GB and filemark size is 1
-MB. The <B>/dev/rmt/3h</B> drive has half the capacity but a much
-smaller filemark size; its port offset is <B>3</B>. The third
-device listed, <B>/dev/rmt/4h</B>, has the same capacity and filemark size
-as the first device and is assigned port offset <B>2</B>. Port
-offset <B>4</B> is assigned to the backup data file <B>/dev/FILE</B>,
-which is actually a symbolic link to the actual file located elsewhere on the
-local disk. The Tape Coordinator writes up to 1.5 GB into the
-file; as recommended, the filemark size is set to zero.
-<PRE>   2G 1M /dev/rmt/0h 0
-   1g 4k /dev/rmt/3h 3
-   2G 1m /dev/rmt/4h 2
-   1.5G 0 /dev/FILE 4
-   
-</PRE>
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf062.htm#HDRBK_ADDHOST">backup addhost</A>
-<P><A HREF="auarf073.htm#HDRBK_DUMP">backup dump</A>
-<P><A HREF="auarf079.htm#HDRBK_LABELTAPE">backup labeltape</A>
-<P><A HREF="auarf086.htm#HDRBK_SAVEDB">backup savedb</A>
-<P><A HREF="auarf126.htm#HDRBUTC">butc</A>
-<P><A HREF="auarf130.htm#HDRFMS">fms</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="auarf049.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="auarf051.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>
diff --git a/doc/html/AdminReference/auarf051.htm b/doc/html/AdminReference/auarf051.htm
deleted file mode 100644 (file)
index e44f626..0000000
+++ /dev/null
@@ -1,58 +0,0 @@
-<!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="auarf050.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="auarf052.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="HDRVLDBDB" HREF="auarf002.htm#ToC_49">vldb.DB0 and vldb.DBSYS1</A></H2>
-<P><STRONG>Purpose</STRONG>
-<A NAME="IDX4030"></A>
-<A NAME="IDX4031"></A>
-<A NAME="IDX4032"></A>
-<A NAME="IDX4033"></A>
-<A NAME="IDX4034"></A>
-<A NAME="IDX4035"></A>
-<P>Contain the Volume Location Database and associated log
-<P><STRONG>Description</STRONG>
-<P>The file <B>vldb.DB0</B> contains the Volume Location Database
-(VLDB), which tracks the location of all AFS volumes stored on file server
-machines in the cell. The Volume Location (VL) Server
-(<B>vlserver</B> process) provides information from the database to Cache
-Managers when they need to access AFS data.
-<P>The file <B>vldb.DBSYS1</B> is a log file in which the VL Server
-logs each database operation before performing it. When an operation is
-interrupted, the VL Server replays the log to complete the operation.
-<P>Both files are in binary format and reside in the <B>/usr/afs/db</B>
-directory on each of the cell's database server machines. When the
-VL Server starts or restarts on a given machine, it establishes a connection
-with its peers and verifies that its copy of the database matches the copy on
-the other database server machines. If not, the VL Servers call on
-AFS's distributed database technology, Ubik, to distribute to all of the
-machines the copy of the database with the highest version number.
-<P>Always use the commands in the <B>vos</B> suite to administer the
-VLDB. It is advisable to create an archive copy of the database on a
-regular basis, using a tool such as the UNIX <B>tar</B> command.
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf248.htm#HDRVLDB_CHECK">vldb_check</A>
-<P><A HREF="auarf249.htm#HDRVLSERVER">vlserver</A>
-<P><A HREF="auarf252.htm#HDRVOS_INTRO">vos</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="auarf050.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="auarf052.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>
diff --git a/doc/html/AdminReference/auarf052.htm b/doc/html/AdminReference/auarf052.htm
deleted file mode 100644 (file)
index a75913a..0000000
+++ /dev/null
@@ -1,122 +0,0 @@
-<!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="auarf051.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="auarf053.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="HDRAFSMONCONFIG" HREF="auarf002.htm#ToC_50">afsmonitor Configuration File</A></H2>
-<P><STRONG>Purpose</STRONG>
-<A NAME="IDX4036"></A>
-<A NAME="IDX4037"></A>
-<P>Provides instructions for the <B>afsmonitor</B> command
-<P><STRONG>Description</STRONG>
-<P>The <B>afsmonitor</B> configuration file determines which machines the
-<B>afsmonitor</B> command probes for File Server or Cache Manager
-statistics and which statistics it gathers. Use the <B>-config</B>
-argument to the <B>afsmonitor</B> command to identify the configuration
-file to use.
-<P>The instructions that can appear in the configuration file are as
-follows:
-<DL>
-<P><DT><B><TT>cm  <VAR>host_name</VAR></TT>
-</B><DD>Names a client machine for which to display Cache Manager
-statistics. The order of <B>cm</B> lines in the file determines the
-order in which client machines appear from top to bottom on the <TT>System
-Overview</TT> and <TT>Cache Managers</TT> output screens.
-<P><DT><B><TT>fs  <VAR>host_name</VAR></TT>
-</B><DD>Names a file server machine for which to display File Server
-statistics. The order of <B>fs</B> lines in the file determines the
-order in which file server machines appear from top to bottom on the
-<TT>System Overview</TT> and <TT>File Servers</TT> output screens.
-<P><DT><B><TT>thresh  fs | cm  <VAR>field_name</VAR>  <VAR>thresh_val</VAR> 
-[<VAR>cmd_to_run</VAR>]  [<VAR>arg</VAR><SUB>1</SUB>] . . .
-[<VAR>arg</VAR><SUB>n</SUB>]</TT>
-</B><DD>Assigns the threshold value <VAR>thresh_val</VAR> to the statistic
-<VAR>field_name</VAR>, for either a File Server statistic (<B>fs</B>) or a
-Cache Manager statistic (<B>cm</B>). The optional
-<VAR>cmd_to_execute</VAR> field names a binary or script to execute each time
-the value of the statistic changes from being below <VAR>thresh_val</VAR> to
-being at or above <VAR>thresh_val</VAR>. A change between two values that
-both exceed <VAR>thresh_val</VAR> does not retrigger the binary or
-script. The optional <VAR>arg</VAR><SUB>1</SUB> through
-<VAR>arg</VAR><SUB>n</SUB> fields are additional values that the
-<B>afsmonitor</B> program passes as arguments to the
-<VAR>cmd_to_execute</VAR> command. If any of them include one or more
-spaces, enclose the entire field in double quotes.
-<p>The <b>afsmonitor</b> program passes the following parameters to the
-<var>cmd_to_execute</var>&#58;
-<p><dt><b><var>host_name</var> fs|cm <var>field_name</var>
-<var>threshold_val</var>
-<var>actual_val</var> [&lt;<var>arg</var><sub>1</sub>>]
-. . . [&lt;<var>arg</var><sub>n</sub>>]</b>
-<P>The parameters <B>fs</B>, <B>cm</B>, <VAR>field_name</VAR>,
-<VAR>threshold_val</VAR>, and <VAR>arg</VAR><SUB>1</SUB> through
-<VAR>arg</VAR><SUB>n</SUB> correspond to the values with the same name on the
-<B>thresh</B> line. The <VAR>host_name</VAR> parameter identifies the
-file server or client machine where the statistic has crossed the threshold,
-and the <VAR>actual_val</VAR> parameter is the actual value of
-<VAR>field_name</VAR> that exceeds the threshold value.
-<P>Use the <B>thresh</B> line to set either a global threshold, which
-applies to all file server machines listed on <B>fs</B> lines or client
-machines listed on <B>cm</B> lines in the configuration file, or a
-machine-specific threshold, which applies to only one file server or client
-machine.
-<UL>
-<P><LI>To set a global threshold, place the <B>thresh</B> line before any of
-the <B>fs</B> or <B>cm</B> lines in the file.
-<P><LI>To set a machine-specific threshold, place the <B>thresh</B> line
-below the corresponding <B>fs</B> or <B>cm</B> line, and above any
-other <B>fs</B> or <B>cm</B> lines. A machine-specific
-threshold value always overrides the corresponding global threshold, if
-set. Do not place a <B>thresh fs</B> line directly after a
-<B>cm</B> line or a <B>thresh cm</B> line directly after a
-<B>fs</B> line.
-</UL>
-<P><DT><B><TT>show  fs | cm  <VAR>field/group/section</VAR></TT>
-</B><DD>Specifies which individual statistic, group of statistics, or section of
-statistics to display on the <TT>File Servers</TT> screen (<B>fs</B>) or
-<TT>Cache Managers</TT> screen (<B>cm</B>) and the order in which to
-display them. The appendix of <B>afsmonitor</B> statistics in the
-<I>IBM AFS Administration Guide</I> specifies the group and section to
-which each statistic belongs. Include as many <B>show</B> lines as
-necessary to customize the screen display as desired, and place them anywhere
-in the file. The top-to-bottom order of the <B>show</B> lines in
-the configuration file determines the left-to-right order in which the
-statistics appear on the corresponding screen.
-<P>If there are no <B>show</B> lines in the configuration file, then the
-screens display all statistics for both Cache Managers and File
-Servers. Similarly, if there are no <B>show fs</B> lines, the
-<TT>File Servers</TT> screen displays all file server statistics, and if
-there are no <B>show cm</B> lines, the <TT>Cache Managers</TT> screen
-displays all client statistics.
-<P><DT><B># <VAR>comments</VAR>
-</B><DD>Precedes a line of text that the <B>afsmonitor</B> program ignores
-because of the initial number (<B>#</B>) sign, which must appear in the
-very first column of the line.
-</DL>
-<P>For a list of the values that can appear in the
-<VAR>field/group/section</VAR> field of a <B>show</B> instruction, see the
-<B>afsmonitor</B> statistics appendix to the <I>IBM AFS Administration
-Guide</I>.
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf059.htm#HDRAFSMONITOR">afsmonitor</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="auarf051.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="auarf053.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>
diff --git a/doc/html/AdminReference/auarf053.htm b/doc/html/AdminReference/auarf053.htm
deleted file mode 100644 (file)
index 6fe5ded..0000000
+++ /dev/null
@@ -1,655 +0,0 @@
-<!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="auarf052.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="auarf054.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="HDRPACKAGECONFIG" HREF="auarf002.htm#ToC_51">package Configuration File</A></H2>
-<P><STRONG>Purpose</STRONG>
-<A NAME="IDX4038"></A>
-<A NAME="IDX4039"></A>
-<A NAME="IDX4040"></A>
-<P>Provides instructions for the <B>package</B> command
-<P><STRONG>Description</STRONG>
-<P>The <B>package</B> configuration file defines the file system elements
-that the <B>package</B> command creates or alters on the local disk of an
-AFS client machine it is configuring. Use the <B>-config</B> or
-<B>-fullconfig</B> argument to the <B>package</B> command to identify
-the configuration file to use.
-<P><B>Summary of Configuration File Instructions</B>
-<P>The configuration file can include one or more instances of each of the
-following instructions, each on its own line. A more detailed
-description of each instruction's syntax follows this list.
-<DL>
-<P><DT><B>B
-</B><DD>Defines a block special device, such as a disk, which deals with input in
-units of multi-byte command blocks
-<P><DT><B>C
-</B><DD>Defines a character special device, such as a terminal or tty, which deals
-with input in single character units
-<P><DT><B>D
-</B><DD>Creates a directory
-<P><DT><B>F
-</B><DD>Creates or alters a file to match the contents of a specified source file
-<P><DT><B>L
-</B><DD>Creates a symbolic link
-<P><DT><B>S
-</B><DD>Defines a socket, which is a communications device for UDP and TCP/IP
-connections
-<P><DT><B>%define
-</B><DD>Defines a variable or declares a string as defined
-<P><DT><B>%ifdef
-</B><DD>Specifies an action to perform if a certain string is declared or defined
-<P><DT><B>%ifndef
-</B><DD>Specifies an action to perform if a certain string is not declared or
-defined
-<P><DT><B>%include
-</B><DD>Includes a library file
-<P><DT><B>%undef
-</B><DD>Declares a string not to be defined, or a variable no longer to have a
-value
-</DL>
-<P><B>The B and C Instructions for Defining Block and Character Special
-Devices</B>
-<A NAME="IDX4041"></A>
-<A NAME="IDX4042"></A>
-<A NAME="IDX4043"></A>
-<A NAME="IDX4044"></A>
-<A NAME="IDX4045"></A>
-<A NAME="IDX4046"></A>
-<A NAME="IDX4047"></A>
-<A NAME="IDX4048"></A>
-<A NAME="IDX4049"></A>
-<A NAME="IDX4050"></A>
-<A NAME="IDX4051"></A>
-<A NAME="IDX4052"></A>
-<A NAME="IDX4053"></A>
-<A NAME="IDX4054"></A>
-<A NAME="IDX4055"></A>
-<P>The <B>B</B> instruction in a <B>package</B> configuration file
-defines a block special device, such as a disk, that deals with input in units
-of multi-byte command blocks. The <B>C</B> instruction defines a
-character special device, such as a terminal or tty, that deals with input in
-single character units. They share a common syntax:
-<PRE>   {<B>B </B>| <B>C</B>}   <VAR>device_name</VAR>  <VAR>major_device</VAR>  <VAR>minor_device</VAR>  <VAR>owner</VAR>  <VAR>group</VAR>  <VAR>mode_bits</VAR>
-   
-</PRE>
-<P>where
-<DL>
-<P><DT><B>B
-</B><DD>Indicates the definition of a block special device. It must be a
-capital letter.
-<P><DT><B>C
-</B><DD>Indicates the definition of character special device. It must be a
-capital letter.
-<P><DT><B><VAR>device_name</VAR>
-</B><DD>Names the special device to define. To learn the name format
-appropriate to the machine's system type, consult the hardware or
-operating system documentation.
-<P><DT><B><VAR>major_device</VAR>
-</B><DD>Specifies the device's major device number in decimal format.
-To learn the correct value for the machine's system type, consult the
-hardware or operating system documentation.
-<P><DT><B><VAR>minor_device</VAR>
-</B><DD>Specifies the device's minor device number in one of hexadecimal,
-octal, or decimal format. Precede a hexadecimal number with the string
-<B>0x</B> (zero and the letter <B>x</B>) or an octal number with a
-<B>0</B> (zero). A number without either prefix is interpreted as a
-decimal. To learn the correct value for the machine's system type,
-consult the hardware or operating system documentation.
-<P><DT><B><VAR>owner</VAR>
-</B><DD>Specifies the username or UNIX user ID (UID) of the user to be designated
-the device's owner in the output from the UNIX <B>ls -l</B>
-command.
-<P><DT><B><VAR>group</VAR>
-</B><DD>Specifies the group name or UNIX group ID (GID) of the group to be
-designated the device's group in the output from the UNIX <B>ls
--lg</B> command.
-<P><DT><B><VAR>mode_bits</VAR>
-</B><DD>Defines the device's UNIX mode bits. Acceptable values are the
-standard three- or four-digit numbers corresponding to combinations of
-permissions. Examples: <B>755</B> corresponds to
-<B>rwxr-xr-x</B>, and <B>644</B> to <B>rw-r--r--</B>.
-</DL>
-<P><B>The D Instruction for Creating a Directory</B>
-<A NAME="IDX4056"></A>
-<A NAME="IDX4057"></A>
-<A NAME="IDX4058"></A>
-<A NAME="IDX4059"></A>
-<A NAME="IDX4060"></A>
-<A NAME="IDX4061"></A>
-<A NAME="IDX4062"></A>
-<P>The <B>D</B> instruction in a <B>package</B> configuration file
-creates a directory on the local disk. If a symbolic link, file, or
-other element on the local disk has the same name, it is replaced with a
-directory. If the directory already exists, its owner, group, and mode
-bits are changed if necessary to conform with the instruction. The
-instruction has the following syntax:
-<PRE>   <B>D</B>[<VAR>update_code</VAR>]  <VAR>directory</VAR>  <VAR>owner</VAR>  <VAR>group</VAR>  <VAR>mode_bits</VAR>
-   
-</PRE>
-<P>where
-<DL>
-<P><DT><B>D
-</B><DD>Indicates the creation of a directory. It must be a capital
-letter.
-<P><DT><B><VAR>update_code</VAR>
-</B><DD>Modulates the directory creation instruction. It is optional and
-follows the letter <B>D</B> directly, without an intervening space.
-Choose one of the two acceptable values: 
-<DL>
-<P><DT><B>X
-</B><DD>Indicates that the directory is a <B>lost+found</B> directory (used by
-the <B>fsck</B> program).
-<P><DT><B>R
-</B><DD>Removes any subdirectory (along its contents) or file that exists in the
-existing directory on the local disk but for which an instruction does not
-appear in the configuration file.
-</DL>
-<P><DT><B><VAR>directory</VAR>
-</B><DD>Specifies the full pathname of the directory to create.
-<P><DT><B><VAR>owner</VAR>
-</B><DD>Specifies the username or UNIX user ID (UID) of the user to be designated
-the directory's owner in the output from the UNIX <B>ls -ld</B>
-command.
-<P><DT><B><VAR>group</VAR>
-</B><DD>Specifies the name or UNIX group ID (GID) of the group to be designated
-the directory's group in the output from the UNIX <B>ls -lgd</B>
-command.
-<P><DT><B><VAR>mode_bits</VAR>
-</B><DD>Defines the directory's UNIX mode bits. Acceptable values are
-the standard three- or four-digit numbers corresponding to combinations of
-permissions. Examples: <B>755</B> corresponds to
-<B>drwxr-xr-x</B>, and <B>644</B> to <B>drw-r--r--</B>.
-</DL>
-<P><B>The F Instruction for Creating or Updating a File</B>
-<A NAME="IDX4063"></A>
-<A NAME="IDX4064"></A>
-<A NAME="IDX4065"></A>
-<A NAME="IDX4066"></A>
-<A NAME="IDX4067"></A>
-<A NAME="IDX4068"></A>
-<A NAME="IDX4069"></A>
-<P>The <B>F</B> instruction in a <B>package</B> configuration file
-creates or updates a file on the local disk by copying in the contents of the
-indicated source file, which can reside in AFS or on the local disk. If
-the <B>package</B> command interpreter cannot access the source file, it
-exits without executing any instruction in the configuration file.
-<P>If a file with the same name already exists on disk, the <B>package</B>
-command overwrites it with the contents of the source file, unless the
-<B>I</B> update code is used to prevent that. To add a
-<B>.old</B> extension to the current version of the file, include
-the <B>O</B> update code. To have the machine reboot automatically
-after the <B>package</B> program completes, include the <B>Q</B>
-update code.
-<P>If a symbolic link, directory, or other element on the local disk has the
-same name, it is replaced with the file (a directory's contents are first
-removed as necessary).
-<P>The instruction has the following syntax:
-<PRE>   <B>F</B>[<VAR>update_code</VAR>]  <VAR>file</VAR>  <VAR>source_file</VAR>  [<VAR>owner  group  mode_bits</VAR>]
-   
-</PRE>
-<P>where
-<DL>
-<P><DT><B>F
-</B><DD>Indicates the creation or update of a file. It must be a capital
-letter.
-<P><DT><B><VAR>update_code</VAR>
-</B><DD>Modulates the file creation instruction. It is optional and follows
-the letter <B>F</B> directly, without an intervening space. Choose
-one or more of the four acceptable values, and list them in any order: 
-<DL>
-<P><DT><B>A
-</B><DD>Indicates that the pathname in the <VAR>source_file</VAR> field is the
-complete pathname of the source file, including the filename. If this
-argument is omitted, the <B>package</B> command appends the pathname in
-the <VAR> file</VAR> field to the pathname in the <VAR>source_file</VAR> field to
-derive the source file's full name. This code allows the source
-and target filenames to differ.
-<P><DT><B>I
-</B><DD>Preserves the existing file called <VAR>file</VAR>, rather than overwriting
-it.
-<P><DT><B>O
-</B><DD>Saves the existing version of the file by appending a
-<B>.old</B> extension to it.
-<P><DT><B>Q
-</B><DD>Causes the <B>package</B> command to exit with status code
-<B>4</B> if it overwrites the file. If the standard
-<B>package</B>-related changes have been made to the machine's AFS
-initialization file, then status code <B>4</B> causes the machine to
-reboot automatically. Use this code when the machine must reboot if
-updates to the file are to have any effect (for example, if the operating
-system file--<B>/vmunix</B> or equivalent--has changed).
-</DL>
-<P><DT><B><VAR>file</VAR>
-</B><DD>Specifies the complete pathname on the local disk of the file to create or
-update, including the filename as the final element.
-<P><DT><B><VAR>source_file</VAR>
-</B><DD>Specifies the pathname (local or AFS) of the file to copy to the local
-disk.
-<P>If the <B>A</B> update code is included, specify the source file's
-complete pathname. Otherwise, the <B>package</B> command derives
-the source file's full name by appending the <VAR>file</VAR> pathname to
-this pathname. For example, if the <B>A</B> update code is not
-included and the file <B>/afs/abc.com/rs_aix42/bin/grep</B> is the
-source file for the <B>/bin/grep</B> binary, the proper value in this
-field is <B>/afs/abc.com/rs_aix42</B>.
-<P><DT><B><VAR>owner</VAR>
-</B><DD>Specifies the username or UNIX user ID (UID) of the user to be designated
-the file's owner in the output from the UNIX <B>ls -l</B>
-command. 
-<P>To copy the source file's owner to the target file, leave this field
-empty. In this case, the <VAR>group</VAR> and <VAR>mode_bits</VAR> fields
-must also be empty.
-<P><DT><B><VAR>group</VAR>
-</B><DD>Specifies the name or UNIX group ID (GID) of the group to be designated
-the file's group in the output from the UNIX <B>ls -lg</B>
-command. 
-<P>To copy the source file's group to the target file, leave this field
-empty. In this case, the <VAR> owner</VAR> and <VAR>mode_bits</VAR> fields
-must also be empty.
-<P><DT><B><VAR>mode_bits</VAR>
-</B><DD>Defines the file's UNIX mode bits. Acceptable values are the
-standard three- or four-digit numbers corresponding to combinations of
-permissions. Examples: <B>755</B> corresponds to
-<B>rwxr-xr-x</B>, and <B>644</B> to <B>rw-r--r--</B>. 
-<P>To copy the source file's mode bits to the target file, leave this
-field empty. In this case, the <VAR>owner</VAR> and <VAR>group</VAR> fields
-must also be empty.
-</DL>
-<P><B>The L Instruction for Creating a Symbolic Link</B>
-<A NAME="IDX4070"></A>
-<A NAME="IDX4071"></A>
-<A NAME="IDX4072"></A>
-<A NAME="IDX4073"></A>
-<A NAME="IDX4074"></A>
-<A NAME="IDX4075"></A>
-<A NAME="IDX4076"></A>
-<P>The <B>L</B> instruction in a <B>package</B> configuration file
-creates a symbolic link on the local disk to a directory or file that exists
-either in AFS or elsewhere on the local disk. As with the standard UNIX
-<B>ln -s</B> command, the link is created even if the actual file or
-directory does not exist.
-<P>If a file or directory on the local disk already has the same name, the
-<B>package</B> command replaces it with a symbolic link.
-<P>The instruction has the following syntax:
-<PRE>   <B>L</B>[<VAR>update_code</VAR>]  <VAR>link</VAR>  <VAR>actual_path</VAR>  [<VAR>owner  group  mode_bits</VAR>]
-    
-</PRE>
-<P>where
-<DL>
-<P><DT><B>L
-</B><DD>Indicates the creation of a symbolic link. It must be a capital
-letter.
-<P><DT><B><VAR>update_code</VAR>
-</B><DD>Modulates the link creation instruction. It is optional and follows
-the letter <B>L</B> directly, without an intervening space. Choose
-one or both of the acceptable values, and list them in any order: 
-<DL>
-<P><DT><B>A
-</B><DD>Indicates that the pathname in the <VAR>actual_path</VAR> field is the
-complete pathname of the actual directory or file (including the filename for
-a file). If this argument is omitted, the <B>package</B> command
-appends the value in the <VAR>link</VAR> field to the pathname in the
-<VAR>actual_path</VAR> field to derive the actual directory or file's full
-name. This code allows the name of the symbolic link and actual
-directory or file to differ.
-<P><DT><B>I
-</B><DD>Preserves the existing symbolic link called <VAR>link</VAR>, rather than
-overwriting it.
-</DL>
-<P><DT><B><VAR>link</VAR>
-</B><DD>Specifies the complete local disk pathname of the symbolic link to
-create.
-<P><DT><B><VAR>actual_path</VAR>
-</B><DD>Specifies the pathname (local or AFS) of the directory or file to which
-the link refers. If the <B>A</B> update code is included, specify
-the directory or file's complete pathname. Otherwise, the
-<B>package</B> command derives the actual directory or file's full
-name by appending the value in the <VAR>link</VAR> field to this
-pathname. For example, if the <B>A</B> update code is not included
-and <B>/etc/ftpd</B> is a symbolic link to the file
-<B>/afs/abc.com/sun4x_56/etc/ftpd</B>, the proper value in this
-field is <B>/afs/abc.com/sun4x_56</B>.
-<P>The <B>package</B> command interpreter correctly handles pathnames that
-begin with the <B>./</B> (period, slash) or
-<B>../</B> (two periods, slash) notation, interpreting them
-relative to the current working directory from which the <B>package</B>
-command is invoked.
-<P><DT><B><VAR>owner</VAR>
-</B><DD>Specifies the username or UNIX user ID (UID) of the user to be designated
-the symbolic link's owner in the output from the UNIX <B>ls -l</B>
-command.
-<P>To designate the issuer of the <B>package</B> command (usually, the
-local superuser <B>root</B>) as the symbolic link's owner, leave this
-field empty. In this case, the <VAR>group</VAR> and <VAR>mode_bits</VAR>
-fields must also be empty.
-<P><DT><B><VAR>group</VAR>
-</B><DD>Specifies the name or UNIX group ID (GID) of the group to be designated
-the link's group in the output from the UNIX <B>ls -lg</B>
-command.
-<P>To have the symbolic link's group match the default group associated
-with the <B>package</B> command's issuer, leave this field
-empty. The issuer is usually the local superuser <B>root</B> and
-the default group is designated in the issuer's entry in the local
-<B>/etc/passwd</B> file or equivalent. If this field is left empty,
-the <VAR>owner</VAR> and <VAR>mode_bits</VAR> fields must also be empty.
-<P><DT><B><VAR>mode_bits</VAR>
-</B><DD>Defines the symbolic link's UNIX mode bits. Acceptable values
-are the standard three- or four-digit numbers corresponding to combinations of
-permissions. Examples: <B>755</B> corresponds to
-<B>rwxr-xr-x</B>, and <B>644</B> to <B>rw-r--r--</B>.
-<P>Leaving this field empty sets the symbolic link's mode bits to
-<B>777</B> (<B>rwxrwxrwx</B>). In this case, the <VAR>owner</VAR>
-and <VAR>group</VAR> fields must also be empty.
-</DL>
-<P><B>The S Instruction for Creating a Socket</B>
-<A NAME="IDX4077"></A>
-<A NAME="IDX4078"></A>
-<A NAME="IDX4079"></A>
-<A NAME="IDX4080"></A>
-<A NAME="IDX4081"></A>
-<A NAME="IDX4082"></A>
-<A NAME="IDX4083"></A>
-<P>The <B>S</B> instruction in a <B>package</B> configuration file
-creates a socket (a communications device for UDP or TCP/IP connections) on
-the local disk. The instruction has the following syntax:
-<PRE>   <B>S</B>  <VAR>socket</VAR> [<VAR>owner  group  mode_bits</VAR>]
-   
-</PRE>
-<P>where
-<DL>
-<P><DT><B>S
-</B><DD>Indicates the creation of a socket. It must be a capital
-letter.
-<P><DT><B><VAR>socket</VAR>
-</B><DD>Names the socket. The proper format depends on the local
-machine's operating system.
-<P><DT><B><VAR>owner</VAR>
-</B><DD>Specifies the username or UNIX user ID (UID) of the user to be designated
-the socket's owner in the output from the UNIX <B>ls -l</B>
-command.
-<P>To designate the issuer of the <B>package</B> command (usually, the
-local superuser <B>root</B>) as the socket's owner, leave this field
-empty. In this case, the <VAR>group</VAR> and <VAR>mode_bits</VAR> fields
-must also be empty.
-<P><DT><B><VAR>group</VAR>
-</B><DD>Specifies the name or UNIX group ID (GID) of the group to be designated
-the socket's group in the output from the UNIX <B>ls -lg</B>
-command.
-<P>To have the symbolic link's group match the default group associated
-with the <B>package</B> command's issuer, leave this field
-empty. The issuer is usually the local superuser <B>root</B> and
-the default group is designated in the issuer's entry in the local
-<B>/etc/passwd</B> file or equivalent. If this field is left empty,
-the <VAR>owner</VAR> and <VAR>mode_bits</VAR> fields must also be empty.
-<P><DT><B><VAR>mode_bits</VAR>
-</B><DD>Defines the socket's UNIX mode bits. Acceptable values are the
-standard three- or four-digit numbers corresponding to combinations of
-permissions. Examples: <B>755</B> corresponds to
-<B>rwxr-xr-x</B>, and <B>644</B> to <B>rw-r--r--</B>.
-<P>Leaving this field empty sets the symbolic link's mode bits to
-<B>777</B> (<B>rwxrwxrwx</B>), modulated by the cell's
-umask. In this case, the <VAR>owner</VAR> and <VAR>group</VAR> fields must
-also be empty.
-</DL>
-<P><B>The %define or %undef Instructions Declaring or Undeclaring a
-Definition</B>
-<A NAME="IDX4084"></A>
-<A NAME="IDX4085"></A>
-<A NAME="IDX4086"></A>
-<A NAME="IDX4087"></A>
-<A NAME="IDX4088"></A>
-<A NAME="IDX4089"></A>
-<P>The <B>%define</B> instruction in a <B>package</B> configuration
-file declares or defines a variable, depending on its number of
-arguments:
-<UL>
-<P><LI>If followed by a single argument, it declares that argument to be
-defined. The argument is then available as a controller when mentioned
-in <B>%ifdef</B> and <B>%ifndef</B> statements, which evaluate to
-<B>true</B> and <B>false</B> respectively.
-<P><LI>If followed by two arguments, it defines the second argument as the value
-of the first. When the first argument appears later in this prototype
-or other prototype or library files as a variable--surrounded by curly
-braces and preceded by a dollar sign, as in the example
-<TT>${variable}</TT>--the <B>package</B> command interpreter
-substitutes the second argument for it.
-</UL>
-<P>The <B>%undef</B> statement negates the effect of a previous
-<B>%define</B> statement, declaring its argument to be defined no longer,
-or to have a value no longer if it is a variable.
-<P>The syntax for the two types of instruction are as follows:
-<PRE>   %define  <VAR>declaration</VAR>
-   %define  <VAR>variable</VAR>  <VAR>value</VAR>
-   %undef  <VAR>declaration</VAR>
-   %undef  <VAR>variable</VAR>
-   
-</PRE>
-<P>where
-<DL>
-<P><DT><B>%define
-</B><DD>Indicates a definition statement.
-<P><DT><B>%undef
-</B><DD>Indicates a statement that negates a definition.
-<P><DT><B><VAR>declaration</VAR>
-</B><DD>Names the string being declared by a <B>%define</B> statement, or
-negated by an <B>%undef</B> statement.
-<P><DT><B><VAR>variable</VAR>
-</B><DD>Specifies the name of the variable that a <B>%define</B> statement is
-defining, or an <B>%undef</B> statement is negating.
-<P><DT><B><VAR>value</VAR>
-</B><DD>Specifies the value to substitute for the string in the <VAR>variable</VAR>
-field when it appears in the appropriate format (surrounded by curly braces
-and preceded by a dollar sign, as in the example <TT>${variable}</TT>), in
-this or other prototype and library files. It can include one or more
-words.
-</DL>
-<P><B>The %ifdef and %ifndef Instructions for Specifying a Conditional
-Action to Perform</B>
-<A NAME="IDX4090"></A>
-<A NAME="IDX4091"></A>
-<A NAME="IDX4092"></A>
-<A NAME="IDX4093"></A>
-<A NAME="IDX4094"></A>
-<A NAME="IDX4095"></A>
-<P>The <B>%ifdef</B> instruction in a <B>package</B> configuration
-file specifies one or more actions to perform if the indicated string has been
-declared by a single-argument <B>%define</B> statement, or is a variable
-for which a value has been defined by a two-argument <B>%define</B>
-statement.
-<P>Similarly, the <B>%ifndef</B> instruction specifies one or more actions
-to perform if the indicated string has not been declared or is a variable
-without a value, either because no <B>%define</B> statement has defined it
-or an <B>%undef</B> statement has undefined it.
-<P>In both cases, the optional <B>%else</B> statement specifies one or
-more alternate actions to perform if the first statement evaluates to
-<B>false</B>. (For an <B>%ifdef</B> statement, the
-<B>%else</B> statement is executed if the indicated string has never been
-declared or is a variable without a value, or if an <B>%undef</B>
-statement has undefined either one; for an <B>%ifndef</B> statement,
-it is executed if the string has been declared or is a variable with a
-value.)
-<P>It is possible to nest any number of <B>%ifdef</B> and
-<B>%ifndef</B> statements.
-<P>The two types of statement share a common syntax:
-<PRE>   %ifdef | ifndef   <VAR>declaration</VAR> 
-                                  <VAR>action</VAR><SUP>+</SUP>
-   [%else [<VAR>declaration</VAR>] 
-                  <VAR>alternate_action</VAR><SUP>+</SUP>]
-   %endif <VAR>declaration</VAR>
-   
-</PRE>
-<P>where
-<DL>
-<P><DT><B>ifdef
-</B><DD>Indicates that the statement evaluates as <B>true</B> if the string in
-the <VAR>declaration</VAR> field is declared or is a variable with a defined
-value.
-<P><DT><B>ifndef
-</B><DD>Indicates that the statement evaluates as <B>true</B> if the string in
-the <VAR>declaration</VAR> field is not declared or is a variable without a
-defined value.
-<P><DT><B><VAR>declaration</VAR>
-</B><DD>Specifies the string that must be declared or the variable name that must
-have a defined value for an <B>%ifdef</B> statement to evaluate as
-<B>true</B>, which results in the specified action being performed.
-For an <B>%ifndef</B> statement, the string must not be declared or the
-variable must have no defined value for the statement to evaluate as
-<B>true</B>. The first and third occurrences of
-<VAR>declaration</VAR> (the latter following the string <B>%endif</B>) are
-required. The second occurrence (following the string <B>%else</B>)
-is optional, serving only to clarify to which <B>%ifdef</B> or
-<B>%ifndef</B> statement the <B>%else</B> statement belongs.
-<P><DT><B><VAR>action</VAR>
-</B><DD>Specifies each action to perform if the <B>%ifdef</B> or
-<B>%ifndef</B> statement evaluates as <B>true</B>. Each action
-must appear on a separate line. Acceptable types of actions are other
-statements beginning with a percent sign and definition instructions.
-<P><DT><B><VAR>alternate_action</VAR>
-</B><DD>Specifies each action to perform if the <B>%ifdef</B> or
-<B>%ifndef</B> statement evaluates to <B>false</B>. Each action
-must appear on a separate line. Acceptable types of actions are other
-statements beginning with a percent sign and definition instructions.
-</DL>
-<P><B>The %include Instruction for Including a Library File</B>
-<A NAME="IDX4096"></A>
-<A NAME="IDX4097"></A>
-<A NAME="IDX4098"></A>
-<P>The <B>%include</B> instruction in a <B>package</B> configuration
-file includes the contents of the indicated library file in a configuration
-file that results from the compilation of the prototype file in which the
-<B>%include</B> instruction appears. It has the following
-syntax:
-<PRE>   %include  <VAR>pathname</VAR>
-   
-</PRE>
-<P>where
-<DL>
-<P><DT><B>%include
-</B><DD>Indicates a library file include statement.
-<P><DT><B><VAR>pathname</VAR>
-</B><DD>Specifies the complete pathname of the library file to include. It
-can be in AFS or on the local disk, and can include one or more
-variables.
-</DL>
-<P><STRONG>Cautions</STRONG>
-<P>The configuration file must be completely correct. If there are any
-syntax errors or incorrect values, the <B>package</B> command interpreter
-exits without executing any instruction.
-<P><STRONG>Examples</STRONG>
-<P>The following example <B>B</B> and <B>C</B> instructions define a
-disk <B>/dev/hd0a</B> with major and minor device numbers <B>1</B> and
-<B>0</B> and mode bits of <B>-rw-r--r--</B>, and a tty
-<B>/dev/ttyp5</B> with major and minor device numbers <B>6</B> and
-<B>5</B> and mode bits of <B>-rw-rw-rw</B>. In both cases, the
-owner is <B>root</B> and the owning group <B>wheel</B>.
-<PRE>   B /dev/hd0a 1 0 root wheel 644
-   C /dev/ttyp5 6 5 root wheel 666
-   
-</PRE>
-<P>The following example <B>D</B> instruction creates the local
-<B>/usr</B> directory with owner <B>root</B> and group
-<B>wheel</B> and mode bits of <B>drwxr-xr-x</B>. The
-<B>R</B> update code removes any files and subdirectories that reside in
-the <B>/usr</B> directory (if it already exists) but do not appear in the
-configuration file.
-<PRE>   DR /usr root wheel 755
-   
-</PRE>
-<P>The following example <B>F</B> instruction, appropriate for a machine
-running AIX 4.2 in the ABC Corporation cell, creates or updates the
-local disk file <B>/bin/grep</B>, using
-<B>/afs/abc.com/rs_aix42/bin/grep</B> as the source.
-<PRE>   F /bin/grep /afs/abc.com/rs_aix42 root wheel 755
-   
-</PRE>
-<P>The next example <B>F</B> instruction creates the
-<B>/usr/vice/etc/ThisCell</B> file and specifies an absolute pathname for
-the source file, as indicated by the <B>A</B> update code. The
-<B>Q</B> code makes the <B>package</B> command return status code 4 as
-it exits, prompting a reboot of the machine if the standard
-<B>package</B>-related changes have been made to the machine's AFS
-initialization file. No values are provided for the owner, group and
-mode bits, so the file inherits them from the source file.
-<PRE>   FAQ /usr/vice/etc/ThisCell /afs/abc.com/common/etc/ThisCell
-   
-</PRE>
-<P>The following example <B>L</B> instruction, appropriate for a machine
-running AIX 4.2 in the ABC Corporation cell, creates a symbolic link
-from <B>/etc/ftpd</B> on the local disk to the file
-<B>/afs/abc.com/rs_aix42/etc/ftpd</B>.
-<PRE>   L /etc/ftpd /afs/abc.com/rs_aix42 root wheel 644
-   
-</PRE>
-<P>The following example <B>S</B> instruction defines the socket
-<B>/dev/printer</B>.
-<PRE> 
-   S /dev/printer root wheel 777
-   
-</PRE>
-<P>The following example <B>%define</B> instruction defines the value for
-the variable <TT>${diskmode}</TT>. This variable is used elsewhere in
-the template to fill the <VAR>owner_name</VAR>, <VAR>group_name</VAR>, and
-<VAR>mode_bits</VAR> fields in a <B>D</B>, <B>F</B>, or <B>L</B>
-instruction.
-<PRE>   %define diskmode root wheel 644
-    
-</PRE>
-<P>The following example <B>%undef</B> instruction declares the string
-<B>afsd</B> not to be defined.
-<PRE>   %undef afsd
-   
-</PRE>
-<P>The following example <B>%ifdef</B> instruction specifies that if the
-string <TT>rs_aix42</TT> is currently declared, then when the prototype file
-containing the instruction is compiled the three indicated library files are
-included. There is no alternate action defined. There must be
-<B>%define</B> statements earlier in the prototype file to declare
-<B>rs_aix42</B> and to assign a value to the <TT>${wsadmin}</TT>
-variable.
-<PRE>   %ifdef rs_aix42
-   %include ${wsadmin}/lib/rs_aix42.readonly
-   %include ${wsadmin}/lib/rs_aix42.generic
-   %include ${wsadmin}/lib/rs_aix42.generic.dev
-   %endif rs_aix42
-   
-</PRE>
-<P>The following example <B>%ifndef</B> instruction, appropriate for the
-State University cell, defines <TT>stateu.edu</TT> as the value of
-the <TT>${cell}</TT> variable if it does not already have a value.
-<PRE>   %ifndef cell
-   %define cell stateu.edu
-   %endif cell
-   
-</PRE>
-<P>The following example <B>%include</B> instruction includes the library
-file <B>base.generic</B> from the <B>lib</B> subdirectory of
-the directory in which <B>package</B>-related files reside. The
-<TT>${wsadmin}</TT> variable resolves to an actual pathname (such as
-<B>/afs/abc.com/wsadmin</B>) during compilation.
-<PRE>   %include ${wsadmin}/lib/base.generic
-   
-</PRE>
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf204.htm#HDRPACKAGE">package</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="auarf052.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="auarf054.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>
diff --git a/doc/html/AdminReference/auarf054.htm b/doc/html/AdminReference/auarf054.htm
deleted file mode 100644 (file)
index eab3e26..0000000
+++ /dev/null
@@ -1,343 +0,0 @@
-<!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="auarf053.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="auarf055.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="HDRUSSBULKINPUT" HREF="auarf002.htm#ToC_52">uss Bulk Input File</A></H2>
-<A NAME="IDX4099"></A>
-<A NAME="IDX4100"></A>
-<A NAME="IDX4101"></A>
-<P><STRONG>Purpose</STRONG>
-<P>Provides instructions for the <B>uss bulk</B> command
-<P><STRONG>Description</STRONG>
-<P>The <B>uss</B> bulk input file lists instructions for the
-<B>uss</B> command interpreter to execute when running the <B>uss
-bulk</B> command. If the file includes <B>add</B> instructions
-that reference a <B>uss</B> template file, then the template file must
-also exist.
-<P><B>Summary of Bulk Input File Instructions</B>
-<P>The bulk input file can include the following instructions, each on its own
-line. A more detailed description of each instruction's syntax
-follows this list.
-<DL>
-<P><DT><B>add
-</B><DD>Creates a user account. Equivalent to the <B>uss add</B>
-command.
-<P><DT><B>delete
-</B><DD>Deletes a user account. Equivalent to the <B>uss delete</B>
-command.
-<P><DT><B>delvolume
-</B><DD>Removes the volume and VLDB entry for each account referenced by a
-<B>delete</B> instruction that follows this instruction in the bulk input
-file.
-<P><DT><B>exec
-</B><DD>Executes a command.
-<P><DT><B>savevolume
-</B><DD>Preserves the volume and VLDB entry for each account referenced by a
-<B>delete</B> instruction that follows this instruction in the bulk input
-file.
-</DL>
-<P><B>The add Instruction for Creating an Account</B>
-<A NAME="IDX4102"></A>
-<A NAME="IDX4103"></A>
-<P>The <B>add</B> instruction creates a user account. Each instance
-in the bulk input file is equivalent in effect to a <B>uss add</B> command
-issued on the command line. The order of the instruction's fields
-matches the order of arguments to the <B>uss add</B> command, although
-some arguments do not have a corresponding field. Like the <B>uss
-add</B> command's arguments, many of the fields correspond to (provide
-a value for) a variable in the <B>uss</B> template file, as indicated in
-the following description of each field.
-<P>The instruction's syntax is as follows. It appears on multiple
-lines here only for the sake of legibility--each <B>add</B>
-instruction must appear on a single line in the bulk input file.
-<PRE>   add <VAR>username</VAR>[:<VAR>full_name</VAR>][:<VAR>initial_password</VAR>][:<VAR>password_expires</VAR>]
-       [:<VAR>file_server</VAR>][:<VAR>partition</VAR>][:<VAR>mount_point</VAR>][:<VAR>uid</VAR>][:<VAR>var1</VAR>][:<VAR>var2</VAR>]
-       [:<VAR>var3</VAR>][:<VAR>var4</VAR>][:<VAR>var5</VAR>][:<VAR>var6</VAR>][:<VAR>var7</VAR>][:<VAR>var8</VAR>][:<VAR>var9</VAR>][:]
-   
-</PRE>
-<P>To omit a value for a field (presumably because it is optional or the
-template specifies a constant value for it), type nothing between the two
-colons that surround it. After the last argument provided, end the line
-with either a colon and carriage return, or a carriage return alone.
-<P>The meaning of, and acceptable values for, each field are as
-follows.
-<DL>
-<P><DT><B><VAR>username</VAR>
-</B><DD>Names the user's Authentication Database and Protection Database
-entries. It can include up to eight alphanumeric characters, but not
-the <B>:</B> (colon), <B>.</B> (period), or <B>@</B>
-(at-sign) characters. Because it becomes the username (the name under
-which a user logs in), it is best not to include shell metacharacters and to
-obey the restrictions that many operating systems impose on usernames
-(usually, to contain no more than eight lowercase letters).
-<P>Corresponding argument to the <B>uss add</B> command:
-<B>-user</B>. Corresponding variable in the template file:
-$USER.
-<P><DT><B><VAR>full_name</VAR>
-</B><DD>Specifies the user's full name. Do not surround it with double
-quotes (""), even if it contains spaces. If not provided, it defaults
-to the username in the <VAR>username</VAR> field. 
-<P>Corresponding argument to the <B>uss add</B> command:
-<B>-realname</B>. Corresponding variable in the template
-file: $NAME. Many operating systems include a field for the full
-name in a user's entry in the local password file (<B>/etc/passwd</B>
-or equivalent), and this variable can be used to pass a value to be used in
-that field.
-<P><DT><B><VAR>initial_password</VAR>
-</B><DD>Specifies the user's initial password. Although the AFS
-commands that handle passwords accept strings of virtually unlimited length,
-it is best to use a password of eight characters or less, which is the maximum
-length that many applications and utilities accept. If not provided,
-this argument defaults to the string <B>changeme</B>.
-<P>Corresponding argument to the <B>uss add</B> command:
-<B>-pass</B>. Corresponding variable in the template file:
-none.
-<P><DT><B><VAR>password_expires</VAR>
-</B><DD>Sets the number of days after a user's password is changed that it
-remains valid. Provide an integer from the range <B>1</B> through
-<B>254</B> to specify the number of days until expiration, or the value
-<B>0</B> to indicate that the password never expires (the default).
-<P>When the password becomes invalid (expires), the user is unable to
-authenticate, but has 30 more days in which to issue the <B>kpasswd</B>
-command to change the password (after that, only an administrator can change
-it).
-<P>Corresponding argument to the <B>uss add</B> command:
-<B>-pwexpires</B>. Corresponding variable in the template
-file: $PWEXPIRES.
-<P><DT><B><VAR>file_server</VAR>
-</B><DD>Names the file server machine on which to create the new user's
-volume. It is best to provide a fully-qualified hostname (for example,
-<B>fs1.abc.com</B>), but an abbreviated form is acceptable
-provided that the cell's naming service is available to resolve it at the
-time the volume is created.
-<P>Corresponding argument to the <B>uss add</B> command:
-<B>-server</B>. Corresponding variable in the template file:
-$SERVER.
-<P><DT><B><VAR>partition</VAR>
-</B><DD>Specifies the partition on which to create the user's volume; it
-must reside on the file server machine named in the <VAR>file_server</VAR>
-field. Identify the partition by its complete name (for example,
-<B>/vicepa</B>, or use one of the following abbreviations: 
-<PRE>   <B>/vicepa</B>     =     <B>vicepa</B>      =      <B>a</B>      =      <B>0</B>
-   <B>/vicepb</B>     =     <B>vicepb</B>      =      <B>b</B>      =      <B>1</B>
-   
-</PRE>
-<P>
-<P>After <B>/vicepz</B> (for which the index is 25) comes 
-<PRE>   <B>/vicepaa</B>    =     <B>vicepaa</B>     =      <B>aa</B>     =      <B>26</B>
-   <B>/vicepab</B>    =     <B>vicepab</B>     =      <B>ab</B>     =      <B>27</B>
-   
-</PRE>
-<P>and so on through 
-<PRE>   <B>/vicepiv</B>    =     <B>vicepiv</B>     =      <B>iv</B>     =      <B>255</B>
-    
-</PRE>
-<P>Corresponding argument to the <B>uss add</B> command:
-<B>-partition</B>. Corresponding variable in template:
-$PART.
-<P><DT><B><VAR>mount_point</VAR>
-</B><DD>Specifies the complete pathname for the user's home directory.
-<P>Corresponding argument to the <B>uss add</B> command:
-<B>-mount</B>.
-<P>Corresponding variable in template: $MTPT, but in the template
-file's <B>V</B> instruction only. Occurrences of the $MTPT
-variable in template instructions that follow the <B>V</B> instruction
-take their value from the <B>V</B> instruction's <VAR>mount_point</VAR>
-field. Thus the value of this command line argument becomes the value
-for the $MTPT variable in instructions that follow the <B>V</B>
-instruction only if the string $MTPT appears alone in the <B>V</B>
-instruction's <VAR>mount_point</VAR> field.
-<P><DT><B><VAR>uid</VAR>
-</B><DD>Specifies a positive integer other than <B>0</B> (zero) to assign as
-the user's AFS UID. If this argument is omitted, the Protection
-Server assigns an AFS UID that is one greater than the current value of the
-<TT>max</TT> <TT>user</TT> <TT>id</TT> counter (use the <B>pts
-listmax</B> command to display the counter). If including this
-argument, first use the <B>pts examine</B> command to verify that no
-existing account already has the desired AFS UID; if one does, the
-account-creation process terminates with an error.
-<P>Corresponding argument to the <B>uss add</B> command:
-<B>-uid</B>. Corresponding variable in template: $UID.
-<P><DT><B><VAR>var1</VAR> through <VAR>var9</VAR>
-</B><DD>Specifies values for each of the number variables $1 through $9 that can
-appear in the template file. The number variables allow the
-administrator to provide values for variables other than the set defined by
-the <B>uss</B> command suite.
-<P>Corresponding argument to the <B>uss add</B> command:
-<B>-var</B>. Corresponding variables in template: $1 through
-$9.
-<P>If providing a value in any of the fields, then in every field that
-precedes it either provide an actual value or indicate an empty field by
-putting nothing between two colons. It is acceptable, but not
-necessary, to indicate empty fields by putting colons after the last field
-that contains an actual value.
-</DL>
-<P><B>The delete Instruction for Deleting an Account</B>
-<A NAME="IDX4104"></A>
-<A NAME="IDX4105"></A>
-<P>The <B>delete</B> instruction deletes a user account from the
-system. Each instance in the bulk input file is equivalent in effect to
-a <B>uss delete</B> command issued on the command line. The order
-of the instruction's fields matches the order of arguments to the
-<B>uss delete</B> command:
-<PRE>   delete <VAR>username</VAR>:<VAR>mount_point_path</VAR>[:{ savevolume | delvolume }][:]
-   
-</PRE>
-<P>where
-<DL>
-<P><DT><B><VAR>username</VAR>
-</B><DD>Names the entry to delete from the Protection and Authentication
-Databases.
-<P><DT><B><VAR>mount_point_path</VAR>
-</B><DD>Specifies the complete pathname to the user's home directory, which
-is deleted from the filespace. By default, the volume mounted there is
-also deleted from the file server machine where it resides, as is its record
-from the Volume Location Database (VLDB). To prevent deletion, include
-the <B>savevolume</B> string in the instruction's third field, or
-precede this <B>delete</B> instruction with a <B>savevolume</B>
-instruction. Partial pathnames are interpreted relative to the current
-working directory.
-<P><DT><B>savevolume
-</B><DD>Retains the volume on its file server machine, and the corresponding entry
-in the VLDB. Provide this value or <B>delvolume</B> in the third
-field, or omit both values to treat the volume according to the prevailing
-default, which is set by a preceding <B>savevolume</B> or
-<B>delvolume</B> instruction in the bulk input file.
-<P><DT><B>delvolume
-</B><DD>Removes the volume from its file server machine, and the corresponding
-entry from the VLDB. Provide this value or <B>savevolume</B> in the
-third field, or omit both values to treat the volume according to the
-prevailing default, which is set by a preceding <B>savevolume</B> or
-<B>delvolume</B> instruction in the bulk input file.
-</DL>
-<P>After the last argument provided, end the line with either a colon and
-carriage return or a carriage return alone.
-<P><B>The exec Instruction for Executing a Command</B>
-<P>The <B>exec</B> instruction executes the specified command, which can
-be a UNIX shell script or command, a program, or an AFS command. The
-<B>uss</B> command interpreter must have the necessary privileges in AFS
-and the local file system; it assumes the AFS and local identities of the
-issuer of the <B>uss bulk</B> command.
-<P>The instruction's syntax is as follows:
-<PRE>   exec <VAR>command</VAR>
-   
-</PRE>
-<P><B>The delvolume and savevolume Instructions for Setting the Default
-Treatment of Volumes</B>
-<A NAME="IDX4106"></A>
-<A NAME="IDX4107"></A>
-<A NAME="IDX4108"></A>
-<A NAME="IDX4109"></A>
-<P>The <B>savevolume</B> and <B>delvolume</B> instructions determine
-the default treatment of volumes referenced by the <B>delete</B>
-instructions that follow them in the bulk input file. Their syntax is
-as follows:
-<PRE>   savevolume
-   delvolume
-   
-</PRE>
-<P>The <B>savevolume</B> instruction prevents the removal of the volume
-and VLDB entry for all <B>delete</B> instruction that follow it in the
-bulk input file, and the <B>delvolume</B> instruction removes the volume
-and VLDB entry for all subsequent <B>delete</B> instructions.
-Either setting persists until its opposite appears in the file, or until the
-end of the bulk file.
-<P>If neither line appears in the bulk input file, the default is to remove
-the volume and the VLDB entry; <B>delete</B> instructions that appear
-before the first <B>savevolume</B> instruction are also subject to this
-default. If a <B>delete</B> instruction's third field
-specifies either <B>savevolume</B> or <B>delvolume</B>, that setting
-overrides the default.
-<P><STRONG>Examples</STRONG>
-<P>The following example <B>add</B> instruction creates an
-authentication-only account. The user's initial password is
-<B>changeme</B> (the default).
-<PRE>   add anderson
-   
-</PRE>
-<P>The following example <B>add</B> instructions refer to the indicated
-<B>V</B> instruction in a template file (which must appear on a single
-line in the template file). 
-<PRE>   add smith:John Smith:::fs1:a:::::marketing 
-   add jones:Pat Jones:::fs3:c:::::finance
-   V user.$USER $SERVER.abc.com /vicep$PART 2000 \
-       /afs/abc.com/usr/$3/$USER $UID $USER all
-   
-</PRE>
-<P>The first <B>add</B> instruction creates an account called
-<B>smith</B> in the Protection and Authentication Databases, with an
-initial password <B>changeme</B> and a value for $UID provided by the
-Protection Server. The volume <B>user.smith</B> resides on
-partition <B>/vicepa</B> of file server machine
-<B>fs1.abc.com</B> and is mounted at
-<B>/afs/abc.com/usr/marketing/smith</B>. He owns his home
-directory and has all access permissions on its root directory's access
-control list (ACL). The account for <B>jones</B> is similar, except
-that the volume resides on partition <B>/vicepc</B> of file server machine
-<B>fs3.abc.com</B> and is mounted at
-<B>/afs/abc.com/usr/finance/jones</B>.
-<P>Notice that the fields corresponding to the volume mount point, UID, $1
-variable, and $2 variable are empty (between <TT>a</TT> and
-<TT>marketing</TT> on the first example line), because their corresponding
-variables do not appear in the template file. The initial password
-field is also empty.
-<P>The following <B>add</B> instructions are equivalent in effect to the
-preceding example, but explicitly indicate empty fields for all of the number
-variables that don't have a value:
-<PRE>   add smith:John Smith:::fs1:a:::::marketing::::::
-   add jones:Pat Jones:::fs3:c:::::finance::::::
-   
-</PRE>
-<P>The following example shows a complete bulk file containing a set of
-<B>delete</B> instructions combined with a <B>savevolume</B>
-instruction. Because the <B>delete</B> instruction for users
-<B>smith</B>, <B>pat</B>, and <B>rogers</B> appear before the
-<B>savevolume</B> instruction and the third field is blank in each, the
-corresponding home volumes are removed. The volume for user
-<B>terry</B> is retained because the default established by the
-<B>savevolume</B> instruction applies to it, but user
-<B>johnson</B>'s volume is removed because the third field of her
-<B>delete</B> instruction overrides the current default.
-<PRE>   delete smith:/afs/abc.com/usr/smith
-   delete pat:/afs/abc.com/usr/pat
-   delete rogers:/afs/abc.com/usr/rogers
-   savevolume
-   delete terry:/afs/abc.com/usr/terry
-   delete johnson:/afs/abc.com/usr/johnson:delvolume
-   
-</PRE>
-<P>The following example <B>exec</B> instruction appears between sets of
-<B>add</B> and <B>delete</B> instructions in a bulk input file.
-A message appears in the command shell where the <B>uss bulk</B> command
-is issued, to indicate when the additions are finished and the deletions
-beginning.
-<PRE>   exec echo "Additions completed; beginning deletions..."
-   
-</PRE>
-<P><STRONG>Related Information</STRONG>
-<P><A HREF="auarf055.htm#HDRUSSFILE">uss Template File</A>
-<P><A HREF="auarf243.htm#HDRUSS_ADD">uss add</A>
-<P><A HREF="auarf245.htm#HDRUSS_BULK">uss bulk</A>
-<P><A HREF="auarf246.htm#HDRUSS_DELETE">uss delete</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="auarf053.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="auarf055.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>
diff --git a/doc/html/AdminReference/auarf055.htm b/doc/html/AdminReference/auarf055.htm
deleted file mode 100644 (file)
index 6e7afaf..0000000
+++ /dev/null
@@ -1,759 +0,0 @@
-<!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="auarf054.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="auarf056.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="HDRUSSFILE" HREF="auarf002.htm#ToC_53">uss Template File</A></H2>
-<P><STRONG>Purpose</STRONG>
-<A NAME="IDX4110"></A>
-<A NAME="IDX4111"></A>
-<A NAME="IDX4112"></A>
-<P>Provides instructions for the <B>uss add</B> command
-<P><STRONG>Description</STRONG>
-<P>The <B>uss</B> template file defines the components of an AFS user
-account that the <B>uss add</B> command (or <B>add</B> instruction in
-a <B>uss</B> bulk input file) creates. Use the <B>-template</B>
-argument to the <B>uss add</B> or <B>uss bulk</B> command to identify
-the template file.
-<P><B>Summary of Template File Instructions</B>
-<P>The template file can include the following instructions, each on its own
-line. A more detailed description of each instruction's syntax
-follows this list.
-<DL>
-<P><DT><B>A
-</B><DD>Imposes restrictions on user passwords and authentication attempts
-<P><DT><B>D
-</B><DD>Creates a directory
-<P><DT><B>E
-</B><DD>Creates a single-line file
-<P><DT><B>F
-</B><DD>Creates a file by copying a prototype
-<P><DT><B>G
-</B><DD>Defines a directory that is one of a set of parent directories into which
-the <B>uss</B> command interpreter evenly distributes newly created home
-directories
-<P><DT><B>L
-</B><DD>Creates a hard link
-<P><DT><B>S
-</B><DD>Creates a symbolic link
-<P><DT><B>V
-</B><DD>Creates a volume, mounts it in the file space and sets the ACL on the
-mount point
-<P><DT><B>X
-</B><DD>Executes a command
-</DL>
-<P>If the template file is empty (zero-length), the <B>uss add</B> command
-or <B>add</B> instruction in a bulk input file only creates an entry in
-the Protection and Authentication Databases, naming them according to the name
-specified with the <B>uss add</B> command's <B>-user</B>
-argument, or in the bulk input file <B>add</B> instruction's
-<VAR>username</VAR> field.
-<P><B>The A Instruction for Setting the Default Treatment of Volumes</B>
-<A NAME="IDX4113"></A>
-<A NAME="IDX4114"></A>
-<A NAME="IDX4115"></A>
-<A NAME="IDX4116"></A>
-<A NAME="IDX4117"></A>
-<A NAME="IDX4118"></A>
-<A NAME="IDX4119"></A>
-<P>The <B>A</B> instruction in a <B>uss</B> template file enhances
-cell security by imposing the following restrictions on users' password
-choice and authentication attempts. For further information on these
-limits, see the <I>IBM AFS Administration Guide</I> and the <B>kas
-setfields</B> reference page.
-<UL>
-<P><LI>Limiting the user's password lifetime. When the lifetime
-expires, the user can no longer authenticate using that password, and must
-change it.
-<P><LI>Prohibiting the reuse of the user's 20 most recently used
-passwords.
-<P><LI>Limiting the number of consecutive times that a user can provide an
-incorrect password during authentication, and for how long the Authentication
-Server refuses further authentication attempts after the limit is exceeded
-(referred to as an <I>account lockout</I>). For regular user
-accounts in most cells, the recommended limit is nine and lockout time is 25
-minutes.
-</UL>
-<P>The instruction has the following syntax:
-<PRE>   <B>A</B>  <VAR>username</VAR>  <VAR>password_lifetime</VAR>  <VAR>password_reuse</VAR>  <VAR>failures</VAR>  <VAR>locktime</VAR>
-   
-</PRE>
-<P>where
-<DL>
-<P><DT><B>A
-</B><DD>Indicates a security-enhancing instruction. It must be a capital
-letter.
-<P><DT><B><VAR>username</VAR>
-</B><DD>Names the Authentication Database entry on which to impose security
-restrictions. Specify the value <B>$USER</B> to read in the
-username from the <B>uss add</B> command's <B>-user</B> argument,
-or from the <VAR>username</VAR> field of an <B>add</B> instruction in a bulk
-input file.
-<P><DT><B><VAR>password_lifetime</VAR>
-</B><DD>Sets the number of days after the user's password is changed that it
-remains valid. When the password becomes invalid (expires), the user is
-unable to authenticate, but has 30 more days in which to issue the
-<B>kpasswd</B> command to change the password (after that, only an
-administrator can change it).
-<P>Specify an integer from the range <B>1</B> through <B>254</B> to
-specify the number of days until expiration, the value <B>0</B> to
-indicate that the password never expires, or the value <B>$PWEXPIRES</B>
-to read in the number of days from the <B>uss add</B> or <B>uss
-bulk</B> command's <B>-pwexpires</B> argument. If the
-<B>A</B> instruction does not appear in the template file, the default is
-for the user's password never to expire.
-<P><DT><B><VAR>password_reuse</VAR>
-</B><DD>Determines whether or not the user can change his or her password (using
-the <B>kpasswd</B> or <B>kas setpassword</B> command) to one that is
-similar to any of the last twenty passwords. The acceptable values are
-<B>reuse</B> to allow reuse and <B>noreuse</B> to prohibit it.
-If the <B>A</B> instruction does not appear in the template file, the
-default is to allow password reuse.
-<P><DT><B><VAR>failures</VAR>
-</B><DD>Sets the number of consecutive times the user can provide an incorrect
-password during authentication (using the <B>klog</B> command or a login
-utility that grants AFS tokens). When the user exceeds the limit, the
-Authentication Server rejects further authentication attempts for the amount
-of time specified in the <VAR>locktime</VAR> field.
-<P>Specify an integer from the range <B>1</B> through <B>254</B> to
-specify the number of failures permitted, or the value <B>0</B> to
-indicate that there is no limit to the number of unsuccessful attempts.
-If the <B>A</B> instruction does not appear in the template file, the
-default is to allow an unlimited number of failures.
-<P><DT><B><VAR>locktime</VAR>
-</B><DD>Specifies how long the Authentication Server refuses authentication
-attempts from a user who has exceeded the failure limit set in the
-<VAR>failures</VAR> field.
-<P>Specify a number of hours and minutes (<VAR>hh:mm</VAR>) or minutes
-only (<VAR>mm</VAR>), from the range <B>01</B> (one minute) through
-<B>36:00</B> (36 hours). The Authentication Server
-automatically reduces any larger value to <B>36:00</B> and also
-rounds up any non-zero value to the next higher multiple of 8.5
-minutes. A value of <B>0</B> (zero) sets an infinite lockout
-time; an administrator must always issue the <B>kas unlock</B>
-command to unlock the account.
-</DL>
-<P><B>The D Instruction for Creating a Directory</B>
-<A NAME="IDX4120"></A>
-<A NAME="IDX4121"></A>
-<A NAME="IDX4122"></A>
-<A NAME="IDX4123"></A>
-<A NAME="IDX4124"></A>
-<A NAME="IDX4125"></A>
-<A NAME="IDX4126"></A>
-<A NAME="IDX4127"></A>
-<A NAME="IDX4128"></A>
-<A NAME="IDX4129"></A>
-<A NAME="IDX4130"></A>
-<P>The <B>D</B> instruction in a <B>uss</B> template file creates a
-directory. Its intended use is to create a subdirectory in the user
-home directory created by the <B>V</B> instruction in the template
-file.
-<P>Any number of <B>D</B> instructions can appear in the template
-file. If any variables in the instruction take their values from the
-<B>V</B> instruction (notably, the $MTPT variable), the instruction must
-follow the <B>V</B> instruction in the file.
-<P>Although it is possible to use the <B>D</B> instruction to create a
-directory on the local disk of the machine where the <B>uss</B> command is
-issued, it is not recommended. The preferred method for automated
-creation of directories on a local disk is the <B>package</B>
-program. Two complications arise if the <VAR>pathname</VAR> field refers
-to a local disk directory:
-<UL>
-<P><LI>The <B>uss</B> command prints a warning message because it cannot
-associate an access control list (ACL) with a local disk directory. It
-creates the directory nonetheless, and some syntactically correct value must
-appear in the instruction's <VAR>ACL</VAR> field.
-<P><LI>To designate any user other than the issuer as the new directory's
-owner, the issuer must log onto the machine as the local superuser
-<B>root</B>. For local disk directories, only the local superuser
-<B>root</B> is allowed to issue the UNIX <B>chown</B> command that the
-<B>uss</B> command interpreter invokes to change the owner from the
-default value (the directory's creator, which in this case is the issuer
-of the <B>uss</B> command). The issuer must then also use the
-<B>-admin</B> argument to the <B>uss add</B> or <B>uss bulk</B>
-command to authenticate as a privileged AFS administrator, which is required
-for creating the Authentication Database and Protection Database entries that
-the <B>uss</B> command interpreter always creates for a new
-account.
-</UL>
-<P>The instruction has the following syntax:
-<PRE>   <B>D</B>  <VAR>pathname</VAR>  <VAR>mode_bits</VAR>  <VAR>owner</VAR>  <VAR>ACL</VAR>
-   
-</PRE>
-<P>where
-<DL>
-<P><DT><B>D
-</B><DD>Indicates a directory creation instruction. It must be a capital
-letter.
-<P><DT><B><VAR>pathname</VAR>
-</B><DD>Specifies the directory's full pathname. It can include
-variables.
-<P>Specify the read/write path to the directory, to avoid the failure that
-results from attempting to create a new directory in a read-only
-volume. By convention, the read/write path is indicated by placing a
-period before the cell name at the pathname's second level (for example,
-<B>/afs/.abc.com</B>). For further discussion of the
-concept of read/write and read-only paths through the filespace, see the
-reference page for the <B>fs mkmount</B> command.
-<P><DT><B><VAR>mode_bits</VAR>
-</B><DD>Sets the directory's UNIX mode bits. Acceptable values are the
-standard three- or four-digit numbers corresponding to combinations of
-permissions. Examples: <B>755</B> corresponds to
-<B>rwxr-xr-x</B>, and <B>644</B> to <B>rw-r--r--</B>. The
-first (owner) <B>x</B> bit must be turned on to enable access to a
-directory.
-<P><DT><B><VAR>owner</VAR>
-</B><DD>Specifies the username or UNIX user ID (UID) of the user to be designated
-the directory's owner in the output from the UNIX <B>ls -ld</B>
-command. If the directory resides in AFS, place the $UID variable in
-this field. If the directory resides on the local disk, this field must
-be the username or UID of the <B>uss</B> command's issuer, unless the
-issuer is logged in as the local superuser <B>root</B>.
-<P><DT><B><VAR>ACL</VAR>
-</B><DD>Sets the ACL on the new directory. It must appear even if the new
-directory resides on the local disk rather than in AFS, but is ignored in that
-case. Provide one or more paired values, each pair consisting of an AFS
-username or group name and the desired permissions, in that order.
-Separate the two parts of the pair, and each pair, with a space. The
-<B>fs setacl</B> reference page describes the available
-permissions.
-<P>For an AFS directory, grant all permissions to the directory's owner
-at least. Usually that is the new user, in which case the appropriate
-value is <B>$USER all</B>.
-<P>It is not possible to grant any permissions to the issuer of the
-<B>uss</B> command. As the last step in account creation, the
-<B>uss</B> command interpreter automatically deletes that person from any
-ACLs set during the creation process.
-</DL>
-<P><B>The E Instruction for Creating a Single-line File</B>
-<A NAME="IDX4131"></A>
-<A NAME="IDX4132"></A>
-<A NAME="IDX4133"></A>
-<A NAME="IDX4134"></A>
-<A NAME="IDX4135"></A>
-<A NAME="IDX4136"></A>
-<P>The <B>E</B> instruction in a <B>uss</B> template file creates a
-file by echoing a specified character string into it. Its intended use
-is to create files in the user home directory created by the <B>V</B>
-instruction in the template file, or in a subdirectory created by a
-<B>D</B> instruction.
-<P>Any number of <B>E</B> instructions can appear in the template
-file. If the file resides in a directory created by a <B>D</B>
-instruction, the <B>E</B> instruction must follow the <B>D</B>
-instruction in the file.
-<P>The <B>E</B> and <B>F</B> instructions have complementary
-advantages. The character string echoed into the file by an
-<B>E</B> instruction can be customized for each user, because it can
-include the standard variables for which the <B>uss</B> command
-interpreter substitutes the values specified by arguments to the <B>uss
-add</B> command or fields in a bulk input file <B>add</B>
-instruction. In contrast, a file created using the <B>F</B>
-instruction cannot include variables and so has the same content for all
-users. However, a file created by an <B>E</B> instruction can be a
-single line only, because no carriage returns (newline characters) are allowed
-in the character string.
-<P>Although it is possible to use the <B>E</B> instruction to create a
-file on the local disk of the machine where the <B>uss</B> command is
-issued, it is not recommended. The preferred method for automated
-creation of files on a local disk is the <B>package</B> program.
-The main complication is that designating any user other than the issuer as
-the new file's owner requires logging onto the machine as the local
-superuser <B>root</B>. For local disk files, only the local
-superuser <B>root</B> is allowed to issue the UNIX <B>chown</B>
-command that the <B>uss</B> command interpreter invokes to change the
-owner from the default value (the file's creator, which in this case is
-the issuer of the <B>uss</B> command). The issuer must then also
-use the <B>-admin</B> argument to the <B>uss add</B> or <B>uss
-bulk</B> command to authenticate as a privileged AFS administrator, which is
-required for creating the Authentication Database and Protection Database
-entries that the <B>uss</B> command interpreter always creates for a new
-account.
-<P>The instruction has the following syntax:
-<PRE>   <B>E</B>  <VAR>pathname</VAR>  <VAR>mode_bits</VAR>  <VAR>owner</VAR>  "<VAR>contents</VAR>"
-   
-</PRE>
-<P>where
-<DL>
-<P><DT><B>E
-</B><DD>Indicates a file creation instruction. It must be a capital
-letter.
-<P><DT><B><VAR>pathname</VAR>
-</B><DD>Specifies the file's full pathname. It can include
-variables.
-<P>Specify the read/write path to the file, to avoid the failure that results
-from attempting to create a new file in a read-only volume. By
-convention, the read/write path is indicated by placing a period before the
-cell name at the pathname's second level (for example,
-<B>/afs/.abc.com</B>). For further discussion of the
-concept of read/write and read-only paths through the filespace, see the
-reference page for the <B>fs mkmount</B> command.
-<P><DT><B><VAR>mode_bits</VAR>
-</B><DD>Sets the file's UNIX mode bits. Acceptable values are the
-standard three- or four-digit numbers corresponding to combinations of
-permissions. Examples: <B>755</B> corresponds to
-<B>rwxr-xr-x</B>, and <B>644</B> to <B>rw-r--r--</B>.
-<P><DT><B><VAR>owner</VAR>
-</B><DD>Specifies the username or UNIX user ID (UID) of the user to be designated
-the file's owner in the output from the UNIX <B>ls -l</B>
-command. If the file resides in AFS, place the $UID variable in this
-field. If the file resides on the local disk, specify the username or
-UID of the <B>uss</B> command's issuer; otherwise, the account
-creation operation halts immediately.
-<P><DT><B><VAR>contents</VAR>
-</B><DD>Specifies the one-line character string to write into the new file.
-Surround it with double quotes if it contains one or more spaces. It
-cannot contain the newline character, but can contain any of the standard
-variables, which the command interpreter resolves as it creates the
-file.
-</DL>
-<P><A NAME="SPTWQ6"></A><B>The F Instruction for Creating a File
-from a Prototype</B>
-<A NAME="IDX4137"></A>
-<A NAME="IDX4138"></A>
-<A NAME="IDX4139"></A>
-<A NAME="IDX4140"></A>
-<A NAME="IDX4141"></A>
-<A NAME="IDX4142"></A>
-<P>The <B>F</B> instruction in a <B>uss</B> template file creates a
-file by copying the contents of an existing file (the <I>prototype</I>)
-into it. Its intended use is to create files in the user home directory
-created by the <B>V</B> instruction in the template file, or in a
-subdirectory created by a <B>D</B> instruction.
-<P>Any number of <B>F</B> instructions can appear in the template
-file. If the file resides in a directory created by a <B>D</B>
-instruction, the <B>F</B> instruction must follow the <B>D</B>
-instruction in the file.
-<P>The <B>E</B> and <B>F</B> instructions have complementary
-advantages. A file created using the <B>F</B> instruction has the
-same content for all users, whereas a file created by an <B>E</B>
-instruction can be customized for each user if it includes variables.
-However, a file created by an <B>E</B> instruction can be a single line
-only, whereas the prototype file copied by an <B>F</B> instruction can be
-any length.
-<P>Although it is possible to use the <B>F</B> instruction to create a
-file on the local disk of the machine where the <B>uss</B> command is
-issued, it is not recommended. The preferred method for automated
-creation of files on a local disk is the <B>package</B> program.
-The main complication is that designating any user other than the issuer as
-the new file's owner requires logging onto the machine as the local
-superuser <B>root</B>. For local disk files, only the local
-superuser <B>root</B> is allowed to issue the UNIX <B>chown</B>
-command that the <B>uss</B> command interpreter invokes to change the
-owner from the default value (the file's creator, which in this case is
-the issuer of the <B>uss</B> command). The issuer must then also
-use the <B>-admin</B> argument to the <B>uss add</B> or <B>uss
-bulk</B> command to authenticate as a privileged AFS administrator, which is
-required for creating the Authentication Database and Protection Database
-entries that the <B>uss</B> command interpreter always creates for a new
-account.
-<P>The instruction has the following syntax:
-<PRE>   <B>F</B>  <VAR>pathname</VAR>  <VAR>mode_bits</VAR>  <VAR>owner</VAR>  <VAR>prototype_file</VAR>
-   
-</PRE>
-<P>where
-<DL>
-<P><DT><B>F
-</B><DD>Indicates a file creation instruction. It must be a capital
-letter.
-<P><DT><B><VAR>pathname</VAR>
-</B><DD>Specifies the full pathname of the file to create, including the
-filename. It can include variables.
-<P>Specify the read/write path to the file, to avoid the failure that results
-from attempting to create a new file in a read-only volume. By
-convention, the read/write path is indicated by placing a period before the
-cell name at the pathname's second level (for example,
-<B>/afs/.abc.com</B>). For further discussion of the
-concept of read/write and read-only paths through the filespace, see the
-reference page for the <B>fs mkmount</B> command.
-<P><DT><B><VAR>mode_bits</VAR>
-</B><DD>Sets the file's UNIX mode bits. Acceptable values are the
-standard three- or four-digit numbers corresponding to combinations of
-permissions. Examples: <B>755</B> corresponds to
-<B>rwxr-xr-x</B>, and <B>644</B> to <B>rw-r--r--</B>.
-<P><DT><B><VAR>owner</VAR>
-</B><DD>Specifies the username or UNIX user ID (UID) of the user to be designated
-the file's owner in the output from the UNIX <B>ls -l</B>
-command. If the file resides in AFS, place the $UID variable in this
-field. If the file resides on the local disk, specify the username or
-UID of the <B>uss</B> command's issuer; otherwise, the account
-creation operation halts immediately.
-<P><DT><B><VAR>prototype_file</VAR>
-</B><DD>Names the AFS or local disk directory that houses the prototype file to
-copy. The prototype file's name must match the final element in
-the <VAR>pathname</VAR> field.
-</DL>
-<P><A NAME="SPTWQ7"></A><B>The G Instruction for Facilitating Even
-Distribution of Home Directories</B>
-<A NAME="IDX4143"></A>
-<A NAME="IDX4144"></A>
-<A NAME="IDX4145"></A>
-<A NAME="IDX4146"></A>
-<A NAME="IDX4147"></A>
-<A NAME="IDX4148"></A>
-<P>The <B>G</B> instruction in a <B>uss</B> template file creates a
-directory as one of the set of directories from which the <B>uss</B>
-command interpreter selects when choosing a new user home directory's
-parent directory. More specifically, when the $AUTO variable appears in
-the <VAR>mount_point</VAR> field of a <B>V</B> instruction, the command
-interpreter substitutes for it the directory defined by a <B>G</B>
-instruction that currently has the fewest entries.
-<P>The instruction's intended use is to distribute user accounts evenly
-among several directories, rather than using directories that reflect
-divisions such as departmental affiliation. Distributing home
-directories in this fashion is useful mainly in very large cells where storing
-all user home directories under a single parent directory potentially slows
-directory lookup, or where a workplace-based division results in unevenly
-sized directories such that some users consistently experience slower
-directory lookup than others. See the chapter on <B>uss</B> in the
-<I>IBM AFS Administration Guide</I> for more information.
-<P>Any number of <B>G</B> instructions can appear in the template
-file. If the <B>V</B> instruction includes the $AUTO variable, it
-must appear after all of the <B>G</B> instructions in the file.
-<P>The instruction has the following syntax:
-<PRE>   <B>G</B>  <VAR>directory</VAR>
-   
-</PRE>
-<P>where
-<DL>
-<P><DT><B>G
-</B><DD>Indicates an instruction that creates a directory to be considered as a
-value for the $AUTO variable. It must be a capital letter.
-<P><DT><B><VAR>directory</VAR>
-</B><DD>Specifies the directory's name as either a complete pathname or only
-the directory name. The choice determines the appropriate format for
-the <VAR>mount_point</VAR> field of a <B>V</B> instruction, as discussed in
-the following example.
-<P>Specify the read/write path to the directory, to avoid the failure that
-results from attempting to create a new mount point in a read-only volume when
-the $AUTO variable is used in a <B>V</B> instruction's
-<VAR>mount_point</VAR> field. By convention, the read/write path is
-indicated by placing a period before the cell name at the pathname's
-second level (for example, <B>/afs/.abc.com</B>). For
-further discussion of the concept of read/write and read-only paths through
-the filespace, see the reference page for the <B>fs mkmount</B>
-command.
-</DL>
-<P><B>The L and S Instructions for Creating a Link</B>
-<A NAME="IDX4149"></A>
-<A NAME="IDX4150"></A>
-<A NAME="IDX4151"></A>
-<A NAME="IDX4152"></A>
-<A NAME="IDX4153"></A>
-<A NAME="IDX4154"></A>
-<A NAME="IDX4155"></A>
-<A NAME="IDX4156"></A>
-<A NAME="IDX4157"></A>
-<A NAME="IDX4158"></A>
-<A NAME="IDX4159"></A>
-<A NAME="IDX4160"></A>
-<A NAME="IDX4161"></A>
-<P>The <B>L</B> instruction in a <B>uss</B> template file creates a
-hard link between two files, as achieved by the standard UNIX <B>ln</B>
-command. The <B>S</B> instruction creates a symbolic link between
-two files, as achieved by the standard UNIX <B>ln -s</B> command. A
-full explanation of links is beyond the scope of this document, but the basic
-effect is to create a second name for an existing file, enabling access via
-either name. Creating a link does not create a second copy of the
-file.
-<P>AFS allows hard links only if the linked files reside in the same
-directory, because it becomes difficult to determine which access control list
-(ACL) applies to the file if the two copies reside in directories with
-different ACLs. AFS allows symbolic links between two files that reside
-in different directories, or even different volumes. The File Server
-uses the ACL associated with the actual file rather than the link.
-<P>Any number of <B>L</B> and <B>S</B> instructions can appear in the
-template file. If the existing file or link is to reside in a directory
-created by a <B>D</B> instruction, or if the existing file was created by
-an <B>E</B> or <B>F</B> instruction, the <B>L</B> or <B>S</B>
-instruction must follow the <B>D</B>, <B>E</B>, or <B>F</B>
-instruction.
-<P>The instructions share the following syntax:
-<PRE>   <B>L</B>  <VAR>existing_file</VAR>  <VAR>link</VAR>
-   <B>S</B>  <VAR>existing_file</VAR>  <VAR>link</VAR>
-   
-</PRE>
-<P>where
-<DL>
-<P><DT><B>L
-</B><DD>Indicates a hard link creation instruction. It must be a capital
-letter.
-<P><DT><B>S
-</B><DD>Indicates a symbolic link creation instruction. It must be a
-capital letter.
-<P><DT><B><VAR>existing_file</VAR>
-</B><DD>Specifies the complete pathname of the existing file.
-<P><DT><B><VAR>link</VAR>
-</B><DD>Specifies the complete pathname of the second name for the file.
-<P>Specify the read/write path to the link, to avoid the failure that results
-from attempting to create a new link in a read-only volume. By
-convention, the read/write path is indicated by placing a period before the
-cell name at the pathname's second level (for example,
-<B>/afs/.abc.com</B>). For further discussion of the
-concept of read/write and read-only paths through the filespace, see the
-reference pa