]> git.ipfire.org Git - thirdparty/util-linux.git/commitdiff
build-sys: add missing files
authorKarel Zak <kzak@redhat.com>
Wed, 11 Jul 2012 16:00:09 +0000 (18:00 +0200)
committerKarel Zak <kzak@redhat.com>
Wed, 11 Jul 2012 16:00:09 +0000 (18:00 +0200)
Reported-by: Bernhard Voelker <mail@bernhard-voelker.de>
Signed-off-by: Karel Zak <kzak@redhat.com>
misc-utils/uuidd.8.in [new file with mode: 0644]
misc-utils/uuidd.rc.in [new file with mode: 0644]
misc-utils/uuidd.socket.in [new file with mode: 0644]

diff --git a/misc-utils/uuidd.8.in b/misc-utils/uuidd.8.in
new file mode 100644 (file)
index 0000000..f35a41e
--- /dev/null
@@ -0,0 +1,94 @@
+.\" -*- nroff -*-
+.\" Copyright 2007 by Theodore Ts'o.  All Rights Reserved.
+.\" This file may be copied under the terms of the GNU Public License.
+.\"
+.TH UUIDD 8 "June 2011" "util-linux" "System Administration"
+.SH NAME
+uuidd \- UUID generation daemon
+.SH SYNOPSIS
+.B uuidd
+.RI [ options ]
+.SH DESCRIPTION
+The
+.B uuidd
+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.
+.SH OPTIONS
+.TP
+.B \-d
+Run uuidd in debugging mode.  This prevents uuidd from running as a daemon.
+.TP
+.BR \-h , " \-\-help "
+Display help screen and exit.
+.TP
+.BR \-k , " \-\-kill "
+If currently a uuidd daemon is running, kill it.
+.TP
+.BR \-n , " \-\-uuids " \fInumber\fR
+When issuing a test request to a running uuidd, request a bulk response
+of
+.I number
+UUIDs.
+.TP
+.BR \-p , " \-\-pid " \fIpath\fR
+Specify the pathname where the pid file should be written.  By default,
+the pid file is written to @localstatedir@/uuidd/uuidd.pid.
+.TP
+.BR \-P , " \-\-no-pid "
+Do not create pid file.
+.TP
+.BR \-F , " \-\-no-fork "
+Do not daemonize using double-fork.
+.TP
+.BR \-S , " \-\-socket-activation "
+Do not create the socket and instead expect it to be provided by the calling
+process.  Implies --no-fork and --no-pid.  As of this writing, this option is
+supposed to be used only with systemd.  This option must be enabled with a configure
+option.
+.TP
+.B \-q
+Suppress some failure messages.
+.TP
+.BR \-r , " \-\-random "
+Test uuidd by trying to connect to a running uuidd daemon and
+request it to return a random-based UUID.
+.TP
+.BR \-s , " \-\-socket " \fIpath\fR
+Specify the pathname used for the unix-domain socket used by uuidd.  By
+default, the pathname used is @localstatedir@/uuidd/request.  This is primarily
+for debugging purposes, since the pathname is hard-coded in the libuuid
+library.
+.TP
+.BR \-T , " \-\-timeout " \fItimeout\fR
+Specify a timeout for uuidd.  If specified, then uuidd will exit after
+.I timeout
+seconds of inactivity.
+.TP
+.BR \-t , " \-\-time "
+Test uuidd by trying to connect to a running uuidd daemon and
+request it to return a time-based UUID.
+.TP
+.BR \-V , " \-\-version "
+Output version information and exit.
+.SH EXAMPLE
+Start up a daemon, print 42 random keys, and then stop the daemon.
+.PP
+.RS
+.nf
+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
+.nf
+.RE
+.SH AUTHOR
+The
+.B uuidd
+daemon was written by Theodore Ts'o <tytso@mit.edu>.
+.SH AVAILABILITY
+The uuidd daemon is part of the util-linux package and is available from
+ftp://ftp.kernel.org/pub/linux/utils/util-linux/.
+.SH "SEE ALSO"
+.BR uuid (3),
+.BR uuidgen (1)
diff --git a/misc-utils/uuidd.rc.in b/misc-utils/uuidd.rc.in
new file mode 100644 (file)
index 0000000..27b75c6
--- /dev/null
@@ -0,0 +1,71 @@
+#! /bin/sh -e
+### BEGIN INIT INFO
+# Provides:          uuidd
+# Required-Start:    $time $local_fs
+# Required-Stop:     $time $local_fs
+# Default-Start:     2 3 4 5
+# Default-Stop:      0 1 6
+# Short-Description: uuidd daemon
+# Description:       Init script for the uuid generation daemon
+### END INIT INFO
+#
+# Author:      "Theodore Ts'o" <tytso@mit.edu>
+#
+set -e
+
+# libuuid is able to execute the uuid daemon on-demand -- in such a case
+# the daemon binary must be setuid to an unprivileged user (e.g. uuidd:uuidd).
+#                                                    [-- kzak Jun 2009]
+UUIDD_ON_DEMAND_ONLY="no"
+
+PATH=/bin:/usr/bin:/sbin:/usr/sbin
+DAEMON=/usr/sbin/uuidd
+UUIDD_USER=uuidd
+UUIDD_GROUP=uuidd
+UUIDD_DIR=@localstatedir@/uuidd
+PIDFILE=$UUIDD_DIR/uuidd.pid
+
+test -x $DAEMON || exit 0
+
+. /lib/lsb/init-functions
+
+case "$1" in
+  start)
+       log_daemon_msg "Starting uuid generator" "uuidd"
+       if ! test -d $UUIDD_DIR; then
+               mkdir -p $UUIDD_DIR
+               chown -R $UUIDD_USER:$UUIDD_GROUP $UUIDD_DIR
+       fi
+       if test "$UUIDD_ON_DEMAND_ONLY" = yes; then
+               echo -n "(on demand only)"
+       else
+               start_daemon -p $PIDFILE $DAEMON
+       fi
+       log_end_msg $?
+    ;;
+  stop)
+       log_daemon_msg "Stopping uuidd generator" "uuidd"
+       killproc -p $PIDFILE $DAEMON
+       log_end_msg $?
+    ;;
+  status)
+       if pidofproc -p $PIDFILE $DAEMON >/dev/null 2>&1; then
+           echo "$DAEMON is running";
+           exit 0;
+       else
+           echo "$DAEMON is NOT running";
+           if test -f $PIDFILE; then exit 2; fi
+           exit 3;
+       fi
+    ;;
+  force-reload|restart)
+    $0 stop
+    $0 start
+    ;;
+  *)
+    echo "Usage: /etc/init.d/uuidd {start|stop|restart|force-reload}"
+    exit 1
+    ;;
+esac
+
+exit 0
diff --git a/misc-utils/uuidd.socket.in b/misc-utils/uuidd.socket.in
new file mode 100644 (file)
index 0000000..d8be72f
--- /dev/null
@@ -0,0 +1,8 @@
+[Unit]
+Description=UUID daemon activation socket
+
+[Socket]
+ListenStream=@localstatedir@/uuidd/request
+
+[Install]
+WantedBy=sockets.target