dsmemberutil(1) BSD General Commands Manual dsmemberutil(1)

NAME
     ddssmmeemmbbeerruuttiill - various operations for the membership APIs, including
     state dump, check memberships, UUIDs, etc.

SYNOPSIS
     ddssmmeemmbbeerruuttiill [-vv] [-hh] command [options]

DESCRIPTION
     ddssmmeemmbbeerruuttiill is a program that implements the membership API calls in a
     command line utility.

FFLLAAGGSS
     A list of flags and their descriptions:

     -hh      Lists the options for calling ddssmmeemmbbeerruuttiill

     -vv      Causes ddssmmeemmbbeerruuttiill to operate in verbose mode.

CCOOMMMMAANNDDSS
     The action of each command is described below:

     getuuid -uuggUUGGssSS value
                 Takes any of the options and returns the associated UUID.

     getid -UUGGssSSXX value
                 Takes any of the options and returns the associated UID or
                 GID depending on option provided.

     getsid -uuggUUGGXX value
                 Takes any of the options and returns the associated SID.

     checkmembership -uuUUxxss param -ggGGXXSS param
                 Returns if a user or group with the associated option is a
                 member of the group.

     flushcache  Flushes the current membership cache.

     dumpstate   Dumps the current state of the cache to /Library/Logs/member-
                 shipdump.log.

     statistics [-ff]
                 Dumps the membership call statistics or optionally flushes
                 them with the option -ff.

     A list of options available. In some cases -xxXX and -ssSS can be used syn-
     onymously due to nature of the value.

     -uu uid           Using user with UID

     -UU name          Using user with name

     -ss sid           Using user with SID

     -xx uuid          Using user with UUID

     -gg gid           Using group with GID

     -GG name          Using group with name

     -SS sid           Using group with SID

     -XX uuid          Using group with UUID

EEXXAAMMPPLLEESS
     Get a user's uuid:
                    % dsmemberutil getuuid -u 501
                    EEA4F2F6-B268-49E7-9C6F-E3C4A37DA4FD

     Get a group's uuid
                    % dsmemberutil getuuid -g 0
                    ABCDEFAB-CDEF-ABCD-EFAB-CDEF00000000

     Get a user's or group's id from a uuid
                    % dsmemberutil getid -X
                    ABCDEFAB-CDEF-ABCD-EFAB-CDEF0000000C
                    gid: 12

     Check a user's membership in a group (using UID and GID)
                    % dsmemberutil checkmembership -u 501 -g 0
                    user is not a member of the group

     Check a user's membership in a group (using names)
                    % dsmemberutil checkmembership -U root -G wheel
                    user is a member of the group

SEE ALSO
     DirectoryService(8), dseditgroup(1), dscacheutil(1)

Darwin                            Jan 1, 2007                           Darwin