]>
Commit | Line | Data |
---|---|---|
815427c7 KZ |
1 | .\" -*- nroff -*- |
2 | .\" Copyright 2007 by Theodore Ts'o. All Rights Reserved. | |
3 | .\" This file may be copied under the terms of the GNU Public License. | |
4 | .\" | |
ae4cc2ad | 5 | .TH UUIDD 8 "July 2014" "util-linux" "System Administration" |
815427c7 KZ |
6 | .SH NAME |
7 | uuidd \- UUID generation daemon | |
8 | .SH SYNOPSIS | |
9 | .B uuidd | |
ae4cc2ad | 10 | [options] |
815427c7 KZ |
11 | .SH DESCRIPTION |
12 | The | |
13 | .B uuidd | |
14 | daemon is used by the UUID library to generate | |
15 | universally unique identifiers (UUIDs), especially time-based UUIDs, | |
16 | in a secure and guaranteed-unique fashion, even in the face of large | |
17 | numbers of threads running on different CPUs trying to grab UUIDs. | |
18 | .SH OPTIONS | |
19 | .TP | |
0e85c43d | 20 | .BR \-d , " \-\-debug " |
815427c7 KZ |
21 | Run uuidd in debugging mode. This prevents uuidd from running as a daemon. |
22 | .TP | |
ae4cc2ad BS |
23 | .BR \-F , " \-\-no-fork " |
24 | Do not daemonize using a double-fork. | |
815427c7 KZ |
25 | .TP |
26 | .BR \-k , " \-\-kill " | |
27 | If currently a uuidd daemon is running, kill it. | |
28 | .TP | |
29 | .BR \-n , " \-\-uuids " \fInumber\fR | |
30 | When issuing a test request to a running uuidd, request a bulk response | |
31 | of | |
32 | .I number | |
33 | UUIDs. | |
34 | .TP | |
ae4cc2ad BS |
35 | .BR \-P , " \-\-no-pid " |
36 | Do not create a pid file. | |
37 | .TP | |
815427c7 KZ |
38 | .BR \-p , " \-\-pid " \fIpath\fR |
39 | Specify the pathname where the pid file should be written. By default, | |
8df54559 | 40 | the pid file is written to @runstatedir@/uuidd/uuidd.pid. |
815427c7 | 41 | .TP |
0e85c43d | 42 | .BR \-q , " \-\-quiet " |
815427c7 KZ |
43 | Suppress some failure messages. |
44 | .TP | |
45 | .BR \-r , " \-\-random " | |
46 | Test uuidd by trying to connect to a running uuidd daemon and | |
47 | request it to return a random-based UUID. | |
48 | .TP | |
ae4cc2ad BS |
49 | .BR \-S , " \-\-socket-activation " |
50 | Do not create a socket but instead expect it to be provided by the calling | |
51 | process. This implies \fB--no-fork\fR and \fB--no-pid\fR. This option is | |
52 | intended to be used only with \fBsystemd\fR(1). It needs to be enabled with | |
53 | a configure option. | |
54 | .TP | |
815427c7 | 55 | .BR \-s , " \-\-socket " \fIpath\fR |
ae4cc2ad | 56 | Make uuidd use this pathname for the unix-domain socket. By default, the |
8df54559 | 57 | pathname used is @runstatedir@/uuidd/request. This option is primarily |
815427c7 KZ |
58 | for debugging purposes, since the pathname is hard-coded in the libuuid |
59 | library. | |
60 | .TP | |
ae4cc2ad BS |
61 | .BR \-T , " \-\-timeout " \fInumber\fR |
62 | Make uuidd exit after \fInumber\fR seconds of inactivity. | |
815427c7 KZ |
63 | .TP |
64 | .BR \-t , " \-\-time " | |
65 | Test uuidd by trying to connect to a running uuidd daemon and | |
66 | request it to return a time-based UUID. | |
67 | .TP | |
68 | .BR \-V , " \-\-version " | |
69 | Output version information and exit. | |
ae4cc2ad BS |
70 | .TP |
71 | .BR \-h , " \-\-help " | |
72 | Display help screen and exit. | |
815427c7 | 73 | .SH EXAMPLE |
ae4cc2ad | 74 | Start up a daemon, print 42 random keys, and then stop the daemon: |
815427c7 KZ |
75 | .PP |
76 | .RS | |
77 | .nf | |
78 | uuidd -p /tmp/uuidd.pid -s /tmp/uuidd.socket | |
79 | uuidd -d -r -n 42 -s /tmp/uuidd.socket | |
80 | uuidd -d -k -s /tmp/uuidd.socket | |
81 | .nf | |
82 | .RE | |
83 | .SH AUTHOR | |
84 | The | |
85 | .B uuidd | |
86 | daemon was written by Theodore Ts'o <tytso@mit.edu>. | |
815427c7 KZ |
87 | .SH "SEE ALSO" |
88 | .BR uuid (3), | |
89 | .BR uuidgen (1) | |
ae4cc2ad BS |
90 | .SH AVAILABILITY |
91 | The uuidd daemon is part of the util-linux package and is available from the | |
d673b74e | 92 | .UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/ |
ae4cc2ad BS |
93 | Linux Kernel Archive |
94 | .UE . |