Import Upstream version 1.8.5
[hcoop/debian/openafs.git] / doc / man-pages / pod1 / vos_listpart.pod.in
... / ...
CommitLineData
1=head1 NAME
2
3vos_listpart - Displays all AFS partitions on a file server machine
4
5=head1 SYNOPSIS
6
7=for html
8<div class="synopsis">
9
10B<vos listpart> S<<< B<-server> <I<machine name>> >>>
11 S<<< [B<-cell> <I<cell name>>] >>>
12 [B<-noauth>] [B<-localauth>]
13 [B<-verbose>] [B<-encrypt>] [B<-noresolve>]
14 S<<< [B<-config> <I<config directory>>] >>>
15 [B<-help>]
16
17B<vos listp> S<<< B<-s> <I<machine name>> >>> S<<< [B<-c> <I<cell name>>] >>>
18 [B<-noa>] [B<-l>] [B<-v>] [B<-e>] [B<-nor>]
19 S<<< [B<-co> <I<config directory>>] >>>
20 [B<-h>]
21
22=for html
23</div>
24
25=head1 DESCRIPTION
26
27The B<vos listpart> command displays all of the valid AFS partitions on
28the indicated file server machine, without consulting the Volume Location
29Database (VLDB). The B<vos partinfo> command reports the size of a
30partition and the available space on that partition.
31
32=head1 OPTIONS
33
34=over 4
35
36=item B<-server> <I<server name>>
37
38Identifies the file server machine for which to list the partitions.
39Provide the machine's IP address or its host name (either fully qualified
40or using an unambiguous abbreviation). For details, see L<vos(1)>.
41
42=include fragments/vos-common.pod
43
44=back
45
46=head1 OUTPUT
47
48The output consists of a list of partition names of the form
49F</vicepI<xx>>, following the header:
50
51 The partitions on the server are:
52
53The last line of the output reports the total number of partitions.
54
55=head1 EXAMPLES
56
57The following command displays the partitions on C<fs1.example.com>:
58
59 % vos listpart fs1.example.com
60 The partitions on the server are:
61 /vicepa /vicepb /vicepc /vicepd
62 Total: 4
63
64=head1 PRIVILEGE REQUIRED
65
66None
67
68=head1 SEE ALSO
69
70L<vos(1)>,
71L<vos_partinfo(1)>
72
73=head1 COPYRIGHT
74
75IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
76
77This documentation is covered by the IBM Public License Version 1.0. It was
78converted from HTML to POD by software written by Chas Williams and Russ
79Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.