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.