| Russ Allbery > Software > partinfo | partinfo Changes > |
(Show summary of space on AFS server partitions)
partinfo [-chqtv] [-T <empty>,<full>] afssvr
partinfo does a vos partinfo on a particular AFS server to determine the amount of used and free space. Unlike vos partinfo, however, it also formats the output into a more easily readable tabular form, displays the total disk space, the used disk space, and the free disk space, calculates what percent full the partition is, and displays the amount that can still be put on the partition before it goes over a particular threshold.
Normally, partinfo displays a header above the output giving the meaning of the columns, but this can optionally be suppressed. partinfo can also optionally use color to highlight partitions with plenty of free space and partitions that are too full.
There are two thresholds that partinfo cares about. The first is the threshold before which the partition will be considered to be mostly empty. This will only change the output if color is requested with -c; if it is, the partition will be shown in green. It defaults to 60%. The second is the threshold after which the partition will be considered full. The final column, available space, is the amount of space remaining on the partition before it goes over this threshold, and partitions over this threshold will be shown in red if color is requested with -c. The thresholds may be changed at the top of this script or overridden for one invocation with -T.
If the server given is just a number, afssvr will be prepended to
form the server name.
Use color to highlight interesting data. Currently this just means that the percent full column will be shown in green for partitions under 60% full and in red for partitions over 85% full. Using this option requires that the Term::ANSIColor module be installed and available on the user's system (this module is not required if -c is not used).
To override the above thresholds, see the -T option.
Print out this documentation (which is done simply by feeding the script
to perldoc -t).
Suppress the header normally printed to explain the meanings of each column of data.
Print totals for the entire server.
Override the default thresholds of 60% (before which a partition will be considered mostly empty) and 85% (after which the partition will be considered full). -T should take two integers between 0 and 100 separated by a comma.
Print out the version of partinfo and exit.
The following command shows the current status of afssvr1:
partinfo afssvr1
This command shows the same data, but without the header and with color highlighting of interesting percent full data:
partinfo -qc afssvr1
This command does the same for afssvr5:
partinfo --color --quiet afssvr5
Use thresholds of 70% and 90% instead, showing the results in color:
partinfo -T 70,90 -c afssvr5
vos(1), vos_partinfo(1)
<http://www.eyrie.org/~eagle/software/partinfo/> will have the current version of this program.
Original Perl script written by Neil Crellin <neilc@stanford.edu>, modified by Russ Allbery <rra@stanford.edu> to use formats, to include an explanatory header, to use color if wanted, and to add optional totals.
Copyright 1998, 1999, 2003, 2004 Board of Trustees, Leland Stanford Jr. University.
This program is free software; you may redistribute it and/or modify it under the same terms as Perl itself.
| Russ Allbery > Software > partinfo | partinfo Changes > |