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.

OpenAFS                                            2025-03-21                                         FS_UUID(1)