MBRUIDTOUUID(3) BSD Library Functions Manual MBRUIDTOUUID(3)

NAME
     mmbbrruuiiddttoouuuuiidd,, mmbbrrggiiddttoouuuuiidd,, mmbbrruuuuiiddttooiidd,, mmbbrrssiiddttoouuuuiidd,,
     mmbbrruuuuiiddttoossiidd - translate user and group identifiers from one form to
     another

LLIIBBRRAARRYY
     Standard C Library (libc, -lc)

SYNOPSIS
     ##iinncclluuddee <>

     int
     mmbbrruuiiddttoouuuuiidd(uidt id, uuidt uu);

     int
     mmbbrrggiiddttoouuuuiidd(gidt id, uuidt uu);

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

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

     int
     mmbbrruuuuiiddttoossiidd(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.

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

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

     mmbbrruuuuiiddttooiidd() 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 mmbbrruuuuiiddttooiidd() 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.

     mmbbrrssiiddttoouuuuiidd() takes a sid and returns the associated uuid.  Like
     mmbbrruuuuiiddttooiidd() , mmbbrruuuuiiddttoossiidd() will always return a uuid for the
     sid, even if the sid cannot be found.

     mmbbrrssiiddttoouuuuiidd() 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