manpagez: man pages & more
man lchflags(3)
Home | html | info | man
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

Mac OS X 10.8 - Generated Tue Aug 28 07:54:51 CDT 2012
© manpagez.com 2000-2017
Individual documents may contain additional copyright information.