4.3BSD-Reno/share/man/cat2/chflags.0

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