PTS(1)                     OpenBSD Reference Manual                     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 and is han-
     dled by the Protection Server.  Note that the pts utility does not modify
     the traditional UNIX user and group database, only the AFS specific in-
     formation.

     The pts utility provides several commands:

     adduser            add a user to a group
     chown              change owner of user or group
     creategroup / cg   create a new group
     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
     listmax            print largest uid and gid
     listowned          list groups owned by a user or group, or orphaned
                        groups
     membership groups  list group or user membership
     removeuser         remove a user from a group
     rename             rename user/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 -id is not specified, a new idnumber is
           taken automatically.

     pts cg
           pts cg is an alias for the pts creategroup command.

     pts createuser [-name] name [-id idnumber] [-cell cellname] [-noauth]
           Create a new user.  If -id is not specified, a new idnumber is tak-
           en 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
           pts groups is an alias for the pts membership command.

     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
           This command is available in the original AFS client, but has not
           been implemented yet.

     pts setmax
           This command is available in the original AFS client, but has not
           been implemented yet.

     pts syncdb
           This command has not been implemented yet.

SEE ALSO
     afsd(8), fs(1), 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.

OpenBSD 2.9                     March 25, 2000                               2
