NAME | SYNOPSIS | DESCRIPTION | OPTIONS | MODULE TYPES PROVIDED | RETURN VALUES | EXAMPLES | SEE ALSO | AUTHOR | COLOPHON

PAM_UMASK(8)                  Linux-PAM Manual                  PAM_UMASK(8)

NAME         top

       pam_umask - PAM module to set the file mode creation mask

SYNOPSIS         top

       pam_umask.so [debug] [silent] [usergroups] [umask=mask]

DESCRIPTION         top

       pam_umask is a PAM module to set the file mode creation mask of the
       current environment. The umask affects the default permissions
       assigned to newly created files.
       The PAM module tries to get the umask value from the following places
       in the following order:
       ·   umask= argument
       ·   umask= entry in the user's GECOS field
       ·   UMASK= entry from /etc/default/login
       ·   UMASK entry from /etc/login.defs
       The GECOS field is split on comma ',' characters. The module also in
       addition to the umask= entry recognizes pri= entry, which sets the
       nice priority value for the session, and ulimit= entry, which sets
       the maximum size of files the processes in the session can create.

OPTIONS         top

       debug
           Print debug information.
       silent
           Don't print informative messages.
       usergroups
           If the user is not root and the username is the same as primary
           group name, the umask group bits are set to be the same as owner
           bits (examples: 022 -> 002, 077 -> 007).
       umask=mask
           Sets the calling process's file mode creation mask (umask) to
           mask & 0777. The value is interpreted as Octal.

MODULE TYPES PROVIDED         top

       Only the session type is provided.

RETURN VALUES         top

       PAM_SUCCESS
           The new umask was set successfully.
       PAM_SERVICE_ERR
           No username was given.
       PAM_USER_UNKNOWN
           User not known.

EXAMPLES         top

       Add the following line to /etc/pam.d/login to set the user specific
       umask at login:
                   session optional pam_umask.so umask=0022

SEE ALSO         top

       pam.conf(5), pam.d(5), pam(8)

AUTHOR         top

       pam_umask was written by Thorsten Kukuk <kukuk@thkukuk.de>.

COLOPHON         top

       This page is part of the linux-pam (Pluggable Authentication Modules
       for Linux) project.  Information about the project can be found at 
       ⟨http://www.linux-pam.org/⟩.  If you have a bug report for this manual
       page, see ⟨//www.linux-pam.org/⟩.  This page was obtained from the
       tarball Linux-PAM-1.3.0.tar.gz fetched from 
       ⟨http://www.linux-pam.org/library/⟩ on 2017-07-05.  If you discover
       any rendering problems in this HTML version of the page, or you
       believe there is a better or more up-to-date source for the page, or
       you have corrections or improvements to the information in this
       COLOPHON (which is not part of the original manual page), send a mail
       to man-pages@man7.org
Linux-PAM Manual                 04/01/2016                     PAM_UMASK(8)