AFS user utility programs
Several utility programs are provided for managing volumes, permissions, passwords etc.
Most are used only by administrators, but a few are useful to all users. The utilities
are a little idiosyncratic compared to most Unix tools. The user interface does not always
follow unix conventions. No widely used menu-driven interface exists.
The tools are conventionally located in /usr/afsws/bin, which must be added
to the standard $PATH setting. On Linux they may be in /usr/bin.
There are a small number of utilities, but a large number of subcommands which can be performed (via
command line arguments).
Some subcommands require special priviledges. Some locally written wrapper scripts or aliases
may be provided for the most commonly used commands.
The main utilities of interest to users are:
klog
- Identify the user to the system (requests password) and generate a token. Usually integrated
with the system login procedure. Use to refresh a token at any time after logging in.
tokens
- Display currently held tokens and their expiration times
pagsh
- Start a new Process Authentication Group (PAG). Usually integrated
with the system login procedure. Explicitly needed when
working in multiple cells or as multiple users.
fs
- Filesystem queries. Used to examine and set quotas, local cache parameters, access control etc.
pts
- Protection database tool. Used to manage users and groups for Access Control Lists (ACLs).
kpasswd
- Password changing facility. Often combined with the standard Unix
passwd utility.
