]> git.saurik.com Git - apple/xnu.git/blobdiff - bsd/man/man2/umask.2
xnu-4903.270.47.tar.gz
[apple/xnu.git] / bsd / man / man2 / umask.2
index 92eff34f7cf1e39b34efc07012a2284f25a514c6..a9e156109a106a6459201c3354557197fc36aa1e 100644 (file)
 .Nm umask
 .Nd set file creation mode mask
 .Sh SYNOPSIS
-.Fd #include <sys/types.h>
 .Fd #include <sys/stat.h>
 .Ft mode_t
-.Fn umask "mode_t numask"
+.Fo umask
+.Fa "mode_t cmask"
+.Fc
 .Sh DESCRIPTION
 The
 .Fn umask
 routine sets the process's file mode creation mask to
-.Fa numask
-and returns the previous value of the mask.  The 9 low-order
-access permission
-bits of
-.Fa numask
+.Fa cmask
+and returns the previous value of the mask.
+The 9 low-order access permission bits of
+.Fa cmask
 are used by system calls, including
 .Xr open 2 ,
 .Xr mkdir 2 ,
-.Xr mkfifo 2
+.Xr mkfifo 2 ,
 and
 .Xr mknod 2
 to turn off corresponding bits
@@ -66,7 +66,7 @@ requested in file mode.
 This clearing allows each user to restrict the default access
 to his files.
 .Pp
-The default mask value is S_IWGRP|S_IWOTH (022, write access for the
+The default mask value is S_IWGRP | S_IWOTH (022, write access for the
 owner only).
 Child processes inherit the mask of the calling process.
 .Sh RETURN VALUES
@@ -75,12 +75,20 @@ The previous value of the file mode mask is returned by the call.
 The
 .Fn umask
 function is always successful.
+.Sh LEGACY SYNOPSIS
+.Fd #include <sys/types.h>
+.Fd #include <sys/stat.h>
+.Pp
+The include file
+.In sys/types.h
+is necessary.
 .Sh SEE ALSO
 .Xr chmod 2 ,
 .Xr mkdir 2 ,
 .Xr mkfifo 2 ,
 .Xr mknod 2 ,
-.Xr open 2
+.Xr open 2 ,
+.Xr compat 5
 .Sh STANDARDS
 The
 .Fn umask