misc-utils/uuidparse.1

   1 .\" Copyright (c) 2017 Sami Kerola
   2 .\" The 3-Clause BSD License
   3 .TH UUIDPARSE "1" "2017-06-18" "util-linux" "User Commands"
   4 .SH NAME
   5 uuidparse \- a utility to parse unique identifiers
   6 .SH SYNOPSIS
   7 .B uuidparse
   8 [options]
   9 .I uuid
  10 .SH DESCRIPTION
  11 This command will parse unique identifier inputs from either command line
  12 arguments or standard input.  The inputs are white-space separated.
  13 .SH OUTPUT
  14 .SS Variants
  15 .nr WI \n(.lu-\n(.iu-\w'Microsoft'u-3n
  16 .TS
  17 tab(:);
  18 l lw(\n(WIu).
  19 NCS:T{
  20 Network Computing System identifier.  These were the original UUIDs.
  21 T}
  22 DCE:T{
  23 The Open Software Foundation's (OSF) Distributed Computing Environment UUIDs.
  24 T}
  25 Microsoft:T{
  26 Microsoft Windows platform globally unique identifier (GUID).
  27 T}
  28 other:T{
  29 Unknown variant.  Usually invalid input data.
  30 T}
  31 .TE
  32 .SS Types
  33 .TS
  34 tab(:);
  35 l l.
  36 nil:Special type for zero in type file.
  37 time-based:The DCE time based.
  38 DCE:The DCE time and MAC Address.
  39 name-based:RFC 4122 md5sum hash.
  40 random:RFC 4122 random.
  41 sha1-based:RFC 4122 sha-1 hash.
  42 unknown:Unknown type.  Usually invalid input data.
  43 .TE
  44 .SH OPTIONS
  45 .TP
  46 \fB\-J\fR, \fB\-\-json\fR
  47 Use JSON output format.
  48 .TP
  49 \fB\-n\fR, \fB\-\-noheadings\fR
  50 Do not print a header line.
  51 .TP
  52 \fB\-o\fR, \fB\-\-output\fR
  53 Specify which output columns to print.  Use \-\-help to get a list of all
  54 supported columns.
  55 .TP
  56 \fB\-r\fR, \fB\-\-raw\fR
  57 Use the raw output format.
  58 .TP
  59 \fB\-V\fR, \fB\-\-version\fR
  60 Display version information and exit.
  61 .TP
  62 \fB\-h\fR, \fB\-\-help\fR
  63 Display help text and exit.
  64 .SH AUTHORS
  65 .MT kerolasa@iki.fi
  66 Sami Kerola
  67 .ME
  68 .SH "SEE ALSO"
  69 .BR uuidgen (1),
  70 .BR libuuid (3),
  71 .UR https://\:tools.ietf.org\:/html\:/rfc4122
  72 RFC 4122
  73 .UE
  74 .SH AVAILABILITY
  75 The example command is part of the util-linux package and is available from
  76 .UR https://\:www.kernel.org\:/pub\:/linux\:/utils\:/util-linux/
  77 Linux Kernel Archive
  78 .UE .