summaryrefslogtreecommitdiffstats
path: root/misc-utils/uuidd.8.in
blob: fda5108b12cb04f8845a92e95122a930cf0fcea2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
.\" -*- 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 "July 2014" "util-linux" "System Administration"
.SH NAME
uuidd \- UUID generation daemon
.SH SYNOPSIS
.B uuidd
[options]
.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
.BR \-d , " \-\-debug"
Run uuidd in debugging mode.  This prevents uuidd from running as a daemon.
.TP
.BR \-F , " \-\-no-fork"
Do not daemonize using a double-fork.
.TP
.BR \-k , " \-\-kill"
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
.BR \-P , " \-\-no-pid"
Do not create a pid file.
.TP
.BR \-p , " \-\-pid " \fIpath\fR
Specify the pathname where the pid file should be written.  By default,
the pid file is written to @runstatedir@/uuidd/uuidd.pid.
.TP
.BR \-q , " \-\-quiet"
Suppress some failure messages.
.TP
.BR \-r , " \-\-random"
Test uuidd by trying to connect to a running uuidd daemon and
request it to return a random-based UUID.
.TP
.BR \-S , " \-\-socket-activation"
Do not create a socket but instead expect it to be provided by the calling
process.  This implies \fB\-\-no-fork\fR and \fB\-\-no-pid\fR.  This option is
intended to be used only with \fBsystemd\fR(1).  It needs to be enabled with
a configure option.
.TP
.BR \-s , " \-\-socket " \fIpath\fR
Make uuidd use this pathname for the unix-domain socket.  By default, the
pathname used is @runstatedir@/uuidd/request.  This option is primarily
for debugging purposes, since the pathname is hard-coded in the libuuid
library.
.TP
.BR \-T , " \-\-timeout " \fInumber\fR
Make uuidd exit after \fInumber\fR seconds of inactivity.
.TP
.BR \-t , " \-\-time"
Test uuidd by trying to connect to a running uuidd daemon and
request it to return a time-based UUID.
.TP
.BR \-V , " \-\-version"
Output version information and exit.
.TP
.BR \-h , " \-\-help"
Display help screen and exit.
.SH EXAMPLE
Start up a daemon, print 42 random keys, and then stop the daemon:
.PP
.RS
.nf
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
.fi
.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)
.SH AVAILABILITY
The uuidd daemon is part of the util-linux package and is available from the
.UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/
Linux Kernel Archive
.UE .