Mac Developer Library Developer
Search

 

This manual page is for Mac OS X version 10.9

If you are running a different version of Mac OS X, view the documentation locally:

  • In Terminal, using the man(1) command

Reading manual pages

Manual pages are intended as a quick reference for people who already understand a technology.

  • To learn how the manual is organized or to learn about command syntax, read the manual page for manpages(5).

  • For more information about this technology, look for other documentation in the Apple Developer Library.

  • For general information about writing shell scripts, read Shell Scripting Primer.




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

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

SYNOPSIS
     dsmemberutil [-v] [-h] command [options]

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

FLAGS
     A list of flags and their descriptions:

     -h      Lists the options for calling dsmemberutil

     -v      Causes dsmemberutil to operate in verbose mode.

COMMANDS
     The action of each command is described below:

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

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

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

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

     flushcache  Flushes the current membership cache.

     Legacy commands such as dumpstate and statistics are gone. See odutil(1) for show cache and statistics
     operations.

     A list of options available. In some cases -xX and -sS can be used synonymously due to nature of the
     value.

     -u uid           Using user with UID

     -U name          Using user with name

     -s sid           Using user with SID

     -x uuid          Using user with UUID

     -g gid           Using group with GID

     -G name          Using group with name

     -S sid           Using group with SID

     -X uuid          Using group with UUID

EXAMPLES
     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
     odutil(1), dseditgroup(1), dscacheutil(1)

Darwin                            Jan 1, 2007                           Darwin

Reporting Problems

The way to report a problem with this manual page depends on the type of problem:

Content errors
Report errors in the content of this documentation with the feedback links below.
Bug reports
Report bugs in the functionality of the described tool or API through Bug Reporter.
Formatting problems
Report formatting mistakes in the online version of these pages with the feedback links below.

Feedback