AFS command card

AFS command reference card

Here you will find a short reference to the most important afs commands. Text in angle brackets indicate information you supply; DO NOT type the < > symbols.

Changing your afs password

kpasswd Use kpasswd to set your afs password.

Obtaining, discarding and checking tokens

tokens Use tokens to check what tokens you have and their lifetime.
Once a token's lifetime has expired, you will not be able to access afs anymore, e.g. you won't be able to save the file you have been working on.
You will receive a fresh token every time you login to afs, or with the klog.

klog If you are about to start a lengthy session or if your token is about to expire, use klog to obtain a new token.

unlog This command will let you destroy a token.
Usage: unlog <cell name>

List volume quota

fs listquota This command will show all information about your disk quota.

fs quota This command will list the percentage of your disk quota used.

Access Control (the ACL commands)

fs listacl Use this command to list the ACL of a specific directory (or of the working directory (.), if you don't supply a directory.
Usage: fs listacl [<directory>]

fs setacl Use this command to set the ACL of a specific directory.
Usage: fs setacl -dir <directory> -acl <access list entries>

User-owned Groups

pts creategroup Use this command to create one of 20 possible user-owned access groups.
Users can insert other users' IDs or machine names in their access groups. Later, they can assign this group access rights to specific directories.
Usage: pts creategroup -name <group name>

pts delete Use this command to delete a user-owned access group.
Usage: pts delete -nameorid <group name or id>

pts adduser This command adds a user to a group
Usage: pts adduser -user <userid> -group <group name>

pts removeuser This command removes a user from a group
Usage: pts removeuser -user <userid> -group <group name>

pts listowned This command lists the groups owned by a particular user.
Usage: pts listowned -nameorid <userid>

pts membership This command lists the members of a particular group.
Usage: pts membership <group name>

At any time, help about the commands may be obtained by typing
fs help
or
pts help

(from A short introduction to AFS – DESY 05.Dec.1996, M. Sievers)

Changing your afs password
`kpasswd`	Use `kpasswd` to set your afs password.
Obtaining, discarding and checking tokens
`tokens`	Use `tokens` to check what tokens you have and their lifetime. Once a token's lifetime has expired, you will not be able to access afs anymore, e.g. you won't be able to save the file you have been working on. You will receive a fresh token every time you login to afs, or with the `klog`.
`klog`	If you are about to start a lengthy session or if your token is about to expire, use `klog` to obtain a new token.
`unlog`	This command will let you destroy a token. Usage: `unlog <cell name>`
List volume quota
`fs listquota`	This command will show all information about your disk quota.
`fs quota`	This command will list the percentage of your disk quota used.
Access Control (the ACL commands)
`fs listacl`	Use this command to list the ACL of a specific directory (or of the working directory (.), if you don't supply a directory. Usage: `fs listacl [<directory>]`
`fs setacl`	Use this command to set the ACL of a specific directory. Usage: `fs setacl -dir <directory> -acl <access list entries>`
User-owned Groups
`pts creategroup`	Use this command to create one of 20 possible user-owned access groups. Users can insert other users' IDs or machine names in their access groups. Later, they can assign this group access rights to specific directories. Usage: `pts creategroup -name <group name>`
`pts delete`	Use this command to delete a user-owned access group. Usage: `pts delete -nameorid <group name or id>`
`pts adduser`	This command adds a user to a group Usage: `pts adduser -user <userid> -group <group name>`
`pts removeuser`	This command removes a user from a group Usage: `pts removeuser -user <userid> -group <group name>`
`pts listowned`	This command lists the groups owned by a particular user. Usage: `pts listowned -nameorid <userid>`
`pts membership`	This command lists the members of a particular group. Usage: `pts membership <group name>`