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