misc-utils/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 "July 2014" "util-linux" "System Administration"
   6 .SH NAME
   7 uuidd \- UUID generation daemon
   8 .SH SYNOPSIS
   9 .B uuidd
  10 [options]
  11 .SH DESCRIPTION
  12 The
  13 .B uuidd
  14 daemon is used by the UUID library to generate
  15 universally unique identifiers (UUIDs), especially time-based UUIDs,
  16 in a secure and guaranteed-unique fashion, even in the face of large
  17 numbers of threads running on different CPUs trying to grab UUIDs.
  18 .SH OPTIONS
  19 .TP
  20 .BR \-d , " \-\-debug "
  21 Run uuidd in debugging mode.  This prevents uuidd from running as a daemon.
  22 .TP
  23 .BR \-F , " \-\-no-fork "
  24 Do not daemonize using a double-fork.
  25 .TP
  26 .BR \-k , " \-\-kill "
  27 If currently a uuidd daemon is running, kill it.
  28 .TP
  29 .BR \-n , " \-\-uuids " \fInumber\fR
  30 When issuing a test request to a running uuidd, request a bulk response
  31 of
  32 .I number
  33 UUIDs.
  34 .TP
  35 .BR \-P , " \-\-no-pid "
  36 Do not create a pid file.
  37 .TP
  38 .BR \-p , " \-\-pid " \fIpath\fR
  39 Specify the pathname where the pid file should be written.  By default,
  40 the pid file is written to @runstatedir@/uuidd/uuidd.pid.
  41 .TP
  42 .BR \-q , " \-\-quiet "
  43 Suppress some failure messages.
  44 .TP
  45 .BR \-r , " \-\-random "
  46 Test uuidd by trying to connect to a running uuidd daemon and
  47 request it to return a random-based UUID.
  48 .TP
  49 .BR \-S , " \-\-socket-activation "
  50 Do not create a socket but instead expect it to be provided by the calling
  51 process.  This implies \fB--no-fork\fR and \fB--no-pid\fR.  This option is
  52 intended to be used only with \fBsystemd\fR(1).  It needs to be enabled with
  53 a configure option.
  54 .TP
  55 .BR \-s , " \-\-socket " \fIpath\fR
  56 Make uuidd use this pathname for the unix-domain socket.  By default, the
  57 pathname used is @runstatedir@/uuidd/request.  This option is primarily
  58 for debugging purposes, since the pathname is hard-coded in the libuuid
  59 library.
  60 .TP
  61 .BR \-T , " \-\-timeout " \fInumber\fR
  62 Make uuidd exit after \fInumber\fR seconds of inactivity.
  63 .TP
  64 .BR \-t , " \-\-time "
  65 Test uuidd by trying to connect to a running uuidd daemon and
  66 request it to return a time-based UUID.
  67 .TP
  68 .BR \-V , " \-\-version "
  69 Output version information and exit.
  70 .TP
  71 .BR \-h , " \-\-help "
  72 Display help screen and exit.
  73 .SH EXAMPLE
  74 Start up a daemon, print 42 random keys, and then stop the daemon:
  75 .PP
  76 .RS
  77 .nf
  78 uuidd -p /tmp/uuidd.pid -s /tmp/uuidd.socket
  79 uuidd -d -r -n 42 -s /tmp/uuidd.socket
  80 uuidd -d -k -s /tmp/uuidd.socket
  81 .nf
  82 .RE
  83 .SH AUTHOR
  84 The
  85 .B uuidd
  86 daemon was written by Theodore Ts'o <tytso@mit.edu>.
  87 .SH "SEE ALSO"
  88 .BR uuid (3),
  89 .BR uuidgen (1)
  90 .SH AVAILABILITY
  91 The uuidd daemon is part of the util-linux package and is available from the
  92 .UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/
  93 Linux Kernel Archive
  94 .UE .