[dovecot-cvs] dovecot/doc dovecot-mysql.conf, NONE, 1.1 Makefile.am, 1.6, 1.7

[cras at procontrol.fi]

Update of /home/cvs/dovecot/doc
In directory talvi:/tmp/cvs-serv31516/doc

Modified Files:
	Makefile.am 
Added Files:
	dovecot-mysql.conf 
Log Message:
MySQL authentication patch by Matther Reimer



--- NEW FILE: dovecot-mysql.conf ---
# For the mysql passdb module, you'll need a database with a table that
# contains fields for at least the userid and password. If you want to
# use the user at domain syntax, you might want to have a separate domain
# field as well.
#
# If your users all have the same uig/gid, and have predictable home
# directories, you can use the static userdb module to generate the home
# dir based on the userid and domain. In this case, you won't need fields
# for home, uid, or gid in the database.
#
# If you prefer to use the mysql userdb module, you'll want to add fields
# for home, uid, and gid. Here is an example table:
#
# CREATE TABLE users (
#     userid VARCHAR(128) NOT NULL,
#     password VARCHAR(64) NOT NULL,
#     home VARCHAR(256) NOT NULL,
#     uid INTEGER NOT NULL,
#     gid INTEGER NOT NULL,
#     active CHAR(1) DEFAULT 'Y' NOT NULL
# );

db_host = localhost
db_port = 3306
#db_unix_socket = /var/tmp/mysql.sock
db = users
db_user = dovecot-db
db_passwd = opensesame
db_client_flags = 0

# Default password scheme.
#
# Currently supported schemes include PLAIN, PLAIN-MD5, DIGEST-MD5, and CRYPT.
#
#default_pass_scheme = PLAIN-MD5

# Query to retrieve the password.
#
# The query should return one row, one column. If more than one row or column
# is returned, authentication will automatically fail.
#
# Available substitutions:
#   %u = entire userid
#   %n = user part of user at domain
#   %d = domain part of user at domain
#
# Example:
#   password_query = SELECT password FROM users WHERE userid = '%n' AND domain = '%d'
#   password_query = SELECT password FROM users WHERE userid = '%u' AND active = 'Y'
#
#password_query = SELECT password FROM users WHERE userid = '%u'

# Query to retrieve the user information.
#
# The query must return only one row. The columns to return are:
#   home - Home directory
#   mail - MAIL environment
#   system_user - System user name (for initgroups())
#   uid - System UID
#   gid - System GID
#
# Either home or mail is required. uid and gid are required. If more than one
# row is returned or there's missing fields, login will automatically fail.
#
# Examples
#   user_query = SELECT home, uid, gid FROM users WHERE userid = '%n' AND domain = '%d'
#   user_query = SELECT dir AS home, user AS uid, group AS gid FROM users where userid = '%u'
#   user_query = SELECT home, 501 AS uid, 501 AS gid FROM users WHERE userid = '%u'
#
#user_query = SELECT home, uid, gid FROM users WHERE userid = '%u'

Index: Makefile.am
===================================================================
RCS file: /home/cvs/dovecot/doc/Makefile.am,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -d -r1.6 -r1.7
--- Makefile.am	8 Nov 2003 14:47:39 -0000	1.6
+++ Makefile.am	10 May 2004 01:47:08 -0000	1.7
@@ -14,5 +14,6 @@
 	mkcert.sh \
 	dovecot-openssl.cnf \
 	dovecot-ldap.conf \
+	dovecot-mysql.conf \
 	dovecot-pgsql.conf \
 	$(doc_DATA)