.\" -*- nroff -*-

.\" Copyright 2007 by Theodore Ts'o.  All Rights Reserved.

.\" This file may be copied under the terms of the GNU Public License.

.\"

.TH UUIDD 8 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@"

.SH NAME

uuidd \- UUID generation daemon

.SH SYNOPSIS

.B uuidd

[

.B \-d

]

[

.B \-p

.I pidfile

]

[

.B \-s

.I socketpath

]

[

.B \-T

.I timeout

]

.B uuidd

[

.B \-r

|

.B \-t

]

[

.B \-n

.I number

]

[

.B \-s

.I socketpath

]

.B uuidd \-k

.SH DESCRIPTION

The

.B uuidd

daemon is used by the UUID library to generate

universally unique identifiers (UUIDs), especially time-based UUID's

in a secure and guaranteed-unique fashion, even in the face of large

numbers of threads trying to grab UUID's running on different CPU's.

.SH OPTIONS

.TP

.B \-d

Run

.B uuidd

in debugging mode.  This prevents uuidd from running as a daemon.

.TP

.B \-k

If a currently uuidd daemon is running, kill it.

.TP

.BI \-n " number"

When issuing a test request to a running uuidd, request a bulk response

of

.I number

UUID's.

.TP

.BI \-p  " pidfile"

Specify the pathname where the pid file should be written.  By default,

the pid file is written to /var/lib/libuuid/uuidd.pid.

.TP

.BI \-s " socketpath"

Specify the pathname used for the unix-domain socket used by uuidd.  By

default, the pathname used is /var/lib/libuuid/request.  This is primarily

for debugging purposes, since the pathname is hard-coded in the libuuid

library.

.TP

.B \-r

Test uuidd by trying to connect to a running uuidd daemon and

request it to return a random-based UUID.

.TP

.B \-t

Test uuidd by trying to connect to a running uuidd daemon and

request it to return a time-based UUID.

.TP

.BI \-T " timeout"

Specify a timeout for uuidd.  If specified, then uuidd will exit after

.I timeout

seconds of inactivity.

.SH AUTHOR

The

.B uuidd

daemon  was written by Theodore Ts'o <tytso@mit.edu>.

.SH AVAILABILITY

.B uuidd

is part of libuuid from the e2fsprogs package and is available from

http://e2fsprogs.sourceforge.net.

.SH "SEE ALSO"

.BR libuuid (3),

.BR uuidgen (1)