Commit | Line | Data |
---|---|---|
805e021f CE |
1 | =head1 NAME |
2 | ||
3 | fs_uuid - Prints the uuid of the client or generates a new one | |
4 | ||
5 | =head1 SYNOPSIS | |
6 | ||
7 | =for html | |
8 | <div class="synopsis"> | |
9 | ||
10 | B<fs uuid> [B<-generate>] [B<-help>] | |
11 | ||
12 | =for html | |
13 | </div> | |
14 | ||
15 | =head1 DESCRIPTION | |
16 | ||
17 | B<fs uuid> prints the current UUID of an OpenAFS client. It can | |
18 | optionally force the generation of a new UUID, if needed. The client UUID | |
19 | is used by the B<fileserver> to differentiate clients with the same IP | |
20 | address. | |
21 | ||
22 | =head1 CAUTIONS | |
23 | ||
24 | The B<fs uuid> command is only available in OpenAFS versions after 1.4.5 | |
25 | and 1.5.8. The behavior differs slightly between versions. In OpenAFS | |
26 | 1.4.5 and later, the B<-generate> option is required and the UUID for the | |
27 | client machine is never printed. OpenAFS versions 1.5.8 and later will | |
28 | print the UUID. | |
29 | ||
30 | =head1 OPTIONS | |
31 | ||
32 | =over 4 | |
33 | ||
34 | =item B<-generate> | |
35 | ||
36 | Generates a new UUID for the cache manager. This is useful if two clients | |
37 | share the same UUID (if systems were cloned incorrectly, for example). | |
38 | B<-generate> is optional in OpenAFS versions 1.5.8 and later, but it is | |
39 | required in OpenAFS versions 1.4.5 and later. | |
40 | ||
41 | =item B<-help> | |
42 | ||
43 | Prints the online help for this command. All other valid options are | |
44 | ignored. | |
45 | ||
46 | =back | |
47 | ||
48 | =head1 OUTPUT | |
49 | ||
50 | B<fs uuid> prints out the current UUID for the client or the new UUID | |
51 | if the B<-generate> option is passed to it. | |
52 | ||
53 | =head1 EXAMPLES | |
54 | ||
55 | There are only two ways to invoke B<fs uuid> under 1.5.8 and later: | |
56 | ||
57 | % fs uuid | |
58 | UUID: 8ac66f9308a8e-47d7-80f7-50d0040cddc2 | |
59 | ||
60 | % fs uuid -generate | |
61 | New UUID: 436bd660-1720-429508e470cff38f5c6fb0 | |
62 | ||
63 | Here is the only way to invoke B<fs uuid> under OpenAFS 1.4.5 and later: | |
64 | ||
65 | % fs uuid -generate | |
66 | New uuid generated. | |
67 | ||
68 | =head1 PRIVILEGE REQUIRED | |
69 | ||
70 | The issuer must be logged on as the local superuser C<root>. | |
71 | ||
72 | =head1 SEE ALSO | |
73 | ||
74 | L<fs(1)> | |
75 | ||
76 | =head1 COPYRIGHT | |
77 | ||
78 | Copyright 2007 Jason Edgecombe <jason@rampaginggeek.com> | |
79 | ||
80 | This documentation is covered by the BSD License as written in the | |
81 | doc/LICENSE file. This man page was written by Jason Edgecombe for | |
82 | OpenAFS. |