NAME    [Toc]    [Back]

     pts - Manage AFS protection database

SYNOPSIS    [Toc]    [Back]

     pts [command] [args]

DESCRIPTION    [Toc]    [Back]

     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    [Toc]    [Back]

     fs(1), afsd(8), vos(8)

STANDARDS    [Toc]    [Back]

     The  Arla  authors  are trying to mimic the behaviour of the
original AFS
     utilities.

AUTHORS    [Toc]    [Back]

     The Arla project  <http://www.stacken.kth.se/project/arla/>.

BUGS    [Toc]    [Back]

     Some commands are not implemented yet.

 The     Arla     Project                   March     25,    2000