pam_mkhomedir(8)

NAME#

pam_mkhomedir - PAM module to create users home directory

SYNOPSIS#

pam_mkhomedir.so [silent] [debug] [umask=mode] [skel=skeldir]

DESCRIPTION#

The pam_mkhomedir PAM module will create a users home directory if it does not exist when the session begins. This allows users to be present in central database (such as NIS, kerberos or LDAP) without using a distributed file system or pre-creating a large number of directories. The skeleton directory (usually /etc/skel/) is used to copy default files and also sets a umask for the creation.

The new users home directory will not be removed after logout of the user.

OPTIONS#

silent

debug

umask=mask

skel=/path/to/skel/directory

MODULE TYPES PROVIDED#

Only the session module type is provided.

RETURN VALUES#

PAM_BUF_ERR

PAM_PERM_DENIED

PAM_USER_UNKNOWN

PAM_SUCCESS

FILES#

/etc/skel

EXAMPLES#

A sample /etc/pam.d/login file:

\n
  auth       requisite   pam_securetty.so
\n
  auth       sufficient  pam_ldap.so
\n
  auth       required    pam_unix.so
\n
  auth       required    pam_nologin.so
\n
  account    sufficient  pam_ldap.so
\n
  account    required    pam_unix.so
\n
  password   required    pam_unix.so
\n
  session    required    pam_mkhomedir.so skel=/etc/skel/ umask=0022
\n
  session    required    pam_unix.so
\n
  session    optional    pam_lastlog.so
\n
  session    optional    pam_mail.so standard
\n

SEE ALSO#

pam.d(5), pam(7).

AUTHOR#

pam_mkhomedir was written by Jason Gunthorpe <[email protected]>.