source: openpam/www/errata.html @ 331

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

Nits.

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 6.5 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 331 2002-02-09 15:43:45Z des $
8  -->
9<html>
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="menuheading">Documentation</p>
26          <p class="menuitem"><a href="errata.html">XSSO Errata</a></p>
27        </td>
28        <td valign="top" rowspan="2" class="main">
29          <h1>XSSO Errata</h1>
30
31          <p>The following is a list of errors discovered in the XSSO
32            document during the development of OpenPAM.</p>
33
34          <dl>
35            <dt>p. 25</dt>
36            <dd>The first member of <tt class="code">struct
37              pam_response</tt> is named <tt class="code">resp</tt>,
38              not <tt class="code">response</tt>.</dd>
39
40            <dt>p. 28</dt>
41            <dd>The first <tt class="code">pam_sm_chauthtok()</tt>
42              flag is <tt class="code">PAM_PRELIM_CHECK</tt>, not <tt
43              class="code">PAM_CRED_PRELIM_CHECK</tt>.</dd>
44
45            <dt>p. 32</dt>
46            <dd><tt class="code">PAM_NEW_AUTHTOKEN_REQD</tt> in the
47              DESCRIPTION and RETURN VALUE sections should be <tt
48              class="code">PAM_NEW_AUTHTOK_REQD</tt>.</dd>
49
50            <dt>p. 32</dt>
51            <dd><tt class="code">pam_acct_mgmt()</tt> must be allowed
52              to return <tt class="code">PAM_AUTH_ERR</tt>.</dd>
53
54            <dt>p. 46</dt>
55            <dd><tt class="code">PAM_AUTHOK</tt> and <tt
56              class="code">PAM_OLDAUTHOK</tt> in the DESCRIPTION
57              section should be <tt class="code">PAM_AUTHTOK</tt> and
58              <tt class="code">PAM_OLDAUTHTOK</tt>, respectively.</dd>
59
60            <dt>p. 60</dt>
61            <dd><tt class="code">PAM_AUTHOK</tt> and <tt
62              class="code">PAM_OLDAUTHOK</tt> in the DESCRIPTION
63              section should be <tt class="code">PAM_AUTHTOK</tt> and
64              <tt class="code">PAM_OLDAUTHTOK</tt>, respectively.</dd>
65
66            <dt>p. 62</dt>
67            <dd>The <tt class="code">target_authtok_len</tt> argument to
68              <tt class="code">pam_set_mapped_authtok()</tt> is of
69              type <tt class="code">size_t</tt>, not <tt
70              class="code">size_t *</tt>.</dd>
71
72            <dt>p. 52</dt>
73            <dd><tt class="code">PAM_CONV_ERR</tt> is listed out of
74              order and with the explanatory text "Conversation
75              failure" instead of "Conversation error".  It is listed
76              correctly on the next page.</dd>
77
78            <dt>p. 59</dt>
79            <dd>The last argument <tt class="code">pam_set_data()</tt>
80              should be written <tt class="code">void
81              (*cleanup)(...)</tt>, not <tt class="code">void
82              *(cleanup)(...)</tt>.</dd>
83
84            <dt>p. 66</dt>
85            <dd>The first occurrence of <tt
86              class="code">pam_acct_mgmt</tt> in the NAME section
87              should be <tt class="code">pam_sm_acct_mgmt</tt>.</dd>
88
89            <dt>p. 66</dt>
90            <dd><tt class="code">pam_sm_acct_mgmt()</tt> must be
91              allowed to return <tt
92              class="code">PAM_AUTH_ERR</tt>.</dd>
93
94            <dt>p. 70</dt>
95            <dd><tt class="code">pam_authenticate_secondary</tt> in
96              the SYNOPSIS section should be <tt
97              class="code">pam_sm_authenticate_secondary</tt>.
98              <tt class="code">pam_sm_authenticate_secondary()</tt>
99              should take <tt class="code">argc</tt> and <tt
100              class="code">argv</tt> arguments like the rest of the
101              <tt class="code">pam_sm_*()</tt> functions.</dd>
102
103            <dt>p. 72</dt>
104            <dd>The flags argument to <tt
105              class="code">pam_sm_chauthtok()</tt> is of type <tt
106              class="code">int</tt>, not <tt class="code">const
107              int</tt>.</dd>
108
109            <dt>p. 77</dt>
110            <dd>The names of several arguments to
111              <tt class="code">pam_sm_get_mapped_authtok()</tt> are
112              missing the initial "t" in "target".</dd>
113
114            <dt>p. 83</dt>
115            <dd>The <tt class="code">target_authtok_len</tt> argument
116              to <tt class="code">pam_sm_set_mapped_authtok()</tt> is
117              of type <tt class="code">size_t</tt>, not a <tt
118              class="code">size_t *</tt>.</dd>
119
120            <dt>p. 85</dt>
121            <dd>The names of several arguments to
122              <tt class="code">pam_sm_set_mapped_username()</tt> are
123              missing the initial "t" in "target".</dd>
124
125            <dt>p. 89</dt>
126            <dd>The user argument to <tt class="code">pam_start()</tt>
127              is of type const <tt class="code">char *</tt>.</dd>
128
129            <dt>p. 89</dt>
130            <dd>The correct definition for <tt class="code">struct
131              pam_conv</tt> is as follows:<pre class="code">
132struct pam_conv {
133        int     (*conv)(int, struct pam_message **,
134                    struct pam_response **, void *);
135        void    *appdata_ptr;
136};</pre></dd>
137
138            <dt>p. 90</dt>
139            <dd>The correct definition for <tt class="code">struct
140              pam_response</tt> is as follows:<pre class="code">
141struct pam_response {
142        char    *resp;
143        int      resp_retcode;
144};</pre></dd>
145
146            <dt>p. 90</dt>
147            <dd>The last sentence of the DESCRIPTION section should refer to
148              <tt class="code">pam_set_data()</tt> rather than <tt
149              class="code">pam_set_item()</tt>.</dd>
150          </dl>
151        </td>
152      </tr>
153      <tr>
154        <td width="164" align="center" valign="top" class="buttons">
155          <p><a href="http://condb.sourceforge.net/"><img src="img/openpam-icon.png" width="88" height="31" border="0" alt="condb logo"/></a></p>
156          <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>
157          <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>
158          <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>
159        </td>
160      </tr>
161      <!--tr>
162        <td width="164">&nbsp;</td>
163        <td align="center" valign="bottom" class="footer">
164          <p><em>Copyright (c) 2002 ThinkSec AS.  All rights reserved.</em></p>
165        </td>
166      </tr-->
167    </table>
168  </body>
169</html>
Note: See TracBrowser for help on using the repository browser.