PTS(1)

NAME
pts - Manage AFS protection database

SYNOPSIS
pts [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 ALSO
fs(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.