CHFALGS(2) 1990 CHFALGS(2) NNAAMMEE chflags, fchflags - set file flags SSYYNNOOPPSSIISS cchhffllaaggss((ppaatthh,, ffllaaggss)) cchhaarr **ppaatthh;; lloonngg ffllaaggss;; ffcchhffllaaggss((ffdd,, ffllaaggss)) iinntt ffdd;; lloonngg ffllaaggss;; DDEESSCCRRIIPPTTIIOONN The file whose name is given by _p_a_t_h or referenced by the descriptor _f_d has its flags changed to _f_l_a_g_s. Only the owner of a file (or the super-user) may change the flags. The owner may only change the lower 16 bits of the flags; the super-user may change all 32 bits of the flags. RREETTUURRNN VVAALLUUEE Upon successful completion, a value of 0 is returned. Oth- erwise, -1 is returned and the global variable _e_r_r_n_o is set to indicate the error. EERRRROORRSS _C_h_f_l_a_g_s fails if one or more of the following are true: [ENOTDIR] A component of the path prefix is not a directory. [EINVAL] The pathname contains a character with the high-order bit set. [ENAMETOOLONG] A component of a pathname exceeded 255 char- acters, or an entire path name exceeded 1023 characters. [ENOENT] The named file does not exist. [EACCES] Search permission is denied for a component of the path prefix. [ELOOP] Too many symbolic links were encountered in translating the pathname. [EPERM] The effective user ID does not match the owner of the file and the effective user ID is not the super-user. [EROFS] The named file resides on a read-only file system. Printed 7/27/90 June 1 CHFALGS(2) 1990 CHFALGS(2) [EFAULT] _P_a_t_h points outside the process's allocated address space. [EIO] An I/O error occurred while reading from or writing to the file system. _F_c_h_f_l_a_g_s will fail if: [EBADF] The descriptor is not valid. [EINVAL] _F_d refers to a socket, not to a file. [EPERM] The effective user ID does not match the owner of the file and the effective user ID is not the super-user. [EROFS] The file resides on a read-only file system. [EIO] An I/O error occurred while reading from or writing to the file system. SSEEEE AALLSSOO chmod(2), open(2), chown(2), stat(2) Printed 7/27/90 June 2