doc/html/AdminReference/auarf137.htm

   1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 4//EN">
   2 <HTML><HEAD>
   3 <TITLE>Administration Reference</TITLE>
   4 <!-- Begin Header Records  ========================================== -->
   5 <!-- /tmp/idwt3672/auarf000.scr converted by idb2h R4.2 (359) ID      -->
   6 <!-- Workbench Version (AIX) on 3 Oct 2000 at 16:18:30                -->
   7 <META HTTP-EQUIV="updated" CONTENT="Tue, 03 Oct 2000 16:18:29">
   8 <META HTTP-EQUIV="review" CONTENT="Wed, 03 Oct 2001 16:18:29">
   9 <META HTTP-EQUIV="expires" CONTENT="Thu, 03 Oct 2002 16:18:29">
  10 </HEAD><BODY>
  11 <!-- (C) IBM Corporation 2000. All Rights Reserved    -->
  12 <BODY bgcolor="ffffff">
  13 <!-- End Header Records  ============================================ -->
  14 <A NAME="Top_Of_Page"></A>
  15 <H1>Administration Reference</H1>
  16 <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="auarf136.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="auarf138.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>
  17 <P>
  18 <H2><A NAME="HDRFS_DISKFREE" HREF="auarf002.htm#ToC_151">fs diskfree</A></H2>
  19 <A NAME="IDX4757"></A>
  20 <A NAME="IDX4758"></A>
  21 <A NAME="IDX4759"></A>
  22 <A NAME="IDX4760"></A>
  23 <A NAME="IDX4761"></A>
  24 <A NAME="IDX4762"></A>
  25 <A NAME="IDX4763"></A>
  26 <A NAME="IDX4764"></A>
  27 <A NAME="IDX4765"></A>
  28 <A NAME="IDX4766"></A>
  29 <A NAME="IDX4767"></A>
  30 <A NAME="IDX4768"></A>
  31 <A NAME="IDX4769"></A>
  32 <A NAME="IDX4770"></A>
  33 <A NAME="IDX4771"></A>
  34 <P><STRONG>Purpose</STRONG>
  35 <P>Displays information about the partition housing a directory or file
  36 <P><STRONG>Synopsis</STRONG>
  37 <PRE><B>fs diskfree</B> [<B>-path</B> &lt;<VAR>dir/file&nbsp;path</VAR>><SUP>+</SUP>]  [<B>-help</B>]
  38
  39 <B>fs df</B> [<B>-p</B> &lt;<VAR>dir/file&nbsp;path</VAR>><SUP>+</SUP>]  [<B>-h</B>]
  40
  41 <B>fs di</B> [<B>-p</B> &lt;<VAR>dir/file&nbsp;path</VAR>><SUP>+</SUP>]  [<B>-h</B>]
  42 </PRE>
  43 <P><STRONG>Description</STRONG>
  44 <P>The <B>fs diskfree</B> command formats and displays information about
  45 the partition that houses the volume containing the specified directory or
  46 file, including its size and how much space is currently used.
  47 <P>To display information about the volume itself, use the <B>fs
  48 examine</B> command. The <B>fs examine</B> and <B>fs
  49 quota</B> commands also display information about a volume.
  50 <P><STRONG>Cautions</STRONG>
  51 <P>The partition-related statistics in this command's output do not
  52 always agree with the corresponding values in the output of the standard UNIX
  53 <B>df</B> command. The statistics reported by this command can be
  54 up to five minutes old, because the Cache Manager polls the File Server for
  55 partition information at that frequency. Also, on some operating
  56 systems, the <B>df</B> command's report of partition size includes
  57 reserved space not included in this command's calculation, and so is
  58 likely to be about 10% larger.
  59 <P><STRONG>Options</STRONG>
  60 <DL>
  61 <P><DT><B>-path
  62 </B><DD>Names a file or directory that resides on the partition about which to
  63 produce output. Partial pathnames are interpreted relative to the
  64 current working directory, which is also the default value if this argument is
  65 omitted.
  66 <P><DT><B>-help
  67 </B><DD>Prints the online help for this command. All other valid options
  68 are ignored.
  69 </DL>
  70 <P><STRONG>Output</STRONG>
  71 <P>The output reports the following information about the volume and partition
  72 that houses each file or directory:
  73 <DL>
  74 <P><DT><B><TT>Volume Name</TT>
  75 </B><DD>The name of the volume
  76 <P><DT><B><TT>kbytes</TT>
  77 </B><DD>The partition's total size in kilobytes
  78 <P><DT><B><TT>used</TT>
  79 </B><DD>The number of kilobytes used on the partition
  80 <P><DT><B><TT>avail</TT>
  81 </B><DD>The number of kilobytes available on the partition
  82 <P><DT><B><TT>%used</TT>
  83 </B><DD>The percentage of the partition's total space that is used (the
  84 <TT>used</TT> statistic divided by the <TT>kbytes</TT> statistic, times
  85 100)
  86 </DL>
  87 <P>If the <TT>%used</TT> statistic is greater than 90%, it is marked with
  88 the string <TT>&lt;&lt;WARNING</TT> at the right margin.
  89 <P>If the volume is a read-only volume, the output includes information about
  90 only one of the partitions that houses it, generally the one on the file
  91 server machine with the lowest preference rank. To verify which machine
  92 the output is referring to, use the <B>vos listvldb</B> command to list
  93 the volume's locations, and the <B>vos partinfo</B> command to
  94 display the size of each one.
  95 <P><STRONG>Examples</STRONG>
  96 <P>The following example shows the output for the partitions housing the
  97 volumes <B>user.smith</B> and <B>sun4x_56.bin</B>:
  98 <PRE>   % <B>fs diskfree -path /afs/abc.com/usr/smith /afs/abc.com/sun4x_56/bin</B>
  99    Volume Name     kbytes  used     avail     %used
 100    user.smith     4177920 3841258  336662       92% &lt;&lt;WARNING
 101    sun4x_56.bin   4423680 3174500 1249180       72%
 102
 103 </PRE>
 104 <P><STRONG>Privilege Required</STRONG>
 105 <P>The issuer must have the <B>l</B> (<B>lookup</B>) permission on the
 106 ACL of the root directory of the volume that houses the file or directory
 107 named by the <B>-path</B> argument, and on the ACL of each directory that
 108 precedes it in the pathname.
 109 <P><STRONG>Related Information</STRONG>
 110 <P><A HREF="auarf138.htm#HDRFS_EXAMINE">fs examine</A>
 111 <P>
 112 <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="auarf136.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="auarf138.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>
 113 <!-- Begin Footer Records  ========================================== -->
 114 <P><HR><B>
 115 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 116 </B>
 117 <!-- End Footer Records  ============================================ -->
 118 <A NAME="Bot_Of_Page"></A>
 119 </BODY></HTML>