jimzah/openafs
1
0
Fork 0
mirror of https://git.openafs.org/openafs.git synced 2025-01-18 23:10:58 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

man-fs-uuid-tweaks-20071128

Browse Source 
Some minor capitalization and formatting tweaks to the fs uuid man page.
This commit is contained in:
Russ Allbery 2007-11-29 02:56:13 +00:00
parent 031369cd32
commit 5743116d70
1 changed files with 15 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

31
doc/man-pages/pod1/fs_uuid.pod
View File

@ -14,18 +14,18 @@ B<fs uuid> [B<-generate>] [B<-help>]
=head1 DESCRIPTION =head1 DESCRIPTION
B<fs uuid> prints the current uuid of an OpenAFS client. It can B<fs uuid> prints the current UUID of an OpenAFS client. It can
optionally force the generation of a new uuid, if needed. The client optionally force the generation of a new UUID, if needed. The client UUID
uuid is used by the B<fileserver> to differentiate clients with the is used by the B<fileserver> to differentiate clients with the same IP
same IP address. address.
=head1 CAUTIONS =head1 CAUTIONS
The B<fs uuid> command is only available in OpenAFS versions after The B<fs uuid> command is only available in OpenAFS versions after 1.4.5
1.4.5 and 1.5.8. The behavior differs slightly between versions. In and 1.5.8. The behavior differs slightly between versions. In OpenAFS
OpenAFS 1.4.5 and later, the B<-generate> option is required and the 1.4.5 and later, the B<-generate> option is required and the UUID for the
uuid for the client machine is never printed. OpenAFS versions 1.5.8 client machine is never printed. OpenAFS versions 1.5.8 and later will
and later will print the uuid. print the UUID.
=head1 OPTIONS =head1 OPTIONS
@ -33,21 +33,21 @@ and later will print the uuid.
=item B<-generate> =item B<-generate>
Generates a new uuid for the cache manager. This is useful if two Generates a new UUID for the cache manager. This is useful if two clients
clients share the same uuid. B<-generate> is optional in OpenAFS share the same UUID (if systems were cloned incorrectly, for example).
versions 1.5.8 and later, but it is required in OpenAFS versions 1.4.5 B<-generate> is optional in OpenAFS versions 1.5.8 and later, but it is
and later. required in OpenAFS versions 1.4.5 and later.
=item B<-help> =item B<-help>
Prints the online help for this command. All other valid options are Prints the online help for this command. All other valid options are
ignored. ignored.
=back =back
=head1 OUTPUT =head1 OUTPUT
B<fs uuid> prints out the current uuid for the client or the new uuid B<fs uuid> prints out the current UUID for the client or the new UUID
if the B<-generate> option is passed to it. if the B<-generate> option is passed to it.
=head1 EXAMPLES =head1 EXAMPLES
@ -65,7 +65,6 @@ Here is the only way to invoke B<fs uuid> under OpenAFS 1.4.5 and later:
% fs uuid -generate % fs uuid -generate
New uuid generated. New uuid generated.
=head1 PRIVILEGE REQUIRED =head1 PRIVILEGE REQUIRED
The issuer must be logged on as the local superuser C<root>. The issuer must be logged on as the local superuser C<root>.