NAME

pts_eachuser - Iterate Protection Service user entries

SYNOPSIS

pts eachuser [-disabled [boolean]] [-afsonly [boolean]] [-authuser [boolean]] [-iregex <include by regular expression of name>+] [-eregex <exclude by regular expression of name>+] [-flag <require all the named flags>+] [-format <output format string>] [-execute] [-verbose] [-count] [-cell <cell name>] [-noauth] [-localauth] [-force] [-help] [-auth] [-encrypt [<yes|no>]] [-config <configuration file>] [-principal <authentication principal>] [-keytab <path to keytab for tokens>] [-encrypt [yes|no]]

DESCRIPTION

pts eachuser enumerates Protection Service user entries satisfying specified predicates and, for each, will expand a user-specified format string. The result of expansion may be interpreted as a shell command and invoked, if -execute is given.

OPTIONS

-format
A

The value of the afs-only setting as a boolean value.

c

The AuriStor User Number (AUN) of the user's creator, in decimal.

D

The value of the disabled setting as a boolean value.

f

The flags associated with the entry.

F

The flags associated with the entry, using human readable names.

i

The AUN of the user, in decimal.

n

The textual name of the user.

o

The AUN of the user's owner, in decimal.

U

Inclusion of the entry in the system:authuser group as a boolean value.

-afsonly [boolean]

Restrict enumeration either to those entities whose Current Protection Set is the anonymous identity when accessing volumes stored on AuriStorFS fileservers; or those users whose Current Protection Set is unrestricted.

-authuser [boolean]

Restrict enumeration either to those entities whose Current Protection Set includes the system:authuser group; or those entities whose Current Protection Set excludes the system:authuser group. Machine and Network entities are not included in the system:authuser group.

-disabled [boolean]

Restrict enumeration either to those entities whose Current Protection Set is is the anonymous identity; or those users whose Current Protection Set is unrestricted.

-iregex <user name regular expression>

Include for enumeration users whose name matches the given regular expression, as per regex(7). If no -iregex options are given, all users will be considered included, but may be subsequently excluded. Multiple -iregex messages will cause a user that matches any argument to be included.

-eregex <user name regular expression>

Exclude from iteration of volume groups whose names match a given regular expression. If no -eregex options are given, no users will be excluded by name (but other filters may apply). Multiple -eregex parameters will exclude users that match any of them.

-flag

Restrict iteration to users with the specified flags asserted on their Protection entries. The following flags are understood:

afsonly

Specifying -flag afsonly is equivalent to the -afsonly flag.

ngroups =item nusers =item disabled =item noauthuser =item status_any =item status_mem =item owned_any =item member_any =item member_mem =item add_any =item add_mem =item remove_mem
-execute

Interpret the post-expansion format string as a shell command. If the string begins with "pts ", it will be interpreted as a pts command and efficiently executed by the current pts process without spawning another instance.

-count

Print the number of matching entries.

PRIVILEGE REQUIRED

The issuer must belong to the system:administrators group.

SEE ALSO

pts(1), pts_creategroup(1), pts_createuser(1), pts_eachgroup(1), pts_listentries(1), pts_examine(1)

ACKNOWLEDGEMENTS

"AFS" is a registered mark of International Business Machines Corporation, used under license. (USPTO Registration 1598389)

"OpenAFS" is a registered mark of International Business Machines Corporation. (USPTO Registration 4577045)

The "AuriStor" name, log 'S' brand mark, and icon are registered marks of AuriStor, Inc. (USPTO Registrations 4849419, 4849421, and 4928460) (EUIPO Registration 015539653).

"Your File System" is a registered mark of AuriStor, Inc. (USPTO Registrations 4801402 and 4849418).

"YFS" and "AuriStor File System" are trademarks of AuriStor, Inc.