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 provided.
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 syn-
onymously 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
Mac OS X 10.8 - Generated Sun Aug 19 18:01:21 CDT 2012