Standards, Environments, and Macros             pamsmbpasswd(5)



NAME
     pamsmbpasswd - SMB password management module

SYNOPSIS
     pamsmbpasswd.so.1


DESCRIPTION
     The pamsmbpasswd module enhances the PAM password  manage-
     ment  stack.  This  functionality  supports  the changing or
     adding of SMB passwords for local Solaris users. The Solaris
     CIFS  server  uses  SMB  passwords to authenticate connected
     Solaris     users.     This     module     includes      the
     pamsmchauthtok(3PAM) function.


     The pamsmchauthtok() function accepts the following flags:

     PAMPRELIMCHECK

         Always returns PAMIGNORE.


     PAMSILENT

         Suppresses messages.


     PAMUPDATEAUTHTOK

         Updates or creates a new CIFS local LM/NTLM hash for the
         user  that is specified in PAMUSER by using the authen-
         tication information found in PAMAUTHTOK. The  LM  hash
         is  only created if the smbd/lmauthlevel property value
         of  the  smb/server  service  is  set  to  3  or   less.
         PAMIGNORE  is  returned if the user is not in the local
         /etc/passwd repository.



     The following options can be passed  to  the  pamsmbpasswd
     module:

     debug

         Produces  syslog(3C)  debugging   information   at   the
         LOGAUTH or LOGDEBUG level.


     nowarn

         Suppresses warning messages.



SunOS 5.11          Last change: 29 Apr 2008                    1






Standards, Environments, and Macros             pamsmbpasswd(5)



FILES
     /var/smb/smbpasswd

         Stores SMB passwords for Solaris users.


ERORS
     Upon   successful    completion    of    pamsmchauthtok(),
     PAMSUCES  is  returned.  The  following  error  codes are
     returned upon error:

     PAMAUTHTOKER

         Authentication token manipulation error


     PAMAUTHTOKLOCKBUSY

         SMB password file is locked


     PAMPERMDENIED

         Permissions are insufficient for accessing the SMB pass-
         word file


     PAMSYSTEMER

         System error


     PAMUSERUNKNOWN

         User is unknown


ATRIBUTES
     See the attributes(5) man page for descriptions of the  fol-
     lowing attributes:















SunOS 5.11          Last change: 29 Apr 2008                    2






Standards, Environments, and Macros             pamsmbpasswd(5)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Committed                   
    
     MT Level                     MT-Safe with exceptions     
    


SEE ALSO
     smbd(1M),     syslog(3C),      libpam(3LIB),      pam(3PAM),
     pamchauthtok(3PAM),  pamsm(3PAM),  pamsmchauthtok(3PAM),
     pam.conf(4), attributes(5)

NOTES
     The interfaces in libpam(3LIB)  are  MT-Safe  only  if  each
     thread  within  the  multi-threaded application uses its own
     PAM handle.


     The pamsmbpasswd.so.1 module should be  stacked  following
     all  password  qualification  modules  in  the  PAM password
     stack.
































SunOS 5.11          Last change: 29 Apr 2008                    3