fs_uuid(1) [opendarwin man page]

FS_UUID(1)						       AFS Command Reference							FS_UUID(1)

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 							    2012-03-26								FS_UUID(1)

uuid(1m)																  uuid(1m)

NAME

       uuid - A dcecp object that generates and compares UUIDs

SYNOPSIS

       uuid compare uuid uuid

       uuid create

       uuid help [operation | -verbose]

       uuid operations

ARGUMENTS

       A UUID in the following form: C069d9fb6-943e-11cd-a35c-0000c08adf56 The name of the uuid operation for which to display help information.

DESCRIPTION

       The  uuid object generates and compares Universal Unique Identifiers (UUIDs).  UUIDs uniquely identify DCE entities such as principals, RPC
       entries, Cell Directory Service (CDS) replicas, and so on.

OPERATIONS

   uuid compare
       Compares two UUIDs.  The syntax is as follows: uuid compare uuid uuid

       The compare operation compares two UUIDs, returning 1 if they are equal or 0 if they are not.  Because the uuid compare command handles the
       comparison of UUIDs in current and previous DCE formats, you should use it rather than string compare.

       Privileges Required

       No special privileges are needed to use the uuid compare command.

       Examples

       dcecp> uuid compare 03bb2688-943e-11cd-8bfd-0000c08adf56  > 069d9fb6-943e-11cd-a35c-0000c08adf56 0 dcecp>

   uuid create
       Returns a newly generated UUID.	The syntax is as follows: uuid create

       The create operation returns a newly generated UUID.  It takes no arguments.

       Privileges Required

       No special privileges are needed to use the uuid create command.

       Examples

       dcecp> uuid create 03bb2688-943e-11cd-8bfd-0000c08adf56 dcecp>

   uuid help
       Returns help information about the uuid object and its operations.  The syntax is as follows: uuid help [operation | -verbose]

       Options Displays information about the uuid object.

       Used  without  an  argument  or	option, the uuid help command returns brief information about each uuid operation.  The optional operation
       argument is the name of an operation about which you want detailed information.	Alternatively, you can use the -verbose  option  for  more
       detailed information about the uuid object itself.

       Privileges Required

       No special privileges are needed to use the uuid help command.

       Examples

       dcecp>  uuid  help  compare		Compares  two  UUIDs  for  equality.   create		    Returns  a newly generated UUID.  help
       Prints a summary of command-line options.  operations	      Returns a list of the valid operations for this command.	dcecp>

   uuid operations
       Returns a list of the operations supported by the uuid object.  The syntax is as follows: uuid operations

       The list of available operations is in alphabetical order except for help and operations, which are listed last.

       Privileges Required

       No special privileges are needed to use the uuid operations command.

       Examples

       dcecp> uuid operations compare create help operations dcecp>

RELATED INFORMATION

       Commands: dcecp(1m).

																	  uuid(1m)