xref: /illumos-gate/usr/src/man/man1/uuidgen.1 (revision 4b5c8e93cab28d3c65ba9d407fd8f46e3be1db1c)
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 3uuidd
64