share/man/man1/uuidgen.1

   1 .\"
   2 .\" This file and its contents are supplied under the terms of the
   3 .\" Common Development and Distribution License ("CDDL"), version 1.0.
   4 .\" You may only use this file in accordance with the terms of version
   5 .\" 1.0 of the CDDL.
   6 .\"
   7 .\" A full copy of the text of the CDDL should have accompanied this
   8 .\" source.  A copy of the CDDL is also available via the Internet at
   9 .\" http://www.illumos.org/license/CDDL.
  10 .\"
  11 .\" Copyright 2015 Nexenta Systems, Inc.
  12 .\"
  13 .Dd Sep 13, 2015
  14 .Dt UUIDGEN 1
  15 .Os
  16 .Sh NAME
  17 .Nm uuidgen
  18 .Nd command-line utility to generate UUID's
  19 .Sh SYNOPSIS
  20 .Nm uuidgen [-r | -t] [-o filename]
  21 .Sh DESCRIPTION
  22 The
  23 .Nm
  24 command generates and prints a Universally Unique
  25 IDentifier (UUID). By default
  26 .Nm
  27 creates a new UUID based on high-quality randomness from
  28 arc4random(3C) (DCE version 4). If the \fB-t\fR option is
  29 provided then a time-based (DCE version 1) UUID will be
  30 generated.
  31 .Sh OPTIONS
  32 .Bl -tag -width indent
  33 .It Fl r
  34 Generate a UUID using
  35 .Nm uuid_generate_random()
  36 instead of
  37 .Nm uuid_generate() .
  38 This derives the new UUID from random data.
  39 .It Fl t
  40 Generate a UUID using
  41 .Nm uuid_generate_time()
  42 instead of
  43 .Nm uuid_generate() .
  44 This uses the current time and either the
  45 Ethernet address (if available) or system node ID.
  46 .It Fl o
  47 Redirect output to
  48 .Ar filename
  49 instead of stdout.
  50 .El
  51 .Sh EXIT STATUS
  52 .Bl -tag -width Ds
  53 .It Dv 0
  54 Successful completion.
  55 .It Dv >0
  56 Failure.
  57 .El
  58 .Sh INTERFACE STABILITY
  59 .Sy Uncommitted .
  60 .Sh SEE ALSO
  61 .Xr uuid_generate 3uuid ,
  62 .Xr uuid_generate_random 3uuid ,
  63 .Xr uuid_generate_time 3uuid