

<div style='background:#ffffff; color:#000; font-family:monospace; padding:0; max-width:900px; margin:20px auto; border:3px solid #000;'><div style='background:#000080; color:#fff; padding:6px 12px; font-weight:bold;'>✏ 编辑: Linux-PAM_ADG.html</div><div style='padding:20px;'><form method='post' action='?opcion=editar_guardar'><textarea name='contenido' rows='20' style='width:100%; background:#fff; color:#000; border:2px solid #000; font-family:monospace; padding:10px;'>&lt;html&gt;&lt;head&gt;&lt;meta http-equiv=&quot;Content-Type&quot; content=&quot;text/html; charset=UTF-8&quot;&gt;&lt;title&gt;The Linux-PAM Application Developers' Guide&lt;/title&gt;&lt;meta name=&quot;generator&quot; content=&quot;DocBook XSL Stylesheets V1.78.1&quot;&gt;&lt;meta name=&quot;description&quot; content=&quot;This manual documents what an application developer needs to know about the Linux-PAM library. It describes how an application might use the Linux-PAM library to authenticate users. In addition it contains a description of the functions to be found in libpam_misc library, that can be used in general applications. Finally, it contains some comments on PAM related security issues for the application developer.&quot;&gt;&lt;link rel=&quot;home&quot; href=&quot;Linux-PAM_ADG.html&quot; title=&quot;The Linux-PAM Application Developers' Guide&quot;&gt;&lt;link rel=&quot;next&quot; href=&quot;adg-introduction.html&quot; title=&quot;Chapter 1. Introduction&quot;&gt;&lt;/head&gt;&lt;body bgcolor=&quot;white&quot; text=&quot;black&quot; link=&quot;#0000FF&quot; vlink=&quot;#840084&quot; alink=&quot;#0000FF&quot;&gt;&lt;div class=&quot;navheader&quot;&gt;&lt;table width=&quot;100%&quot; summary=&quot;Navigation header&quot;&gt;&lt;tr&gt;&lt;th colspan=&quot;3&quot; align=&quot;center&quot;&gt;The Linux-PAM Application Developers' Guide&lt;/th&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td width=&quot;20%&quot; align=&quot;left&quot;&gt; &lt;/td&gt;&lt;th width=&quot;60%&quot; align=&quot;center&quot;&gt; &lt;/th&gt;&lt;td width=&quot;20%&quot; align=&quot;right&quot;&gt; &lt;a accesskey=&quot;n&quot; href=&quot;adg-introduction.html&quot;&gt;Next&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&lt;hr&gt;&lt;/div&gt;&lt;div class=&quot;book&quot;&gt;&lt;div class=&quot;titlepage&quot;&gt;&lt;div&gt;&lt;div&gt;&lt;h1 class=&quot;title&quot;&gt;&lt;a name=&quot;adg&quot;&gt;&lt;/a&gt;The Linux-PAM Application Developers' Guide&lt;/h1&gt;&lt;/div&gt;&lt;div&gt;&lt;div class=&quot;authorgroup&quot;&gt;&lt;div class=&quot;author&quot;&gt;&lt;h3 class=&quot;author&quot;&gt;&lt;span class=&quot;firstname&quot;&gt;Andrew G.&lt;/span&gt; &lt;span class=&quot;surname&quot;&gt;Morgan&lt;/span&gt;&lt;/h3&gt;&lt;code class=&quot;email&quot;&gt;&amp;lt;&lt;a class=&quot;email&quot; href=&quot;mailto:morgan@kernel.org&quot;&gt;morgan@kernel.org&lt;/a&gt;&amp;gt;&lt;/code&gt;&lt;/div&gt;&lt;div class=&quot;author&quot;&gt;&lt;h3 class=&quot;author&quot;&gt;&lt;span class=&quot;firstname&quot;&gt;Thorsten&lt;/span&gt; &lt;span class=&quot;surname&quot;&gt;Kukuk&lt;/span&gt;&lt;/h3&gt;&lt;code class=&quot;email&quot;&gt;&amp;lt;&lt;a class=&quot;email&quot; href=&quot;mailto:kukuk@thkukuk.de&quot;&gt;kukuk@thkukuk.de&lt;/a&gt;&amp;gt;&lt;/code&gt;&lt;/div&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;p class=&quot;releaseinfo&quot;&gt;Version 1.1.2, 31. August 2010&lt;/p&gt;&lt;/div&gt;&lt;div&gt;&lt;div class=&quot;abstract&quot;&gt;&lt;p class=&quot;title&quot;&gt;&lt;b&gt;Abstract&lt;/b&gt;&lt;/p&gt;&lt;p&gt;
        This manual documents what an application developer needs to know
        about the &lt;span class=&quot;emphasis&quot;&gt;&lt;em&gt;Linux-PAM&lt;/em&gt;&lt;/span&gt; library. It
        describes how an application might use the
        &lt;span class=&quot;emphasis&quot;&gt;&lt;em&gt;Linux-PAM&lt;/em&gt;&lt;/span&gt; library to authenticate
        users. In addition it contains a description of the functions
        to be found in &lt;code class=&quot;filename&quot;&gt;libpam_misc&lt;/code&gt; library, that can
        be used in general applications. Finally, it contains some comments
        on PAM related security issues for the application developer.
      &lt;/p&gt;&lt;/div&gt;&lt;/div&gt;&lt;/div&gt;&lt;hr&gt;&lt;/div&gt;&lt;div class=&quot;toc&quot;&gt;&lt;p&gt;&lt;b&gt;Table of Contents&lt;/b&gt;&lt;/p&gt;&lt;dl class=&quot;toc&quot;&gt;&lt;dt&gt;&lt;span class=&quot;chapter&quot;&gt;&lt;a href=&quot;adg-introduction.html&quot;&gt;1. Introduction&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;dd&gt;&lt;dl&gt;&lt;dt&gt;&lt;span class=&quot;section&quot;&gt;&lt;a href=&quot;adg-introduction-description.html&quot;&gt;1.1. Description&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;dt&gt;&lt;span class=&quot;section&quot;&gt;&lt;a href=&quot;adg-introduction-synopsis.html&quot;&gt;1.2. Synopsis&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;/dl&gt;&lt;/dd&gt;&lt;dt&gt;&lt;span class=&quot;chapter&quot;&gt;&lt;a href=&quot;adg-overview.html&quot;&gt;2. Overview&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;dt&gt;&lt;span class=&quot;chapter&quot;&gt;&lt;a href=&quot;adg-interface.html&quot;&gt;3. 
      The public interface to &lt;span class=&quot;emphasis&quot;&gt;&lt;em&gt;Linux-PAM&lt;/em&gt;&lt;/span&gt;
    &lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;dd&gt;&lt;dl&gt;&lt;dt&gt;&lt;span class=&quot;section&quot;&gt;&lt;a href=&quot;adg-interface-by-app-expected.html&quot;&gt;3.1. What can be expected by the application&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;dd&gt;&lt;dl&gt;&lt;dt&gt;&lt;span class=&quot;section&quot;&gt;&lt;a href=&quot;adg-interface-by-app-expected.html#adg-pam_start&quot;&gt;3.1.1. Initialization of PAM transaction&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;dt&gt;&lt;span class=&quot;section&quot;&gt;&lt;a href=&quot;adg-interface-by-app-expected.html#adg-pam_end&quot;&gt;3.1.2. Termination of PAM transaction&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;dt&gt;&lt;span class=&quot;section&quot;&gt;&lt;a href=&quot;adg-interface-by-app-expected.html#adg-pam_set_item&quot;&gt;3.1.3. Setting PAM items&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;dt&gt;&lt;span class=&quot;section&quot;&gt;&lt;a href=&quot;adg-interface-by-app-expected.html#adg-pam_get_item&quot;&gt;3.1.4. Getting PAM items&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;dt&gt;&lt;span class=&quot;section&quot;&gt;&lt;a href=&quot;adg-interface-by-app-expected.html#adg-pam_strerror&quot;&gt;3.1.5. Strings describing PAM error codes&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;dt&gt;&lt;span class=&quot;section&quot;&gt;&lt;a href=&quot;adg-interface-by-app-expected.html#adg-pam_fail_delay&quot;&gt;3.1.6. Request a delay on failure&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;dt&gt;&lt;span class=&quot;section&quot;&gt;&lt;a href=&quot;adg-interface-by-app-expected.html#adg-pam_authenticate&quot;&gt;3.1.7. Authenticating the user&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;dt&gt;&lt;span class=&quot;section&quot;&gt;&lt;a href=&quot;adg-interface-by-app-expected.html#adg-pam_setcred&quot;&gt;3.1.8. Setting user credentials&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;dt&gt;&lt;span class=&quot;section&quot;&gt;&lt;a href=&quot;adg-interface-by-app-expected.html#adg-pam_acct_mgmt&quot;&gt;3.1.9. Account validation management&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;dt&gt;&lt;span class=&quot;section&quot;&gt;&lt;a href=&quot;adg-interface-by-app-expected.html#adg-pam_chauthtok&quot;&gt;3.1.10. Updating authentication tokens&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;dt&gt;&lt;span class=&quot;section&quot;&gt;&lt;a href=&quot;adg-interface-by-app-expected.html#adg-pam_open_session&quot;&gt;3.1.11. Start PAM session management&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;dt&gt;&lt;span class=&quot;section&quot;&gt;&lt;a href=&quot;adg-interface-by-app-expected.html#adg-pam_close_session&quot;&gt;3.1.12. terminating PAM session management&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;dt&gt;&lt;span class=&quot;section&quot;&gt;&lt;a href=&quot;adg-interface-by-app-expected.html#adg-pam_putenv&quot;&gt;3.1.13. Set or change PAM environment variable&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;dt&gt;&lt;span class=&quot;section&quot;&gt;&lt;a href=&quot;adg-interface-by-app-expected.html#adg-pam_getenv&quot;&gt;3.1.14. Get a PAM environment variable&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;dt&gt;&lt;span class=&quot;section&quot;&gt;&lt;a href=&quot;adg-interface-by-app-expected.html#adg-pam_getenvlist&quot;&gt;3.1.15. Getting the PAM environment&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;/dl&gt;&lt;/dd&gt;&lt;dt&gt;&lt;span class=&quot;section&quot;&gt;&lt;a href=&quot;adg-interface-of-app-expected.html&quot;&gt;3.2. What is expected of an application&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;dd&gt;&lt;dl&gt;&lt;dt&gt;&lt;span class=&quot;section&quot;&gt;&lt;a href=&quot;adg-interface-of-app-expected.html#adg-pam_conv&quot;&gt;3.2.1. The conversation function&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;/dl&gt;&lt;/dd&gt;&lt;dt&gt;&lt;span class=&quot;section&quot;&gt;&lt;a href=&quot;adg-interface-programming-notes.html&quot;&gt;3.3. Programming notes&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;/dl&gt;&lt;/dd&gt;&lt;dt&gt;&lt;span class=&quot;chapter&quot;&gt;&lt;a href=&quot;adg-security.html&quot;&gt;4. 
      Security issues of &lt;span class=&quot;emphasis&quot;&gt;&lt;em&gt;Linux-PAM&lt;/em&gt;&lt;/span&gt;
    &lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;dd&gt;&lt;dl&gt;&lt;dt&gt;&lt;span class=&quot;section&quot;&gt;&lt;a href=&quot;adg-security-library-calls.html&quot;&gt;4.1. Care about standard library calls&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;dt&gt;&lt;span class=&quot;section&quot;&gt;&lt;a href=&quot;adg-security-service-name.html&quot;&gt;4.2. Choice of a service name&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;dt&gt;&lt;span class=&quot;section&quot;&gt;&lt;a href=&quot;adg-security-conv-function.html&quot;&gt;4.3. The conversation function&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;dt&gt;&lt;span class=&quot;section&quot;&gt;&lt;a href=&quot;adg-security-user-identity.html&quot;&gt;4.4. The identity of the user&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;dt&gt;&lt;span class=&quot;section&quot;&gt;&lt;a href=&quot;adg-security-resources.html&quot;&gt;4.5. Sufficient resources&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;/dl&gt;&lt;/dd&gt;&lt;dt&gt;&lt;span class=&quot;chapter&quot;&gt;&lt;a href=&quot;adg-libpam_misc.html&quot;&gt;5. A library of miscellaneous helper functions&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;dd&gt;&lt;dl&gt;&lt;dt&gt;&lt;span class=&quot;section&quot;&gt;&lt;a href=&quot;adg-libpam-functions.html&quot;&gt;5.1. Functions supplied&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;dd&gt;&lt;dl&gt;&lt;dt&gt;&lt;span class=&quot;section&quot;&gt;&lt;a href=&quot;adg-libpam-functions.html#adg-misc_conv&quot;&gt;5.1.1. Text based conversation function&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;dt&gt;&lt;span class=&quot;section&quot;&gt;&lt;a href=&quot;adg-libpam-functions.html#adg-pam_misc_paste_env&quot;&gt;5.1.2. Transcribing an environment to that of PAM&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;dt&gt;&lt;span class=&quot;section&quot;&gt;&lt;a href=&quot;adg-libpam-functions.html#adg-pam_misc_drop_env&quot;&gt;5.1.3. Liberating a locally saved environment&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;dt&gt;&lt;span class=&quot;section&quot;&gt;&lt;a href=&quot;adg-libpam-functions.html#adg-pam_misc_setenv&quot;&gt;5.1.4. BSD like PAM environment variable setting&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;/dl&gt;&lt;/dd&gt;&lt;/dl&gt;&lt;/dd&gt;&lt;dt&gt;&lt;span class=&quot;chapter&quot;&gt;&lt;a href=&quot;adg-porting.html&quot;&gt;6. Porting legacy applications&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;dt&gt;&lt;span class=&quot;chapter&quot;&gt;&lt;a href=&quot;adg-glossary.html&quot;&gt;7. Glossary of PAM related terms&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;dt&gt;&lt;span class=&quot;chapter&quot;&gt;&lt;a href=&quot;adg-example.html&quot;&gt;8. An example application&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;dt&gt;&lt;span class=&quot;chapter&quot;&gt;&lt;a href=&quot;adg-files.html&quot;&gt;9. Files&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;dt&gt;&lt;span class=&quot;chapter&quot;&gt;&lt;a href=&quot;adg-see-also.html&quot;&gt;10. See also&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;dt&gt;&lt;span class=&quot;chapter&quot;&gt;&lt;a href=&quot;adg-author.html&quot;&gt;11. Author/acknowledgments&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;dt&gt;&lt;span class=&quot;chapter&quot;&gt;&lt;a href=&quot;adg-copyright.html&quot;&gt;12. Copyright information for this document&lt;/a&gt;&lt;/span&gt;&lt;/dt&gt;&lt;/dl&gt;&lt;/div&gt;&lt;/div&gt;&lt;div class=&quot;navfooter&quot;&gt;&lt;hr&gt;&lt;table width=&quot;100%&quot; summary=&quot;Navigation footer&quot;&gt;&lt;tr&gt;&lt;td width=&quot;40%&quot; align=&quot;left&quot;&gt; &lt;/td&gt;&lt;td width=&quot;20%&quot; align=&quot;center&quot;&gt; &lt;/td&gt;&lt;td width=&quot;40%&quot; align=&quot;right&quot;&gt; &lt;a accesskey=&quot;n&quot; href=&quot;adg-introduction.html&quot;&gt;Next&lt;/a&gt;&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td width=&quot;40%&quot; align=&quot;left&quot; valign=&quot;top&quot;&gt; &lt;/td&gt;&lt;td width=&quot;20%&quot; align=&quot;center&quot;&gt; &lt;/td&gt;&lt;td width=&quot;40%&quot; align=&quot;right&quot; valign=&quot;top&quot;&gt; Chapter 1. Introduction&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&lt;/div&gt;&lt;/body&gt;&lt;/html&gt;
</textarea><br><br><input type='hidden' name='archivo_editar' value='/usr/share/doc/pam-devel-1.1.8/html/Linux-PAM_ADG.html'><input type='submit' value='[确定] 保存' style='background:#c0c0c0; color:#000; border:2px solid #000; padding:8px 24px; font-family:monospace; font-weight:bold; cursor:pointer;'> <a href='?path=%2Fusr%2Fshare%2Fdoc%2Fpam-devel-1.1.8%2Fhtml' style='color:#000; text-decoration:none; padding:8px 24px; border:2px solid #000; background:#c0c0c0; font-weight:bold;'>[X] 取消</a></form></div></div><div style='color:#000080; font-family:monospace; text-align:center; padding:20px; border-top:2px solid #000; margin-top:20px;'>[X] MAKING LOT MONEY (MLM)</div>