This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

MBR_UID_TO_UUID(3)       BSD Library Functions Manual       MBR_UID_TO_UUID(3)

NAME
     mbr_uid_to_uuid, mbr_gid_to_uuid, mbr_uuid_to_id, mbr_sid_to_uuid, mbr_uuid_to_sid -- user and group
     identifier translation functions

SYNOPSIS
     #include <membership.h>

     int
     mbr_uid_to_uuid(uid_t id, uuid_t uu);

     int
     mbr_gid_to_uuid(gid_t id, uuid_t uu);

     int
     mbr_uuid_to_id(const uuid_t uu, uid_t *id, int *id_type);

     int
     mbr_sid_to_uuid(const nt_sid_t *sid, uuid_t uu);

     int
     mbr_uuid_to_sid(const uuid_t uu, nt_sid_t *sid);

DESCRIPTION
     Users and groups can be referred to in multiple ways.  In addition to the traditional uid and gid,
     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.

     These routines communicate with the DirectoryService(8) daemon.

     mbr_uid_to_uuid() takes a uid and looks up the associated user account.  It provides the the uuid for
     that user as an output parameter.

     mbr_gid_to_uuid() similarly gets the uuid associated with a group.

     mbr_uuid_to_id() takes a uuid that refers to a user or group and fetches the corresponding uid or gid.
     id_type is set to ID_TYPE_UID or ID_TYPE_GID to indicate which type was found.  Note that
     mbr_uuid_to_id() always returns an id even if the uuid is not found.  This returned id is not persis-tant, persistant,
     tant, but can be used to map back to the uuid during runtime.  To determine if the uuid exists, the
     returned id can be used in a call to getpwuid(3) or getgrgid(3).

     mbr_sid_to_uuid() takes a sid and returns the associated uuid.  Like mbr_uuid_to_id(),
     mbr_sid_to_uuid() always returns a uuid for the sid, even if the sid can not be found.

     mbr_uuid_to_sid() returns a sid for the associated uuid.

RETURN VALUES
     These functions return 0 on success, or EIO if communications with the DirectoryService(8) daemon
     fails.  ENOENT is returned if the mapping can not be performed.

SEE ALSO
     getpwuid(3), getgrgid(3), mbr_check_membership(3), DirectoryService(8)

Mac OS X                       February 3, 2005                       Mac OS X