.Dd Jan 1, 2007 .Dt dsmemberutil 1 .Os Darwin .Sh NAME .Nm dsmemberutil .Nd various operations for the membership APIs, including state dump, check memberships, UUIDs, etc. .Sh SYNOPSIS .Nm .Op Fl v .Op Fl h .Ar command .Op options .Pp .Sh DESCRIPTION .Nm is a program that implements the membership API calls in a command line utility. .Pp .Sh FLAGS A list of flags and their descriptions: .Bl -tag -width -ident .It Fl h Lists the options for calling .Nm .It Fl v Causes .Nm to operate in verbose mode. .El .Pp .Sh COMMANDS The action of each command is described below: .Bl -tag -width "xxxxxxxxxx" .It Ar getuuid Fl ugUGsS Ar value Takes any of the options and returns the associated UUID. .It Ar getid Fl UGsSX Ar value Takes any of the options and returns the associated UID or GID depending on option provided. .It Ar getsid Fl ugUGX Ar value Takes any of the options and returns the associated SID. .It Ar checkmembership Fl uUxs Ar param Fl gGXS Ar param Returns if a user or group with the associated option is a member of the group. .It Ar flushcache Flushes the current membership cache. .It Ar dumpstate Dumps the current state of the cache to /Library/Logs/membership_dump.log. .It Ar statistics Op Fl f Dumps the membership call statistics or optionally flushes them with the option .Fl f . .El .Pp A list of options available. In some cases .Fl xX and .Fl sS can be used synonymously due to nature of the value. .Bl -tag -width "-x xxxxxxxxxxxx" .It Fl u Ar uid Using user with UID .It Fl U Ar name Using user with name .It Fl s Ar sid Using user with SID .It Fl x Ar uuid Using user with UUID .It Fl g Ar gid Using group with GID .It Fl G Ar name Using group with name .It Fl S Ar sid Using group with SID .It Fl X Ar uuid Using group with UUID .El .Sh EXAMPLES .Pp .Bl -tag -width -indent \" Differs from above in tag removed .It Get a user's uuid: .Dl % dsmemberutil getuuid -u 501 .Dl EEA4F2F6-B268-49E7-9C6F-E3C4A37DA4FD .It Get a group's uuid .Dl % dsmemberutil getuuid -g 0 .Dl ABCDEFAB-CDEF-ABCD-EFAB-CDEF00000000 .It Get a user's or group's id from a uuid .Dl % dsmemberutil getid -X ABCDEFAB-CDEF-ABCD-EFAB-CDEF0000000C .Dl gid: 12 .It Check a user's membership in a group (using UID and GID) .Dl % dsmemberutil checkmembership -u 501 -g 0 .Dl user is not a member of the group .It Check a user's membership in a group (using names) .Dl % dsmemberutil checkmembership -U root -G wheel .Dl user is a member of the group .El \" Ends the list .Pp .Sh SEE ALSO .Xr DirectoryService 8 , .Xr dseditgroup 1 , .Xr dscacheutil 1