2005-12-08 12:14:33 +00:00
|
|
|
=head1 NAME
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
volinfo - Produces detailed statistics about AFS volume headers
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 SYNOPSIS
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
B<volinfo> [B<-online>] [B<-vnode>] [B<-date>] [B<-inode>] [B<-itime>]
|
|
|
|
[B<-part> <I<AFS partition name (default current partition)>>+]
|
|
|
|
[B<-volumeid> <I<volume id>>+] [B<-header>] [B<-sizeOnly>]
|
|
|
|
[B<-fixheader>] [B<-saveinodes>] [B<-orphaned>] [B<-help>]
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 DESCRIPTION
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
The B<volinfo> command displays detailed statistics about one or more
|
|
|
|
volume headers and the partition that houses them. The command must be
|
|
|
|
issued on a file server machine and by default produces output for every
|
|
|
|
volume on every AFS server partition on the machine. To display output for
|
|
|
|
the volumes on one partition only, include the B<-part> argument. To
|
|
|
|
display output for one volume only, include the B<-volumeid> argument.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 OPTIONS
|
|
|
|
|
|
|
|
=over 4
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-online>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
Is nonoperational.
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-vnode>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
Displays a table for each volume which lists the large (directory) and
|
|
|
|
small (file) vnodes in it, in addition to the default output.
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-date>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
When combined with the B<-vnode> flag, adds the C<ServerModTime> field to
|
|
|
|
each vnode entry in the large vnode and small vnode tables, reporting its
|
|
|
|
most recent modification time.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-inode>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
When combined with the B<-vnode> flag, adds the C<inode> field to each
|
|
|
|
vnode entry in the large vnode and small vnode tables, reporting the
|
|
|
|
associated inode number.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-itime>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
When combined with the B<-vnode> flag, displays a change, modification,
|
|
|
|
and access timestamp for each of the large vnode and small vnode tables.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-part> <I<partition name>>+
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
Specifies the partition that houses each volume for which to produce
|
2005-12-13 19:21:13 +00:00
|
|
|
output. Use the format F</vicepI<xx>>, where I<xx> is one or two lowercase
|
|
|
|
letters. This argument can be omitted if the current working directory is
|
|
|
|
the mount location for an AFS server partition; it is not the mount
|
|
|
|
location for an AFS server partition, the command produces output for
|
|
|
|
every volume on all local AFS server partitions.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-volumeid> <I<volume id>>+
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
Specifies the ID number of one volume for which to produce output. The
|
|
|
|
B<-part> argument must be provided along with this one unless the current
|
|
|
|
working directory is the mount location for the AFS server partition that
|
|
|
|
houses the volume.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-header>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
Displays statistics about the volume header of each volume, in addition to
|
|
|
|
the default output.
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-sizeOnly>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
Displays a single line of output for each volume, reporting the size of
|
|
|
|
various structures associated with it. The default output is suppressed
|
|
|
|
and any flags that modify it (such as B<-vnode>) are ignored.
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-fixheader>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
Repairs damaged inodes in each volume if possible. If there are any, it
|
|
|
|
reports the action it is taking to repair them. Otherwise, it produces no
|
|
|
|
output in addition to the default output.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-saveinodes>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
Creates a file in the current working directory for each inode in each
|
2005-12-13 19:21:13 +00:00
|
|
|
volume. Each file is called F<TmpInode.I<vnode_number>> and contains the
|
|
|
|
inode's contents. The default output is suppressed and any flags that
|
|
|
|
modify it (such as B<-vnode>) are ignored.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-orphaned>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
Displays a large vnode and small vnode table for each volume, which lists
|
2005-12-13 19:21:13 +00:00
|
|
|
only orphaned vnodes (vnodes that have no parent). If there are none, the
|
|
|
|
tables are empty (only the headers appear).
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
=item B<-help>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
Prints the online help for this command. All other valid options are
|
|
|
|
ignored.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=back
|
|
|
|
|
|
|
|
=head1 OUTPUT
|
|
|
|
|
|
|
|
By default, the command produces several line of statistics for each
|
|
|
|
volume. Adding other options produces or substitutes additional
|
2005-12-13 19:21:13 +00:00
|
|
|
information as described in L<OPTIONS>. The output is intended for
|
|
|
|
debugging purposes and is meaningful to someone familiar with the internal
|
|
|
|
structure of volume headers.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 PRIVILEGE REQUIRED
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
The issuer must be logged in as the local superuser C<root>.
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 SEE ALSO
|
|
|
|
|
2005-12-13 19:21:13 +00:00
|
|
|
L<vldb.DB0(5)>,
|
|
|
|
L<volserver(8)>
|
2005-12-08 12:14:33 +00:00
|
|
|
|
|
|
|
=head1 COPYRIGHT
|
|
|
|
|
|
|
|
IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
|
|
|
|
|
|
|
|
This documentation is covered by the IBM Public License Version 1.0. It was
|
|
|
|
converted from HTML to POD by software written by Chas Williams and Russ
|
|
|
|
Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.
|