[PATCH] Documentation clarification for uuid_create(3)

classic Classic list List threaded Threaded
4 messages Options
Reply | Threaded
Open this post in threaded view
|

[PATCH] Documentation clarification for uuid_create(3)

William Orr-2

Hey,

I've added a small clarification around uuid's generated by
`uuid_create`, since DCE 1.1 doesn't explicitly specify version
4 UUIDs.

This implementation differs from FreeBSD's and bitrig's as they
generate version 1 UUIDs, which warrants this clarfication.

Thanks

Index: lib/libc/uuid/uuid.3
===================================================================
RCS file: /cvs/src/lib/libc/uuid/uuid.3,v
retrieving revision 1.5
diff -u -p -r1.5 uuid.3
--- lib/libc/uuid/uuid.3 20 Nov 2015 21:05:52 -0000 1.5
+++ lib/libc/uuid/uuid.3 1 Oct 2018 02:07:42 -0000
@@ -204,3 +204,6 @@ The
 and
 .Fn uuid_to_string
 functions are compatible with the DCE 1.1 RPC specification.
+The UUIDs generated by
+.Fn uuid_create
+are Version 4 UUIDs, specified by section 4.4 of RFC 4122.

Reply | Threaded
Open this post in threaded view
|

Re: [PATCH] Documentation clarification for uuid_create(3)

Jason McIntyre-2
On Mon, Oct 01, 2018 at 11:26:51PM -0700, William Orr wrote:

>
> Hey,
>
> I've added a small clarification around uuid's generated by
> `uuid_create`, since DCE 1.1 doesn't explicitly specify version
> 4 UUIDs.
>
> This implementation differs from FreeBSD's and bitrig's as they
> generate version 1 UUIDs, which warrants this clarfication.
>
> Thanks
>
> Index: lib/libc/uuid/uuid.3
> ===================================================================
> RCS file: /cvs/src/lib/libc/uuid/uuid.3,v
> retrieving revision 1.5
> diff -u -p -r1.5 uuid.3
> --- lib/libc/uuid/uuid.3 20 Nov 2015 21:05:52 -0000 1.5
> +++ lib/libc/uuid/uuid.3 1 Oct 2018 02:07:42 -0000
> @@ -204,3 +204,6 @@ The
>  and
>  .Fn uuid_to_string
>  functions are compatible with the DCE 1.1 RPC specification.
> +The UUIDs generated by
> +.Fn uuid_create
> +are Version 4 UUIDs, specified by section 4.4 of RFC 4122.
>

morning. hopefully someone can ok the content, but i'd be tempted to
trim the text slightly:

        .Fn uuid_create
        generates version 4 UUIDs,
        specified by section 4.4 of RFC 4122.

jmc

Reply | Threaded
Open this post in threaded view
|

Re: [PATCH] Documentation clarification for uuid_create(3)

Theo Buehler-3
In reply to this post by William Orr-2
In-Reply-To: <20181002063056.GA30912@harkle>
> morning. hopefully someone can ok the content, but i'd be tempted to
> trim the text slightly:
>
> .Fn uuid_create
> generates version 4 UUIDs,
> specified by section 4.4 of RFC 4122.

this is correct, ok for your trimmed version.

Reply | Threaded
Open this post in threaded view
|

Re: [PATCH] Documentation clarification for uuid_create(3)

Jason McIntyre-2
On Tue, Oct 02, 2018 at 10:52:53AM +0200, Theo Buehler wrote:

> In-Reply-To: <20181002063056.GA30912@harkle>
> > morning. hopefully someone can ok the content, but i'd be tempted to
> > trim the text slightly:
> >
> > .Fn uuid_create
> > generates version 4 UUIDs,
> > specified by section 4.4 of RFC 4122.
>
> this is correct, ok for your trimmed version.
>

thanks for checking. will commit now..
jmc