1 OpenPAM Micrampelis 2012-05-26
3 - FEATURE: Add an openpam_readword(3) function which reads the next
4 word from an input stream, applying shell quoting and escaping
5 rules. Add numerous unit tests for openpam_readword(3).
7 - FEATURE: Add an openpam_readlinev(3) function which uses the
8 openpam_readword(3) function to read words from an input stream one
9 at a time until it reaches an unquoted, unescaped newline, and
10 returns an array of those words. Add several unit tests for
13 - FEATURE: Add a PAM_HOST item which pam_start(3) initializes to the
14 machine's hostname. This was implemented in Lycopsida but
15 inadvertantly left out of the release notes.
17 - FEATURE: In pam_get_authtok(3), if neither the application nor the
18 module have specified a prompt and PAM_HOST and PAM_RHOST are both
19 defined but not equal, use a different default prompt that includes
20 PAM_USER and PAM_HOST.
22 - ENHANCE: Rewrite the policy parser to used openpam_readlinev(),
23 which greatly simplifies the code.
25 - ENHANCE: The previous implementation of the policy parser relied on
26 the openpam_readline(3) function, which (by design) munges
27 whitespace and understands neither quotes nor backslash escapes.
28 As a result of the aforementioned rewrite, whitespace, quotes and
29 backslash escapes in policy files are now handled in a consistent
30 and predictable manner.
32 - ENHANCE: On platforms that have it, use fdlopen(3) to load modules.
33 This closes the race between the ownership / permission check and
36 - ENHANCE: Reduce the amount of pointless error messages generated
37 while searching for a module.
39 - ENHANCE: Numerous documentation improvements, both in content and
42 - BUGFIX: A patch incorporated in Lycopsida inadvertantly changed
43 OpenPAM's behavior when several policies exist for the same
44 service, from ignoring all but the first to concatenating them all.
45 Revert to the original behavior.
47 - BUGFIX: Plug a memory leak in the policy parser.
48 ============================================================================
49 OpenPAM Lycopsida 2011-12-18
51 - ENHANCE: removed static build autodetection, which didn't work
52 anyway. Use an explicit, user-specified preprocessor variable
55 - ENHANCE: cleaned up the documentation a bit.
57 - ENHANCE: added openpam_subst(3), allowing certain PAM items to be
58 embedded in strings such as prompts. Apply it to the prompts used
59 by pam_get_user(3) and pam_get_authtok(3).
61 - ENHANCE: added support for the user_prompt, authtok_prompt and
62 oldauthtok_prompt module options, which override the prompts passed
63 by the module to pam_set_user(3) and pam_get_authtok(3).
65 - ENHANCE: rewrote the policy parser to support quoted option values.
67 - ENHANCE: added pamtest(1), a tool for testing modules and policies.
69 - ENHANCE: added code to check the ownership and permissions of a
70 module before loading it.
72 - ENHANCE: added / improved input validation in many cases, including
73 the policy file and some function arguments.
74 ============================================================================
75 OpenPAM Hydrangea 2007-12-21
77 - ENHANCE: when compiling with GCC, mark up API functions with GCC
78 attributes where appropriate.
80 - BUGFIX: fixed numerous warnings uncovered by GCC 4.
82 - ENHANCE: building the documentation is now optional.
84 - ENHANCE: corrected a number of mistakes and style issues in the
87 - ENHANCE: API function arguments are now const where appropriate, to
88 match corresponding changes in the Solaris PAM and Linux-PAM APIs.
90 - ENHANCE: corrected a number of C namespace violations.
92 - ENHANCE: the module cache has been removed, allowing long-lived
93 applications to pick up module changes. This also allows multiple
94 threads to use PAM simultaneously (as long as they use separate PAM
95 contexts), since the module cache was the only part of OpenPAM that
97 ============================================================================
98 OpenPAM Figwort 2005-06-16
100 - BUGFIX: Correct several small signedness and initialization bugs
101 discovered during review by the NetBSD team.
103 - BUGFIX: Modify gendoc.pl to sort cross-references in dictionary
104 order within each section.
106 - ENHANCE: if a policy specifies a relative module path, prepend the
107 module directory so we never call dlopen(3) with a relative path.
109 - ENHANCE: add a pam.conf(5) manual page.
110 ============================================================================
111 OpenPAM Feterita 2005-02-01
113 - BUGFIX: Correct numerous markup errors, invalid cross-references,
114 and other issues in the manual pages, with kind assistance from
115 Ruslan Ermilov <ru@freebsd.org>.
117 - BUGFIX: Avoid multiple evaluation of macro arguments in ENTERX()
118 and RETURNX() macros.
120 - BUGFIX: Remove an unnecessary and non-portable pointer cast in
123 - BUGFIX: Fix identical typos in PAM_ACCT_EXPIRED case in
124 pam_strerror(3) and gendoc.pl.
126 - ENHANCE: Minor overhaul of the autoconf / build system.
128 - ENHANCE: Add openpam_free_envlist(3).
129 ============================================================================
130 OpenPAM Eelgrass 2004-02-10
132 - BUGFIX: Correct array handling bugs in conversation code.
134 - BUGFIX: In openpam_ttyconv(3), don't strip trailing linear
135 whitespace from the user's response.
137 - BUGFIX: Many constness issues addressed.
138 ============================================================================
139 OpenPAM Dogwood 2003-07-15
141 - ENHANCE: Use the GNU autotools.
143 - ENHANCE: Constify the msg field in struct pam_message.
145 - BUGFIX: Remove left-over debugging output
147 - BUGFIX: Avoid side effects in arguments to the FREE() macro
149 - ENHANCE: Make openpam_ttyconv(3) use read(2) rather than fgets(3).
151 - BUGFIX: Staticize some variables which shouldn't be global.
153 - BUGFIX: Correcly anticipate a NULL user in pam_get_user(3).
155 - ENHANCE: Various minor documentation improvements.
157 Thanks to Dmitry V. Levin <ldv@altlinux.org> for considerable
158 assistance with this release.
159 ============================================================================
160 OpenPAM Digitalis 2003-06-01
162 - ENHANCE: Completely rewrite the configuration parser and add
163 support for the "include" control flag.
165 - ENHANCE: Improve portability to NetBSD, OpenBSD and Linux.
167 - ENHANCE: Lots of additional paranoia.
169 - BUGFIX: The sample su(1) application dropped privileges before
170 forking instead of after.
172 - ENHANCE: Document openpam_log(3).
174 - ENHANCE: Other minor documentation fixes.
176 Thanks to Dmitry V. Levin <ldv@altlinux.org> for considerable
177 assistance with this release.
178 ============================================================================
179 OpenPAM Dianthus 2003-05-02
181 - BUGFIX: Initialize some potentially uninitialized variables.
183 - BUGFIX: Silence some warnings emitted by gcc -std=iso9899:1999.
185 - BUGFIX: In pam_getenv(), return a pointer to the stored variable
186 instead of a freshly allocated copy.
188 - ENHANCE: Detect recursion in openpam_borrow_cred()
190 - ENHANCE: Make borrowing one's own credentials a no-op.
192 - ENHANCE: Further improve debugging support.
194 - ENHANCE: Clean up some variable names.
195 ============================================================================
196 OpenPAM Daffodil 2003-01-06
198 - ENHANCE: Document dependency on <sys/types.h> (for size_t)
200 - ENHANCE: Slightly improve error detection in openpam_ttyconv().
202 - BUGFIX: Fix several typos in debugging macros.
203 ============================================================================
204 OpenPAM Cyclamen 2002-12-12
206 - ENHANCE: Improve recursion detection in openpam_dispatch().
208 - ENHANCE: Add debugging messages at entry and exit points of most
211 - ENHANCE: Fix some minor style issues.
213 - BUGFIX: Add default cases to the switches in openpam_log.c.
215 - ENHANCE: Add /usr/local/etc/pam.conf to policy search path.
217 - BUGFIX: In openpam_ttyconv(3), print the prompt to stdout rather
219 ============================================================================
220 OpenPAM Citronella 2002-06-30
222 - ENHANCE: Add the "binding" control flag (from Solaris 9).
224 - ENHANCE: Define struct pam_repository and PAM_REPOSITORY (from
227 - ENHANCE: Flesh out the pam(3) man page.
229 - ENHANCE: Add an openpam(3) page with cross-references to all the
230 documented OpenPAM API extensions.
232 - ENHANCE: Add a pam_conv(3) man page describing the conversation
235 - ENHANCE: Improved sample application.
237 - ENHANCE: Added sample pam_unix module.
239 - BUGFIX: Various documentation nits.
240 ============================================================================
241 OpenPAM Cinquefoil 2002-05-24
243 - BUGFIX: Various warnings uncovered by gcc 3.1.
245 - ENHANCE: Add a null conversation function, openpam_nullconv(3).
247 - BUGFIX: Initialize the "other" chain to all zeroes.
249 - ENHANCE: Document openpam_ttyconv(3).
250 ============================================================================
251 OpenPAM Cinnamon 2002-05-02
253 - ENHANCE: Add a null conversation function, openpam_nullconv().
255 - BUGFIX: Various markup bugs in the documentation.
257 - BUGFIX: Document <security/openpam.h>.
259 - BUGFIX: Duplicate expansion of openpam_log() macro arguments.
261 - ENHANCE: Restructure the policy-loading code and align our use of
262 the "other" policy with Solaris and Linux-PAM.
264 - ENHANCE: Log dlopen() and dlsym() failures.
266 - ENHANCE: In openpam_ttyconv(), emit a newline after error and info
267 messages unless the message contains one already.
269 - BUGFIX: In pam_vprompt(), initialize the response pointer to NULL
270 so we can detect whether the conversation function touched it.
271 ============================================================================
272 OpenPAM Cineraria 2002-04-14
274 - BUGFIX: Fix confusion between token and prompt in
277 - ENHANCE: Improved documentation.
279 - ENHANCE: Adopt the same preprocessor tricks that were used in
280 FreeBSD's version of Linux-PAM to simplify static linking without
281 requiring dummy primitives.
283 - ENHANCE: Move the policy-loading code out of pam_start.c.
285 - BUGFIX: Fix typo in one of the versions of the openpam_log macro.
287 - ENHANCE: Add versioning macros.
288 ============================================================================
289 OpenPAM Cinchona 2002-04-08
291 - ENHANCE: Improved documentation for several API functions.
293 - BUGFIX: Fix bug in pam_set_data() that would result in corruption
294 of the module data list.
296 - BUGFIX: Allocate the correct amount of memory for the environment
297 list in pam_putenv().
299 - ENHANCE: Change pam_get_authtok()'s prototype so the caller can
300 specify what token it wants. Also introduce PAM_OLDAUTHTOK_PROMPT.
302 - BUGFIX: Plug memory leak in pam_get_user() / pam_get_authtok(), and
303 reduce differences between these very similar functions.
305 - ENHANCE: Check flags carefully in pam_authenticate() and
308 - BUGFIX: Fix bugs in portability code; libpam now builds on NetBSD.
310 - ENHANCE: In pam_get_authtok(), if PAM_OLDAUTHTOK is set, we're
311 asked for PAM_AUTHTOK, and we have to prompt the user, prompt her
312 twice and compare the responses.
314 - ENHANCE: Add openpam_{borrow,restore}_cred(), for temporarily
315 switching to user credentials.
317 - ENHANCE: Add openpam_free_data(), a generic cleanup function for
318 pam_set_data() consumers.
319 ============================================================================
320 OpenPAM Centaury 2002-03-14
322 - BUGFIX: Add missing #include <string.h> to openpam_log.c.
324 - BUGFIX: s/PAM_REINITIALISE_CRED/PAM_REINITIALIZE_CRED/. XSSO uses
325 the former, but Solaris and Linux-PAM use the latter.
327 - BUGFIX: The dynamic loader and the module cache contained a number
328 of bugs which would cause a segmentation fault if pam_start(3) was
329 called again after pam_end(3), as happens in login(1), xdm(1) etc.
330 after a failed login.
332 - BUGFIX: Refer to a module by the name used in the policy file, even
333 if the module that was actually loaded was versioned.
335 - ENHANCE: Suppress debugging logs, unless compiled with -DDEBUG.
336 ============================================================================
337 OpenPAM Celandine 2002-03-05
339 - BUGFIX: PAM_TRY_AGAIN is a valid return value for pam_chauthtok().
341 - BUGFIX: Run passwd chain twice, first with the PAM_PRELIM_CHECK
342 flag set, then with the PAM_UPDATE_AUTHTOK flag set.
344 - BUGFIX: Failure of a "sufficient" module should not terminate the
345 passwd chain if the PAM_PRELIM_CHECK flag is set.
347 - BUGFIX: Clear PAM_AUTHTOK after running the service modules.
349 - ENHANCE: Prevent applications from specifying the PAM_PRELIM_CHECK
350 or PAM_UPDATE_AUTHTOK flags themselves.
352 - BUGFIX: openpam_set_option() did not support changing the value of
355 - ENHANCE: Add support for module versioning. OpenPAM will prefer a
356 module with the same version number as the library itself to one
357 with no version number at all.
358 ============================================================================
359 OpenPAM Cantaloupe 2002-02-22
361 - BUGFIX: The proper use of PAM_SYMBOL_ERR is to indicate an invalid
362 argument to pam_[gs]et_item(3), not to indicate dlsym(3) failures.
364 - ENHANCE: Add in-line documentation in most source files, and a Perl
365 script that generates mdoc code from that.
367 - BUGFIX: The environment list was not properly NULL-terminated.
369 - ENHANCE: Allow the PAM_AUTHTOK_PROMPT item to override the prompt
370 specified by the module.
372 - BUGFIX: PAM_NUM_ITEMS was set too low. It has been moved to
373 pam_constants.h to avoid it going stale again.
375 - ENHANCE: Move all code related to static modules into a separate
378 - ENHANCE: openpam_ttyconv() now masks most signals while prompting the
379 user, and supports setting a timeout (which defaults to off).
381 - BUGFIX: Some manual pages referenced XSSO even though they
382 documented OpenPAM-specific functions.
384 - ENHANCE: Added openpam_get_option() and openpam_set_option().
386 - ENHANCE: openpam_get_authtok() now respects the echo_pass,
387 try_first_pass, and use_first_pass options.
388 ============================================================================
389 OpenPAM Caliopsis 2002-02-13
391 Fixed a number of bugs in the previous release, including:
392 - a number of bugs in and related to pam_[gs]et_item(3)
393 - off-by-one bug in pam_start.c would trim last character off certain
395 - incorrect ordering of an array in openpam_load.c would cause service
396 module functions to get mixed up
397 - missing 'continue' in openpam_dispatch.c caused successes to be
399 ============================================================================
400 OpenPAM Calamite 2002-02-09
402 First (beta) release.
403 ============================================================================
404 $Id: HISTORY 609 2012-05-26 13:57:45Z des $