NAME

       pam_oddjob_mkhomedir.so - PAM module to create users home directory via oddjob

SYNOPSIS

       session optional /lib/security/pam_oddjob_mkhomedir.so

DESCRIPTION

       The  pam_oddjob_mkhomedir.so  module checks if the user's home directory exists, and if it
       does not, it invokes the mkhomedirfor method of  the  com.redhat.oddjob_mkhomedir  service
       for  the  PAM_USER  if  the  module  is  running with superuser privileges.  Otherwise, it
       invokes the mkmyhomedir method.

       The location of the skeleton directory and the default umask are determined by the  values
       of  HOME_MODE  or  UMASK  (as a fallback) variables in /etc/login.defs, so they can not be
       specified as arguments to this module.

       If D-Bus has not been configured to allow the calling application to invoke these  methods
       provided  as part of the com.redhat.oddjob_mkhomedir interface of the / object provided by
       the com.redhat.oddjob_mkhomedir service, then oddjobd will not receive the request and  an
       error will be returned by D-Bus.

       If oddjobd has not been configured to provide these methods, or the user is not authorized
       to use them, then oddjobd will ignore the module's requests.

OPTIONS

       The module takes no options.  What oddjobd does in response to  the  module's  request  is
       controlled  by  the  daemon's  configuration  file, typically /etc/oddjobd.conf.d/oddjobd-
       mkhomedir.conf.

SEE ALSO

       oddjob_request(1) oddjob.conf(5) oddjobd.conf(5) oddjobd(8)