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 3uuidd