Tweak documentation for pam_console (#31877).

Package-Manager: portage-2.0.51.19

4 files changed, 48 insertions, 37 deletions

diff --git a/sys-libs/pam/ChangeLog b/sys-libs/pam/ChangeLog
index bfc959f63007..96ffa6a3b701 100644
--- a/sys-libs/pam/ChangeLog
+++ b/sys-libs/pam/ChangeLog
@@ -1,6 +1,10 @@
 # ChangeLog for sys-libs/pam
 # Copyright 2002-2005 Gentoo Foundation; Distributed under the GPL v2
-# $Header: /var/cvsroot/gentoo-x86/sys-libs/pam/ChangeLog,v 1.84 2005/07/07 19:46:03 corsair Exp $
+# $Header: /var/cvsroot/gentoo-x86/sys-libs/pam/ChangeLog,v 1.85 2005/07/08 07:47:56 greg_g Exp $
+
+  08 Jul 2005; Gregorio Guidi <greg_g@gentoo.org> files/README.pam_console,
+  pam-0.78-r2.ebuild:
+  Tweak documentation for pam_console (#31877).
 
   07 Jul 2005; Markus Rothe <corsair@gentoo.org> pam-0.78-r2.ebuild:
   Stable on ppc64
diff --git a/sys-libs/pam/Manifest b/sys-libs/pam/Manifest
index 6eace03c60f5..bb9afd7993ee 100644
--- a/sys-libs/pam/Manifest
+++ b/sys-libs/pam/Manifest
@@ -1,39 +1,29 @@
------BEGIN PGP SIGNED MESSAGE-----
-Hash: SHA1
-
-MD5 45e4ffa616491f670f6b43f7482889e7 pam-0.77-r6.ebuild 8080
+MD5 c1bc40f3becae42b69e9aaa00978ca36 pam-0.77-r7.ebuild 8068
+MD5 a2841aed626bce9793c2583d1a22cef2 pam-0.78-r1.ebuild 9939
 MD5 1d05f0436f1c273d7862099f309afe4d metadata.xml 156
-MD5 c3f5aee94d17c63381b7a8ba81df0f40 pam-0.77-r1.ebuild 7500
+MD5 45e4ffa616491f670f6b43f7482889e7 pam-0.77-r6.ebuild 8080
 MD5 4d2b29a9e809cb02f1cfe9fff7266f21 pam-0.77-r4.ebuild 7834
-MD5 ff81a075c6aa014c7ef0c12fd5b7b184 pam-0.77-r2.ebuild 7784
 MD5 d6f6914fedb8a4a20a6de8965bd98304 pam-0.77-r8.ebuild 8237
-MD5 c1bc40f3becae42b69e9aaa00978ca36 pam-0.77-r7.ebuild 8068
-MD5 261bcf08fa203b4f49ae1da4e548ddb7 pam-0.77-r3.ebuild 7833
-MD5 f50265fdbc063e1f2e21fae1c2481f44 pam-0.77.ebuild 7449
 MD5 11800e877d380cc4453b83c8faa5e3b7 pam-0.78.ebuild 9592
-MD5 16099306907820ed44d8a8da21f03983 pam-0.78-r2.ebuild 11121
-MD5 32da0d9be5eed87ec0accc4c78b3f600 ChangeLog 13846
-MD5 a2841aed626bce9793c2583d1a22cef2 pam-0.78-r1.ebuild 9939
-MD5 7abfe66b5996b628696d244d462e47b0 files/digest-pam-0.77-r3 201
-MD5 693d0527279f95e01ad9a5ba6ef45389 files/digest-pam-0.77-r8 201
-MD5 028c285db4076f549774c258d0eddcfc files/digest-pam-0.77 201
-MD5 21390b7acb42d4c22215492782e98f5e files/digest-pam-0.78-r1 200
+MD5 e78ea1c0307867c4990afa621009711e ChangeLog 13992
+MD5 f50265fdbc063e1f2e21fae1c2481f44 pam-0.77.ebuild 7449
+MD5 ff81a075c6aa014c7ef0c12fd5b7b184 pam-0.77-r2.ebuild 7784
+MD5 261bcf08fa203b4f49ae1da4e548ddb7 pam-0.77-r3.ebuild 7833
+MD5 9a38495a0da43f578bcf6100caa4c3e1 pam-0.78-r2.ebuild 11307
+MD5 c3f5aee94d17c63381b7a8ba81df0f40 pam-0.77-r1.ebuild 7500
+MD5 73f196808b2658496c9a9bd525ca30da files/README.pam_console 2615
 MD5 028c285db4076f549774c258d0eddcfc files/digest-pam-0.77-r1 201
-MD5 92aced5acf4c59db3039da332ca1c47e files/digest-pam-0.78 200
+MD5 c0fd7f7bf69f4f0effdfc66eed6d6ed2 files/digest-pam-0.77-r4 201
+MD5 7abfe66b5996b628696d244d462e47b0 files/digest-pam-0.77-r3 201
+MD5 b38aa656e6c205427dd4c4ba7d6d3f97 files/digest-pam-0.77-r6 201
 MD5 f6222db3bcd34dad4edfcdcd8e488920 files/digest-pam-0.78-r2 264
+MD5 028c285db4076f549774c258d0eddcfc files/digest-pam-0.77 201
 MD5 69f8cfad7f241eb669085eaa753cd9dd files/pam-0.77-console-reset.patch 1826
+MD5 92aced5acf4c59db3039da332ca1c47e files/digest-pam-0.78 200
+MD5 693d0527279f95e01ad9a5ba6ef45389 files/digest-pam-0.77-r8 201
 MD5 7abfe66b5996b628696d244d462e47b0 files/digest-pam-0.77-r2 201
 MD5 41e8f5fddbc8e00ebfdc3aeadbf7c50e files/digest-pam-0.77-r7 201
-MD5 b38aa656e6c205427dd4c4ba7d6d3f97 files/digest-pam-0.77-r6 201
-MD5 c0fd7f7bf69f4f0effdfc66eed6d6ed2 files/digest-pam-0.77-r4 201
-MD5 c3f9e8ddddd908bd83aa6859d279dd7d files/README.pam_console 2096
 MD5 652f6b0ebdc63b0aa9ca6e1783c468a1 files/pam_env.conf 2980
+MD5 21390b7acb42d4c22215492782e98f5e files/digest-pam-0.78-r1 200
 MD5 2d840b9afde7319bc8a8f7676582af11 files/pam.d/other 139
 MD5 33d9efd092b6999143ea42c99a59bfb1 files/pam.d/system-auth 365
------BEGIN PGP SIGNATURE-----
-Version: GnuPG v1.4.1 (GNU/Linux)
-
-iD8DBQFCzadSgIKl8Uu19MoRAgdGAJ4va+ISoAym/96CzuEOq+Kw7ihsjwCePesm
-NREPhHxPYyIG562hOkVH2u4=
-=LbOD
------END PGP SIGNATURE-----
diff --git a/sys-libs/pam/files/README.pam_console b/sys-libs/pam/files/README.pam_console
index 129f9aef9a3b..66f80c83c950 100644
--- a/sys-libs/pam/files/README.pam_console
+++ b/sys-libs/pam/files/README.pam_console
@@ -25,14 +25,22 @@ have to be members of the audio group to access audio devices).
 However, Gentoo gives you the possibility to enable pam_console, you just have
 to follow these advices:
 
-1) In /etc/pam.d/login, add the following line:
+1) Make sure you compiled sys-libs/pam with USE="pam_console", otherwise the
+   pam_console module will not be built.
 
-  session    optional     /lib/security/pam_console.so
+2) In /etc/pam.d/login, add the following line:
+
+  session    optional     pam_console.so
 
    Thus, pam_console will apply permissions from /etc/security/console.perms
-   when you log in.
+   when you log in in text consoles.
+   Do the same with /etc/pam.d/xdm if you login through xdm, with /etc/pam.d/kde
+   if you login through kdm, and so on.
+
+   Alternatively (but not recommended), you can add the line above to
+   /etc/pam.d/system-auth so that pam_console will be enabled everywhere.
    
-2) If you're using devfs, add the following lines in /etc/devfsd.conf:
+3) If you're using devfs, add the following lines in /etc/devfsd.conf:
 
   REGISTER  .*  CFUNCTION /lib/security/pam_console_apply_devfsd.so\
                     pam_console_apply_single $devpath
@@ -40,12 +48,12 @@ to follow these advices:
    In this way, permissions from /etc/security/console.perms will be applied
    also to those devices that are created dynamically.
 
-3) If you're using udev, create a file in /etc/dev.d/default/ ending with
+4) If you're using udev, create a file in /etc/dev.d/default/ ending with
    '.dev', for instance /etc/dev.d/default/pam_console.dev, containing the
    following lines:
 
-   #!/bin/sh
-   exec /sbin/pam_console_apply
+  #!/bin/sh
+  exec /sbin/pam_console_apply
  
    and make it executable:
 
@@ -54,5 +62,7 @@ to follow these advices:
    In this way, pam_console will reevaluate permissions from
    /etc/security/console.perms each time a device is dynamically created.
 
-4) Tweak /etc/security/console.perms to your own needs.
+   Another possible way to obtain the same result is to use the RUN key
+   in udev rules (see the udev documentation for more info).
 
+5) Tweak /etc/security/console.perms to your own needs.
diff --git a/sys-libs/pam/pam-0.78-r2.ebuild b/sys-libs/pam/pam-0.78-r2.ebuild
index 102d222e2eb4..c8c9b0fcc071 100644
--- a/sys-libs/pam/pam-0.78-r2.ebuild
+++ b/sys-libs/pam/pam-0.78-r2.ebuild
@@ -1,6 +1,6 @@
 # Copyright 1999-2005 Gentoo Foundation
 # Distributed under the terms of the GNU General Public License v2
-# $Header: /var/cvsroot/gentoo-x86/sys-libs/pam/pam-0.78-r2.ebuild,v 1.19 2005/07/07 22:05:18 vapier Exp $
+# $Header: /var/cvsroot/gentoo-x86/sys-libs/pam/pam-0.78-r2.ebuild,v 1.20 2005/07/08 07:47:56 greg_g Exp $
 
 FORCE_SYSTEMAUTH_UPDATE="no"
 
@@ -378,4 +378,11 @@ pkg_postinst() {
 			rm -f ${ROOT}/etc/pam.d/system-auth.new
 		fi
 	fi
+
+	if use pam_console; then
+		echo
+		einfo "If you want to enable the pam_console module, please follow"
+		einfo "the instructions in /usr/share/doc/${PF}/README.pam_console."
+		echo
+	fi
 }