misc/uuidd.8.in

   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,
  67 the pid file is written to /var/lib/libuuid/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/lib/libuuid/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 .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)