uuidd(8)

1UUIDD(8)                     System Administration                    UUIDD(8)
2
3
4

NAME

6       uuidd - UUID generation daemon
7

SYNOPSIS

9       uuidd [options]
10

DESCRIPTION

12       The  uuidd  daemon  is used by the UUID library to generate universally
13       unique identifiers (UUIDs), especially time-based UUIDs,  in  a  secure
14       and  guaranteed-unique  fashion,  even  in the face of large numbers of
15       threads running on different CPUs trying to grab UUIDs.
16

OPTIONS

18       -d, --debug
19              Run uuidd in debugging mode.  This prevents uuidd  from  running
20              as a daemon.
21
22       -h, --help
23              Display help screen and exit.
24
25       -k, --kill
26              If currently a uuidd daemon is running, kill it.
27
28       -n, --uuids number
29              When  issuing  a test request to a running uuidd, request a bulk
30              response of number UUIDs.
31
32       -p, --pid path
33              Specify the pathname where the pid file should be  written.   By
34              default, the pid file is written to /var/uuidd/uuidd.pid.
35
36       -P, --no-pid
37              Do not create pid file.
38
39       -F, --no-fork
40              Do not daemonize using double-fork.
41
42       -S, --socket-activation
43              Do not create the socket and instead expect it to be provided by
44              the calling process.  Implies --no-fork  and  --no-pid.   As  of
45              this  writing, this option is supposed to be used only with sys‐
46              temd.  This option must be enabled with a configure option.
47
48       -q, --quiet
49              Suppress some failure messages.
50
51       -r, --random
52              Test uuidd by trying to connect to a running  uuidd  daemon  and
53              request it to return a random-based UUID.
54
55       -s, --socket path
56              Specify  the  pathname  used  for the unix-domain socket used by
57              uuidd.  By default, the  pathname  used  is  /var/uuidd/request.
58              This  is primarily for debugging purposes, since the pathname is
59              hard-coded in the libuuid library.
60
61       -T, --timeout timeout
62              Specify a timeout for uuidd.  If specified, then uuidd will exit
63              after timeout seconds of inactivity.
64
65       -t, --time
66              Test  uuidd  by  trying to connect to a running uuidd daemon and
67              request it to return a time-based UUID.
68
69       -V, --version
70              Output version information and exit.
71

EXAMPLE

73       Start up a daemon, print 42 random keys, and then stop the daemon.
74
75              uuidd -p /tmp/uuidd.pid -s /tmp/uuidd.socket
76              uuidd -d -r -n 42 -s /tmp/uuidd.socket
77              uuidd -d -k -s /tmp/uuidd.socket
78

AUTHOR

80       The uuidd daemon was written by Theodore Ts'o <tytso@mit.edu>.
81

AVAILABILITY

83       The uuidd daemon is part of the util-linux  package  and  is  available
84       from ftp://ftp.kernel.org/pub/linux/utils/util-linux/.
85