.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "FS_UUID 1"
.TH FS_UUID 1 2024-02-03 OpenAFS "AFS Command Reference"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
fs_uuid \- Prints the uuid of the client or generates a new one
.SH SYNOPSIS
.IX Header "SYNOPSIS"
\&\fBfs uuid\fR [\fB\-generate\fR] [\fB\-help\fR]
.SH DESCRIPTION
.IX Header "DESCRIPTION"
\&\fBfs uuid\fR 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 \fBfileserver\fR to differentiate clients with the same IP
address.
.SH CAUTIONS
.IX Header "CAUTIONS"
The \fBfs uuid\fR 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 \fB\-generate\fR option is required and the UUID for the
client machine is never printed.  OpenAFS versions 1.5.8 and later will
print the UUID.
.SH OPTIONS
.IX Header "OPTIONS"
.IP \fB\-generate\fR 4
.IX Item "-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).
\&\fB\-generate\fR is optional in OpenAFS versions 1.5.8 and later, but it is
required in OpenAFS versions 1.4.5 and later.
.IP \fB\-help\fR 4
.IX Item "-help"
Prints the online help for this command.  All other valid options are
ignored.
.SH OUTPUT
.IX Header "OUTPUT"
\&\fBfs uuid\fR prints out the current UUID for the client or the new UUID
if the \fB\-generate\fR option is passed to it.
.SH EXAMPLES
.IX Header "EXAMPLES"
There are only two ways to invoke \fBfs uuid\fR under 1.5.8 and later:
.PP
.Vb 2
\&   % fs uuid
\&   UUID: 8ac66f9308a8e\-47d7\-80f7\-50d0040cddc2
\&
\&   % fs uuid \-generate
\&   New UUID: 436bd660\-1720\-429508e470cff38f5c6fb0
.Ve
.PP
Here is the only way to invoke \fBfs uuid\fR under OpenAFS 1.4.5 and later:
.PP
.Vb 2
\&   % fs uuid \-generate
\&   New uuid generated.
.Ve
.SH "PRIVILEGE REQUIRED"
.IX Header "PRIVILEGE REQUIRED"
The issuer must be logged on as the local superuser \f(CW\*(C`root\*(C'\fR.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBfs\fR\|(1)
.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright 2007 Jason Edgecombe <jason@rampaginggeek.com>
.PP
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.