4.3BSD-Reno/share/man/cat3/setmode.0

SETMODE(3)		      1990		       SETMODE(3)



NNAAMMEE
     getmode, setmode - modify mode bits

SSYYNNOOPPSSIISS
     ggeettmmooddee((sseett,, mmooddee))
     mmooddee__tt **sseett,, mmooddee;;

     sseett == sseettmmooddee((mmooddee__ssttrr))
     mmooddee__tt **sseett;;
     cchhaarr **mmooddee__ssttrr;;

DDEESSCCRRIIPPTTIIOONN
     _G_e_t_m_o_d_e returns a copy of the file permission bits _m_o_d_e as
     altered by the values pointed to by _s_e_t.  While only the
     mode bits are altered, other parts of the file mode may be
     examined.

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

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

EERRRROORRSS
     _S_e_t_m_o_d_e may fail and set errno for any of the errors speci-
     fied for the library routine _m_a_l_l_o_c(3).

SSEEEE AALLSSOO
     chmod(1), stat(2), umask(2), malloc(3)



















Printed 7/27/90               June				1