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