pd.if.org Git - uuid/blob - uuidgen.1

   1 .TH uuidgen 1 "Tue Sep 23 09:54:24 UTC 2014"
   2 .SH NAME
   3
   4 uuidgen - command line utility for generating uuids
   5
   6 .SH SYNOPSIS
   7
   8 uuidgen [-tvnqODUX]
   9
  10 uuidgen [-n ns | -UXD] name ...
  11
  12 .SH DESCRIPTION
  13
  14 This program generates uuids and writes their canonical string representation
  15 to stdout.
  16
  17 .SH OPTIONS
  18
  19 .TP
  20 .BI \-r
  21 Generate a version 4 random uuid.
  22 .TP
  23 .BI \-t
  24 Generate a version 1 timestamp based uuid
  25 .TP
  26 .B \-n " namespace | oid | dns | x500 | url"
  27 set the namespace for version 3 or version 5 uuids
  28 .TP
  29 .B \-q num
  30 Specify how many uuids to generate for version 1 and 4 uuids.  UUIDs will
  31 be output one per line on stdout.
  32 .TP
  33 .B \-h
  34 Write a help message to stdout and exit.
  35
  36 .SH DIAGNOSTICS
  37
  38 The program will exit 0 on success, and non zero on failure.  Running
  39 witht the \-h or \-V switches will write the appropriate message
  40 to stdout and exit successfully.
  41
  42 Errors will generate a message to stderr and nothing to stdout, as
  43 well as exiting non-zero.
  44
  45 .SH BUGS
  46
  47 .SH AUTHOR
  48
  49 Nathan Wagner
  50 .I
  51 <nw@hydaspes.if.org>
  52
  53 .SH COPYRIGHT
  54
  55 None.  Program is in the public domain.