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)
Check Out this Related Man Page
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)