X-Git-Url: https://git.subgeniuskitty.com/unix-history/.git/blobdiff_plain/8c6b2df90eebacd557b851752a2611dde6ed4a3c..be8ee4f021b43684944d8fe26d3d979714531f2b:/usr/share/man/cat3/getmode.0 diff --git a/usr/share/man/cat3/getmode.0 b/usr/share/man/cat3/getmode.0 index 7565e35407..bb699dc2f7 100644 --- a/usr/share/man/cat3/getmode.0 +++ b/usr/share/man/cat3/getmode.0 @@ -1,66 +1,39 @@ - - - -SETMODE(3) 1990 SETMODE(3) - - +SETMODE(3) BSD Programmer's Manual SETMODE(3) NNAAMMEE - getmode, setmode - modify mode bits + ggeettmmooddee, sseettmmooddee - modify mode bits SSYYNNOOPPSSIISS - ggeettmmooddee((sseett,, mmooddee)) - mmooddee__tt **sseett,, mmooddee;; + _m_o_d_e___t + ggeettmmooddee(_c_o_n_s_t _v_o_i_d _*_s_e_t, _m_o_d_e___t _m_o_d_e); - sseett == sseettmmooddee((mmooddee__ssttrr)) - mmooddee__tt **sseett;; - cchhaarr **mmooddee__ssttrr;; + _v_o_i_d + sseettmmooddee(_c_o_n_s_t _c_h_a_r _*_m_o_d_e___s_t_r); 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. + The ggeettmmooddee() function 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 al- + tered, 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. + The sseettmmooddee() function takes an absolute (octal) or symbolic value, as + described in chmod(1), as an argument and returns a pointer to mode val- + ues to be supplied to ggeettmmooddee(). Because some of the symbolic values are + relative to the file creation mask, sseettmmooddee() may call umask(2). If this + occurs, the file creation mask will be restored before sseettmmooddee() returns. + If the calling program changes the value of its file creation mask after + calling sseettmmooddee(), sseettmmooddee() must be called again if ggeettmmooddee() is to mod- + ify 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. + If the mode passed to sseettmmooddee() is invalid, sseettmmooddee() 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). + The sseettmmooddee() function may fail and set errno for any of the errors spec- + ified for the library routine malloc(3). SSEEEE AALLSSOO - chmod(1), stat(2), umask(2), malloc(3) - - - - - - - - - - - - - - - - - - - -Printed 7/27/90 June 1 - + chmod(1), stat(2), umask(2), malloc(3) +HHIISSTTOORRYY + The ggeettmmooddee() and sseettmmooddee() functions first appeared in 4.4BSD. +4.4BSD June 9, 1993 1