Gecko [ nbspublicschool.com ]

Name	Size	Permission
Linux-PAM_ADG.html	8.41 KB	-rw-r--r--
Linux-PAM_MWG.html	8.59 KB	-rw-r--r--
adg-author.html	3.02 KB	-rw-r--r--
adg-copyright.html	3.54 KB	-rw-r--r--
adg-example.html	3.59 KB	-rw-r--r--
adg-files.html	2.18 KB	-rw-r--r--
adg-glossary.html	3.21 KB	-rw-r--r--
adg-interface-by-app-expected....	61.01 KB	-rw-r--r--
adg-interface-of-app-expected....	8.26 KB	-rw-r--r--
adg-interface-programming-note...	2.55 KB	-rw-r--r--
adg-interface.html	4.9 KB	-rw-r--r--
adg-introduction-description.h...	3.29 KB	-rw-r--r--
adg-introduction-synopsis.html	2.62 KB	-rw-r--r--
adg-introduction.html	2.01 KB	-rw-r--r--
adg-libpam-functions.html	13.13 KB	-rw-r--r--
adg-libpam_misc.html	3.34 KB	-rw-r--r--
adg-overview.html	8.16 KB	-rw-r--r--
adg-porting.html	4.2 KB	-rw-r--r--
adg-security-conv-function.htm...	2.29 KB	-rw-r--r--
adg-security-library-calls.htm...	3.13 KB	-rw-r--r--
adg-security-resources.html	2.83 KB	-rw-r--r--
adg-security-service-name.html	4.43 KB	-rw-r--r--
adg-security-user-identity.htm...	5.38 KB	-rw-r--r--
adg-security.html	3.73 KB	-rw-r--r--
adg-see-also.html	2.16 KB	-rw-r--r--
mwg-author.html	3 KB	-rw-r--r--
mwg-copyright.html	3.52 KB	-rw-r--r--
mwg-example.html	1.96 KB	-rw-r--r--
mwg-expected-by-module-item.ht...	45.36 KB	-rw-r--r--
mwg-expected-by-module-other.h...	8.15 KB	-rw-r--r--
mwg-expected-by-module.html	4.02 KB	-rw-r--r--
mwg-expected-of-module-acct.ht...	6.05 KB	-rw-r--r--
mwg-expected-of-module-auth.ht...	10.73 KB	-rw-r--r--
mwg-expected-of-module-chautht...	7.8 KB	-rw-r--r--
mwg-expected-of-module-overvie...	6.28 KB	-rw-r--r--
mwg-expected-of-module-session...	6.98 KB	-rw-r--r--
mwg-expected-of-module.html	4.27 KB	-rw-r--r--
mwg-introduction-description.h...	3.88 KB	-rw-r--r--
mwg-introduction-synopsis.html	1.98 KB	-rw-r--r--
mwg-introduction.html	1.98 KB	-rw-r--r--
mwg-see-also.html	2.18 KB	-rw-r--r--
mwg-see-options.html	2.92 KB	-rw-r--r--
mwg-see-programming-libs.html	2.94 KB	-rw-r--r--
mwg-see-programming-sec.html	8.92 KB	-rw-r--r--
mwg-see-programming-syslog.htm...	4.63 KB	-rw-r--r--
mwg-see-programming.html	3 KB	-rw-r--r--

Code Editor : mwg-expected-of-module-session.html

<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>3.4. Session management</title><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="Linux-PAM_MWG.html" title="The Linux-PAM Module Writers' Guide"><link rel="up" href="mwg-expected-of-module.html" title="Chapter 3. What is expected of a module"><link rel="prev" href="mwg-expected-of-module-acct.html" title="3.3. Account management"><link rel="next" href="mwg-expected-of-module-chauthtok.html" title="3.5. Authentication token management"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.4. Session management</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="mwg-expected-of-module-acct.html">Prev</a> </td><th width="60%" align="center">Chapter 3. What is expected of a module</th><td width="20%" align="right"> <a accesskey="n" href="mwg-expected-of-module-chauthtok.html">Next</a></td></tr></table><hr></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="mwg-expected-of-module-session"></a>3.4. Session management</h2></div></div></div><p>
        To be correctly initialized, <em class="parameter"><code>PAM_SM_SESSION</code></em>
        must be <span class="command"><strong>#define</strong></span>'d prior to including
        <code class="function">&lt;security/pam_modules.h&gt;</code>. This will
        ensure that the prototypes for static modules are properly declared.
      </p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="mwg-pam_sm_open_session"></a>3.4.1. Service function to start session management</h3></div></div></div><div class="funcsynopsis"><pre class="funcsynopsisinfo">#define PAM_SM_SESSION</pre><pre class="funcsynopsisinfo">#include &lt;security/pam_modules.h&gt;</pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">PAM_EXTERN int <b class="fsfunc">pam_sm_open_session</b>(</code></td><td><var class="pdparam">pamh</var>, </td><td> </td></tr><tr><td> </td><td><var class="pdparam">flags</var>, </td><td> </td></tr><tr><td> </td><td><var class="pdparam">argc</var>, </td><td> </td></tr><tr><td> </td><td><var class="pdparam">argv</var><code>)</code>;</td><td> </td></tr></table><div class="paramdef-list"><code>pam_handle_t *<var class="pdparam">pamh</var></code>;<br><code>int <var class="pdparam">flags</var></code>;<br><code>int <var class="pdparam">argc</var></code>;<br><code>const char **<var class="pdparam">argv</var></code>;</div><div class="funcprototype-spacer"> </div></div><div class="section"><div class="titlepage"><div><div><h4 class="title"><a name="mwg-pam_sm_open_session-description"></a>3.4.1.1. DESCRIPTION</h4></div></div></div><p>
      The <code class="function">pam_sm_open_session</code> function is the service
      module's implementation of the
      <span class="citerefentry"><span class="refentrytitle">pam_open_session</span>(3)</span> interface.
    </p><p>
      This function is called to commence a session. The only valid
      value for <code class="varname">flags</code> is zero or:
    </p><div class="variablelist"><dl class="variablelist"><dt><span class="term">PAM_SILENT</span></dt><dd><p>
             Do not emit any messages.
          </p></dd></dl></div></div><div class="section"><div class="titlepage"><div><div><h4 class="title"><a name="mwg-pam_sm_open_session-return_values"></a>3.4.1.2. RETURN VALUES</h4></div></div></div><div class="variablelist"><dl class="variablelist"><dt><span class="term">PAM_SESSION_ERR</span></dt><dd><p>
            Cannot make/remove an entry for the specified session.
          </p></dd><dt><span class="term">PAM_SUCCESS</span></dt><dd><p>
             The session was successfully started.
          </p></dd></dl></div></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="mwg-pam_sm_close_session"></a>3.4.2. Service function to terminate session management</h3></div></div></div><div class="funcsynopsis"><pre class="funcsynopsisinfo">#define PAM_SM_SESSION</pre><pre class="funcsynopsisinfo">#include &lt;security/pam_modules.h&gt;</pre><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">PAM_EXTERN int <b class="fsfunc">pam_sm_close_session</b>(</code></td><td><var class="pdparam">pamh</var>, </td><td> </td></tr><tr><td> </td><td><var class="pdparam">flags</var>, </td><td> </td></tr><tr><td> </td><td><var class="pdparam">argc</var>, </td><td> </td></tr><tr><td> </td><td><var class="pdparam">argv</var><code>)</code>;</td><td> </td></tr></table><div class="paramdef-list"><code>pam_handle_t *<var class="pdparam">pamh</var></code>;<br><code>int <var class="pdparam">flags</var></code>;<br><code>int <var class="pdparam">argc</var></code>;<br><code>const char **<var class="pdparam">argv</var></code>;</div><div class="funcprototype-spacer"> </div></div><div class="section"><div class="titlepage"><div><div><h4 class="title"><a name="mwg-pam_sm_close_session-description"></a>3.4.2.1. DESCRIPTION</h4></div></div></div><p>
      The <code class="function">pam_sm_close_session</code> function is the service
      module's implementation of the
      <span class="citerefentry"><span class="refentrytitle">pam_close_session</span>(3)</span> interface.
    </p><p>
      This function is called to terminate a session. The only valid
      value for <code class="varname">flags</code> is zero or:
    </p><div class="variablelist"><dl class="variablelist"><dt><span class="term">PAM_SILENT</span></dt><dd><p>
             Do not emit any messages.
          </p></dd></dl></div></div><div class="section"><div class="titlepage"><div><div><h4 class="title"><a name="mwg-pam_sm_close_session-return_values"></a>3.4.2.2. RETURN VALUES</h4></div></div></div><div class="variablelist"><dl class="variablelist"><dt><span class="term">PAM_SESSION_ERR</span></dt><dd><p>
            Cannot make/remove an entry for the specified session.
          </p></dd><dt><span class="term">PAM_SUCCESS</span></dt><dd><p>
             The session was successfully terminated.
          </p></dd></dl></div></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="mwg-expected-of-module-acct.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="mwg-expected-of-module.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="mwg-expected-of-module-chauthtok.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">3.3. Account management </td><td width="20%" align="center"><a accesskey="h" href="Linux-PAM_MWG.html">Home</a></td><td width="40%" align="right" valign="top"> 3.5. Authentication token management</td></tr></table></div></body></html>

${this.title}

Code Editor : mwg-expected-of-module-session.html