NetBSD Problem Report #23470
Received: (qmail 14850 invoked by uid 605); 17 Nov 2003 20:05:11 -0000
Message-Id: <200311172005.hAHK52Rj009774@deathmitten.home.elfie.org>
Date: Mon, 17 Nov 2003 15:05:02 -0500 (EST)
From: franklin@elfie.org
Sender: gnats-bugs-owner@NetBSD.org
Reply-To: franklin@elfie.org
To: gnats-bugs@gnats.netbsd.org
Subject: port of FreeBSD uuid support
X-Send-Pr-Version: 3.95
>Number: 23470
>Category: kern
>Synopsis: port of FreeBSD uuid support
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: thorpej
>State: closed
>Class: change-request
>Submitter-Id: net
>Arrival-Date: Mon Nov 17 20:06:00 +0000 2003
>Closed-Date: Mon Sep 13 23:34:56 +0000 2004
>Last-Modified: Mon Sep 13 23:36:00 +0000 2004
>Originator: John Franklin
>Release: NetBSD 1.6ZF
>Organization:
John Franklin
franklin@elfie.org
ICBM: 35°43'56"N 78°53'27"W
>Environment:
System: NetBSD 1.6ZF NetBSD 1.6ZF (JLFS) #5: Mon Nov 17 12:33:01 EST 2003 franklin@deathmitten:/usr/src/sys/arch/i386/compile/JLFS i386
Architecture: i386
Machine: i386
>Description:
UUID support is missing in NetBSD. This patch imports the FreeBSD version.
>How-To-Repeat:
>Fix:
In addition to the UUID support for both kernel and userland, this patch
adds sys/sys/packbyte.h which includes some inline functions used by
FreeBSD to pack byte data into and out of ints of various sizes in an
endian independent fashion. FreeBSD's UUID code used it. I've included
it to make porting of other FreeBSD features easier.
FreeBSD includes the functions in packbyte.h in sys/sys/endian.h.
This patch does not add uuid support to COMPAT_{FREEBSD,DARWIN,FOO},
although it should be pretty trivial to do. Nor does it modify anything
in the ext2fs support to take advantage of the patch.
How to add:
foo# cd /usr/src
foo# uudecode uuid.tgz.uu
foo# md5 uuid.tgz
MD5 (uuid.tgz) = f10ceb5951fff6f61dafd0f2011b6287
foo# tar -xzf uuid.tgz
foo# patch < uuid.patch
foo# cd sys/kern
foo# make init_sysent.c
--- uuid.patch BEGINS ---
Index: distrib/sets/lists/base/mi
===================================================================
RCS file: /cvsroot/src/distrib/sets/lists/base/mi,v
retrieving revision 1.438
diff -u -r1.438 mi
--- distrib/sets/lists/base/mi 2003/11/05 08:23:44 1.438
+++ distrib/sets/lists/base/mi 2003/11/17 18:55:46
@@ -588,6 +588,7 @@
./usr/bin/uucp base-uucp-bin
./usr/bin/uudecode base-util-bin
./usr/bin/uuencode base-util-bin
+./usr/bin/uuidgen base-util-bin
./usr/bin/uulog base-uucp-bin
./usr/bin/uuname base-uucp-bin
./usr/bin/uupick base-uucp-bin
Index: distrib/sets/lists/comp/mi
===================================================================
RCS file: /cvsroot/src/distrib/sets/lists/comp/mi,v
retrieving revision 1.640
diff -u -r1.640 mi
--- distrib/sets/lists/comp/mi 2003/11/16 15:10:46 1.640
+++ distrib/sets/lists/comp/mi 2003/11/17 18:55:55
@@ -813,6 +813,7 @@
./usr/include/sys/mtio.h comp-c-include
./usr/include/sys/namei.h comp-c-include
./usr/include/sys/null.h comp-c-include
+./usr/include/sys/packbyte.h comp-c-include
./usr/include/sys/param.h comp-c-include
./usr/include/sys/pipe.h comp-c-include
./usr/include/sys/pmc.h comp-c-include
@@ -878,6 +879,7 @@
./usr/include/sys/unpcb.h comp-c-include
./usr/include/sys/user.h comp-c-include
./usr/include/sys/utsname.h comp-c-include
+./usr/include/sys/uuid.h comp-c-include
./usr/include/sys/vadvise.h comp-c-include
./usr/include/sys/verified_exec.h comp-c-include
./usr/include/sys/vmmeter.h comp-c-include
@@ -921,6 +923,7 @@
./usr/include/utime.h comp-c-include
./usr/include/utmp.h comp-c-include
./usr/include/utmpx.h comp-c-include
+./usr/include/uuid.h comp-c-include
./usr/include/uvm/uvm.h comp-c-include
./usr/include/uvm/uvm_amap.h comp-c-include
./usr/include/uvm/uvm_amap_i.h comp-c-include
@@ -1377,6 +1380,7 @@
./usr/share/man/cat2/unmount.0 comp-c-catman
./usr/share/man/cat2/utimes.0 comp-c-catman
./usr/share/man/cat2/utrace.0 comp-c-catman
+./usr/share/man/cat2/uuidgen.0 comp-c-catman
./usr/share/man/cat2/vfork.0 comp-c-catman
./usr/share/man/cat2/wait.0 comp-c-catman
./usr/share/man/cat2/wait3.0 comp-c-catman
@@ -3497,6 +3501,15 @@
./usr/share/man/cat3/util.0 comp-c-catman
./usr/share/man/cat3/utime.0 comp-c-catman
./usr/share/man/cat3/utmpxname.0 comp-c-catman
+./usr/share/man/cat3/uuid.0 comp-c-catman
+./usr/share/man/cat3/uuid_compare.0 comp-c-catman
+./usr/share/man/cat3/uuid_create.0 comp-c-catman
+./usr/share/man/cat3/uuid_create_nil.0 comp-c-catman
+./usr/share/man/cat3/uuid_equal.0 comp-c-catman
+./usr/share/man/cat3/uuid_from_string.0 comp-c-catman
+./usr/share/man/cat3/uuid_hash.0 comp-c-catman
+./usr/share/man/cat3/uuid_is_nil.0 comp-c-catman
+./usr/share/man/cat3/uuid_to_string.0 comp-c-catman
./usr/share/man/cat3/va_arg.0 comp-c-catman
./usr/share/man/cat3/va_copy.0 comp-c-catman
./usr/share/man/cat3/va_end.0 comp-c-catman
@@ -4842,6 +4855,7 @@
./usr/share/man/man2/unmount.2 comp-c-man
./usr/share/man/man2/utimes.2 comp-c-man
./usr/share/man/man2/utrace.2 comp-c-man
+./usr/share/man/man2/uuidgen.2 comp-c-man
./usr/share/man/man2/vfork.2 comp-c-man
./usr/share/man/man2/wait.2 comp-c-man
./usr/share/man/man2/wait3.2 comp-c-man
@@ -6962,6 +6976,15 @@
./usr/share/man/man3/util.3 comp-c-man
./usr/share/man/man3/utime.3 comp-c-man
./usr/share/man/man3/utmpxname.3 comp-c-man
+./usr/share/man/man3/uuid.3 comp-c-man
+./usr/share/man/man3/uuid_compare.3 comp-c-man
+./usr/share/man/man3/uuid_create.3 comp-c-man
+./usr/share/man/man3/uuid_create_nil.3 comp-c-man
+./usr/share/man/man3/uuid_equal.3 comp-c-man
+./usr/share/man/man3/uuid_from_string.3 comp-c-man
+./usr/share/man/man3/uuid_hash.3 comp-c-man
+./usr/share/man/man3/uuid_is_nil.3 comp-c-man
+./usr/share/man/man3/uuid_to_string.3 comp-c-man
./usr/share/man/man3/va_arg.3 comp-c-man
./usr/share/man/man3/va_copy.3 comp-c-man
./usr/share/man/man3/va_end.3 comp-c-man
Index: distrib/sets/lists/man/mi
===================================================================
RCS file: /cvsroot/src/distrib/sets/lists/man/mi,v
retrieving revision 1.628
diff -u -r1.628 mi
--- distrib/sets/lists/man/mi 2003/11/10 18:49:14 1.628
+++ distrib/sets/lists/man/mi 2003/11/17 18:55:59
@@ -406,6 +406,7 @@
./usr/share/man/cat1/uucp.0 man-uucp-catman
./usr/share/man/cat1/uudecode.0 man-uucp-catman
./usr/share/man/cat1/uuencode.0 man-uucp-catman
+./usr/share/man/cat1/uuidgen.0 man-util-catman
./usr/share/man/cat1/uustat.0 man-uucp-catman
./usr/share/man/cat1/uux.0 man-uucp-catman
./usr/share/man/cat1/vacation.0 man-mail-catman
@@ -2160,6 +2161,7 @@
./usr/share/man/man1/uucp.1 man-uucp-man
./usr/share/man/man1/uudecode.1 man-uucp-man
./usr/share/man/man1/uuencode.1 man-uucp-man
+./usr/share/man/man1/uuidgen.1 man-util-man
./usr/share/man/man1/uustat.1 man-uucp-man
./usr/share/man/man1/uux.1 man-uucp-man
./usr/share/man/man1/vacation.1 man-mail-man
Index: include/Makefile
===================================================================
RCS file: /cvsroot/src/include/Makefile,v
retrieving revision 1.115
diff -u -r1.115 Makefile
--- include/Makefile 2003/10/14 12:46:44 1.115
+++ include/Makefile 2003/11/17 18:57:01
@@ -20,7 +20,7 @@
sgtty.h signal.h stab.h stddef.h stdio.h stdlib.h string.h \
strings.h stringlist.h struct.h sysexits.h tar.h threadlib.h time.h \
ttyent.h tzfile.h ucontext.h ulimit.h unistd.h util.h utime.h utmp.h \
- utmpx.h varargs.h vis.h wchar.h wctype.h
+ utmpx.h uuid.h varargs.h vis.h wchar.h wctype.h
INCS+= arpa/ftp.h arpa/inet.h arpa/nameser.h arpa/telnet.h arpa/tftp.h
INCS+= protocols/dumprestore.h protocols/routed.h protocols/rwhod.h \
protocols/talkd.h protocols/timed.h
Index: lib/libc/Makefile
===================================================================
RCS file: /cvsroot/src/lib/libc/Makefile,v
retrieving revision 1.112
diff -u -r1.112 Makefile
--- lib/libc/Makefile 2003/07/10 10:34:22 1.112
+++ lib/libc/Makefile 2003/11/17 18:57:03
@@ -93,6 +93,7 @@
.include "${.CURDIR}/termios/Makefile.inc"
.include "${.CURDIR}/thread-stub/Makefile.inc"
.include "${.CURDIR}/time/Makefile.inc"
+.include "${.CURDIR}/uuid/Makefile.inc"
.include "${.CURDIR}/sys/Makefile.inc"
.if (${MKYP} != "no")
.include "${.CURDIR}/yp/Makefile.inc"
Index: lib/libc/sys/Makefile.inc
===================================================================
RCS file: /cvsroot/src/lib/libc/sys/Makefile.inc,v
retrieving revision 1.144
diff -u -r1.144 Makefile.inc
--- lib/libc/sys/Makefile.inc 2003/09/16 13:51:34 1.144
+++ lib/libc/sys/Makefile.inc 2003/11/17 18:57:08
@@ -72,7 +72,7 @@
__sigaction_sigtramp.S __sigtimedwait.S \
socket.S socketpair.S __stat13.S statfs.S \
swapctl.S symlink.S umask.S undelete.S unlink.S \
- unmount.S utimes.S utrace.S vadvise.S \
+ unmount.S utimes.S utrace.S uuidgen.S vadvise.S \
__sysctl.S \
__posix_chown.S __posix_fchown.S __posix_lchown.S __posix_rename.S \
_lwp_create.S _lwp_exit.S _lwp_self.S _lwp_wait.S \
@@ -153,7 +153,7 @@
socketpair.2 stat.2 statfs.2 swapctl.2 swapon.3 symlink.2 \
sync.2 sysarch.2 syscall.2 timer_create.2 timer_delete.2 \
timer_settime.2 truncate.2 umask.2 undelete.2 \
- unlink.2 utimes.2 utrace.2 vfork.2 wait.2 write.2
+ unlink.2 utimes.2 utrace.2 uuidgen.2 vfork.2 wait.2 write.2
MLINKS+=_exit.2 _Exit.2
MLINKS+=brk.2 sbrk.2
Index: lib/libc/sys/makelintstub
===================================================================
RCS file: /cvsroot/src/lib/libc/sys/makelintstub,v
retrieving revision 1.15
diff -u -r1.15 makelintstub
--- lib/libc/sys/makelintstub 2003/09/30 22:30:16 1.15
+++ lib/libc/sys/makelintstub 2003/11/17 18:57:08
@@ -67,6 +67,7 @@
#include <sys/timex.h>
#include <sys/socket.h>
#include <sys/event.h>
+ #include <sys/uuid.h>
#ifdef __STDC__
#include <stdarg.h>
#else
Index: sys/conf/files
===================================================================
RCS file: /cvsroot/src/sys/conf/files,v
retrieving revision 1.644
diff -u -r1.644 files
--- sys/conf/files 2003/11/16 12:10:41 1.644
+++ sys/conf/files 2003/11/17 18:57:50
@@ -1141,6 +1141,7 @@
file kern/kern_sysctl.c
file kern/kern_time.c
file kern/kern_timeout.c
+file kern/kern_uuid.c
file kern/kern_xxx.c
file kern/kgdb_stub.c kgdb
file kern/subr_autoconf.c
Index: sys/kern/syscalls.master
===================================================================
RCS file: /cvsroot/src/sys/kern/syscalls.master,v
retrieving revision 1.134
diff -u -r1.134 syscalls.master
--- sys/kern/syscalls.master 2003/11/15 01:19:38 1.134
+++ sys/kern/syscalls.master 2003/11/17 18:57:55
@@ -708,3 +708,4 @@
354 STD { int sys_fsync_range(int fd, int flags, off_t start, \
off_t length); }
+355 STD { int sys_uuidgen(struct uuid *store, int count); }
Index: sys/sys/Makefile
===================================================================
RCS file: /cvsroot/src/sys/sys/Makefile,v
retrieving revision 1.61
diff -u -r1.61 Makefile
--- sys/sys/Makefile 2003/10/26 20:48:17 1.61
+++ sys/sys/Makefile 2003/11/17 18:57:58
@@ -18,8 +18,8 @@
malloc.h mallocvar.h mbuf.h md4.h \
md5.h midiio.h mman.h mount.h msg.h msgbuf.h mtio.h \
namei.h null.h \
- param.h pipe.h pmc.h poll.h pool.h power.h proc.h properties.h \
- protosw.h ptrace.h queue.h \
+ packbyte.h param.h pipe.h pmc.h poll.h pool.h power.h proc.h \
+ properties.h protosw.h ptrace.h queue.h \
ras.h reboot.h radioio.h resource.h resourcevar.h rnd.h \
sa.h scanio.h sched.h scsiio.h select.h sem.h sha1.h shm.h \
siginfo.h signal.h signalvar.h sigtypes.h socket.h \
@@ -28,7 +28,7 @@
tablet.h termios.h time.h timeb.h timepps.h times.h \
timex.h tprintf.h trace.h tree.h tty.h ttychars.h ttycom.h \
ttydefaults.h ttydev.h types.h \
- ucontext.h ucred.h uio.h un.h unistd.h unpcb.h user.h utsname.h \
+ ucontext.h ucred.h uio.h un.h unistd.h unpcb.h user.h utsname.h uuid.h \
vadvise.h verified_exec.h vmmeter.h vnode.h vnode_if.h \
wait.h wdog.h
Index: usr.bin/Makefile
===================================================================
RCS file: /cvsroot/src/usr.bin/Makefile,v
retrieving revision 1.136
diff -u -r1.136 Makefile
--- usr.bin/Makefile 2003/07/04 05:41:49 1.136
+++ usr.bin/Makefile 2003/11/17 18:58:03
@@ -24,7 +24,7 @@
tcopy tee telnet tftp time tip tn3270 top touch tput \
tr true tset tsort tty ul uname unexpand unifdef \
uniq units unvis usbhidaction usbhidctl users \
- uudecode uuencode vacation vgrind vi vis vmstat w \
+ uudecode uuencode uuidgen vacation vgrind vi vis vmstat w \
wall wc what whatis whereis which who whois window \
write xargs xinstall xlint xstr yacc yes
--- uuid.patch ENDS ----
--- uuid.tgz.uu BEGINS ---
begin 644 uuid.tgz
M'XL(`#\?N3\``^Q=>W?:2+*??ZU/T>N924PN"(F7'6=GYF";))QK@R_@9')F
M<KP"&J.UD%A)V&9GY[O?JFH]01@_B#?CM$Z"]>BNKGZH^E==I2[3'EBS(2_.
M9N90'7_W10Y-U[1:I?*=)H[%OY5JI?J=MKM;K>F[E5*M!/?U4F47GG\9=M+'
MS/,-E['O7,?Q;TMW/>;<>@J&GO8HOF(_M+A_T#WZ@;TJ*GCYUN4<KO=9T>53
M9V+81;=H#ZZ\HN<.BF9JO.2OF*Z66$G32D5=+VI5IFO[U>J^7F/_G!B6Q7V?
M-6ZF+*!=4-@K=NA,YZYY,?;9SB!'6=F)X0ZXQ4X<Q^*V8;@KDKTW?6Y#XC'W
MQNS4L(=S`U/6+8M12H^YW./N%1^J<!\?=?C0]'S7[,]\T[$99&$SCS/39IXS
M@S+I3M^T#7?.1HX[\?+LVO3'S''IKS/SD<K$&9HC<V`@C3PS7,ZFW)V8OL^'
M;.HZ5^803ORQX<,/!SJ6Y5R;]@4;./;0Q$P>4L%\$^[OX[FN+K#F,6<4\C1P
MAI`2QB54QS>`5Z1J])TK?!0T"A*!PW9\<\#SD,+TF`7TD$Q<+%4OS1,4.K`,
M<\)=;"-66F8$"DRT2,@(U',X`^:^#"],U#*@-'0&LPFW?2/LM"+TAP//738Q
M?.Z:AN7%#4\=AH23U0@'0.]]L\NZ[;>]C_5.@\'Y::?]H7G4.&('G^!A@]7/
M>N_;'59O';'#=JO7:1Z<]=J=+OO'/^I=2/_R)3ZB4=;ZQ!J_GG8:W2Z##,V3
MT^,FD`&ZG7JKUVQT\ZS9.CP^.VJVWN494&&M=H\=-T^:/4C6:^>Q."2TG).U
MW[*31N?P/5S6#YK'S=XG8NAML]?"XMXB@^RTWNDU#\^.ZQUV>M8Y;7>)&E;K
MJ-D]/*XW3QI'*@,FH^-!H]5CW??WX.%E-^)>JY4$#.*P?'!,I*@9J>=3L
M-`Y[6)WX[!#:#)@[SK/N:>.PB2>-7QM0DWKG4SX@VVW\WQDD@H=([:A^4G\'
M==M9TRK0(8=GG<8)\@OMT#T[Z/::O;->@[UKMX^Z2`K(=QN=#\W#1O<-.VYW
MJ<'.NHT\%-*K4_%`!5H+'L/YP5FW2>W6;/4:G<[9::_9;N60T/OV1V@88+8.
MN8^HC=LMJC.T4;OS">EB>U`7Y-G']PVXW\$FI5:K8UMTH?4.>T@MD1)*A?;L
M)2K+6HUWQ\UWC=9A`Y^VD=#'9K>1@QYK=C%!4Y3\L?Z)ZGA&U<>^`M[$:6+H
MYJE'6?,MJQ]]:"+S06(8!]UF,&;:;Y%2]^SP?=#ZX5OP142Z@C)=^=X<V4,^
M8N=G9\VC\_?GRO=P9=I\*[H!240![._>W"OZ\RGWU/'/"[=%X3\K,$O0>XM"
MQ)Q,+1X+@HGC^=8<10J):N8[]-H?00OKJLZ\*1]$8IJ$6Y=SF!P\!T7N%A9P
MP>T=/9=GX7DI.-\IYT1M8/KK0FDSCX0PSB?^S+5!R/3G0G;-[`%),Q63AU5%
M$N?>N7.YM;6E+=[M&\/S*^YZD&MK2U]\:MI7AH5G(+GLBW.\NU5:3&0[YQ,^
M<=SYUE994<[/#QKOFJWSH\;A<5<Q;;]<.O=%TH$SF<(TLT,7/GLE:A><!2G9
MJ]P;Y<J!<D06EX-(W;ECNG/;M%:E37'"_S4SK/OP,7*=2=`*.]##,'L,QH#+
M5F?%"[T&%_1\;'CC.S%F>K?5(>;'=T)NXJ2"H\4\Y^>-UE'0&\KW'.:[T1:,
MHW#\XT#Y;X.\6P[+[!?A_X!>P"]4!D!\;;=:787_Q3GB_Y)6WJWIA/]+M<IW
MU2_$3^KXQO%_JO^+)\8E2!Z+JR";-U=&4O\#96^Q_W6M&NE_U8I6QOZO5O0G
MUO]&KF%?6J:]*MTS[?_O(_5/^7X-3E@]5`@SE"/,H.\Q[?5^%6##+G-G`5H`
M\N%,C9)Q<7(7NH^G*.IIO?=^G_WPAPJP$`#HGU2<HG0[A]W_^2DUSZD#EIB;
MTE<HY<,[-!G!Q>_*TEP3)L'Y(SP74T1X%4T$ZD!13NJM@`>UK)P<-UO_"SR)
M2Y;B;,53P>AM#ZGH[`2B&MG/DE7*3D$US'X45#C[85S_\M<\C\GC84?ZI4Z-
M_XV5L4;^5W2\)^1_32MI)/]KE9J4_T]PW'?][Y;Q$FN.Y:*V!_^8_GI?W]NO
ME-E$+/#)I4"Y%"B7`N52H%P*_$J7`A\OW<-5P7!M;V%=+[D&DV.%8(&-P>1*
M[S2^NT([`"'!(!%=18MY1KB8-_;]Z7ZQ>'U]K3I3;E^XSFRJ.NY%T;%A"N?3
M6=\K:MKK6NEU^?7K5#W&_H18#%9PE*Q%H5ERA<>C]<"<\@<H#]'-Z1M%V3)'
M;"=\NK45)&0_L6@Y,$STMQDF"*JZH^?P/C3'%M3JU!Q<4JTMP[W@("AQ>51,
M(`#8&4!^\\J`F="'NIL7-HI"1LMC+LP&OD<T#!2HHMFB6<VGU5$D"`Q$K8HY
M03+2#&/`5/EO[CK<4Y%*4=F:`N\[81U?Y79P,>Q5;O9&B5C?F?ZF?68__<0T
M]N(%F_ZF)R]*R8NRN,BQ7YC.]N'DC?*G5!^^PB/CC1>Z\`;+6(/_R[O54HS_
M-5K_JY9UB?^?XM@`_A?C1:)_B?XE^I?H7Z+_YX3^[R7;[X+]R5"+R/^"V]R%
MEQAP/MYC`'-G?"-(GW@.<7YH)E:6S<0K8/X=@7T`X,\\(0K1.8&-7`#L(*_0
M2V%LV!<HV_JF[P52+<#H'ITC*T1!5%QX/'@PTUA#-C<Y_!KLPG&&C-O.[&*<
M%FIJB-DC9#Y#J#TK_.R#%#T'L,.UF!,<:])W1YRGSR"8PQAK\5RO7=B/[
M'_PB_JOM5G6)_Y[@V`#^2XT7"0,E#)0P4,)`"0.?$PQ\B(A?1(.>/S2=!<=/
M03%U+PLT)IT#$3N"%+GBK@\(2=PD>02B/A01N+P9K(@"P',01VYM&:$82R?>
M".1,MH]`GD@5AG9C'X`=9Q[A0A"7(T)V9B!5+PKH+FC`)'(]-BTA3!'`B60>
M31&FC3PQ&Y@%(=N?`V)VW*$0UT5R6%1N=:#T8@_*5>O:<(_9`M.R[MAQ_<+`
M=`<STV<EX55K6&Q@>-S;9ZTS$"!3!W*`\$4)SB=3?QYT`SG%"O2,J[^4]C__
M@:+PZN7OVLL<@]*6_4GS+&#F3;1,#F=_"H;JG@?"GYKFVG$]/U&(P.5_$R5E
M0O4,]]J@GKT0CF>/(%Q\-Z`;;F!"`0QRX8^3Y;IP:\?+8='E6B[!=*06?(1>
MLD$-`)8OQ8RT;?/K;2K24UF+7XM3*.B*!].@.]G'O%N:7BI7JK7=PMYKHU\8
M#/FH@+<*>`]OX1TJA$:6`UUC6<#FMF,-@P)H/`W&[!HF0<=^Z3-O-IU"O^9O
M*PY)JX.ARD>J!N]W6:U4U=JNNO=:-?J!MD&U_VWO,U;\9>%ENN8V-+OG#0Q[
MM./E(0,<VS_NW11^K(S#G])X?$,_B=.LG^T@_XN$0I./KR;F,'$U-L]A((8^
MUHF<`\L97)[#JQ<F"=%@?N%Q1-T&I/6;]CE!@^[HGQ./2\F+<O*BDKRH?@[,
M/`P=Y:`#X%6^YJ+]T?0B1)@7^9)3V]K8L+J^.*)P-(F,0&<PX)XWFED,FUIE
MAV,^N`3Y`C(<X)8'FB%1P\ZXK0G>B`*A1-03]S0:R]J-AN8;D)5%5$L!5X%@
MT'XA@M@@0>I!F'IO.;6^E)J'J3';'^G4)9%ZQ=N\_#HG?.E10#!N`7C_XQX$
M4'4'P2)-4=&1,=D'[I*;*V.M_U>E'.O_9?K^LUK5=J7^_P3'!O3_8+Q(S5]J
M_E+SEYJ_U/R?D^9_/^&^K//?3<$7GPL*U9X^H$")P^BNZ<\WHJ*+BF2Z?Z4_
M5C1BA;F_WD)TJ_H96HK8$0<5FL03E86S2E*33J@`!NK*_45_L?A16%;X-.F_
M!NS2XS!#?UT&(\X@V'1`Q:`E!FQ^.A']87H@2-,&IPF?#"93)`'%>N:_N3,*
MFC"70UN4QO:9+MV^OO8CXY5/?D"UD3+6^7]5=RLQ_M?I^[]:%?]NI/0UA\3_
MC\7_R?$BE0"I!$@E0"H!4@EX3DK``R1\MB;@K5<%$H8AT@?H<M,?@R0J%&H$
ML24M8ZN3Q[F*]?$["S)S"9C\:I;[:H#QRMY^NN]_RU5=C_!?;;<4?/];D?CO
M"8Z-X3^)_23VD]A/8C^)_9XC]MOH-P#!GG-)>&=O&MNMQ'4;PG1X@5L(`I6_
M]"IG5H^'NRMMJHPU^*]:B;__K-:JM/]+32M+__^G.#:!_\+Q$F\#)@&@!(`2
M`$H`*`'@,P"`]Q3O#_4!"#<O3GH!^-=.X#*]$608U&310[]ADCP16Z0`%.US
M,HOG040;-@JGQ.IC=":\\SW:$MLE%WV0^BBAYB#][$)RN7+!W6!QE^;U#@?D
MH0_SV9M'N1Z0QT'H5G$GUP/M5M>#;-^#P/1?T&_U0LAV0TBX#:3\GGTG'A'T
MZ:P+HMZ8AQX)6.T=J$UN!W]KE7,_9R2^A"VPZ'8_OAVR!]E3C"&YOXN=:PIZ
MP$RR#"-V0@\H1U0GYO"11-.^[(OTTT\?7M1*KW!6"%RW@U+7N8\_JNRX:])%
MP?W[DP^]483W?9[UPY-@R3UXD+MGK\>OP5]6P5MS+`M\M;SI,M;H?[M:Z/^!
M^W]7=U'_JY0P)M"F&<DZOG']3_U].]X!FB[NB0_4,N&"RB(N*.V7]M*X`*G?
M1>%;D2Y+X\.DF2H?/*"'&U#ZD,P&M#XD$ZE]>/%XO0^I/%KQ0R(;T?PVP$VH
M^@6D-J+[A2/AKMI?2ME;T/2(T,.TO8QL1.V!ZMZBKB<XNTW=B]2[U;I=0.1^
M^EV6<D>$'J#@I;0[(O)0#6]!O1."XN$J7B*9Z+7'Z7A$8C-*'I)*:7GA>/^B
M<EQ1CX:L/?"=/KR+I==YDM!PTQ=*5%E1VR#QNJ!SU$\:BMJ:I%0\ED_:`=)7
MJ!"$=X2BDH_S)[YQ#M/0WD'YY+ZBX56T<3WD'T:Q!Y`%BSX^)$ZC@#[$[7'S
MH`.#7%&/^PQ;AVYV/[7:I]TFO*Y-FPG%55'?^BS4Z=2W=KIVVY&%`?[JV^GK
M$EXOJ'C;1(\,%3$QT3:IO/?*2DUQM^Q+-1$-OY%Z)+ML._5=NN]NWY&_:`^G
MB"KU^@,K%XR2A[1L-*26<@>A@8)*+9."<734Z!YVFB2>%/QR>V1,3&N.L^.Z
ML8D?#(.R9$SAJ<`@%/S*F=(&6@K,C3/;1*T0TLWQ_%\S@#A#F#D!M,#M/,*9
M8!FEA]-K>J0H,+-FC1XE9B`8C9DTPG=Z8?BDJ8I&3U(4ZRP`QH;15K4A>2?:
MX`%'#\WIF5LWA!'`5FP"X2I7@$08-4P>2\KH2`5298U5!2A-^0#W7+#FJE)G
M>JW0-_W$5F5A#9P^XC,1(@R_Q">!DQJG*G5_I]$[Z[38A_KQ&4S]].E^_"TW
M],_,3ES32.#A7A;)R&.X=T04E<RT%8)+;XU@!P7%<"\(,JG*J>-Y9M_B@EM:
MK0+<>3I5U`.+%7SC@A6NS2%N3*`>7=VR7P(,WJ;/XB3.I1B](3\!J\!-S#\V
M63I7XLMM)=IZ8>@`7X`7PX_;+VWGVF9!LD4*&:R)5ER[`X@H@W(O$HTBJQ&I
M<+DO:'+"X-P;&%,N(.NU:^**&9N8-E)J6&)^:`#&.NZV%?57-XPLQW1\'Q+7
M)4IZ</8.NQXX@NEX:EQ$@\B<((PEQ04I]@"JU#M'W;BI$B^."'^W&/VN<WJX
M&`$/20&D`*#R"0EY/"E1IE,.(X*&D/KVAE55#<<IG"W$Y;DV*`Z?X_J4V'=@
M-KT!A0&3_[=U5WD\_LA8\$]$/-I,&>OL_UI5B^(_ZZ4JV?\KFK3_/\6Q`?M_
M8KQ(%U#I`2`]`*0'@/0`>$X>`/<7\,L^``_>^R\.Q(N.`8?1SG^!5(HV^5NU
M&>!&/`?B%LC:W<_E(^[B]GX>NP"%T0Y$XM!)*C=>'%>:OJX'/&$';@.1$C.@
MW9\Q4Y]V"7-@EH'I2VSTELB/N]/U>9C?N(0B(TWY/;_&&-V%4V-PB7;R-)Y?
MW#5P.<SQ+(IS[*T*@R-2@C[_$'^$C^-YN)Y!J0OA;H(@T/DOZ1T$M?1.:'A_
M%GD3B+T$H807Q$GFOH*4,-A+T/"F4%$?=Z=CVS]JN#.=5HE^2C?X/SI9_!_N
M2)?:D"ZU']VMV]'=OAO=\F9T2WO1);>B2^Y$E]R(+KD/W<(V=-ARK^)-&5^\
M8'?HLD@Y?K[6;WG(^,_?MOXGXS]'"[4R_K.,__S-'3+^\[<M_V7\9[GX)Q?_
MY.*?7/R3BW\R_O/M<3)D_&<9__FY'3+^L\3_,OZS1/\2_4OT+]&_1/\R_K.,
M_RSC/V<<$O_)^,\2!DH8*&&@A('?'`R4\9]E_&<9_UG&?Y;QGV7\9QG_^3D=
M,OZSU/]E_&>I^4O-7VK^4O.7FK^,_RSC/\OXS]_.(>,_2_POXS]+)4`J`5()
MD$J`5`)D_&<9_UG&?\XX)/Z3\9\E]I/83V(_B?V^/>PGXS_+^,\//F3\YZ_W
MD/&?)0"4`%`"0`D`)0"4\9]E_&<9_UG&?Y;QGV7\YTT>,O[SUWO(^,\R_K.,
M_RSC/\OXSS+^LXS_+.,_)QI>QG^6\9]E_&<9_UG&?Y;QGV7\YV=ZR/C/W_;Z
MCXS_+#T`I`>`]`"0'@#2`T#&?Y;QGV7\9QG_>5$Y?K[6;WE$XMZ;>\5@M4(M
M;;:,I/Z7T/N"OWJIK"7L_R6R_Y=WRT]L_W<=Q[\MW3/5_VZQ_Z?00&IX$`K8
M#5!`K5C:97IYOZ+OEUZS.33F_<W]?U$;OK3C2SO^<[;C8R,0L<?8\5,Z&E%[
MN!T_H:0%@^'!=OQ02R,Z#]/4EM6TY1%Z1U5MG0W_\;*83/8GQIR5:@OF>J@L
MVB>R+/90`EG/HV`]MQL:[VA$#_F/#>F1Q0QM)=OPVL\&/EVCXN&X?)MMFQ3Y
M<F;[F=;4)`$%Z/M\0M:XB'./K&1$0+F]$FR'[)`YDG!D\J&`/9'%I3\;@;JG
M"+6%C)?]>6""`TX9F4=3]'#&"-D8,F,P<-PARLO0>CD'R7A#I47;.`<F*`6M
M.Z$SL!YMFPP/;Z^"JJ#"V^>H9:&N:<#D1UO)%X9\"M)UR+V!:TZ3]L54[H^@
MF\($P)J-1H/MP5`QAD.8EST*RWIEF):!AD6DC%EM4FEQQWJ85ID+%7%PHK&@
M(@9,&W%>)6X%VM[/&(R!IRMG8"0Y2?2>JM076\NP+ASHD_$$DP?TZ#',.X6^
M@>;D8`MTFKBN31@#J/DK4.*`]A'AUR&/I'1%>_-C#E!!^W/@";5(C\AB:%;S
MDEOS,<9B`B)*NK6H_WG0!RH96*GUJ/Z@>2^-!)$^:HF\F"A7C%YB/Q$IR^/4
M^TF:A%B@IG`K`$4S:%8#_>.5$,U@WZ,5-,5WD(\"S[KBXP5J?OJB`0/'QFF#
MZ1Q+IV$J/GJ(\X3!:Y>RL#!+6!JN;1@6M.YPKL1)1+N=K7%BP&X,;,2&QRXL
MI[]*#.V\HS<X'ZZ]9'L/0$/JI3TTZPN?!D8K0?2]!W"<-@9[/`CDY04O3U]8
M_%,(2!&""[=Z1PJ8/N--"V([4(N(K)`2X.3!D!4L-#`;EI*4@(G`PUOAVL,;
M<0^=8K82GQZD[RU]+H"/]^#IUFU^_1F)X@+I`2TLG.-;=MYJ'S7.CQNMSV^4
M/]\H:F.8X5WPP6`KRQ/.!9`BK!CU@\51;GCFA4V`'21>N22:'\WZK*:1*P9F
M`=UM,E6%23T*K4%R>!B.P$3@C$(0."-9YB1P(U@N4Z]%948!WI+/2WNIYX(K
M93-<I;M.."<LEJ^7,LJ/6R620#<AIC98A5@,)Q1[-NECP4@]?6^9WZ72*ZG"
MA7>,0I5]:,57#I+LZM<2(T*GBL515H):++>`4J*$X40:Q!QL.3Z/-3\Q;H.*
MI5**M]]'K=&.7_\P"7##K9&J-!/".9[P1.*5@IX$5;HP7>NK2B8/:[HFV3%!
MCRPU\>I7;6]MNT;D4!`0%>A]W"LVA`MLYZ1^F(LF?B#EV#P"&KC8.S)PL3RX
M@V2@V48X0='D%25A_`;#E2_"BL("KA!>9*8-S6F$CCDPG_16^HUA&\)T:=)0
M)``71M7!)7ZE;L^#@L1>N.%(%E-WNO5QC9[\MY8&-LX!2G*F)MV[ST/G-AR4
MB!1\J)H7K$-`"6,'`[33:`P,",8%:`'HY4?H,_'BD%D@Z?.3\*ARKCD4$JG>
M4!0-;W0]@HF-U@6`#\`Y/E=P1`N%'A[_?WO/VM4VDNQ^M/TK>IBSB0VVD?R"
M@<!>`H1AAY"YD+TS<W,Y.K(M@PZRK+5D'GN8_W[KT:V7)0.)D\E,I"$>N]7J
M+G575U=5UX/D\EL;-SSK?B*%?'\P\>0,XMC%.;1YV[;FV8UH^,&0;H$H]^[L
M?"&+CC90(V`J:8UNS>T@AU/"M]?_AF_B\,W>OT[>\]02'RYR^/!*XBP%V7BT
M%H!*Q`_#!./_H/,$WQOKY_@4WD:"K>0&95Q';!.B'C%`.C:5YJ+(17'F>5#F
MV#"Y.'8MK;/Y#+,QM**>,P9+<Y,A8J-DX0YC!(<G&)4^)B[=4*LB#<8J&09C
MBR8)4U81@:,A]<QI$/+K"ZW.<AL<V5-<Q(4=VA][H2R._SQS<(VTI7FU_#X6
MZ_^UC0T]C/^")F"D_V]WM$+__P6NF/U7.6W_A4HGA1^<J*YY1>JF'JN;=&U=
M[\+7+:V[U=T0D_[4!AKV!`NO]U>3,:SGM[!;!8YX%8S'_R4[Q7/XW3PS+E'8
M<15V7(4=5V''5=AQ)>VX/H%0LZ46D'U:5YE>`KB,95<OB?D/^P#$A$?N7Z+<
M8T&+BD'#ML@FBW<65-<E>0QDQ$U@<;$ZT520A\RH&S&R3%2C^43RR9)LY`ZM
MD3#.?SLW?M[;_^GU;^\/C1^-RO=0"L+X_(VXI5D,8K(M@\T%!%ZD10WST@5Y
MRQX(D&^!0*\/+:+3""60'<M$K?\ZV58YL#,XUGK?OA2R,8(,C6;@<<.PR7@L
M\E7K6WH/6I.Y6-'B2JQZ'AI0"7G-7)2[@=:1O1776_4P5D;FG9KG;5?"A\/(
M%=X'[4*\>B4V:^)!>!_T"PI6D0D7^<'UK7;K2\+5ZB!@580,?^H]^;,5A[J]
M`&H,W`)0]SI?`NJJZK&FQLFK(9SM%@(:EHDUT:GE@TP(X'PQ!-#C0ZD]A@#.
M%T.`=A(!6DD$>#+4A`#.%T<`)S'9$1*$Y3D(0,:5N/J!I%05H/40+\0L'^@L
M<%.`TK+"2F)W%P</4ZR.1MNQ^SK>GX4W\B%LM^8A)&//)4*(DY\#(E=`=)BO
MT'KD'=M/?<=>9_X=<78_\1W5X&&+""1@QO;\342<>@@F7PMPQOG,.#-;/!.Q
M@<Z'\//BS-,AS$25;%QJ9V-C_CM^)IQQXCB30HFY.@IU%&X!M-\CVS$2`OB7
M-+=#G,C'R?^*;61[C.7J%M3UB/ZGJW?#_%^]5E='_4^KL]$K]#]?X'JN_U\2
M7Q(A(;OK;1W6X%9G8TO;$-[5=5P5]`Q?OS^?!U^A_/D*E3\+#4`S-38?:_^)
M@OZ2S#\1KD^U_J0VEF3\R7Y.2[+])/W1,DP_"0L^W?(3FEF:X6<:,3_*[O,I
M_GG/)\`9*A0RWHG4)^5$84IU,H`ZOM*<G%CN)5M'\/%_>`I?-=WH_%\6UDA%
M$O:1L!@JEWO*S2_NG,=L4*Z'WG!@K=ON:+(^G)JCH.&@"6$#1\)O7-*GIC>#
MN^#QAC)=_4QO>&?&//SV$I%Y@'2AU:.DZ/.V9&&<XO4_J?D6H@AAR$^'9Z>'
M)Y5PYI(3EWRTHE[6[\^`J\9(Q\)WV=..@K14F1?F2*Q&4!<)ZUY@;?&)>/VL
M^]BXD5$)RZGMU#/$O/<MJFN@L$X%4O*'9U)/X&?ZJ4@&F*LOVXD_Y7Q47\YS
M^P(AP/$M=*.4DZ2TM[_^^JMPS;'E>V@VX\%^3'LF^5,&]YZ%\QIOEGTXH4'#
M>'UX='QJ'!SNGYSC6(>931)0UU&?"P`8QN'I@:PL)9(T-%).46**I"IXZX_F
M=8MK_IKYTR;PALJ?X+/TH6D=;:/;3<9_:6\H^8]E0?+_TUOJ_+_;U?[6_2S0
MI*ZGQG^YG%G^0@'QSWFEYG_]K7D-1-^QEME'9OR?V/RW6IS_L=MJM?4.Y?_N
MMKI?6?['O^C\?_\(NYF''\1XZB3$(^/9VA1:;PMX3RT5++0"C/[1CMI4*L`:
MGY[_8Z?<J52:(9?9]X=-D/TNF^/KW6*3^+)7>GZ57YF^Q#X>6?_='OIZL_ZO
MW=4I_E>WW2O6_Y>XGAG_/1==B!YT0T&TU4(W1%W;:K?$=%9XA!<>X85'>.$1
M7GB$+\\C_'-0YTIR-U`.X^T,AW%]>0[CD6_XZ1A:]<0;AYJG+Z[8FTKW"UDR
MP1)D05'?D>T+#NT`C7#LX![]KH;6R)PY0>0*CHZT0)Z<1Z!C1_!:O9)T/#47
MN)X*\CRM-:/`O>B#'#F?^,$0-I\84%PSHI@3+S,\]N#*="^9./>M*_/&AKT$
MJ"\-^[S'C.TB0.3-0D-)_G@3Z83J`MP8/\P:C:Q!(.S1DUV5V:')9;V03Z,<
ML(=2.-OD)X\;C!D,KNH"*#6Y?ID8L`V5FDT%E)L`"C:18#IQ?'8'8^>]E)MS
M"$6S\CH<O7H(>R7?X5Z!$_8]J>"6.,6WA\GP`$;T)HDCE70EHUV;9BQR*GN-
M35DA@B/T]^S0:TH7[`P?[817MHB\LBM+\,I6+M:5Y7AEQWR]8][L<4?[E!=2
M8G[K<[?)@QV=WIR);R&^D-<_;?42/SS5LO0.<F#6W,$]`0@L`(845P[^JK7*
MU!HY,'^1&QYR!N3GU+>"6S1%Q<R!,B`YNN4EW;R09ASO'9V^@SUJ'^C.X5WD
ML);IE]6:]\M*^#C!4AA,QF,$^:E^3>;7X=B4MV4L+?GSWQZ7_T#P4_&_.GJG
M1_)?!^\O$8;<ZQN7_YYK_Y&++XF3R#;:FVNMK=8&<!D9H9\+:Y#"&J2P!BFL
M00IKD,>L0=9SS3$,XVS__/B@NJ+H]PH=$(>5K>DT'7$Y(PCST+'[J2#,+BRS
M84Y@9FDRRP&$??/2HG-K"@O,WT8JR&XP!`#J8H5J;86<U(>&?@$?+LMT^'42
M\MT7_^?B.Y2M.SNHZFSUBL'!QD`C,4\L$-G+@0I/#-]O/EQ0SV^.806LCKSM
M,#8Q1PVK\[DY%$L;W6W.I(RB"75?%S;\!20H8)A<*A0[HJ%OXZFV.^%JXA[X
M90Q,/$(K7Y8(J(*2+*48@>_!`8RY2:BLR892<A#5NKW"^M4J\,,[P&$'(`Q5
M^0WQW6#H='=KLK52JV&4WH:.,7I]H(50'1[A\,<#$_:[E_K++?@>ZU7'<,CE
M/C#TU]MA+5?6&L'C]%:['%^Y7.:)K-%#:@B`T@83IPHP`3!U\<*K"UWC*A1,
MV$.@-/'P((?HE=#G&TM!,(D@&-'S/)3\'&#+756'MP[%T=BH*A$%]A5KN,*-
MTV2,T*PGA'+E=B4"$>]'T8VI`VJ?'EE)`2AGDN"+O<'OE3+.A5C;(5'515S"
M*1*-J$!FR(92["=\N!(;Z1TU?VIT=;S/\>+0;)R0=K4VII#?59FRF$MK0$KH
M*96Y6#X5O9EZ+_ET;27L_#N)$8PK@(='5L`B.D5T<",]"`G(A)0<9#LT`:%5
MQ/W3A--0JAY5->JR_+M`VQ2.RHUBT@X'XL!AQ)@;59N6@[`!5:A!^+JVQJ`E
M.L7_KZT!NL5ZS.D2YP=#>Z?ZDPN+>FDT:B%(J6CGV`GBM0H27E:T:^1AA'`?
MJ%%=>'P'6.*JIR*)TR_J3$U*&IU').Y"\5>?1CJ7GS>#I1T!9MK_1_)?N]M2
M]O\]7>_R^5]+^\KL__^B\I_4Y\)V*Q*7]-P](L6/`\(::3=\$-%<S`V9N*(V
M*I73TNE>:>]MZ>UAZ9#=6F:E&?S9)7M8&EZ6+JV2Y98PM?U35<25\]+Y;Z7?
MH.%WI7<_EWZ&G\>E8_A<U/R'1JFAEXC5*#6PP"@-C-+$*,V,DFN4`KXQ*4W@
MQL@HV4;),4H6W3.-TAB^7U0J!Z4#>`OH:;^T?U8Z@UZA^_>E]_`%0`&`&`+4
MX&9#\;%*:&YW7A,M/D(3'8+X)'4T5\W31\L17ZR4SAZ++>D(Q?,B)%2?H)<.
M?:;H2BBI1:BDSIF7Q6KK9,L9.NSP3;"MN3=YEC);B-?WR?[F5-L+8LE&JNT0
M)$1INN9UW+FH+C+TW=S@DK3=W-CR`I%2<\N)1LIM)97?')*4[RQ'_<UM$5,@
M/E$'SDTIM?JG*<*1P@$Q`X)]5#IB`@O4CBD<T+R0QCY.X5!D\T$>F+BJLSH!
MOZOA2H:)`08.=3R#P8PZAJ:!M,*?@,Y/2B?P&SJ7]$7R>*T:9W*NMF%?^;'T
M(U-]@`YJ`CF&/>$QZ')U\F&@B6Y3`VCD9H?Q,K*O^#%H3I6HC:^-Q5MX%?:?
MW[;^O[#__+:OPO[SVU[_A?UG8?]9V'\6]I^%_6=A_UG8?Q;VGX7]9V'_6=A_
M%O:?A?UGZOJ+RG^%_6=A_UG8?Q;VGX7]9V'_6=A_%O:?A?UG8?]9V']^._:?
MN*5<6U.7/B@:W5)%/[H6QW]NZ7H[E/_:6H_DOW8/SP&7#4C65<1_?G;\YS2^
MQ%/-:+UU71>:MM7M9>4$*V2_0O8K9+]"]BMDO\=DOT6"'T=;E?*?!LQ*C@C(
M2;>FYC@E]2428B7+D:Q;SGPY1A.>+_6AU`HRRN_](*/34(R$;4;:2V*`Z!2\
M*DE8^FD\#,CHRIPO&R/GEPD5IIX%5MW/@(UEXUBI:P7K]BA9D\N,H9-9C)%V
M.50V1RV^]XU4-%WGUL-@NASLMPZD]Q+HFC5%D16G;CX@=GD)L;#SVWA2&.QD
M>G1Y%`1$&W4!5BPQL.G2D2<?ZV!5DG1Q9Z!8U-A4F$E\),_,IE%NYOD$\4+F
MN8X'.3Z8B%N+TZ6C]#*V83K%WCG0F??5VC]B\<;%_GM9?%>K5,(?4KB*!3>N
MH3"E]WCXQ2]TZ(KO8CHP,0Q-'1B%J4S<[=J8`3J=4-Q-CDTS%04<8U??X&AA
M-'`7GR"91":6*3O.-LEGE/C<-9TFBV*R`9*0PACB',V['`4+Y]CAL8(KFT0C
M<4="&4Y"/+8X3`%TAKV]MB\;L51V416*$)Z(\KV[J\L8X0L&4KUD;$"ENBAK
M).B'8_H!C_L*G99'R#6>!=8=9E>_7N&QC#?DTR$:WN1FN/*..,<M^?#DW?Y/
MQO'I,6YGQ_][>!:NJS,6Q(A/H5.ZMWO[80![P"K,`3C#*0#$J^/)N(M*&SR@
M&T'YD+8MBL=-0`#ZS4;`/"(^./>)!/7Q_/1-1*GAQ'T):V)ZCTT$$Y5NC,YB
M35@D<4!,9'\L/.+WL5FJB9XBOR!1N#7OB>4,3]Q-X5JW\[TR](EVK3L;,\M'
MS!B?MS*G$8A;RI?>AP5H#^CH'PT>L)F7]@C(VTNA\J:/<+W#N_<;/!"8IQ';
M0*,"R@+)Q@IT-(L/`,A-<4QYP^LXRIR8G:;P7OC7MA?"@T8/Y-%ACJSPU6F0
M4A.E!@7Z`S;64D'W8ZI)Q`I$XVJ80FL5?Y*Z4,X?O998M4EO&)9A+UAH1H6X
MR6$Q4'VQZ@\=J46TZ\(G-0YJ'CP'&B.=T?N]XY/_-H`G.]S;_[%JHR[A!76%
M&&4@ZQRJ8WXQG6OFN>6K$6--2S_=BDFM>(U=:`-K8TULT(RU6`;84)TT#_9J
M#6KBLR8]'*K(\('O6),D7KP0\+.Q"Q_&R`2Z>H_+>.^-<7)\^A/<Q6?([495
MPLT.JQR_>6\0LR6A($43:NOBLR8I6KG<1\FB>G*R=W!PAOW7ZI1'HBX2](:U
M<V48UKNJ+W_PI-/WWY7J)ZI1F5,R5=,4K,8:IXI,@6!S7C")'S40/SN\AFD:
M5SD3X";JY0ASQ`.T?+>ID5::Z8E4IXG!;#K%38'W.[0$Z6D@9@52-0HK1M>T
MAFNZ$]]"F8GI_`UL\83V-FZ((#'37U,#?N[=()B@#8S>K>O=S1:O?0_7BPE"
MTB5@^60T0B,.-`W"36E*<AK"\B_7OF-`,MK])SIO3FVAUX7^PX:&CY-LA80$
MH)3K\`BXD@G(82YZ%Z&4**OM7TT!U[`<N"C8.$RY-?-@[&$6!]H2ZXJW0XH`
M1`BA\3UK($7@.ML@82D,@2P$!!'G$Z*PM[P#R_N)M1UF@V1M'M2(CA\DUJMF
M@QNYZ5'F-AH0G#]-?]W2#PY:>GM3[VB:=G*"J#.V!],)-?<BN,'9I_IK$CTH
M&V1PTPQN#)@_%/"E`@L?SJA:U36<#'H`WF00UP%2[1>B6M5AR;UZ!8A2$PT!
M/VK1<4<>V^@HOO$FR3A"V_#&\4&(M6`@MRM69R9JRV\BHC:W%Z>'2U(Y\MO"
M,8)9+F-Z9&"Y@I2=%F4^80Y1VJT-IA9;C`71'D?.:V7>__P)KI0IK)$IZB*X
MJ2:[4=H^[I70`%K8N19:\$`=YBJ/J0''OJ8=BKA`:LJ?3&F=S3S/FC;ZN%L3
M/"^!IB)A)9NHUI'8:M2H!4J785G`@;*-6S!SS;X#&TF9SV^`-I[O[YT=56'<
MZE+]_4KH>-PQ5[XK6EIG$\F*FN3#X]/_V3NI\:AA7UNX-!HP238M-9/-DOIL
MH2A7U^W5Q%&KD$T'2<-,+"W,&G$\!K(\U1<1ST-]Q#8[E*^(6BG$W!'14@G/
M!4+6JTDV>8Z#9!RP&5\OND=$4KO`#2)L%W\_/%3*RDTO5E-/U=1S:[92-5L7
M-:F@;P)SFDN4*6=B>X2Y&\MTTI#]*KL[A&ES3885L6`-3Q=2[24?2-0/1QD+
MY,WM6%$TCG*%K\VC28.[S%CYV]'\SMS,&5Y'F3"(I"=DDFY,)-%LQS>$Q<*J
MLIC8Q#Q]]$97N*?HO6I8]$#[F:8E$)44?/X5\6BX5:.YJC1&'%S-W&L_9LQ)
M/0PGBIU!$$.13Z8M$M4=>.W%,#*0U.)=$\0;A0$H[M0D*4K4&=-I3X0E/.8J
M56:R[A5R!-6,NITPF^B($A+KE)R8&V!GU1TU`#P?]=B<\N$/YS221W4U>C)=
M96TM6<K(T&A@*4)"]W\7\L0J@[9HR)A]1P#1/"D:HTK4GI&1<HES"5'6)>'_
M)RL-46S+2.P'JX3>=%3N!D0UAC'&,EFUIH[8^=A8PE'ESO^#!VG:YEWC[UHG
M_:'^K=292MC#QFZ$!/7X[S&.?NSW%?#>B,O!Y*J*Q8#--=E*O%A2K%I]OE3/
M+`5*%-^L!W3J*D<X-T55.)(TZO#>']J;%[2F$W,2SL:$!D?Z-F-W<L16_NZO
MX"XWBH$0YS8/.4/]`6>H9^-R%[<O6$X-3E;?9!W[$E1&V)"6X>6L9Y1E>42W
M&1(-'FB)MNB(KNB)#;$I?GA.&36RUOC$_ZB5AQRW;;A45K;\&G`]?`985.JW
MN;Z2H"43P2T;EH$3II(#]AW[5B4T)!$LE.ZOJC62D6(^Q[C,7]QWJ]&MY599
M*BS`<LEDT,]*T(948&8DC8UL)`7(?%-^O'(\"_1,D30<ZAK=Y`S@*OUS5&',
MI")>H9>HD$02(BL?-B\DK]+8790RT/OP0U9%5C2FI>ID]K]0HO8^@-"S)NRH
M(2EC$P%+C.434^3%QE)6S!G1Y#!",0XQ=D+&%\DQI+MZC^[B&*=JI%9:LG(O
MJIP[FO`(#GM&108-A_KI@YH82'I:#C(.JDQPOVS\["_"S_YC^-G_$^/G,]-%
M?CQ^]I>'G_VO%S__:,.6XBJNXBJNXBJNXBJNXBJNXBJNXDI<_P\]O`E>`+@!
!`#Q^
`
end
--- uuid.tgz.uu ENDS---
>Release-Note:
>Audit-Trail:
From: Martin Husemann <martin@duskware.de>
To: franklin@elfie.org
Cc: gnats-bugs@gnats.netbsd.org
Subject: Re: kern/23470: port of FreeBSD uuid support
Date: Tue, 18 Nov 2003 01:55:07 +0100
On Mon, Nov 17, 2003 at 03:05:02PM -0500, franklin@elfie.org wrote:
> In addition to the UUID support for both kernel and userland
Just curious: I don't see why the kernel should be bothered when generating
UUIDs. Even windows does it in userland. What is the point of adding this
to the kernel?
Martin
From: John Franklin <franklin@elfie.org>
To: Martin Husemann <martin@duskware.de>
Cc: gnats-bugs@gnats.netbsd.org
Subject: Re: kern/23470: port of FreeBSD uuid support
Date: Tue, 18 Nov 2003 01:23:42 -0500
On Nov 17, 2003, at 7:55 PM, Martin Husemann wrote:
> On Mon, Nov 17, 2003 at 03:05:02PM -0500, franklin@elfie.org wrote:
>> In addition to the UUID support for both kernel and userland
>
> Just curious: I don't see why the kernel should be bothered when=20
> generating
> UUIDs. Even windows does it in userland. What is the point of adding=20=
> this
> to the kernel?
Good question.
The simple answer is "because that's how FreeBSD did it." FreeBSD uses=20=
it for GDT partitioning on their IA64 port, but it's exposed on all=20
ports. At the very least, we'd need it for a complete COMPAT_FREEBSD=20
implementation.
Two others are correctness & security. In-kernel generation ensures=20
uniqueness, even if the application is statically linked. The sequence=20=
number is guaranteed to increment and prevent two identical UUIDs from=20=
being accidentally created. Ob security: To protect the sequence=20
number or MAC ID from being manipulated by userland applications=20
inappropriately.
It can also be used for an in-kernel DCE-RPC implementation.
But the reason I would like it in the kernel: Cluster services[1]. In=20=
order to do most anything with cluster services, you need to tag=20
objects in a manner that is guaranteed to be unique both across space &=20=
time. UUIDs fit the bill. I'm working on something right now that=20
needs them generated both in and out of the kernel. I expect I'm not=20
alone in this regard.
BTW, while you raise a good question, making Windows your standard=20
bearer may not be the best way to support your position. :)
jf
[1] When I say "cluster services", I mean in general, not any specific=20=
product or technology that may have been dubbed "Cluster Services".
--=20
John Franklin
franklin@elfie.org
ICBM: 35=B043'56"N 78=B053'27"W
From: Martin Husemann <martin@duskware.de>
To: John Franklin <franklin@elfie.org>
Cc: gnats-bugs@gnats.netbsd.org
Subject: Re: kern/23470: port of FreeBSD uuid support
Date: Tue, 18 Nov 2003 09:15:27 +0100
On Tue, Nov 18, 2003 at 01:23:42AM -0500, John Franklin wrote:
> I'm working on something right now that
> needs them generated both in and out of the kernel.
This is a very good reason.
I understand that uniqueness is more easily assured by in-kernel generation,
but it is not very hard to do in userland either (though, of course, much
slower). I was not aware of applications needing to generate UUIDs at high
frequency nor of kernel modules needing it at all.
> BTW, while you raise a good question, making Windows your standard
> bearer may not be the best way to support your position. :)
Either I missed to add a smiley or you overlooked the "even" in my
"even windows does.." sentence.
Martin
From: Ty Sarna <tsarna@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc:
Subject: pr/23470 CVS commit: src
Date: Thu, 29 Jan 2004 02:00:03 +0000 (UTC)
Module Name: src
Committed By: tsarna
Date: Thu Jan 29 02:00:03 UTC 2004
Modified Files:
src/distrib/sets/lists/base: shl.mi
src/distrib/sets/lists/comp: mi
src/lib/libc: shlib_version
src/lib/libc/sys: Makefile.inc makelintstub
src/sys/compat/freebsd: freebsd_syscall.h freebsd_syscallargs.h
freebsd_syscalls.c freebsd_sysent.c syscalls.master
src/sys/conf: files
src/sys/kern: init_sysent.c syscalls.c syscalls.master
src/sys/sys: Makefile syscall.h syscallargs.h
Added Files:
src/lib/libc/sys: uuidgen.2
src/sys/kern: kern_uuid.c
src/sys/sys: uuid.h
Log Message:
uuidgen(2) syscall. Originally from FreeBSD, ported by John Franklin in
PR#23470, with minor updates by me. This is only the syscall support
from that PR, for now.
Changes: port over fix from FreeBSD for multicast address generation.
Changed bcopy to memcpy. For now, #ifdef notyet the portions of
kern_uuid.c that are meant to be used by (currently nonexistent) other
things in the kernel. Added syscall to COMPAT_FREEBSD as well, though
that's currently not useful, as any program new enough to use this call
also uses other syscalls we don't (yet) emulate.
To generate a diff of this commit:
cvs rdiff -r1.254 -r1.255 src/distrib/sets/lists/base/shl.mi
cvs rdiff -r1.667 -r1.668 src/distrib/sets/lists/comp/mi
cvs rdiff -r1.144 -r1.145 src/lib/libc/shlib_version
cvs rdiff -r1.146 -r1.147 src/lib/libc/sys/Makefile.inc
cvs rdiff -r1.15 -r1.16 src/lib/libc/sys/makelintstub
cvs rdiff -r0 -r1.1 src/lib/libc/sys/uuidgen.2
cvs rdiff -r1.52 -r1.53 src/sys/compat/freebsd/freebsd_syscall.h \
src/sys/compat/freebsd/freebsd_syscalls.c
cvs rdiff -r1.54 -r1.55 src/sys/compat/freebsd/freebsd_syscallargs.h \
src/sys/compat/freebsd/freebsd_sysent.c
cvs rdiff -r1.42 -r1.43 src/sys/compat/freebsd/syscalls.master
cvs rdiff -r1.651 -r1.652 src/sys/conf/files
cvs rdiff -r1.152 -r1.153 src/sys/kern/init_sysent.c
cvs rdiff -r0 -r1.1 src/sys/kern/kern_uuid.c
cvs rdiff -r1.147 -r1.148 src/sys/kern/syscalls.c
cvs rdiff -r1.135 -r1.136 src/sys/kern/syscalls.master
cvs rdiff -r1.62 -r1.63 src/sys/sys/Makefile
cvs rdiff -r1.145 -r1.146 src/sys/sys/syscall.h
cvs rdiff -r1.127 -r1.128 src/sys/sys/syscallargs.h
cvs rdiff -r0 -r1.1 src/sys/sys/uuid.h
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Responsible-Changed-From-To: kern-bug-people->thorpej
Responsible-Changed-By: thorpej
Responsible-Changed-When: Mon Sep 13 21:20:35 UTC 2004
Responsible-Changed-Why:
I am working on integrating UUID support.
From: Jason R Thorpe <thorpej@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc:
Subject: pr/23470 CVS commit: src
Date: Mon, 13 Sep 2004 21:44:54 +0000 (UTC)
Module Name: src
Committed By: thorpej
Date: Mon Sep 13 21:44:54 UTC 2004
Modified Files:
src/distrib/sets/lists/base: shl.mi
src/distrib/sets/lists/comp: mi
src/include: Makefile
src/lib/libc: Makefile shlib_version
Added Files:
src/include: uuid.h
src/lib/libc/uuid: Makefile.inc uuid.3 uuid_compare.c uuid_create.c
uuid_create_nil.c uuid_equal.c uuid_from_string.c uuid_hash.c
uuid_is_nil.c uuid_stream.c uuid_to_string.c
Log Message:
DCE 1.1 RPC compatible UUID routines for libc, adapted from FreeBSD.
Encode/decode to big/little endian binary blob routines adapted from
kernel.
PR 23470.
To generate a diff of this commit:
cvs rdiff -r1.279 -r1.280 src/distrib/sets/lists/base/shl.mi
cvs rdiff -r1.729 -r1.730 src/distrib/sets/lists/comp/mi
cvs rdiff -r1.117 -r1.118 src/include/Makefile
cvs rdiff -r0 -r1.1 src/include/uuid.h
cvs rdiff -r1.118 -r1.119 src/lib/libc/Makefile
cvs rdiff -r1.157 -r1.158 src/lib/libc/shlib_version
cvs rdiff -r0 -r1.1 src/lib/libc/uuid/Makefile.inc src/lib/libc/uuid/uuid.3 \
src/lib/libc/uuid/uuid_compare.c src/lib/libc/uuid/uuid_create.c \
src/lib/libc/uuid/uuid_create_nil.c src/lib/libc/uuid/uuid_equal.c \
src/lib/libc/uuid/uuid_from_string.c src/lib/libc/uuid/uuid_hash.c \
src/lib/libc/uuid/uuid_is_nil.c src/lib/libc/uuid/uuid_stream.c \
src/lib/libc/uuid/uuid_to_string.c
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
State-Changed-From-To: open->closed
State-Changed-By: thorpej
State-Changed-When: Mon Sep 13 23:34:33 UTC 2004
State-Changed-Why:
UUID library and generation command supported added.
From: Jason R Thorpe <thorpej@netbsd.org>
To: gnats-bugs@gnats.NetBSD.org
Cc:
Subject: pr/23470 CVS commit: src
Date: Mon, 13 Sep 2004 23:35:19 +0000 (UTC)
Module Name: src
Committed By: thorpej
Date: Mon Sep 13 23:35:19 UTC 2004
Modified Files:
src/distrib/sets/lists/base: mi
src/distrib/sets/lists/man: mi
src/usr.bin: Makefile
Added Files:
src/usr.bin/uuidgen: Makefile uuidgen.1 uuidgen.c
Log Message:
Add the uuidgen(1) command, adapted from FreeBSD. While here, also add
a DCE-compatible -s flag, which causes uuidgen(1) to output C code for
the UUIDs rather than the standard string representation.
PR 23470.
To generate a diff of this commit:
cvs rdiff -r1.500 -r1.501 src/distrib/sets/lists/base/mi
cvs rdiff -r1.724 -r1.725 src/distrib/sets/lists/man/mi
cvs rdiff -r1.140 -r1.141 src/usr.bin/Makefile
cvs rdiff -r0 -r1.1 src/usr.bin/uuidgen/Makefile \
src/usr.bin/uuidgen/uuidgen.1 src/usr.bin/uuidgen/uuidgen.c
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
>Unformatted:
(Contact us)
$NetBSD: query-full-pr,v 1.51 2026/08/10 02:28:17 riastradh Exp $
$NetBSD: gnats_config.sh,v 1.10 2026/05/13 22:00:09 riastradh Exp $
Copyright © 1994-2026
The NetBSD Foundation, Inc. ALL RIGHTS RESERVED.