xref: /dflybsd-src/share/man/man5/uuids.5 (revision 86d7f5d305c6adaa56ff4582ece9859d73106103)
1*86d7f5d3SJohn Marino.\"
2*86d7f5d3SJohn Marino.\" Copyright (c) 2008
3*86d7f5d3SJohn Marino.\"	The DragonFly Project.  All rights reserved.
4*86d7f5d3SJohn Marino.\"
5*86d7f5d3SJohn Marino.\" Redistribution and use in source and binary forms, with or without
6*86d7f5d3SJohn Marino.\" modification, are permitted provided that the following conditions
7*86d7f5d3SJohn Marino.\" are met:
8*86d7f5d3SJohn Marino.\"
9*86d7f5d3SJohn Marino.\" 1. Redistributions of source code must retain the above copyright
10*86d7f5d3SJohn Marino.\"    notice, this list of conditions and the following disclaimer.
11*86d7f5d3SJohn Marino.\" 2. Redistributions in binary form must reproduce the above copyright
12*86d7f5d3SJohn Marino.\"    notice, this list of conditions and the following disclaimer in
13*86d7f5d3SJohn Marino.\"    the documentation and/or other materials provided with the
14*86d7f5d3SJohn Marino.\"    distribution.
15*86d7f5d3SJohn Marino.\" 3. Neither the name of The DragonFly Project nor the names of its
16*86d7f5d3SJohn Marino.\"    contributors may be used to endorse or promote products derived
17*86d7f5d3SJohn Marino.\"    from this software without specific, prior written permission.
18*86d7f5d3SJohn Marino.\"
19*86d7f5d3SJohn Marino.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
20*86d7f5d3SJohn Marino.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
21*86d7f5d3SJohn Marino.\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
22*86d7f5d3SJohn Marino.\" FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE
23*86d7f5d3SJohn Marino.\" COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
24*86d7f5d3SJohn Marino.\" INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING,
25*86d7f5d3SJohn Marino.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
26*86d7f5d3SJohn Marino.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
27*86d7f5d3SJohn Marino.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
28*86d7f5d3SJohn Marino.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
29*86d7f5d3SJohn Marino.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30*86d7f5d3SJohn Marino.\" SUCH DAMAGE.
31*86d7f5d3SJohn Marino.\"
32*86d7f5d3SJohn Marino.Dd February 8, 2009
33*86d7f5d3SJohn Marino.Dt UUIDS 5
34*86d7f5d3SJohn Marino.Os
35*86d7f5d3SJohn Marino.Sh NAME
36*86d7f5d3SJohn Marino.Nm uuids
37*86d7f5d3SJohn Marino.Nd UUIDs and their symbolic names
38*86d7f5d3SJohn Marino.Sh SYNOPSIS
39*86d7f5d3SJohn Marino.Nm /etc/defaults/uuids
40*86d7f5d3SJohn Marino.Nm /etc/uuids
41*86d7f5d3SJohn Marino.Sh DESCRIPTION
42*86d7f5d3SJohn MarinoA
43*86d7f5d3SJohn Marino.Nm
44*86d7f5d3SJohn Marinofile contains a list of UUIDs (universally unique identifiers) and their symbolic names.
45*86d7f5d3SJohn Marino.Pp
46*86d7f5d3SJohn MarinoEach line in a
47*86d7f5d3SJohn Marino.Nm
48*86d7f5d3SJohn Marinofile, other than comment lines that begin with a
49*86d7f5d3SJohn Marino.Sq # ,
50*86d7f5d3SJohn Marinospecifies a UUID and its symbolic name.
51*86d7f5d3SJohn MarinoThe first field is the UUID, the second field is the name,
52*86d7f5d3SJohn Marinothey are separated by tabs or spaces.
53*86d7f5d3SJohn MarinoA UUID is a 128 bit number written in hexadecimal and formatted like this:
54*86d7f5d3SJohn Marino01234567-89ab-cdef-0123-456789abcdef,
55*86d7f5d3SJohn Marinoi.e. 16 hexadecimal digits, with dash
56*86d7f5d3SJohn Marino.Pq Sq - ,
57*86d7f5d3SJohn Marinoafter digit no. 8, 12, 16 and 20.
58*86d7f5d3SJohn MarinoA name is a text string enclosed in double quotes
59*86d7f5d3SJohn Marino.Pq Sq \&" .
60*86d7f5d3SJohn Marino.Sh FILES
61*86d7f5d3SJohn Marino.Bl -tag -width ".Pa /etc/defaults/uuids" -compact
62*86d7f5d3SJohn Marino.It Pa /etc/defaults/uuids
63*86d7f5d3SJohn MarinoA list of UUIDs and their symbolic names provided by the OS vendor.
64*86d7f5d3SJohn Marino.It Pa /etc/uuids
65*86d7f5d3SJohn MarinoA list of UUIDs and their symbolic names provided by the
66*86d7f5d3SJohn Marinosystem administrator.
67*86d7f5d3SJohn Marino.El
68*86d7f5d3SJohn Marino.Sh EXAMPLES
69*86d7f5d3SJohn MarinoA UUID with name
70*86d7f5d3SJohn Marino.Dq test UUID :
71*86d7f5d3SJohn Marino.Bd -literal -offset indent
72*86d7f5d3SJohn Marino# test uuids(5) file
73*86d7f5d3SJohn Marino061ceb5d-5beb-11dd-924c-010e0cd0bad1   "test UUID"
74*86d7f5d3SJohn Marino.Ed
75*86d7f5d3SJohn Marino.Sh SEE ALSO
76*86d7f5d3SJohn Marino.Xr uuid 3
77*86d7f5d3SJohn Marino.Sh AUTHORS
78*86d7f5d3SJohn MarinoThis manual page was written by
79*86d7f5d3SJohn Marino.An Thomas Nikolajsen .
80