Files and Directories File types stat functions for file information File permissions suid and sgid Sticky bit Hard link and soft link Directory operations Device special files File system

File Types Regular file Directory file Character special file (unbuffered I/O access) Block special file (buffered I/O) Named Pipe (a type of IPC) - FIFO Socket (a network form of IPC) Symbolic Link (a file that just points to another file)

stat, fstat and lstat int stat(const char *path, struct stat *buf); int fstat(int filedes, struct stat *buf); int lstat(const char *path, struct stat *buf); All three return 0 on success or -1 on failure All three set buf to point to a structure of information stat get info about the file fstat gets info about an already open file lstat same as stat but if given a symbolic link will get info about the link instead of what the link points to

stat structure Definition on page 88 st_mode st_ino st_size st_dev st_rdev st_nlink st_uid st_gid st_size st_blocks st_blksize st_atime st_mtime st_ctime st_mode – file type and mode (permissions) st_ino - i-node number (serial number) st_dev - device number st_rdev - device number for special files st_nlink - number of links st_uid - user id of owner st_gid - group id of owner st_size - number of bytes (for regular files) st_blocks – number of disk blocks allocated st_blksize – best I/O block size st_atime - time of last access st_mtime - time of last modification st_ctime - time of last file status change

Determining the type of a file Set of macros defined in <sys/stat.h> can be used. They all accept the st_mode field of the stat struct as their only parameter S_ISREG(mode_t mode) S_ISDIR(mode_t mode) S_ISCHR(mode_t mode) S_ISBLK(mode_t mode) S_ISFIFO(mode_t mode) S_ISLNK(mode_t mode) S_ISSOCK(mode_t mode) Example code on page 90, fig 4.3 Similar program http://www.cs.uah.edu/~kkeen/CS590/examples/filesanddirs/lstat/lstatexample.c

Set-User-ID & Set-Group-ID Every process has 6 or more IDs Real user ID Real group ID Effective user ID Effective group ID Supplementary group IDs Saved set-user-ID Saved set-group-ID Green – IDs of the account that starts the process. Usually taken from login information such as that defined in /etc/passwd file Blue – used for file access permission checks Red – previous effective UID and GID saved by the exec function

Set-User-ID & Set-Group-ID Normally, effective IDs are the same as real user IDs Sometimes, we need to run a process with the permissions of the user or group that owns the file (ex: passwd) Two bits in the file’s mode word (st_mode) allow this. set-user-ID bit set-group-ID bit Setting the set-user-ID bit will cause the effective UID to be the same as st_uid (owner of the file) Setting the set-group-ID bit will cause the effective GID to be the same as st_gid (owning group of the file)

Set-User-ID & Set-Group-ID When creating a file with the creat function, the new file’s UID is the effective UID of the process, and the new file’s GID is the effective GID of the process

Checking set-user-ID and set-group-ID bits Can use S_ISUID and S_ISGID masks Ex: if(S_ISUID & st_mode) if(S_ISGID & st_mode)

Setting SUID and GUID SUID has a value of 4 GUID has a value of 2 chmod 4755 afile -rwsr-xr-x chmod 2755 afile -rwxr-sr-x chmod 6755 afile -rwsr-sr-x Execute permission must be set for the associated SUID and GUID bits to have any effect.

File access permissions Read section 4.5 on page 92. Note the different permissions required for operations on regular files versus directories

access function Tests to see if the real user ID and real group ID allow access to a file Useful if a program that may be running as another user (ex root) wants to be sure that the person that started the program has permissions to access some file int access(const char *pathname, int mode); Returns 0 if ok, -1 otherwise

access function (cont) In this context, mode is not the same as in previous functions. Here, mode is the bitwise OR of several constants R_OK - test for read permission W_OK - test for write permission X_OK - test for execute permission F_OK - test for file existence Example: http://www.cs.uah.edu/~kkeen/CS590/examples/filesanddirs/access/accessexample.c

umask function mode_t umask(mode_t mask); Sets the “file mode creation mask” “file mode creation mask” is used to specify the default permissions of newly created files Since we are dealing with a mask it is the complement of what we want. So we set the bits corresponding to the permissions we don’t want.

umask function When using open or creat, any bits in mode that are also set in the file creation mask are turned off. All the UNIX shells also define a shell command called umask that displays the default umask set at login. Each process can change its own mask without interfering with each other http://www.cs.uah.edu/~kkeen/CS590/examples/filesanddirs/umask/umaskexample.c

File Size st_size member of stat structure holds the size of a file Only meaningful for regular files, directories and symbolic links Regular file – number of bytes in the file Directories – multiple of a number (more on this later) Symbolic Links – number of chars in filename Symbolic link – no ending null byte on filename because we know the size from st_size

Sticky Bit Historically Used to tell the system to keep a copy of the “text” portion of a program in the swap space even after the program exits. (text = instructions, not data) Swap file is contiguous  faster start on next execution.

Sticky Bit Currently To set the sticky bit Used on directories, indicates that in order to rename or delete a file in that directory a user must both have write permissions to the directory and one of the following must be true User owns the file User owns the directory User is the superuser To set the sticky bit chmod +t mydir This is useful for directories where everyone has permissions to create files, but only the owners of files should be able to delete them.

chmod and fchmod Allows us to change the existing permissions for a file int chmod(const char *path, mode_t mode); int fchmod(int fildes, mode_t mode); Returns 0 on success or -1 on failure mode is bitwise OR of constants shown on page 99 fig 4.11 Effective UID of process must be the same as the UID of the file or the process must have superuser permissions

link, unlink, remove and rename link int link(const char *oldpath, const char *newpath); Creates a new hard link within the file system oldpath is the file to be linked. Newpath must already exist except for the last portion which will be created If all of newpath already exists, an error will be returned Returns 0 if ok, -1 otherwise A hard link looks like another regular file that actually points to the same data. What really happens is that a new entry is put into the directory that points to the same i-node as the original file. Thus, we have two “filenames” that are really one file. Every file keep track of the number of hard links that refer to it. This data is stored in the st_nlink field of the stat struct Ex: link(“/home/bob/data.txt”, ”/home/joe/foo.txt”); /home/joe must already exist, and foo.txt will be created. If foo.txt already exists in that directory, an error will be returned.

link, unlink, remove and rename unlink int unlink(const char *pathname); Removes directory entry indicated by pathname Decrements the link count of the file Must have write and execute on containing directory Only when link count reaches 0 and no process has the file open will it be deleted Also, if sticky bit is set on the directory we must either Own the file Own the directory Have superuser privileges Because a file is not truly removed while a process has it open, this makes unlink very useful for temporary files a process may need to create. The process can create the file, and immediately unlink it so that if the process crashes, the temp file will automatically be removed. If pathname is a symbolic link, the symbolic link will be removed, not the file it points to

link, unlink, remove and rename remove int remove(const char *pathname); Calls unlink for files and rmdir for directories rename int rename(const char *oldpath, const char *newpath); Equivelant to mv shell command superuser can call unlink on a directory, but really should use rmdir instead

Symbolic Links Indirect pointer to a file or directory Created to get around limitations of hard links Hard links must live in the same file system that the think it links to is in Only superuser can hard link to a directory

symlink and readlink symlink int symlink(const char *oldpath, const char *newpath); Creates the symbolic link file newpath that contains the text contained in oldpath oldpath and newpath may be on different file systems readlink ssize_t readlink(const char *path, char *buf, size_t bufsiz); open function follows symbolic links. readlink operates on the link file itself String from file placed in buf, with number of bytes in bufsiz. String is not null terminated Readlink returns number of bytes read if ok, or -1 otherwise

File Times 3 times are kept for any file Last access time Last modified time Last status change time These are stored in the following fields of the stat struct st_atime st_mtime st_ctime The ls shell command can display sorted by any of these three times. The default time display is last modified. ls –lu can display the last access time ls –lc can display the last status change time Examples of operations that would effect the various times: Access time: read Modification time: write Status change time: chmod, chown (basically anything that changes the file’s i-node)

utime int utime(const char *filename, const struct utimbuf *buf); struct utimbuf { time_t actime; time_t modtime; } actime and modtime are calendar times marking seconds since Epoch buf may be NULL, in which case the time is updated to current system time Unless using NULL for buf, just having write permissions is not enough. Effective user ID must equal owner ID or process must have superuser privileges Requires <utime.h> Epoch: 00:00:00 January 1st 1970 UTC (aka GMT) touch uses utime on some implementations Some backup programs use utime when restoring files to set the date of the newly restored file back to the original date http://www.cs.uah.edu/~kkeen/CS590/examples/filesanddirs/utime/utimeexample.c

Directory Operations mkdir and rmdir int mkdir(const char *pathname, mode_t mode); int rmdir(const char *pathname); Create and remove the specified directory For mkdir, the mode parameter is the same as those used for open. However, recall that interactions with the umask may occur! When creating directories, remember that we usually want execute permissions so that the files within the directory can be listed

Reading Directories DIR *opendir(const char *name); struct dirent *readdir(DIR *dir); void rewinddir(DIR *dir); int closedir(DIR *dir); off_t telldir(DIR *dir); void seekdir(DIR *dir, off_t offset); struct dirent { ino_t d_ino; char d_name[NAME_MAX + 1]; } The dirent struct contains information about individual files in that directory. At a minimum it must contain the file name and i-node number of the associated file. These functions require #include <dirent.h>

chdir fchdir and getcwd int chdir(const char *path); int fchdir(int fd); Change the current working directory of the process long getcwd(char *buf, unsigned long size); Get the current working directory of the process http://www.cs.uah.edu/~kkeen/CS590/examples/filesanddirs/getcwd/getcwdexample.c

Device Special Files Many devices are represented as files within /dev directory Each device has major number and minor number for the Kernel to identify it Major number usually specifies the driver to use for the device Minor number may be the specific sub device or options for that device Example: For file systems, the same driver (major number) would be used for a single disk, but the various file systems would have different minor numbers.

Device Special Files ls –lL on a device file will show major and minor numbers instead of size of file st_dev and st_rdev st_dev for every file is the device number under the filesystem containing that filename and its associated i-node st_rdev (only for character and block special files) contains actual device number Capitol L option to ls says to follow symbolic links

Device Special Files Obtaining the major and minor numbers Use the major and minor macros major(st_dev) minor(st_dev) For block and character special devices use st_rdev instead to obtain real device number http://www.cs.uah.edu/~keen/CS590/filesanddirs/device/devexample.c