| Theodore Ts'o | 740837d | 2007-12-16 17:21:38 -0500 | [diff] [blame] | 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 "@E2FSPROGS_MONTH@ @E2FSPROGS_YEAR@" "E2fsprogs version @E2FSPROGS_VERSION@" |
| 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, |
| Eric Sandeen | ebf5fb2 | 2008-01-19 09:16:03 -0500 | [diff] [blame] | 67 | the pid file is written to /var/lib/libuuid/uuidd.pid. |
| Theodore Ts'o | 740837d | 2007-12-16 17:21:38 -0500 | [diff] [blame] | 68 | .TP |
| 69 | .BI \-s " socketpath" |
| 70 | Specify the pathname used for the unix-domain socket used by uuidd. By |
| Eric Sandeen | ebf5fb2 | 2008-01-19 09:16:03 -0500 | [diff] [blame] | 71 | default, the pathname used is /var/lib/libuuid/request. This is primarily |
| Theodore Ts'o | 740837d | 2007-12-16 17:21:38 -0500 | [diff] [blame] | 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 | .B uuidd |
| 93 | is part of libuuid from the e2fsprogs package and is available from |
| 94 | http://e2fsprogs.sourceforge.net. |
| 95 | .SH "SEE ALSO" |
| 96 | .BR libuuid (3), |
| 97 | .BR uuidgen (1) |