mojave man page for lchflags

LCHFLAGS(3)						   BSD Library Functions Manual 					       LCHFLAGS(3)

NAME
     lchflags -- set file flags

SYNOPSIS
     #include <sys/stat.h>
     #include <unistd.h>

     int
     lchflags(const char *path, u_int flags);

DESCRIPTION
     The file whose name is given by path has its flags changed to flags.  See chflags(2) for the values of the flags.

     The lchflags() call is like chflags() except when the named file is a symbolic link, in which case lchflags() will change the flags of the
     link itself, rather than the file it points to.

NOTE
     Instead of being a system call, lchflags() is emulated using setattrlist(2).  Not all file systems support setattrlist(2).

RETURN VALUES
     Upon successful completion, a value of 0 is returned.  Otherwise, -1 is returned and the global variable errno is set to indicate the error.

ERRORS
     The lchflags() call may return the same errors as chflags(2) and setattrlist(2).

SEE ALSO
     chflags(2), setattrlist(2)

BSD
								   Oct 31, 2005 							       BSD