blob: e65e3916e6abce7dac9886c5d94bb5289e744efa [file] [log] [blame]
Theodore Ts'o740837d2007-12-16 17:21:38 -05001.\" -*- 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.\"
5.TH UUIDD 8 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@"
6.SH NAME
7uuidd \- UUID generation daemon
8.SH SYNOPSIS
9.B uuidd
10[
11.B \-d
12]
13[
14.B \-p
15.I pidfile
16]
17[
18.B \-s
19.I socketpath
20]
21[
22.B \-T
23.I timeout
24]
25
26.B uuidd
27[
28.B \-r
29|
30.B \-t
31]
32[
33.B \-n
34.I number
35]
36[
37.B \-s
38.I socketpath
39]
40
41.B uuidd \-k
42.SH DESCRIPTION
43The
44.B uuidd
45daemon is used by the UUID library to generate
46universally unique identifiers (UUIDs), especially time-based UUID's
47in a secure and guaranteed-unique fashion, even in the face of large
48numbers of threads trying to grab UUID's running on different CPU's.
49.SH OPTIONS
50.TP
51.B \-d
52Run
53.B uuidd
54in debugging mode. This prevents uuidd from running as a daemon.
55.TP
56.B \-k
57If a currently uuidd daemon is running, kill it.
58.TP
59.BI \-n " number"
60When issuing a test request to a running uuidd, request a bulk response
61of
62.I number
63UUID's.
64.TP
65.BI \-p " pidfile"
66Specify the pathname where the pid file should be written. By default,
Eric Sandeenebf5fb22008-01-19 09:16:03 -050067the pid file is written to /var/lib/libuuid/uuidd.pid.
Theodore Ts'o740837d2007-12-16 17:21:38 -050068.TP
69.BI \-s " socketpath"
70Specify the pathname used for the unix-domain socket used by uuidd. By
Eric Sandeenebf5fb22008-01-19 09:16:03 -050071default, the pathname used is /var/lib/libuuid/request. This is primarily
Theodore Ts'o740837d2007-12-16 17:21:38 -050072for debugging purposes, since the pathname is hard-coded in the libuuid
73library.
74.TP
75.B \-r
76Test uuidd by trying to connect to a running uuidd daemon and
77request it to return a random-based UUID.
78.TP
79.B \-t
80Test uuidd by trying to connect to a running uuidd daemon and
81request it to return a time-based UUID.
82.TP
83.BI \-T " timeout"
84Specify a timeout for uuidd. If specified, then uuidd will exit after
85.I timeout
86seconds of inactivity.
87.SH AUTHOR
88The
89.B uuidd
90daemon was written by Theodore Ts'o <tytso@mit.edu>.
91.SH AVAILABILITY
92.B uuidd
93is part of libuuid from the e2fsprogs package and is available from
94http://e2fsprogs.sourceforge.net.
95.SH "SEE ALSO"
96.BR libuuid (3),
97.BR uuidgen (1)