=head1 NAME fs_uuid - Prints the uuid of the client or generates a new one =head1 SYNOPSIS =for html
B [B<-generate>] [B<-help>] =for html
=head1 DESCRIPTION B prints the current UUID of an OpenAFS client. It can optionally force the generation of a new UUID, if needed. The client UUID is used by the B to differentiate clients with the same IP address. =head1 CAUTIONS The B command is only available in OpenAFS versions after 1.4.5 and 1.5.8. The behavior differs slightly between versions. In OpenAFS 1.4.5 and later, the B<-generate> option is required and the UUID for the client machine is never printed. OpenAFS versions 1.5.8 and later will print the UUID. =head1 OPTIONS =over 4 =item B<-generate> Generates a new UUID for the cache manager. This is useful if two clients share the same UUID (if systems were cloned incorrectly, for example). B<-generate> is optional in OpenAFS versions 1.5.8 and later, but it is required in OpenAFS versions 1.4.5 and later. =item B<-help> Prints the online help for this command. All other valid options are ignored. =back =head1 OUTPUT B prints out the current UUID for the client or the new UUID if the B<-generate> option is passed to it. =head1 EXAMPLES There are only two ways to invoke B under 1.5.8 and later: % fs uuid UUID: 8ac66f9308a8e-47d7-80f7-50d0040cddc2 % fs uuid -generate New UUID: 436bd660-1720-429508e470cff38f5c6fb0 Here is the only way to invoke B under OpenAFS 1.4.5 and later: % fs uuid -generate New uuid generated. =head1 PRIVILEGE REQUIRED The issuer must be logged on as the local superuser C. =head1 SEE ALSO L =head1 COPYRIGHT Copyright 2007 Jason Edgecombe This documentation is covered by the BSD License as written in the doc/LICENSE file. This man page was written by Jason Edgecombe for OpenAFS.