MBR_CHECKMEMBERSHIP

NAME
     mbr_check_membership -- check whether a user is a member of a group

LIBRARY
     Standard C Library (libc, -lc)

SYNOPSIS
     #include <membership.h>

     int
     mbr_check_membership(uuid_t user, uuid_t group, int* ismember);

DESCRIPTION
     mbr_uid_to_uuid() eliminates the 16 group limit inherent in getgroups(3).
     It will always return if a given user is a member of a given group, even
     if the membership is due to nesting of groups.  ismember is set to 1 if
     the user is a member of the group, and 0 otherwise.

     There are two special cases. If the two uuids are equal, then ismember is
     set to 1.  If the group uuid is equal to the reserved "everyone" uuid
     (ABCDEFAB-CDEF-ABCD-EFAB-CDEF0000000C), then ismember will be set to 1
     for any valid user.

RETURN VALUES
     mbr_uid_to_uuid() will return EIO if it is unable to talk to memberd.  If
     user cannot be found it will return ENOENT.  Note that it makes no
     attempt to determine whether group exists or not.  Querying membership
     about a nonexistant group will simply return the user is not a member.

SEE ALSO
     mbr_uid_to_uuid(3)

BSD                            February 3, 2005                            BSD