NAME

       fs_uuid - Prints the uuid of the client or generates a new one

SYNOPSIS

       fs uuid [-generate] [-help]

DESCRIPTION

       fs uuid 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 fileserver to
       differentiate clients with the same IP address.

CAUTIONS

       The fs uuid 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 -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.

OPTIONS

       -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).  -generate is optional in
           OpenAFS versions 1.5.8 and later, but it is required in OpenAFS versions 1.4.5 and
           later.

       -help
           Prints the online help for this command.  All other valid options are ignored.

OUTPUT

       fs uuid prints out the current UUID for the client or the new UUID if the -generate option
       is passed to it.

EXAMPLES

       There are only two ways to invoke fs uuid 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 fs uuid under OpenAFS 1.4.5 and later:

          % fs uuid -generate
          New uuid generated.

PRIVILEGE REQUIRED

       The issuer must be logged on as the local superuser "root".

SEE ALSO

       fs(1)

COPYRIGHT

       Copyright 2007 Jason Edgecombe <jason@rampaginggeek.com>

       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.