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 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.

 The Arla Project               March 25, 2000                               2
