.Dd March 25, 2000 .Dt PTS 1 .Os .Sh NAME .Nm pts .Nd Manage AFS protection database .Sh SYNOPSIS .Nm pts .Op Ar command .Op Ar args .Sh DESCRIPTION The .Nm utility is used to manipulate the contents of the AFS Protection Database, which contains information about users and groups and is handled by the Protection Server. Note that the .Nm utility does .Em not modify the traditional .Ux user and group database, only the AFS specific information. .Pp The .Nm utility provides several commands: .Pp .Bl -tag -width "membership groups" -compact .It Cm adduser add a user to a group .It Cm chown change owner of user or group .It Cm creategroup / cg create a new group .It Cm createuser create a new user .It Cm dump dump pts database .It Cm delete delete user or group .It Cm examine examine a user or a group .It Cm help Cm ? get help on .Nm .It Cm listmax print largest uid and gid .It Cm listowned list groups owned by a user or group, or orphaned groups .It Cm membership Cm groups list group or user membership .It Cm removeuser remove a user from a group .It Cm rename rename user/group .It Cm setfields not yet implemented .It Cm setmax not yet implemented .It Cm syncdb not yet implemented .El .Pp Most .Nm commands accept the following general arguments: .Pp .Bd -filled -offset indent -compact .Op Fl cell Ar cellname Specifies which AFS cell to use, if the default cell is not to be used. .Pp .Op Fl noauth Specifies that .Nm 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 .Fl noauth is specified. .Ed .Pp The syntax of the .Nm commands: .Pp .Ic pts adduser .Op Fl name .Ar user .Op Fl group .Ar group .Op Fl cell Ar cellname .Op Fl noauth .Bd -filled -offset indent -compact Add the specified user to the specified group. .Ed .Pp .Ic pts chown .Op Fl name .Ar user/group .Op Fl owner .Ar owner .Op Fl cell Ar cellname .Op Fl noauth .Bd -filled -offset indent -compact Change owner of a group or user. .Ed .Pp .Ic pts creategroup .Op Fl name .Ar name .Op Fl id Ar idnumber .Op Fl cell Ar cellname .Op Fl noauth .Bd -filled -offset indent -compact Create a new group. If .Fl id is not specified, a new idnumber is taken automatically. .Ed .Pp .Ic pts cg .Bd -filled -offset indent -compact .Ic pts cg is an alias for the .Ic pts creategroup command. .Ed .Pp .Ic pts createuser .Op Fl name .Ar name .Op Fl id Ar idnumber .Op Fl cell Ar cellname .Op Fl noauth .Bd -filled -offset indent -compact Create a new user. If .Fl id is not specified, a new idnumber is taken automatically. .Ed .Pp .Ic pts dump .Ar server .Op Fl cell cellname .Bd -filled -offset indent -compact Dump the Protection Database in a human readable form. The database is read from the given database server. .Ed .Pp .Ic pts delete .Op Fl name .Ar name/group .Op Fl cell Ar cellname .Op Fl noauth .Bd -filled -offset indent -compact Delete a user or group from the database. .Ed .Pp .Ic pts examine .Ar user/group .Op Fl cell Ar cellname .Op Fl noauth .Bd -filled -offset indent -compact Print verbose information about a user or a group. .Ed .Pp .Ic pts help or .Ic pts ? .Bd -filled -offset indent -compact Print help about .Nm .Ed .Pp .Ic pts listmax .Op Fl cell Ar cellname .Bd -filled -offset indent -compact Print the largest uid and gid. .Ed .Pp .Ic pts listowned .Op Fl id .Ar user/group .Op Fl cell Ar cellname .Op Fl noauth .Bd -filled -offset indent -compact List the groups owned by a user or group. .Ed .Pp .Ic pts membership .Op Fl nameorid Ar user/group .Op Fl cell Ar cellname .Op Fl noauth .Bd -filled -offset indent -compact List the members of a group, or the groups a user is a member of. .Ed .Pp .Ic pts groups .Bd -filled -offset indent -compact .Ic pts groups is an alias for the .Ic pts membership command. .Ed .Pp .Ic pts removeuser .Op Fl user .Ar user .Op Fl group .Ar group .Op Fl cell Ar cellname .Op Fl noauth .Bd -filled -offset indent -compact Remove a users membership from a group. .Ed .Pp .Ic pts rename .Op Fl from .Ar "old name" .Op Fl to .Ar "new name" .Op Fl cell Ar cellname .Op Fl noauth .Bd -filled -offset indent -compact Rename a user or group. .Ed .Pp .Ic pts setfields .Bd -filled -offset indent -compact This command is available in the original AFS client, but has not been implemented yet. .Ed .Pp .Ic pts setmax .Bd -filled -offset indent -compact This command is available in the original AFS client, but has not been implemented yet. .Ed .Pp .Ic pts syncdb .Bd -filled -offset indent -compact This command has not been implemented yet. .Ed .Pp .Sh SEE ALSO .Xr afsd 8 , .Xr fs 1 , .Xr vos 8 .Sh STANDARDS The Arla authors are trying to mimic the behaviour of the original AFS utilities. .Sh AUTHORS The Arla project . .Sh BUGS Some commands are not implemented yet.