misc-utils/uuidd.8

   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 .RB [ \-d ]
  11 .RB [ \-p
  12 .IR pidfile ]
  13 .RB [ \-s
  14 .IR socketpath ]
  15 .RB [ \-T
  16 .IR timeout ]
  17 .br
  18 .B uuidd
  19 .RB [ \-r | \-t ]
  20 .RB [ \-n
  21 .IR number ]
  22 .RB [ \-s
  23 .IR socketpath ]
  24 .br
  25 .B uuidd \-k
  26 .SH DESCRIPTION
  27 The
  28 .B uuidd
  29 daemon is used by the UUID library to generate
  30 universally unique identifiers (UUIDs), especially time-based UUID's
  31 in a secure and guaranteed-unique fashion, even in the face of large
  32 numbers of threads trying to grab UUID's running on different CPU's.
  33 .SH OPTIONS
  34 .TP
  35 .B \-d
  36 Run
  37 .B uuidd
  38 in debugging mode.  This prevents uuidd from running as a daemon.
  39 .TP
  40 .B \-k
  41 If a currently uuidd daemon is running, kill it.
  42 .TP
  43 .BI \-n " number"
  44 When issuing a test request to a running uuidd, request a bulk response
  45 of
  46 .I number
  47 UUID's.
  48 .TP
  49 .BI \-p  " pidfile"
  50 Specify the pathname where the pid file should be written.  By default,
  51 the pid file is written to /var/run/uuidd/uuidd.pid.
  52 .TP
  53 .BI \-s " socketpath"
  54 Specify the pathname used for the unix-domain socket used by uuidd.  By
  55 default, the pathname used is /var/run/uuidd/request.  This is primarily
  56 for debugging purposes, since the pathname is hard-coded in the libuuid
  57 library.
  58 .TP
  59 .B \-r
  60 Test uuidd by trying to connect to a running uuidd daemon and
  61 request it to return a random-based UUID.
  62 .TP
  63 .B \-t
  64 Test uuidd by trying to connect to a running uuidd daemon and
  65 request it to return a time-based UUID.
  66 .TP
  67 .BI \-T " timeout"
  68 Specify a timeout for uuidd.  If specified, then uuidd will exit after
  69 .I timeout
  70 seconds of inactivity.
  71 .SH AUTHOR
  72 The
  73 .B uuidd
  74 daemon  was written by Theodore Ts'o <tytso@mit.edu>.
  75 .SH AVAILABILITY
  76 uuidd is part of the util-linux-ng package and is available from
  77 ftp://ftp.kernel.org/pub/linux/utils/util-linux-ng/.
  78 .SH "SEE ALSO"
  79 .BR libuuid (3),
  80 .BR uuidgen (1)