Index: ossp-pkg/uuid/Makefile.in RCS File: /v/ossp/cvs/ossp-pkg/uuid/Attic/Makefile.in,v rcsdiff -q -kk '-r1.1' '-r1.2' -u '/v/ossp/cvs/ossp-pkg/uuid/Attic/Makefile.in,v' 2>/dev/null --- Makefile.in 2004/01/06 20:14:28 1.1 +++ Makefile.in 2004/01/06 20:20:12 1.2 @@ -55,6 +55,8 @@ PRG_NAME = uuid PRG_OBJS = uuid_cli.o +MAN_NAME = uuid.3 uuid.1 + .SUFFIXES: .SUFFIXES: .c .o .lo @@ -83,6 +85,16 @@ --release="$$D" --date="OSSP uuid $$V1" uuid.pod | \ sed -e "s;UUID_VERSION_STR;$$V2;" >uuid.3 +man: uuid.1 +uuid.1: uuid_cli.pod + V1=`$(SHTOOL) version -l txt -d short VERSION`; \ + V2=`$(SHTOOL) version -l txt -d long VERSION`; \ + D=`$(SHTOOL) version -l txt -d long VERSION | sed -e 's;.*(;;' -e 's;).*;;'`; \ + $(POD2MAN) --quotes=none \ + --section=1 --center="Universally Unique Identifiers" \ + --release="$$D" --date="OSSP uuid $$V1" uuid_cli.pod | \ + sed -e "s;UUID_VERSION_STR;$$V2;" >uuid.1 + check: $(PRG_NAME) @$(LIBTOOL) --mode=execute ./$(PRG_NAME) -n 16 @@ -96,8 +108,12 @@ $(SHTOOL) install -c -m 644 uuid.h $(DESTDIR)$(includedir)/ $(SHTOOL) install -c -m 644 uuid.3 $(DESTDIR)$(mandir)/man3/ @$(LIBTOOL) --mode=install $(SHTOOL) install -c -m 644 libuuid.la $(DESTDIR)$(libdir)/ + $(SHTOOL) install -c -s -m 755 uuid $(DESTDIR)$(bindir)/ + $(SHTOOL) install -c -m 644 uuid.1 $(DESTDIR)$(mandir)/man1/ uninstall: + -$(RM) $(DESTDIR)$(mandir)/man1/uuid.1 + -$(RM) $(DESTDIR)$(bindir)/uuid @$(LIBTOOL) --mode=uninstall $(RM) $(DESTDIR)$(libdir)/libuuid.la -$(RM) $(DESTDIR)$(mandir)/man3/uuid.3 -$(RM) $(DESTDIR)$(includedir)/uuid.h @@ -121,7 +137,7 @@ -$(RM) libtool realclean: distclean - -$(RM) uuid.3 + -$(RM) uuid.3 uuid.1 -$(RM) configure config.h.in -$(RM) shtool -$(RM) ltmain.sh libtool.m4 config.guess config.sub Index: ossp-pkg/uuid/uuid.pod RCS File: /v/ossp/cvs/ossp-pkg/uuid/Attic/uuid.pod,v co -q -kk -p'1.1' '/v/ossp/cvs/ossp-pkg/uuid/Attic/uuid.pod,v' | diff -u /dev/null - -L'ossp-pkg/uuid/uuid.pod' 2>/dev/null --- ossp-pkg/uuid/uuid.pod +++ - 2024-05-16 04:05:56.597598499 +0200 @@ -0,0 +1,135 @@ +## +## OSSP uuid - Universally Unique Identifier +## Copyright (c) 2004 Ralf S. Engelschall +## Copyright (c) 2004 The OSSP Project +## +## This file is part of OSSP uuid, a library for the generation +## of UUIDs which can found at http://www.ossp.org/pkg/lib/uuid/ +## +## Permission to use, copy, modify, and distribute this software for +## any purpose with or without fee is hereby granted, provided that +## the above copyright notice and this permission notice appear in all +## copies. +## +## THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED +## WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF +## MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +## IN NO EVENT SHALL THE AUTHORS AND COPYRIGHT HOLDERS AND THEIR +## CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +## SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +## LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF +## USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND +## ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, +## OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT +## OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +## SUCH DAMAGE. +## +## uuid.pod: manual page +## + +=pod + +=head1 NAME + +B - B + +=head1 SYNOPSIS + +...FIXME... + +=head1 DESCRIPTION + +=head2 Overview + +B stands for Bniversal Bnique Bentifier (aka B +which stands for Blobally Bnique Bentifier). Bs are 128 +bit numbers assigned to any object and which are intended to have a high +likelihood of uniqueness over space and time and are computationally +difficult to guess. + +A B is usually encoded using the ASCII character string +representation described in ISO/IEC 11578:1996: a string +consisting of 8 hexadecimal digits followed by a hyphen, +then three groups of 4 hexadecimal digits each followed by a +hyphen, then 12 hexadecimal digits. An example of a B is +"C<54531d28-402b-11d8-af12-0002a5094c23>". + +=head2 Uniqueness + +The mechanism used to guarantee that Bs are unique is +through combinations of hardware addresses, time stamps and random +seeds. + +There is a reference in the B to the hardware (MAC) address of +the first network interface card (NIC) on the host which generated the +B -- this reference is intended to ensure the B will be +unique in space as the MAC address of every network card is assigned by +a single global authority (IEEE) and is guaranteed to be unique. + +The next component in a B is a timestamp which, as clock always +(should) move forward, will be unique in time. + +Just in case some part of the above goes wrong (the hardware address +cannot be determined or the clock moved a step backward), there is +a random component placed into the B as a "catch-all" for +uniqueness. + +=head1 APPLICATION PROGRAMMING INTERFACE + +...FIXME... + +=head1 SEE ALSO + +See the following are references to more B documentation and specifications: + +=over 4 + +=item + +B, +IETF Internet Draft (expired), +Paul J. Leach, Rich Salz, +February 1998, 27 pages, +http://www.opengroup.org/dce/info/draft-leach-uuids-guids-01.txt + +=item + +B, +appendix B, +Open Group Technical Standard +Document Number C706, August 1997, 737 pages, +(supercedes C309 DCE: Remote Procedure Call 8/1994, +which was basis for ISO/IEC 11578:1996 specification), +http://www.opengroup.org/publications/catalog/c706.htm + +=item + +B, +ISO/IEC 11578:1996, +August 2001, 570 pages, (CHF 340,00), +http://www.iso.ch/cate/d2229.html + +=item + +B, +section B<6.4.1 Node Field Generation Without the IEEE 802 Address>, +IETF RFC 2518, +February 1999, 94 pages, +http://www.ietf.org/rfc/rfc2518.txt + +=item + +B, +P. Leach, M. Mealling, R. Salz, +IETF Internet Draft draft-mealling-uuid-urn-01, +October 2003, 31 pages, +http://www.ietf.org/internet-drafts/draft-mealling-uuid-urn-01.txt + +=item + +B, +FreeBSD manual pages uuid(3) and uuidgen(2), +http://www.freebsd.org/cgi/man.cgi?query=uuid&manpath=FreeBSD+5.2-RELEASE + +=cut + Index: ossp-pkg/uuid/uuid_cli.pod RCS File: /v/ossp/cvs/ossp-pkg/uuid/Attic/uuid_cli.pod,v co -q -kk -p'1.1' '/v/ossp/cvs/ossp-pkg/uuid/Attic/uuid_cli.pod,v' | diff -u /dev/null - -L'ossp-pkg/uuid/uuid_cli.pod' 2>/dev/null --- ossp-pkg/uuid/uuid_cli.pod +++ - 2024-05-16 04:05:56.611462905 +0200 @@ -0,0 +1,53 @@ +## +## OSSP uuid - Universally Unique Identifier +## Copyright (c) 2004 Ralf S. Engelschall +## Copyright (c) 2004 The OSSP Project +## +## This file is part of OSSP uuid, a library for the generation +## of UUIDs which can found at http://www.ossp.org/pkg/lib/uuid/ +## +## Permission to use, copy, modify, and distribute this software for +## any purpose with or without fee is hereby granted, provided that +## the above copyright notice and this permission notice appear in all +## copies. +## +## THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED +## WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF +## MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +## IN NO EVENT SHALL THE AUTHORS AND COPYRIGHT HOLDERS AND THEIR +## CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +## SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +## LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF +## USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND +## ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, +## OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT +## OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +## SUCH DAMAGE. +## +## uuid_cli.pod: manual page +## + +=pod + +=head1 NAME + +B - B + +=head1 SYNOPSIS + +...FIXME... + +=head1 DESCRIPTION + +...FIXME... + +=head1 OPTIONS + +...FIXME... + +=head1 SEE ALSO + +uuid(3). + +=cut +