man-pages/man8/uuidd.8.html
2021-03-31 01:06:50 +01:00

157 lines
4.0 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of UUIDD</TITLE>
</HEAD><BODY>
<H1>UUIDD</H1>
Section: System Administration (8)<BR>Updated: July 2014<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
uuidd - UUID generation daemon
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>uuidd</B>
[options]
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
The
<B>uuidd</B>
daemon is used by the UUID library to generate
universally unique identifiers (UUIDs), especially time-based UUIDs,
in a secure and guaranteed-unique fashion, even in the face of large
numbers of threads running on different CPUs trying to grab UUIDs.
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>
<DL COMPACT>
<DT id="1"><B>-d</B>,<B> --debug </B>
<DD>
Run uuidd in debugging mode. This prevents uuidd from running as a daemon.
<DT id="2"><B>-F</B>,<B> --no-fork </B>
<DD>
Do not daemonize using a double-fork.
<DT id="3"><B>-k</B>,<B> --kill </B>
<DD>
If currently a uuidd daemon is running, kill it.
<DT id="4"><B>-n</B>,<B> --uuids </B><I>number</I>
<DD>
When issuing a test request to a running uuidd, request a bulk response
of
<I>number</I>
UUIDs.
<DT id="5"><B>-P</B>,<B> --no-pid </B>
<DD>
Do not create a pid file.
<DT id="6"><B>-p</B>,<B> --pid </B><I>path</I>
<DD>
Specify the pathname where the pid file should be written. By default,
the pid file is written to /run/uuidd/uuidd.pid.
<DT id="7"><B>-q</B>,<B> --quiet </B>
<DD>
Suppress some failure messages.
<DT id="8"><B>-r</B>,<B> --random </B>
<DD>
Test uuidd by trying to connect to a running uuidd daemon and
request it to return a random-based UUID.
<DT id="9"><B>-S</B>,<B> --socket-activation </B>
<DD>
Do not create a socket but instead expect it to be provided by the calling
process. This implies <B>--no-fork</B> and <B>--no-pid</B>. This option is
intended to be used only with <B><A HREF="/cgi-bin/man/man2html?1+systemd">systemd</A></B>(1). It needs to be enabled with
a configure option.
<DT id="10"><B>-s</B>,<B> --socket </B><I>path</I>
<DD>
Make uuidd use this pathname for the unix-domain socket. By default, the
pathname used is /run/uuidd/request. This option is primarily
for debugging purposes, since the pathname is hard-coded in the libuuid
library.
<DT id="11"><B>-T</B>,<B> --timeout </B><I>number</I>
<DD>
Make uuidd exit after <I>number</I> seconds of inactivity.
<DT id="12"><B>-t</B>,<B> --time </B>
<DD>
Test uuidd by trying to connect to a running uuidd daemon and
request it to return a time-based UUID.
<DT id="13"><B>-V</B>,<B> --version </B>
<DD>
Output version information and exit.
<DT id="14"><B>-h</B>,<B> --help </B>
<DD>
Display help screen and exit.
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>EXAMPLE</H2>
Start up a daemon, print 42 random keys, and then stop the daemon:
<P>
<DL COMPACT><DT id="15"><DD>
<PRE>
uuidd -p /tmp/uuidd.pid -s /tmp/uuidd.socket
uuidd -d -r -n 42 -s /tmp/uuidd.socket
uuidd -d -k -s /tmp/uuidd.socket
</DL>
</PRE><A NAME="lbAG">&nbsp;</A>
<H2>AUTHOR</H2>
The
<B>uuidd</B>
daemon was written by Theodore Ts'o &lt;<A HREF="mailto:tytso@mit.edu">tytso@mit.edu</A>&gt;.
<A NAME="lbAH">&nbsp;</A>
<H2>SEE ALSO</H2>
<B><A HREF="/cgi-bin/man/man2html?3+uuid">uuid</A></B>(3),
<B><A HREF="/cgi-bin/man/man2html?1+uuidgen">uuidgen</A></B>(1)
<A NAME="lbAI">&nbsp;</A>
<H2>AVAILABILITY</H2>
The uuidd daemon is part of the util-linux package and is available from the
Linux Kernel Archive
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="16"><A HREF="#lbAB">NAME</A><DD>
<DT id="17"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="18"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="19"><A HREF="#lbAE">OPTIONS</A><DD>
<DT id="20"><A HREF="#lbAF">EXAMPLE</A><DD>
<DT id="21"><A HREF="#lbAG">AUTHOR</A><DD>
<DT id="22"><A HREF="#lbAH">SEE ALSO</A><DD>
<DT id="23"><A HREF="#lbAI">AVAILABILITY</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:06:18 GMT, March 31, 2021
</BODY>
</HTML>