Checkpoint commit: add sample application, mess with bibliography.

svn path=/head/; revision=13323

en_US.ISO8859-1/articles/pam/article.sgml

@@ -4,7 +4,7 @@
 ]>
 
 <!--
-  - Copyright (c) 2001,2002 Networks Associates Technologies, Inc.
+  - Copyright (c) 2001,2002 Networks Associates Technology, Inc.
   - All rights reserved.
   -
   - This software was developed for the FreeBSD Project by ThinkSec AS and
@@ -830,7 +830,15 @@ sshd    password required       pam_permit.so</programlisting>
   <appendix id="pam-sample-module">
     <title id="pam-sample-module.title">Sample PAM module</title>
 
-    <para><!--XXX-->This section has not yet been written.</para>
+    <para>The following is a minimal implementation of
+      &man.pam.unix.8;, offering only authentication services.  It
+      should build and run with most PAM implementations, but takes
+      advantage of OpenPAM extensions if available: note the use of
+      &man.pam.get.authtok.3;, which enormously simplifies prompting
+      the user for a password.</para>
+
+<programlisting><inlinegraphic fileref="pam_module.c"
+  format="linespecific"></programlisting>
   </appendix>
 
   <bibliography id="pam-further">
@@ -892,10 +900,8 @@ sshd    password required       pam_permit.so</programlisting>
 
 	<author>
 	  <surname>Morgan</surname>
-
 	  <firstname>Andrew</firstname>
-
-	  <othername>G.</othername>
+	  <othername role="mi">G.</othername>
 	</author>
 
 	<pubdate>October 6, 1999</pubdate>
@@ -910,9 +916,6 @@ sshd    password required       pam_permit.so</programlisting>
 	  url="http://www.sun.com/software/solaris/pam/pam.admin.pdf">PAM
 	  Administration</ulink></title>
 	<orgname>Sun Microsystems</orgname>
-
-	<!-- an introduction to configuring and using PAM, from Sun
-	-->
       </biblioentry>
     </bibliodiv>
 
@@ -920,15 +923,29 @@ sshd    password required       pam_permit.so</programlisting>
       <title>Related Web pages</title>
 
       <biblioentry>
-	<title><ulink url="http://openpam.sourceforge.net/">OpenPAM at
-	  Source Forge</ulink></title>
+	<title><ulink url="http://openpam.sourceforge.net/">OpenPAM homepage</ulink></title>
 
 	<author>
-	  <lastname>Sm&oslash;rgrav</lastname>
-
+	  <surname>Sm&oslash;rgrav</surname>
 	  <firstname>Dag-Erling</firstname>
 	</author>
       </biblioentry>
+
+      <biblioentry>
+	<title><ulink url="http://www.kernel.org/pub/linux/libs/pam/">Linux-PAM homepage</ulink></title>
+
+	<author>
+	  <surname>Morgan</surname>
+	  <firstname>Andrew</firstname>
+	  <othername role="mi">G.</othername>
+	</author>
+      </biblioentry>
+
+      <biblioentry>
+	<title><ulink url="http://wwws.sun.com/software/solaris/pam/">Solaris PAM homepage</ulink></title>
+
+	<orgname>Sun Microsystems</orgname>
+      </biblioentry>
     </bibliodiv>
   </bibliography>
 </article>