xref: /dflybsd-src/share/man/man5/uuids.5 (revision 86d7f5d305c6adaa56ff4582ece9859d73106103)
186d7f5d3SJohn Marino.\"
286d7f5d3SJohn Marino.\" Copyright (c) 2008
386d7f5d3SJohn Marino.\"	The DragonFly Project.  All rights reserved.
486d7f5d3SJohn Marino.\"
586d7f5d3SJohn Marino.\" Redistribution and use in source and binary forms, with or without
686d7f5d3SJohn Marino.\" modification, are permitted provided that the following conditions
786d7f5d3SJohn Marino.\" are met:
886d7f5d3SJohn Marino.\"
986d7f5d3SJohn Marino.\" 1. Redistributions of source code must retain the above copyright
1086d7f5d3SJohn Marino.\"    notice, this list of conditions and the following disclaimer.
1186d7f5d3SJohn Marino.\" 2. Redistributions in binary form must reproduce the above copyright
1286d7f5d3SJohn Marino.\"    notice, this list of conditions and the following disclaimer in
1386d7f5d3SJohn Marino.\"    the documentation and/or other materials provided with the
1486d7f5d3SJohn Marino.\"    distribution.
1586d7f5d3SJohn Marino.\" 3. Neither the name of The DragonFly Project nor the names of its
1686d7f5d3SJohn Marino.\"    contributors may be used to endorse or promote products derived
1786d7f5d3SJohn Marino.\"    from this software without specific, prior written permission.
1886d7f5d3SJohn Marino.\"
1986d7f5d3SJohn Marino.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
2086d7f5d3SJohn Marino.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
2186d7f5d3SJohn Marino.\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
2286d7f5d3SJohn Marino.\" FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE
2386d7f5d3SJohn Marino.\" COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
2486d7f5d3SJohn Marino.\" INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING,
2586d7f5d3SJohn Marino.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
2686d7f5d3SJohn Marino.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
2786d7f5d3SJohn Marino.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
2886d7f5d3SJohn Marino.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
2986d7f5d3SJohn Marino.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
3086d7f5d3SJohn Marino.\" SUCH DAMAGE.
3186d7f5d3SJohn Marino.\"
3286d7f5d3SJohn Marino.Dd February 8, 2009
3386d7f5d3SJohn Marino.Dt UUIDS 5
3486d7f5d3SJohn Marino.Os
3586d7f5d3SJohn Marino.Sh NAME
3686d7f5d3SJohn Marino.Nm uuids
3786d7f5d3SJohn Marino.Nd UUIDs and their symbolic names
3886d7f5d3SJohn Marino.Sh SYNOPSIS
3986d7f5d3SJohn Marino.Nm /etc/defaults/uuids
4086d7f5d3SJohn Marino.Nm /etc/uuids
4186d7f5d3SJohn Marino.Sh DESCRIPTION
4286d7f5d3SJohn MarinoA
4386d7f5d3SJohn Marino.Nm
4486d7f5d3SJohn Marinofile contains a list of UUIDs (universally unique identifiers) and their symbolic names.
4586d7f5d3SJohn Marino.Pp
4686d7f5d3SJohn MarinoEach line in a
4786d7f5d3SJohn Marino.Nm
4886d7f5d3SJohn Marinofile, other than comment lines that begin with a
4986d7f5d3SJohn Marino.Sq # ,
5086d7f5d3SJohn Marinospecifies a UUID and its symbolic name.
5186d7f5d3SJohn MarinoThe first field is the UUID, the second field is the name,
5286d7f5d3SJohn Marinothey are separated by tabs or spaces.
5386d7f5d3SJohn MarinoA UUID is a 128 bit number written in hexadecimal and formatted like this:
5486d7f5d3SJohn Marino01234567-89ab-cdef-0123-456789abcdef,
5586d7f5d3SJohn Marinoi.e. 16 hexadecimal digits, with dash
5686d7f5d3SJohn Marino.Pq Sq - ,
5786d7f5d3SJohn Marinoafter digit no. 8, 12, 16 and 20.
5886d7f5d3SJohn MarinoA name is a text string enclosed in double quotes
5986d7f5d3SJohn Marino.Pq Sq \&" .
6086d7f5d3SJohn Marino.Sh FILES
6186d7f5d3SJohn Marino.Bl -tag -width ".Pa /etc/defaults/uuids" -compact
6286d7f5d3SJohn Marino.It Pa /etc/defaults/uuids
6386d7f5d3SJohn MarinoA list of UUIDs and their symbolic names provided by the OS vendor.
6486d7f5d3SJohn Marino.It Pa /etc/uuids
6586d7f5d3SJohn MarinoA list of UUIDs and their symbolic names provided by the
6686d7f5d3SJohn Marinosystem administrator.
6786d7f5d3SJohn Marino.El
6886d7f5d3SJohn Marino.Sh EXAMPLES
6986d7f5d3SJohn MarinoA UUID with name
7086d7f5d3SJohn Marino.Dq test UUID :
7186d7f5d3SJohn Marino.Bd -literal -offset indent
7286d7f5d3SJohn Marino# test uuids(5) file
7386d7f5d3SJohn Marino061ceb5d-5beb-11dd-924c-010e0cd0bad1   "test UUID"
7486d7f5d3SJohn Marino.Ed
7586d7f5d3SJohn Marino.Sh SEE ALSO
7686d7f5d3SJohn Marino.Xr uuid 3
7786d7f5d3SJohn Marino.Sh AUTHORS
7886d7f5d3SJohn MarinoThis manual page was written by
7986d7f5d3SJohn Marino.An Thomas Nikolajsen .
80