svn commit: r232686 - stable/9/lib/libc/uuid

[Andrey V. Elsukov]

Author: ae
Date: Thu Mar  8 09:55:18 2012
New Revision: 232686
URL: http://svn.freebsd.org/changeset/base/232686

Log:
  MFC r232339:
    Note that memory should be freed after uuid_to_string(3) call.
  
  PR:		docs/161808

Modified:
  stable/9/lib/libc/uuid/uuid.3
Directory Properties:
  stable/9/lib/libc/uuid/   (props changed)

Modified: stable/9/lib/libc/uuid/uuid.3
==============================================================================
--- stable/9/lib/libc/uuid/uuid.3	Thu Mar  8 09:20:00 2012	(r232685)
+++ stable/9/lib/libc/uuid/uuid.3	Thu Mar  8 09:55:18 2012	(r232686)
@@ -25,7 +25,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd August 13, 2008
+.Dd March 1, 2012
 .Dt UUID 3
 .Os
 .Sh NAME
@@ -84,6 +84,15 @@ A 16-bit hash value can be obtained by c
 .Fn uuid_hash .
 .Pp
 The
+.Fn uuid_to_string
+function set
+.Fa *str
+to be a pointer to a buffer sufficiently large to hold the string.
+This pointer should be passed to
+.Xr free 3
+to release the allocated storage when it is no longer needed.
+.Pp
+The
 .Fn uuid_enc_le
 and
 .Fn uuid_enc_be
@@ -116,7 +125,7 @@ The UUID does not have a known version.
 .It Dv uuid_s_invalid_string_uuid
 The string representation of an UUID is not valid.
 .It Dv uuid_s_no_memory
-The meaning of the code escaped the writers mind.
+The function can not allocate memory to store an UUID representation.
 .El
 .Sh SEE ALSO
 .Xr uuidgen 1 ,