PTS(1) OpenBSD Reference Manual PTS(1)NAMEpts - Manage AFS protection database
SYNOPSISpts [command] [args]
DESCRIPTION
The pts utility is used to manipulate the contents of the AFS Protection
Database, which contains information about users and groups in AFS. Note
that the pts utility does not modify the traditional UNIX user and group
database, only the AFS specific information.
The pts utility provides several commands:
adduser add a user to a group
chown change owner of user or group
creategroup create a new group
cg shorthand for creategroup
createuser create a new user
dump dump pts database
delete delete user or group
examine examine a user or a group
help get help on pts
? shorthand for help
listmax print largest afs user and group
listowned list groups owned by a user or group, or orphaned
groups
membership list group or user membership
groups shorthand for membership
removeuser remove a user from a group
rename rename a user or a group
setfields not yet implemented
setmax not yet implemented
syncdb not yet implemented
Most pts commands accept the following general arguments:
[-cell cellname] Specifies which AFS cell to use, if the default
cell is not to be used.
[-noauth] Specifies that pts should not try to authenticate the
connection to the server. This may be useful with shell scripts,
or if there is a problem with the AFS cell. Note that the server
will reject many commands if -noauth is specified.
The syntax of the pts commands:
pts adduser [-name] user [-group] group [-cell cellname] [-noauth]
Add the specified user to the specified group.
pts chown [-name] user/group [-owner] owner [-cell cellname] [-noauth]
Change owner of a group or user.
pts creategroup [-name] name [-id idnumber] [-cell cellname] [-noauth]
Create a new group. If idnumber is not specified, a new idnumber
is taken automatically.
pts cg
Shorthand for creategroup.
pts createuser [-name] name [-id idnumber] [-cell cellname] [-noauth]
Create a new user. If idnumber is not specified, a new idnumber is
taken automatically.
pts dump server [-cell -cellname]
Dump the Protection Database in a human readable form. The
database is read from the given database server.
pts delete [-name] name/group [-cell cellname] [-noauth]
Delete a user or group from the database.
pts examine user/group [-cell cellname] [-noauth]
Print verbose information about a user or a group.
pts help or pts ?
Print help about pts
pts listmax [-cell cellname]
Print the largest uid and gid.
pts listowned [-id] user/group [-cell cellname] [-noauth]
List the groups owned by a user or group.
pts membership [-nameorid user/group] [-cell cellname] [-noauth]
List the members of a group, or the groups a user is a member of.
pts groups
Shorthand for membership.
pts removeuser [-user] user [-group] group [-cell cellname] [-noauth]
Remove a users membership from a group.
pts rename [-from] old name [-to] new name [-cell cellname] [-noauth]
Rename a user or group.
pts setfields
Not yet implemented.
pts setmax
Not yet implemented.
pts syncdb
Not yet implemented.
SEE ALSOfs(1), afsd(8), vos(8)STANDARDS
The Arla authors are trying to mimic the behaviour of the original AFS
utilities.
AUTHORS
The Arla project <http://www.stacken.kth.se/project/arla/>.
BUGS
Some commands are not implemented yet.
The Arla Project March 25, 2000 The Arla Project
