The Rensselaer Computing System (RCS) uses AFS (formerly called the Andrew File System), and acts like most other UNIX file systems in that, unless you have specifically placed files in your /public or /public_html directory (both of which are automatically created for you within your computer account), other users cannot read or use your files. However, the system also makes it easier for you to share files with others, both on-campus and at other AFS sites.
See also the AFS User Guide.
The Rensselaer Computing System (RCS) uses AFS (formerly called the Andrew File System), and acts like most other UNIX file systems in that, unless you have specifically placed files in your /public or /public_html directory (both of which are automatically created for you within your computer account), other users cannot read or use your files. However, the system also makes it easier for you to share files with others, both on-campus and at other AFS sites. Basically, RCS gives you the authority to share your files with others -- or keep them secure from others -- by allowing you to group your files into directories and then granting specific kinds of access to those directories. For example, you can set up a directory so that others can only read the files in it, like your public directory, or you can set up a directory so that others can both read and edit the files in it.
Unlike standard NFS UNIX file permissions, AFS uses Access Control Lists, or ACLs, to control permissions on a directory and the files contained in it; ACLs allow you to specify users who have permission to use a particular directory, as well those users' specific permissions to that directory.
(Refer to the Using chmod section of this document for an explanation of further differences between the NFS and AFS file systems.) Since ACLs are defined for directories rather than files, the permissions specified by a directory's ACL affect all the files in that directory, rather than affecting the individual files. For example, you can define an ACL that lets two users read and modify files in a directory, while a third user can only read them.
When you first log on with your Rensselaer userID and use the ls command to check to see what's in your home directory, you will discover that it includes the public and private subdirectories.
The public directory gives all users lookup and read access; this means that other users can view the contents of your files in this directory, or copy files to their own directories for their own use. By contrast, other users have no access at all to the files contained within your private directory. Therefore, the easiest way for you to give others read access to your files is to copy the files into your public directory, and the easiest way to keep files hidden is to move them into your private directory.
You also have a yesterday directory within your computer account, and this contains copies of all your files as of the most recent system backup. However, since this directory does not use up any of the space in your disk quota allotment, do not try to change the permissions within this directory, or to delete files.
Please note that any new directories which you create with the mkdir command will have the same permission as their parent directories unless you change them, as outlined below.
Understanding File Permissions
Because the Rensselaer Computing System uses AFS, this means that RCS' file permission scheme is a little different from those on UNIX systems that do not use AFS. Specifically, rather than setting access controls on individual files, AFS requires you to set your controls on the directory level, and as a result, files which require the same set of access controls should be placed in the same directory. Every directory has an access control list, or ACL, and you can use these these ACLs to grant access rights to other users.
AFS allows for seven specific access rights to be set up, and you can use these ACLs to grant access to individuals or groups. There are two distinct groups of rights: directory and file rights.
Directory Rights (lookup, insert, delete, administer)
These rights apply to the directory itself. For example, if only the insert right has been granted for your userID, you cannot insert text directly into a specific file, but you can create (or insert) files in that particular directory.
- lookup (l) -- Allows you to issue the ls command, examine the ACL for the directory, and access the directory's subdirectories (which are protected by their own ACLs). Users must have the lookup right before they can access files or directories.
- insert (i) -- Allows users to add new files to the directory (by creating or copying) and gives them permission to create subdirectories, but they cannot change any existing files. The user who creates any new files will own them, and only they can change their chmod permissions.
- delete (d) -- Allows you to delete files from the directory.
- administer (a) -- Allows you to set the ACL for that directory. Users always have this right on any directory that they own, even if his or her right has been removed from the directory's ACL.
File Rights (read, write, lock)
These rights apply to individual files within a directory.
- read (r) -- Allows you to read the contents of a file
- write (w) -- Allows you to change the contents of a file
- lock (k) -- Allows you to run programs that must ``lock" files in that directory. (For example, certain database programs may need to lock files to prevent more than one person from writing to the same file at the same time.)
Note that, even though other users can list the names of the files in your home directory, you are the only one who can actually read them and any files in subdirectories under it, except for those you specifically make ``public." Your public directory gives all users the ability to list names of files (lookup) and read and copy them; the private directory gives others no file permissions at all, and other users can't even list file names.
Note that you may combine these file and directory access rights (rlidwka) in different ways, in a sort of ``shorthand" form. The shorthand for the four most common combinations appears below.(For example, instead of typing out rlidwk when you grant a user permisssion to a directory, you can just use the word write.)
|write||rlidwk||Provides all rights except administer|
|read||rl||Provides read and lookup rights|
|all||rlidwka||Provides all rights, including administer|
|none||no rights||Removes user from the ACL entry|
Accessing Files Permitted to You
If someone has permitted a file to you, you can read or print it simply by specifying the file's entire path in the command. For example, to read the file lab12 in lucez's public directory, you could enter the following command:
Checking File Permissions
To check the permissions of the current directory, use the fs listacl command. As shown below, you may also use the abbreviation la instead of listacl; think of it as standing for ``list access."
Access list for /home/60/ramabz is
This access control list tells you that the user ramabz has ALL permissions for her directory (rlidwka), while others can just list the files in her directory (anyuser l). In this example, the userid ramabz is the only name on the ACL for this directory. If other users had specific permissions, they would appear in this listing as well. Any subdirectories you create will inherit the default permissions of the parent directory. However, subsequently changing the default permissions of the parent will not automatically change the permissions of the subdirectories.
Changing File Permissions: Working With ACLs
Adding a User to an ACL
To add a user to an ACL, first use the UNIX cd command to move to the parent directory of the directory to which you wish to change the file permissions, and then issue a command having the format:
fs setacl directory userid access-rights
- refers to the name of the directory in which you want to add someone to the ACL
- refers to the Rensselaer userID of the person you want to add to the ACL
- may consist of any combination of the seven access privileges (rlidwka)
If you wish, you can also use the abbreviation sa in place of setacl; think of it as standing for ``set access."
Rights issued with the setacl command will replace any pre-existing rights for a person or group.
To give user ramabz read access to your math directory, you would use the command:
fs sa math ramabz rl
To give user healyj write access (rldiwk) to the same directory:
fs sa math healyj write
To give user tartom list access to the same directory:
fs sa math tartom l
To perform the three previous commands all at once:
fs sa math ramabz read healyj write tartom l
Let's suppose that your own userid is doej2. Now, if you were to look at the ACL for your math directory after setting the permissions above, it would appear as follows:
fs la math
Access list for math is
Adding All Users to an ACL
If you wish, you may permit a directory to any user with AFS access by using a group called system:anyuser in the fs sa command, instead of a specific userid. This group contains anyone using AFS. A group called system:authuser also exists; this group contains only the people who have used valid userIDs and passwords to log into RCS. (Please refer to the section Working With Groups for more information about groups.)
For example, to give everyone read access (rl) to the directory named math, make sure you are in math's parent directory, and then type:
If you look at the ACL for your public directory, you will notice that system:anyuser has rl permission, meaning that anyone logged into AFS can read the files in that directory.
Removing an ACL Entry
To remove a user from an ACL, use the following command format:
For example, to remove all of user healyj's permissions within the math directory:
If you then checked the ACL list, it would appear as follows:
Denying a User Access
If a user would by default receive certain permissions based on his or her group membership (for example, system:authuser), and you don't want to allow that person to have such permission, you can use the -negative option before the userid. This indicates that the user is specifically not to have the permissions listed, no matter what else is set, and places them on the negative ACL list.
As an example, suppose we had the following:
However, let's suppose that you don't want user whitez to have permission to list or read any of the files in the directory (which he or she would have received by default as a member of the group system:authuser). In this case, you could type:
Your directory would then have an access list of:
Note: Negative ACLs are complex, in that setting one for a user does not necessarily prevent them from ever accessing that directory. For example, a directory that also has permissions set for the group system:anyuser can still allow the user some access to the directory; that person can use the unlog program and still have access as a member of system:anyuser. As a result, you should probably restrict use of negative ACLs to those directories that have permissions for system:authuser or another group that has limited membership that you control. (See the section Working With Groups for more information about groups.)
Using the chmod Command
(change mode), the traditional file permission command, has limited capabilities in AFS. You can use chmod to reduce access to a particular file in a directory; that is, you can give the file more limited access than the directory itself. You can also use it to make a file executable, which is appropriate for a file containing UNIX commands. For example, you can use chmod to remove write access to a file in a directory that permits write access to all its files. However, you cannot use the chmod command to give write access to a file in a directory that does not permit write access to any of its files. Using the ls -l command will display all the files in a directory, with their related chmod permissions appearing on the left, as shown below.
The command chmod has nine permission settings, with the chmod permission bits appearing to the left, and filenames to the right. AFS uses only the first three - read (r), write(w), and execute(x) bits and ignores the other bits. The first entry can be a dash (-), indicating a regular file, d, indicating a directory, or l, indicating a link. If the second entry appears as an r, anyone who has ACL read and lookup access to the directory can read that particular file. If the r bit does not appear, no one, including the owner, can read that file. If the third entry appears as a w, anyone who has ACL read, lookup, and write access to the directory can change that file. If the fourth entry appears as an x, anyone who has ACL read and lookup access to the directory can execute that program file. To set chmod permissions, use the command format
- indicates that you want to permit the file to a particular user. Currently, the only valid AFS option is u, or ``user."
- represents the chmod permission mode bits: r,w,x
- means add permissions. You can also have a - here, which means to remove the indicated permissions.
- refers to the file for which you want to set permissions or access
Example: To add execute permission to the file article:
More detailed information is available via the chmod man page; to access it, type the following command from a UNIX window:
- man chmod
Working With Groups
- 1.Create a group2.Assign members to the group3.Set an ACL entry for the group
Creating a Group
In order to work with a group, the first thing you need to do is create one. Most of the group-related commands use the pts command, which tells AFS to use the protection server to check directory access permitted to group members. As an example, suppose you want to create a group with your project team members in it.
The basic command format to use is:
- yourid refers to your own Rensselaer userID
- groupname refers to the name you wish to give the group
As a general rule, group names have two parts, separated by a colon, with the first part containing the owner's name, and the second part containing the group's name. All letters must be lowercase; you can include numbers and punctuation, except for the colon. The total name (userID and group name) may contain as many as 63 characters.
As an example, suppose your own userid is doej2. To create a group called doej2:team, you would enter the pts command shown below:
Each group is assigned an id-number.
Adding Users to a Group
It's important to note that a newly-created group is empty, so, once you have created a group, your next step is to add users to it.
To add users to a group, use the following command format:
- useridi1, userid2, and userid3 refer to the Rensselaer userIDs of the users you want to add to the group
- yourid refers to your own Rensselaer userID
- groupname refers to the name of the group to which you want to add members
As an example, to add three members to the group team, you would enter the following command:
Setting an ACL Entry for a Group
Setting the ACL entry for a group gives the members specified access to the files in that directory. The command for setting a group ACL entry, which is very similar to that for an individual user, uses the following format:
- directory refers to the directory to which you want to give the group access
- yourid refers to your own Rensselaer userID
- groupname refers to the name of the group
- rights may consist of any combination (or shortcut) of rlidwka access rights
For example, to give the group team write access to the math directory, first make sure you're in math's parent directory, and then issue the following command:
You can then use the following fs la command to check the results:
Listing Group Members
To list group members, use the following command format:
If you wish, you may use the abbreviation mem instead of membership. For example, to see the members of doej2:team, enter the following command:
Listing the Groups to Which You Belong
To see a list of the groups to which you belong, use the following command format:
In addition to the groups listed, you are always a member of system:anyuser and, if you are logged on, a member of system:authuser.
Removing a User From a Group
To remove a user from a group, use the following command format:
If you want to remove a person from more than one group, add the -group option just after the userID of the person you want to remove, and add other group names to the end of the command.
Examples: To remove the member ramabz from the group team:
To remove the member ramabz from the groups team and dept:
- pts removeuser -user ramabz -group doej2:team doej2:dept
Removing a Group
Removing a group requires two separate actions: you must first delete the group, and then remove its ACL reference.
To delete a group, use the following command format:
To then remove the group's ACL reference:
where directory refers to the directory containing the ACL from which you want to remove the group. The system will automatically show you an updated ACL for the directory.
For example, to delete the group doej2:team, you would enter the command:
To then remove the group from the math directory's ACL:
The system will then show you an updated ACL like this:
To see a list of fs commands, enter the following command from a UNIX window:
To see a list of pts commands, enter the following command from a UNIX window: