Documentation Archive Developer
Search
ADC Home > Reference Library > Reference > Mac OS X > Mac OS X Man Pages

 

This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).



LCHMOD(3)                BSD Library Functions Manual                LCHMOD(3)

NAME
     lchmod -- change mode of file

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

     int
     lchmod(const char *path, mode_t flags);

DESCRIPTION
     The function lchmod() sets the file permission bits of the file specified
     by the pathname path to mode.  See chmod(2) for the values of the flags.

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

NOTE
     Instead of being a system call, lchmod() 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 lchmod() call may return the same errors as chmod(2) and
     setattrlist(2).

SEE ALSO
     chmod(2), setattrlist(2)

BSD                              Oct 31, 2005                              BSD