~pr0gg3d/ubuntu/oneiric/util-linux/bug-805886

« back to all changes in this revision

Viewing changes to misc-utils/uuidd.8

  • Committer: Bazaar Package Importer
  • Author(s): Scott James Remnant
  • Date: 2009-07-16 15:48:23 UTC
  • mfrom: (1.3.7 upstream)
  • Revision ID: james.westby@ubuntu.com-20090716154823-i26fshvs4v8h90qh
Tags: 2.16-1ubuntu1
* Merge from Debian, remaining changes:
  - Since udev is required in Ubuntu, the hwclock.sh init script is
    not called on startup and the hwclockfirst.sh init script is
    removed.
  - Remove /etc/adjtime on upgrade if it was not used.
  - Install custom blkid.conf to use /dev/.blkid.tab since we don't
    expect device names to survive a reboot
  - No lsb_release call in mount.preinst since we'd need Pre-Depends
    (LP: #383697).

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
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
.\"
 
5
.TH UUIDD 8 "May 2009" "Linux"
 
6
.SH NAME
 
7
uuidd \- 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
 
43
The
 
44
.B uuidd
 
45
daemon is used by the UUID library to generate
 
46
universally unique identifiers (UUIDs), especially time-based UUID's
 
47
in a secure and guaranteed-unique fashion, even in the face of large
 
48
numbers of threads trying to grab UUID's running on different CPU's.
 
49
.SH OPTIONS
 
50
.TP
 
51
.B \-d
 
52
Run
 
53
.B uuidd
 
54
in debugging mode.  This prevents uuidd from running as a daemon.
 
55
.TP
 
56
.B \-k
 
57
If a currently uuidd daemon is running, kill it.
 
58
.TP
 
59
.BI \-n " number"
 
60
When issuing a test request to a running uuidd, request a bulk response
 
61
of
 
62
.I number
 
63
UUID's.
 
64
.TP
 
65
.BI \-p  " pidfile"
 
66
Specify the pathname where the pid file should be written.  By default,
 
67
the pid file is written to /var/run/uuidd/uuidd.pid.
 
68
.TP
 
69
.BI \-s " socketpath"
 
70
Specify the pathname used for the unix-domain socket used by uuidd.  By
 
71
default, the pathname used is /var/run/uuidd/request.  This is primarily
 
72
for debugging purposes, since the pathname is hard-coded in the libuuid
 
73
library.
 
74
.TP
 
75
.B \-r
 
76
Test uuidd by trying to connect to a running uuidd daemon and
 
77
request it to return a random-based UUID.
 
78
.TP
 
79
.B \-t
 
80
Test uuidd by trying to connect to a running uuidd daemon and
 
81
request it to return a time-based UUID.
 
82
.TP
 
83
.BI \-T " timeout"
 
84
Specify a timeout for uuidd.  If specified, then uuidd will exit after
 
85
.I timeout
 
86
seconds of inactivity.
 
87
.SH AUTHOR
 
88
The
 
89
.B uuidd
 
90
daemon  was written by Theodore Ts'o <tytso@mit.edu>.
 
91
.SH AVAILABILITY
 
92
uuidd is part of the util-linux-ng package and is available from
 
93
ftp://ftp.kernel.org/pub/linux/utils/util-linux-ng/.
 
94
.SH "SEE ALSO"
 
95
.BR libuuid (3),
 
96
.BR uuidgen (1)