2
''' $RCSfile$$Revision$$Date$
20
.ie \\n(.$>=3 .ne \\$3
36
''' Set up \*(-- to give an unbreakable dash;
37
''' string Tr holds user defined translation string.
38
''' Bell System Logo is used as a dummy character.
44
.if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
45
.if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
48
''' \*(M", \*(S", \*(N" and \*(T" are the equivalent of
49
''' \*(L" and \*(R", except that they are used on ".xx" lines,
50
''' such as .IP and .SH, which do another additional levels of
51
''' double-quote interpretation
80
.\" If the F register is turned on, we'll generate
81
.\" index entries out stderr for the following things:
86
.\" X<> Xref (embedded
87
.\" Of course, you have to process the output yourself
88
.\" in some meaninful fashion.
91
.tm Index:\\$1\t\\n%\t"\\$2"
96
.TH FS_UUID 1 "OpenAFS" "25/Dec/2007" "AFS Command Reference"
100
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
101
.de CQ \" put $1 in typewriter font
107
\\&\\$2 \\$3 \\$4 \\$5 \\$6 \\$7
110
.\" @(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2
111
. \" AM - accent mark definitions
113
. \" fudge factors for nroff and troff
122
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
128
. \" simple accents for nroff and troff
141
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
142
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
143
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
144
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
145
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
146
. ds ? \s-2c\h'-\w'c'u*7/10'\u\h'\*(#H'\zi\d\s+2\h'\w'c'u*8/10'
147
. ds ! \s-2\(or\s+2\h'-\w'\(or'u'\v'-.8m'.\v'.8m'
148
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
149
. ds q o\h'-\w'o'u*8/10'\s-4\v'.4m'\z\(*i\v'-.4m'\s+4\h'\w'o'u*8/10'
151
. \" troff and (daisy-wheel) nroff accents
152
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
153
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
154
.ds v \\k:\h'-(\\n(.wu*9/10-\*(#H)'\v'-\*(#V'\*(#[\s-4v\s0\v'\*(#V'\h'|\\n:u'\*(#]
155
.ds _ \\k:\h'-(\\n(.wu*9/10-\*(#H+(\*(#F*2/3))'\v'-.4m'\z\(hy\v'.4m'\h'|\\n:u'
156
.ds . \\k:\h'-(\\n(.wu*8/10)'\v'\*(#V*4/10'\z.\v'-\*(#V*4/10'\h'|\\n:u'
157
.ds 3 \*(#[\v'.2m'\s-2\&3\s0\v'-.2m'\*(#]
158
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
159
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
160
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
161
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
162
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
163
.ds ae a\h'-(\w'a'u*4/10)'e
164
.ds Ae A\h'-(\w'A'u*4/10)'E
165
.ds oe o\h'-(\w'o'u*4/10)'e
166
.ds Oe O\h'-(\w'O'u*4/10)'E
167
. \" corrections for vroff
168
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
169
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
170
. \" for low resolution devices (crt and lpr)
171
.if \n(.H>23 .if \n(.V>19 \
175
. ds v \h'-1'\o'\(aa\(ga'
191
fs_uuid \- Prints the uuid of the client or generates a new one
193
\fBfs uuid\fR [\fB\-generate\fR] [\fB\-help\fR]
195
\fBfs uuid\fR prints the current UUID of an OpenAFS client. It can
196
optionally force the generation of a new UUID, if needed. The client UUID
197
is used by the \fBfileserver\fR to differentiate clients with the same IP
200
The \fBfs uuid\fR command is only available in OpenAFS versions after 1.4.5
201
and 1.5.8. The behavior differs slightly between versions. In OpenAFS
202
1.4.5 and later, the \fB\-generate\fR option is required and the UUID for the
203
client machine is never printed. OpenAFS versions 1.5.8 and later will
206
.Ip "\fB\-generate\fR" 4
207
Generates a new \s-1UUID\s0 for the cache manager. This is useful if two clients
208
share the same \s-1UUID\s0 (if systems were cloned incorrectly, for example).
209
\fB\-generate\fR is optional in OpenAFS versions 1.5.8 and later, but it is
210
required in OpenAFS versions 1.4.5 and later.
212
Prints the online help for this command. All other valid options are
215
\fBfs uuid\fR prints out the current UUID for the client or the new UUID
216
if the \fB\-generate\fR option is passed to it.
218
There are only two ways to invoke \fBfs uuid\fR under 1.5.8 and later:
222
\& UUID: 8ac66f9308a8e-47d7-80f7-50d0040cddc2
225
\& % fs uuid -generate
226
\& New UUID: 436bd660-1720-429508e470cff38f5c6fb0
228
Here is the only way to invoke \fBfs uuid\fR under OpenAFS 1.4.5 and later:
231
\& % fs uuid -generate
232
\& New uuid generated.
234
.SH "PRIVILEGE REQUIRED"
235
The issuer must be logged on as the local superuser \f(CWroot\fR.
237
the \fIfs(1)\fR manpage
239
Copyright 2007 Jason Edgecombe <jason@rampaginggeek.com>
241
This documentation is covered by the BSD License as written in the
242
doc/LICENSE file. This man page was written by Jason Edgecombe for
246
.IX Title "FS_UUID 1"
247
.IX Name "fs_uuid - Prints the uuid of the client or generates a new one"
251
.IX Header "SYNOPSIS"
253
.IX Header "DESCRIPTION"
255
.IX Header "CAUTIONS"
259
.IX Item "\fB\-generate\fR"
261
.IX Item "\fB\-help\fR"
265
.IX Header "EXAMPLES"
267
.IX Header "PRIVILEGE REQUIRED"
269
.IX Header "SEE ALSO"
271
.IX Header "COPYRIGHT"