xref: /illumos-gate/usr/src/man/man1/uuidgen.1 (revision bde334a8dbd66dfa70ce4d7fc9dcad6e1ae45fe4)
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
22The
23.Nm
24command generates and prints a Universally Unique
25IDentifier (UUID). By default
26.Nm
27creates a new UUID based on high-quality randomness from
28arc4random(3C) (DCE version 4). If the \fB-t\fR option is
29provided then a time-based (DCE version 1) UUID will be
30generated.
31.Sh OPTIONS
32.Bl -tag -width indent
33.It Fl r
34Generate a UUID using
35.Nm uuid_generate_random()
36instead of
37.Nm uuid_generate() .
38This derives the new UUID from random data.
39.It Fl t
40Generate a UUID using
41.Nm uuid_generate_time()
42instead of
43.Nm uuid_generate() .
44This uses the current time and either the
45Ethernet address (if available) or system node ID.
46.It Fl o
47Redirect output to
48.Ar filename
49instead of stdout.
50.El
51.Sh EXIT STATUS
52.Bl -tag -width Ds
53.It Dv 0
54Successful completion.
55.It Dv >0
56Failure.
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
64