1
0
mirror of https://github.com/samba-team/samba.git synced 2024-12-28 07:21:54 +03:00
samba-mirror/source3/pam_smbpass
Andrew Bartlett 5f5ca913b7 lib/util: new merged debug system
This is the s3 debug system, with a number of changes to tidy it up
for common use.  The debug class system is simplified by the removal of the
ISSET table, the system no longer attempts to cope with assignment of
DEBUGLEVEL, and the full class table is always available (rather than
just DEBUGLEVEL_CLASS[DBCG_ALL]) from startup.  It is also no longer
confusingly described as a hack, but as the initial table.

Autobuild-User: Andrew Bartlett <abartlet@samba.org>
Autobuild-Date: Tue Mar  1 04:32:12 CET 2011 on sn-devel-104
2011-03-01 04:32:12 +01:00
..
samples
CHANGELOG
general.h pam: share pam errors in a common location. 2011-02-08 14:05:36 +01:00
INSTALL
pam_smb_acct.c lib/util/charset Add back setlocale(), but only when called from binaries 2011-02-18 09:29:35 +01:00
pam_smb_auth.c lib/util: new merged debug system 2011-03-01 04:32:12 +01:00
pam_smb_passwd.c lib/util/charset Add back setlocale(), but only when called from binaries 2011-02-18 09:29:35 +01:00
README
support.c s3: Use asprintf where appropriate 2010-09-22 15:42:28 -07:00
support.h s3:pam_smbpass: don't call openlog() or closelog() from pam_smbpass 2009-05-26 16:23:11 +02:00
TODO
wscript_build s3-waf: rename LIBSAMBA subsystem to LIBNTLMSSP (which it is in fact). 2011-02-23 22:33:52 +01:00

25 Mar 2001

pam_smbpass is a PAM module which can be used on conforming systems to
keep the smbpasswd (Samba password) database in sync with the unix
password file. PAM (Pluggable Authentication Modules) is an API supported
under some Unices, such as Solaris, HPUX and Linux, that provides a
generic interface to authentication mechanisms.

For more information on PAM, see http://ftp.kernel.org/pub/linux/libs/pam/

This module authenticates a local smbpasswd user database.  If you require
support for authenticating against a remote SMB server, or if you're
concerned about the presence of suid root binaries on your system, it is
recommended that you use pam_winbind instead.

Options recognized by this module are as follows:

	debug		-	log more debugging info
	audit		-	like debug, but also logs unknown usernames
	use_first_pass	-	don't prompt the user for passwords;
				take them from PAM_ items instead
	try_first_pass  -	try to get the password from a previous
				PAM module, fall back to prompting the user
	use_authtok	-	like try_first_pass, but *fail* if the new
				PAM_AUTHTOK has not been previously set.
				(intended for stacking password modules only)
	not_set_pass    -	don't make passwords used by this module
				available to other modules.
	nodelay		-	don't insert ~1 second delays on authentication
				failure.
	nullok		-	null passwords are allowed.
	nonull		-	null passwords are not allowed. Used to
				override the Samba configuration.
	migrate		-	only meaningful in an "auth" context;
				used to update smbpasswd file with a
				password used for successful authentication.
	smbconf=<file>	-	specify an alternate path to the smb.conf
				file.

See the samples/ directory for example PAM configurations using this
module.

Thanks go to the following people:

* Andrew Morgan <morgan@transmeta.com>, for providing the Linux-PAM
framework, without which none of this would have happened

* Christian Gafton <gafton@redhat.com> and Andrew Morgan again, for the
pam_pwdb module upon which pam_smbpass was originally based

* Luke Leighton <lkcl@switchboard.net> for being receptive to the idea,
and for the occasional good-natured complaint about the project's status
that keep me working on it :)

* and of course, all the other members of the Samba team 
<http://www.samba.org/samba/team.html>, for creating a great product 
and for giving this project a purpose

---------------------
Stephen Langasek <vorlon@netexpress.net>