MBRUIDTOUID(3)       BSD Library Functions Manual       MBRUIDTOUID(3)

NAME
     mbruidtouuid,, mbrgidtouuid,, mbruuidtoid,, mbrsidtouuid,,
     mbruuidtosid -- translate user and group identifiers from one form to
     another

LIBRARY
     Standard C Library (libc, -lc)

SYNOPSIS
     ##include <>

     int
     mbruidtouuid(uidt id, uuidt uu);

     int
     mbrgidtouuid(gidt id, uuidt uu);

     int
     mbruuidtoid(uuidt uu, uidt* id, int* idtype);

     int
     mbrsidtouuid(const ntsidt* sid, uuidt uu);

     int
     mbruuidtosid(uuidt uu, const ntsidt* sid);

DESCRIPTION
     Users and groups can be referred to in multiple ways.  In addition to the
     traditional uid and gid concepts, every user or group can be looked up by
     a 128 bit uuid.  In addition, if the user or group is hosted on a PDC or
     Active Directory server, it will also have a 128 bit or larger sid.

     mbruidtouuid() will take a uid and look up the user the same way as
     getpwuid.  It will then return the uuid for that user.

     mbrgidtouuid() does the same thing to get the uuid for a group.

     mbruuidtoid() takes a uuid that refers to a user or group and returns
     the uid or gid for the item.  idtype will be filled in with either
     IDTYPEUID or IDTYPEGID to tell you which was found.  It is important
     to note that mbruuidtoid() will always return an id even if the uuid
     is not found.  This returned id is not persistant, but can be used to map
     back to the uuid during runtime.  If you need to know if the uuid exists,
     you should call getgrgid on the returned id.

     mbrsidtouuid() takes a sid and returns the associated uuid.  Like
     mbruuidtoid() , mbruuidtosid() will always return a uuid for the
     sid, even if the sid cannot be found.

     mbrsidtouuid() will return a sid for the associate uuid if the item
     contains a sid.

RETURN VALUES
     All function may return EIO if the memberd daemon is not reachable.  They
     will also return ENOENT if the mapping could not be performed.

SEE ALSO
     mbrcheckmembership(3)

BSD                            February 3, 2005                            BSD