source: openpam/www/errata.html @ 340

Last change on this file since 340 was 340, checked in by Dag-Erling Smørgrav, 19 years ago

* empty log message *

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 6.6 KB
Line 
1<?xml version="1.0" encoding="iso-8859-1"?>
2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
3  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
4<!--
5  - Copyright (c) 2002 ThinkSec AS.  All rights reserved.
6  -
7  - $Id: errata.html 340 2002-02-12 16:34:37Z des $
8  -->
9<html xmlns="http://www.w3.org/1999/xhtml" xml.lang="en" lang="en">
10  <head>
11    <title>OpenPAM: XSSO Errata</title>
12    <link rel="stylesheet" type="text/css" href="openpam.css"/>
13  </head>
14  <body bgcolor="white" text="black" link="blue" vlink="navy" alink="red">
15    <table border="0" width="100%" cellspacing="8">
16      <tr>
17        <td width="164" align="center"><a href="http://openpam.sourceforge.net/"><img border="0" src="img/openpam-164x32.png" width="164" height="32" alt="OpenPAM logo"/></a></td>
18        <td>&nbsp;</td>
19      </tr>
20      <tr>
21        <td width="164" valign="top" class="menu">
22          <p class="menuheading">Project</p>
23          <p class="menuitem"><a href="index.html">About</a></p>
24          <p class="menuitem"><a href="http://sourceforge.net/projects/openpam/">SourceForge</a></p>
25          <p class="menuitem"><a href="http://sourceforge.net/project/showfiles.php?group_id=45677">Download</a></p>
26          <p class="menuheading">Documentation</p>
27          <p class="menuitem"><a href="errata.html">XSSO Errata</a></p>
28        </td>
29        <td valign="top" rowspan="2" class="main">
30          <h1>XSSO Errata</h1>
31
32          <p>The following is a list of errors discovered in the XSSO
33            document during the development of OpenPAM.</p>
34
35          <dl>
36            <dt>p. 25</dt>
37            <dd>The first member of <tt class="code">struct
38              pam_response</tt> is named <tt class="code">resp</tt>,
39              not <tt class="code">response</tt>.</dd>
40
41            <dt>p. 28</dt>
42            <dd>The first <tt class="code">pam_sm_chauthtok()</tt>
43              flag is <tt class="code">PAM_PRELIM_CHECK</tt>, not <tt
44              class="code">PAM_CRED_PRELIM_CHECK</tt>.</dd>
45
46            <dt>p. 32</dt>
47            <dd><tt class="code">PAM_NEW_AUTHTOKEN_REQD</tt> in the
48              DESCRIPTION and RETURN VALUE sections should be <tt
49              class="code">PAM_NEW_AUTHTOK_REQD</tt>.</dd>
50
51            <dt>p. 32</dt>
52            <dd><tt class="code">pam_acct_mgmt()</tt> must be allowed
53              to return <tt class="code">PAM_AUTH_ERR</tt>.</dd>
54
55            <dt>p. 46</dt>
56            <dd><tt class="code">PAM_AUTHOK</tt> and <tt
57              class="code">PAM_OLDAUTHOK</tt> in the DESCRIPTION
58              section should be <tt class="code">PAM_AUTHTOK</tt> and
59              <tt class="code">PAM_OLDAUTHTOK</tt>, respectively.</dd>
60
61            <dt>p. 60</dt>
62            <dd><tt class="code">PAM_AUTHOK</tt> and <tt
63              class="code">PAM_OLDAUTHOK</tt> in the DESCRIPTION
64              section should be <tt class="code">PAM_AUTHTOK</tt> and
65              <tt class="code">PAM_OLDAUTHTOK</tt>, respectively.</dd>
66
67            <dt>p. 62</dt>
68            <dd>The <tt class="code">target_authtok_len</tt> argument to
69              <tt class="code">pam_set_mapped_authtok()</tt> is of
70              type <tt class="code">size_t</tt>, not <tt
71              class="code">size_t *</tt>.</dd>
72
73            <dt>p. 52</dt>
74            <dd><tt class="code">PAM_CONV_ERR</tt> is listed out of
75              order and with the explanatory text "Conversation
76              failure" instead of "Conversation error".  It is listed
77              correctly on the next page.</dd>
78
79            <dt>p. 59</dt>
80            <dd>The last argument <tt class="code">pam_set_data()</tt>
81              should be written <tt class="code">void
82              (*cleanup)(...)</tt>, not <tt class="code">void
83              *(cleanup)(...)</tt>.</dd>
84
85            <dt>p. 66</dt>
86            <dd>The first occurrence of <tt
87              class="code">pam_acct_mgmt</tt> in the NAME section
88              should be <tt class="code">pam_sm_acct_mgmt</tt>.</dd>
89
90            <dt>p. 66</dt>
91            <dd><tt class="code">pam_sm_acct_mgmt()</tt> must be
92              allowed to return <tt
93              class="code">PAM_AUTH_ERR</tt>.</dd>
94
95            <dt>p. 70</dt>
96            <dd><tt class="code">pam_authenticate_secondary</tt> in
97              the SYNOPSIS section should be <tt
98              class="code">pam_sm_authenticate_secondary</tt>.
99              <tt class="code">pam_sm_authenticate_secondary()</tt>
100              should take <tt class="code">argc</tt> and <tt
101              class="code">argv</tt> arguments like the rest of the
102              <tt class="code">pam_sm_*()</tt> functions.</dd>
103
104            <dt>p. 72</dt>
105            <dd>The flags argument to <tt
106              class="code">pam_sm_chauthtok()</tt> is of type <tt
107              class="code">int</tt>, not <tt class="code">const
108              int</tt>.</dd>
109
110            <dt>p. 77</dt>
111            <dd>The names of several arguments to
112              <tt class="code">pam_sm_get_mapped_authtok()</tt> are
113              missing the initial "t" in "target".</dd>
114
115            <dt>p. 83</dt>
116            <dd>The <tt class="code">target_authtok_len</tt> argument
117              to <tt class="code">pam_sm_set_mapped_authtok()</tt> is
118              of type <tt class="code">size_t</tt>, not a <tt
119              class="code">size_t *</tt>.</dd>
120
121            <dt>p. 85</dt>
122            <dd>The names of several arguments to
123              <tt class="code">pam_sm_set_mapped_username()</tt> are
124              missing the initial "t" in "target".</dd>
125
126            <dt>p. 89</dt>
127            <dd>The user argument to <tt class="code">pam_start()</tt>
128              is of type const <tt class="code">char *</tt>.</dd>
129
130            <dt>p. 89</dt>
131            <dd>The correct definition for <tt class="code">struct
132              pam_conv</tt> is as follows:<pre class="code">
133struct pam_conv {
134        int     (*conv)(int, struct pam_message **,
135                    struct pam_response **, void *);
136        void    *appdata_ptr;
137};</pre></dd>
138
139            <dt>p. 90</dt>
140            <dd>The correct definition for <tt class="code">struct
141              pam_response</tt> is as follows:<pre class="code">
142struct pam_response {
143        char    *resp;
144        int      resp_retcode;
145};</pre></dd>
146
147            <dt>p. 90</dt>
148            <dd>The last sentence of the DESCRIPTION section should refer to
149              <tt class="code">pam_set_data()</tt> rather than <tt
150              class="code">pam_set_item()</tt>.</dd>
151          </dl>
152        </td>
153      </tr>
154      <tr>
155        <td width="164" align="center" valign="top" class="buttons">
156          <p><a href="http://openpam.sourceforge.net/"><img src="img/openpam-icon.png" width="88" height="31" border="0" alt="OpenPAM logo"/></a></p>
157          <p><a href="http://sourceforge.net/"><img src="http://sourceforge.net/sflogo.php?group_id=45677" width="88" height="31" border="0" alt="SourceForge Logo"/></a></p>
158          <p><a href="http://validator.w3.org/check/referer"><img border="0" src="img/valid-xhtml10.png" alt="Valid XHTML 1.0 Transitional!" height="31" width="88"/></a></p>
159          <p><a href="http://jigsaw.w3.org/css-validator/"><img border="0" src="img/valid-css.png" alt="Valid CSS!" height="31" width="88"/></a></p>
160        </td>
161      </tr>
162      <!--tr>
163        <td width="164">&nbsp;</td>
164        <td align="center" valign="bottom" class="footer">
165          <p><em>Copyright (c) 2002 ThinkSec AS.  All rights reserved.</em></p>
166        </td>
167      </tr-->
168    </table>
169  </body>
170</html>
Note: See TracBrowser for help on using the repository browser.