2012-07-11 11:00:09 -05:00
|
|
|
.\" -*- nroff -*-
|
|
|
|
|
.\" Copyright 2007 by Theodore Ts'o. All Rights Reserved.
|
|
|
|
|
.\" This file may be copied under the terms of the GNU Public License.
|
|
|
|
|
.\"
|
2014-07-27 13:58:56 -05:00
|
|
|
.TH UUIDD 8 "July 2014" "util-linux" "System Administration"
|
2012-07-11 11:00:09 -05:00
|
|
|
.SH NAME
|
|
|
|
|
uuidd \- UUID generation daemon
|
|
|
|
|
.SH SYNOPSIS
|
|
|
|
|
.B uuidd
|
2014-07-27 13:58:56 -05:00
|
|
|
[options]
|
2012-07-11 11:00:09 -05:00
|
|
|
.SH DESCRIPTION
|
|
|
|
|
The
|
|
|
|
|
.B uuidd
|
|
|
|
|
daemon is used by the UUID library to generate
|
|
|
|
|
universally unique identifiers (UUIDs), especially time-based UUIDs,
|
|
|
|
|
in a secure and guaranteed-unique fashion, even in the face of large
|
|
|
|
|
numbers of threads running on different CPUs trying to grab UUIDs.
|
|
|
|
|
.SH OPTIONS
|
|
|
|
|
.TP
|
2020-07-09 18:24:27 -05:00
|
|
|
.BR \-d , " \-\-debug"
|
2012-07-11 11:00:09 -05:00
|
|
|
Run uuidd in debugging mode. This prevents uuidd from running as a daemon.
|
|
|
|
|
.TP
|
2020-07-09 18:24:27 -05:00
|
|
|
.BR \-F , " \-\-no-fork"
|
2014-07-27 13:58:56 -05:00
|
|
|
Do not daemonize using a double-fork.
|
2012-07-11 11:00:09 -05:00
|
|
|
.TP
|
2020-07-09 18:24:27 -05:00
|
|
|
.BR \-k , " \-\-kill"
|
2012-07-11 11:00:09 -05:00
|
|
|
If currently a uuidd daemon is running, kill it.
|
|
|
|
|
.TP
|
|
|
|
|
.BR \-n , " \-\-uuids " \fInumber\fR
|
|
|
|
|
When issuing a test request to a running uuidd, request a bulk response
|
|
|
|
|
of
|
|
|
|
|
.I number
|
|
|
|
|
UUIDs.
|
|
|
|
|
.TP
|
2020-07-09 18:24:27 -05:00
|
|
|
.BR \-P , " \-\-no-pid"
|
2014-07-27 13:58:56 -05:00
|
|
|
Do not create a pid file.
|
|
|
|
|
.TP
|
2012-07-11 11:00:09 -05:00
|
|
|
.BR \-p , " \-\-pid " \fIpath\fR
|
|
|
|
|
Specify the pathname where the pid file should be written. By default,
|
2017-07-27 09:00:42 -05:00
|
|
|
the pid file is written to @runstatedir@/uuidd/uuidd.pid.
|
2012-07-11 11:00:09 -05:00
|
|
|
.TP
|
2020-07-09 18:24:27 -05:00
|
|
|
.BR \-q , " \-\-quiet"
|
2012-07-11 11:00:09 -05:00
|
|
|
Suppress some failure messages.
|
|
|
|
|
.TP
|
2020-07-09 18:24:27 -05:00
|
|
|
.BR \-r , " \-\-random"
|
2012-07-11 11:00:09 -05:00
|
|
|
Test uuidd by trying to connect to a running uuidd daemon and
|
|
|
|
|
request it to return a random-based UUID.
|
|
|
|
|
.TP
|
2020-07-09 18:24:27 -05:00
|
|
|
.BR \-S , " \-\-socket-activation"
|
2014-07-27 13:58:56 -05:00
|
|
|
Do not create a socket but instead expect it to be provided by the calling
|
2019-12-15 18:51:57 -06:00
|
|
|
process. This implies \fB\-\-no-fork\fR and \fB\-\-no-pid\fR. This option is
|
2014-07-27 13:58:56 -05:00
|
|
|
intended to be used only with \fBsystemd\fR(1). It needs to be enabled with
|
|
|
|
|
a configure option.
|
|
|
|
|
.TP
|
2012-07-11 11:00:09 -05:00
|
|
|
.BR \-s , " \-\-socket " \fIpath\fR
|
2014-07-27 13:58:56 -05:00
|
|
|
Make uuidd use this pathname for the unix-domain socket. By default, the
|
2017-07-27 09:00:42 -05:00
|
|
|
pathname used is @runstatedir@/uuidd/request. This option is primarily
|
2012-07-11 11:00:09 -05:00
|
|
|
for debugging purposes, since the pathname is hard-coded in the libuuid
|
|
|
|
|
library.
|
|
|
|
|
.TP
|
2014-07-27 13:58:56 -05:00
|
|
|
.BR \-T , " \-\-timeout " \fInumber\fR
|
|
|
|
|
Make uuidd exit after \fInumber\fR seconds of inactivity.
|
2012-07-11 11:00:09 -05:00
|
|
|
.TP
|
2020-07-09 18:24:27 -05:00
|
|
|
.BR \-t , " \-\-time"
|
2012-07-11 11:00:09 -05:00
|
|
|
Test uuidd by trying to connect to a running uuidd daemon and
|
|
|
|
|
request it to return a time-based UUID.
|
|
|
|
|
.TP
|
2020-07-09 18:24:27 -05:00
|
|
|
.BR \-V , " \-\-version"
|
2012-07-11 11:00:09 -05:00
|
|
|
Output version information and exit.
|
2014-07-27 13:58:56 -05:00
|
|
|
.TP
|
2020-07-09 18:24:27 -05:00
|
|
|
.BR \-h , " \-\-help"
|
2014-07-27 13:58:56 -05:00
|
|
|
Display help screen and exit.
|
2012-07-11 11:00:09 -05:00
|
|
|
.SH EXAMPLE
|
2014-07-27 13:58:56 -05:00
|
|
|
Start up a daemon, print 42 random keys, and then stop the daemon:
|
2012-07-11 11:00:09 -05:00
|
|
|
.PP
|
|
|
|
|
.RS
|
|
|
|
|
.nf
|
2019-12-15 18:51:57 -06:00
|
|
|
uuidd \-p /tmp/uuidd.pid \-s /tmp/uuidd.socket
|
|
|
|
|
uuidd \-d \-r \-n 42 \-s /tmp/uuidd.socket
|
|
|
|
|
uuidd \-d \-k \-s /tmp/uuidd.socket
|
2020-07-09 18:50:26 -05:00
|
|
|
.fi
|
2012-07-11 11:00:09 -05:00
|
|
|
.RE
|
|
|
|
|
.SH AUTHOR
|
|
|
|
|
The
|
|
|
|
|
.B uuidd
|
|
|
|
|
daemon was written by Theodore Ts'o <tytso@mit.edu>.
|
|
|
|
|
.SH "SEE ALSO"
|
|
|
|
|
.BR uuid (3),
|
|
|
|
|
.BR uuidgen (1)
|
2014-07-27 13:58:56 -05:00
|
|
|
.SH AVAILABILITY
|
|
|
|
|
The uuidd daemon is part of the util-linux package and is available from the
|
2016-12-17 02:06:57 -06:00
|
|
|
.UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/
|
2014-07-27 13:58:56 -05:00
|
|
|
Linux Kernel Archive
|
|
|
|
|
.UE .
|
