[dovecot-cvs] dovecot/doc auth.txt,1.2,1.3 configuration.txt,1.5,1.6

[cras at procontrol.fi]

Update of /home/cvs/dovecot/doc
In directory danu:/tmp/cvs-serv23839

Modified Files:
	auth.txt configuration.txt 
Log Message:
updates



Index: auth.txt
===================================================================
RCS file: /home/cvs/dovecot/doc/auth.txt,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -d -r1.2 -r1.3
--- auth.txt	15 Oct 2002 00:45:46 -0000	1.2
+++ auth.txt	24 Nov 2002 23:13:50 -0000	1.3
@@ -20,6 +20,36 @@
 Digest-MD5 works only with passwd-file. More mechanisms and backends can be
 easily added later.
 
+
+passwd
+------
+
+This is the most standard way to authenticate. However with shadow
+passwords some systems (Linux) don't work with this backend. At least BSDs
+still support this backend correctly.
+
+
+shadow
+------
+
+Authenticate from /etc/shadow. Works at least with Linux and Solaris.
+
+
+pam
+---
+
+PAM is the preferred authentication system nowadays with Linux. PAM handles
+only password checking, for getting the user information Dovecot still
+requires the user to exist in /etc/passwd. This requirement may be removed
+later.
+
+Here's an example /etc/pam.d/imap configuration file which uses
+/etc/imap.passwd:
+
+auth     required     pam_pwdfile.so pwdfile /etc/imap.passwd
+account  required     pam_unix.so
+
+
 passwd-file
 -----------
 

Index: configuration.txt
===================================================================
RCS file: /home/cvs/dovecot/doc/configuration.txt,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -d -r1.5 -r1.6
--- configuration.txt	24 Nov 2002 22:56:37 -0000	1.5
+++ configuration.txt	24 Nov 2002 23:13:50 -0000	1.6
@@ -103,7 +103,7 @@
 ps/top is from mmap()ed files, meaning that operating system can drop any
 of those memory pages at any time without needing to swap them. With
 Linux/x86 Dovecot usually takes about 48kB of non-mmaped memory plus ~4kB
-per cached mail, max. 16 by default, totaling to 112kB.
+per cached mail, max. 16 by default, totaling around to 112kB.
 
 
 Rootless Dovecot
@@ -112,7 +112,7 @@
 It's possible to make Dovecot run under one uid, not requiring root
 privileges at any point. This shouldn't be thought of as any security
 feature, but instead just as a way for non-admins to run imap server from
-their favourite mail computer.
+their favourite mail server.
 
 If you do think of this as a good way to achieve security, ask yourself
 which is worse:
@@ -126,7 +126,7 @@
 b) zero possibility to get root privileges through Dovecot, small
 possibility to get into system as mail user, possibly even without logging
 in, and being able to read everyone's mail (and finally getting roots by
-exploiting some local just released vulnerability, unless you bothered to
+exploiting some local just discovered vulnerability, unless you bothered to
 set up special chroot environment).
 
 Anyway, doing it is easy. configure --prefix=$HOME, make install, change