Command Reference

This document provides a summary of the most frequently used AFS commands. For a complete reference, see the OpenAFS User Guide and the OpenAFS Administration Reference.

Getting help

 % fs help

Show all the fs or pts commands.

 % pts help
 % fs help command

Show syntax for fs or pts command.

 % pts help command 	

File server information

 % fs whereis filename/dirname 	

Show the file server hosting a specific file or directory.

 % fs checkservers 	

Check the status of the file servers.

Quota commands

 % fs listquota 	

Show quota information.

 % fs quota 	

Show quota used.

Protecting files and directories

 % fs listacl filename/dirname 	

Show a directory's ACL (access control list).

 % fs setacl dirname user/groupname permissions 	

Set a directory's ACL.

 Permissions 	Shorthand
 r = read 	read = rl
 l = lookup 	write = rlidwk
 i = insert 	all = rlidwka
 d = delete 	none = removes entry
 w = write
 k = lock
 a = administer
 % fs copyacl olddirname newdirname

Copy a directory's ACL to another.

Protection group information

 % pts membership groupname 	

Show the members of a group.

 % pts membership username 	

Show the groups a user belongs to.

 % pts listowned username

Show the groups a user or group owns.

 % pts listowned groupname 	
 % pts examine groupname 	

Show information about a group.

Protection group creation & modification

 % pts creategroup username:groupname 	

Create a new user-owned group.

 % pts adduser username groupname 	

Add a user to an existing group.

 % pts removeuser username groupname 	

Remove a user from and existing group.

 % pts delete groupname 	

Delete an existing group.

 % pts rename oldgroupname newgroupname 	

Give an existing group a new name.

AFS tokens

 % kinit 	

Get new Kerberos ticket.

 % aklog 	

Get new AFS token once you have a Kerberos ticket.

 % klog 	

Get new AFS tokens, skipping the Kerberos ticket step. Useful for machines where kerberos is not setup.

 % unlog 	

Destroy your AFS tokens.

 % tokens 	

Show current tokens.