# 2.11BSD#431 - /usr/man/cat3/setmode.0

    SETMODE(3)	    UNIX Programmer's Manual	       SETMODE(3)

    NAME
         getmode, setmode - modify mode bits

    SYNOPSIS
         #include <sys/types.h>

         mode_t
         getmode(set, mode)
         void *set;
         mode_t mode

         void *
         setmode(mode_str)
         char *mode_str;

    DESCRIPTION
         The getmode function returns a copy of the file permission
         bits mode as altered by the values pointed to by set.  While
         only the mode bits are altered, other parts of the file mode
         may be examined.

         The setmode function takes an absolute (octal) or symbolic
         value, as described in chmod(1), as an argument and returns
         a pointer to mode values to be supplied to getmode.  Because
         some of the symbolic values are relative to the file crea-
         tion mask, setmode may call umask(2).  If this occurs, the
         file creation mask will be restored before setmode returns.
         If the calling program changes the value of its file crea-
         tion mask after calling setmode, setmode must be called
         again if getmode is to modify future file modes correctly.

         If the mode passed to setmode is invalid, setmode returns
         NULL.

    ERRORS
         The setmode function may fail and set errno for any of the
         errors specified for the library routine malloc(3).

    SEE ALSO
         chmod(1), stat(2), umask(2), malloc(3)

    HISTORY
         The getmode and setmode functions first appeared in 4.4BSD.

    Printed 11/26/99	February 20, 1996			1

Generated: 2016-12-26 | Generated by man2html V0.25 page hit count: 274 |