Libinfo-477.50.4.tar.gz

[apple/libinfo.git] / membership.subproj / mbr_uid_to_uuid.3

diff --git a/membership.subproj/mbr_uid_to_uuid.3 b/membership.subproj/mbr_uid_to_uuid.3
index a778aeade6fbb7ff5a2b4aa439028d4f9ac0e04b..9ca8ec9dab5784926da475df257ba8c25e6bff98 100644 (file)
--- a/membership.subproj/mbr_uid_to_uuid.3
+++ b/membership.subproj/mbr_uid_to_uuid.3
@@ -26,7 +26,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\"
 .\" SUCH DAMAGE.
 .\"
 .\"

-.Dd August 25, 2010
+.Dd October 10, 2011

 .Dt MBR_UID_TO_UUID 3
 .Os "Mac OS X"
 .Sh NAME
 .Dt MBR_UID_TO_UUID 3
 .Os "Mac OS X"
 .Sh NAME


@@ -59,9 +59,8 @@ every user or group can be referenced by a 128 bit uuid.
 Additionally, if the user or group is hosted on a PDC
 or Active Directory server, it will have a 128 bit or larger sid.
 .Pp
 Additionally, if the user or group is hosted on a PDC
 or Active Directory server, it will have a 128 bit or larger sid.
 .Pp

-These routines communicate with the
-.Xr DirectoryService 8
-daemon.
+These routines communicate with
+.Xr openditectoryd 8 .

 .Pp
 .Fn mbr_uid_to_uuid
 takes a uid and looks up the associated user account.
 .Pp
 .Fn mbr_uid_to_uuid
 takes a uid and looks up the associated user account.


@@ -109,23 +108,30 @@ The converted string is terminated with a nul character.
 .Fn mbr_string_to_sid
 converts an external string representation into a sid.
 .Sh RETURN VALUES
 .Fn mbr_string_to_sid
 converts an external string representation into a sid.
 .Sh RETURN VALUES

-These functions return 0 on success, or EIO if communications with the
-.Xr DirectoryService 8
-daemon fails.
-ENOENT is returned if the mapping can not be performed.
+These functions return 0 on success or one of the following error codes on failure:
+.Bl -tag -width Er
+.It Bq Er EIO
+Communication with
+.Xr openditectoryd 8
+failed.
+.It Bq Er ENOENT
+The mapping can not be performed.
+.It Bq Er EAUTH
+Communication with
+.Xr openditectoryd 8
+failed due to an authentication error.
+.It Bq Er EINVAL
+Invalid arguments were provided.
+.It Bq Er ENOMEM
+Insufficient storage space is available.
+.El

 .Pp
 .Fn mbr_gid_to_uuid
 and
 .Fn mbr_uid_to_uuid
 return 0 (success), even if the user/group does not exist.
 .Pp
 .Fn mbr_gid_to_uuid
 and
 .Fn mbr_uid_to_uuid
 return 0 (success), even if the user/group does not exist.

-.Pp
-The 
-.Fn mbr_sid_to_string
-and 
-.Fn mbr_string_to_sid
-functions return 0 on success, or an errno value on failure.

 .Sh SEE ALSO
 .Xr getpwuid 3 ,
 .Xr getgrgid 3 ,
 .Xr mbr_check_membership 3 ,
 .Sh SEE ALSO
 .Xr getpwuid 3 ,
 .Xr getgrgid 3 ,
 .Xr mbr_check_membership 3 ,

-.Xr DirectoryService 8
\ No newline at end of file
+.Xr openditectoryd 8