]> granicus.if.org Git - linux-pam/blob - CHANGELOG
Relevant BUGIDs: 476940
[linux-pam] / CHANGELOG
1
2 $Id$
3
4 -----------------------------
5
6 TODO:
7
8   - sanitize use of md5 throughout distribution.. Make a static
9     library for helping to develop modules that contains it and other
10     stuff. Also add sha-1 and ripemd-160 digest algorithms.
11   - once above is done. remove hacks from the secret@here module etc..
12   - remove prototype for gethostname in pam_access.c (Derrick)
13   - document PAM_INCOMPLETE changes
14   - verify that the PAM_INCOMPLETE interface is sensible.   Can we
15     catch errors? should we permit item changing etc., between
16     pam_authenticate re-invocations?
17   - verify that the PAM_INCOMPLETE interface works (auth seems ok..)
18   - add PAM_INCOMPLETE support to modules (partially added to pam_pwdb)
19   - work on RFC.
20   - do we still need to remove openlog/closelog from modules..?
21   - auth and acct support in pam_cracklib, "yes, I know the password
22     you just typed was valid, I just don't think it was very strong..."
23   - add in the pam_cap and pam_netid modules
24
25 ====================================================================
26 Note, as of release 0.73, all checkins should be accompanied with a
27 Bug ID. The bug IDs relate to sourceforge IDs.. (Of course, nothing is
28 ever that simple. It turns out that at some point in Sourceforge's
29 history all of the bug ids got bumped by 100000, so pretty much if you
30 see a bug ID below that begins with a '1' and your attempted query
31 fails, try adding 100000 to the number and trying again. I believe
32 this only affects bugs before release 0.76.)
33
34 You can query the related bug description with the following URL:
35
36  http://sourceforge.net/tracker/index.php?func=detail&aid=XXXXXX&group_id=6663&atid=106663
37
38 Where you should replace XXXXXX with a bug-id.
39
40 If you have found a bug in Linux-PAM, please consider filing such a
41 bug report - outstanding bugs are listed here:
42
43  http://sourceforge.net/tracker/?atid=106663&group_id=6663&func=browse
44
45 (to file another bug see the 'submit bug' button on this page).
46
47 ====================================================================
48
49 0.76: please submit patches for this section with actual code/doc
50       patches!
51
52 * MANDIR cleanup. It defaults to /usr/share/man, but can be overridden
53   using the --enable-mandir ./configure option, similarly for DOCDIR
54   from Nalin (Bug 476940 - agmorgan)
55 * pam_filter cleanup (including moving the filter directory) Nalin
56   and Harald Welte (Bugs 436057, 476970 - agmorgan)
57 * pam_limits can handle negative priority limits now (which can apply
58   to the superuser too) - base on patch from Nalin. (Bug 476990 -
59   agmorgan)
60 * db3 is now recognized as a libdb candidate (Bug 435764 - agmorgan)
61 * more changes (extracted from redhat version) courtesy of
62   Harald Welte (Bugs pam_limits=436061, pam_lastlog=436060,
63   pam_mkhomedir/pam_env=435991 - agmorgan)
64 * fix for legacy behavior of pam_setcred and pam_close_session in
65   the case that pam_authenticate and pam_open_session hadn't been
66   called - bug report from Seongwan Park. (Bug 468724 - agmorgan)
67 * some BSD updates and fixes from Mark Murray - including a slightly
68   more robust conversation function and some minimization of gcc
69   warnings. (Bugs 449203,463984 - agmorgan)
70 * verified that the setcred stack didn't suffer from the bug I was
71   nervous about, add a new module pam_debug to help me test this.
72   fixed a libpam/pam_dispatch.c instrumentation line that I tripped
73   over when testing. (Bug 424315 - agmorgan)
74 * pam_unix/support.c: sample use of reentrant NSS function.  Not yet active,
75   because modules do not include _pam_aconf_h! (Bug 440107 - vorlon)
76 * doc/Makefile changes - use $(mandir) [courtesy Harald Welte] (Bug
77   435760) and add some rules to make/delete the draft rfc I've been
78   working on (Task 17426 - agmorgan)
79 * pam_modules.sgml: sourceforge has changed its CVS viewing software
80   (Bug 460491 - agmorgan)
81 * pam_unix_passwd: got rid of an annoying warning (Bug 461089 - agmorgan)
82 * configure.in, _pam_aconf.h.in: set the stage for fully reentrant PAM
83   modules, with some infrastructure to detect getxxbyxx_r() functions
84   (Bug 440107 - vorlon)
85 * pam_unix: removed superfluous use of static variables in md5 and bigcrypt
86   routines, bringing us a step closer to thread-safeness.  Eliminated
87   some variable indirection along the way.  (Bug 440107 - vorlon)
88 * pam_tally: remove #include of stdlib.h, which isn't needed by anything
89   found in this module.  Can be readded if we find a real need for it at
90   a later date. (Bug 436432 - vorlon)
91 * pam_tally: added an #include (was it really needed?) and made the
92   pam_tally app install (with more pretty printing and a corrected
93   Makefile dependency) motivated by a (red hat diff) courtesy of Harald
94   Welte (Bug 436432 - agmorgan)
95 * configure.in changes to help support non-Linux environments courtesy
96   of Scott T. Emery (Bug 422563 - agmorgan)
97 * made a pam_cracklib enhancement to interpret -ve limits in a
98   sensible fashion contributed by Werner Puschitz (Bug 413162 -
99   agmorgan)
100 * another fix for the latest number of rlimits available to pam_limits
101   (Bug 424060 - agmorgan)
102 * removed stale link from pam_pwdb documentation (Bug 433460 - agmorgan)
103 * pam_appl.sgml change - more discussion of choosing a service name
104   (Bug 417512 - agmorgan)
105 * more specific linking requirements for -lndbm for pam_userdb - from
106   David Lee (Bug 417339 - agmorgan)
107 * a large number of small changes to make AIX support better (Bug
108   416229 - agmorgan)
109 * $(MAKE) instead of 'make' - from Scott T. Emery (Bug 422144 -
110   agmorgan)
111 * c++ header fixes for pam_misc.h and pam_client.h - from Alexandre
112   Sagala (Bug 420270 - agmorgan)
113 * pam_access fixes - looks out for trailing '.' - from Carlo Marcelo
114   Arenas Belon (Bug 419631 - agmorgan)
115 * don't zero out password strings during pam_unix's password changing
116   function (Bug 419803 - vorlon)
117 * propagate some definitions to the _pam_aconf.h file - from David Lee
118   (Bug 415419 - agmorgan)
119 * solaris GCC OS_CFLAGS change from David Lee (Bug 415412 - agmorgan)
120 * added a comment to this CHANGELOG to explain why most of the bugids
121   used below appear not to be known to sourceforge [try adding 100000
122   to the bugid number.] (Bug 414943 - agmorgan)
123 * bumped version numbers and also added support for SONAME defines
124   that appear not to have survived the great autoconf experiment (Bug
125   414669 - agmorgan).
126
127 0.75: Sat Apr  7 23:10:50 PDT 2001
128
129                           ** WARNING **
130
131 This release contains backwardly incompatible changes to
132 libpam. Prior versions were buggy - see bugfix for Bug 129775.
133
134                           ** WARNING **
135
136 * made 0.75 release (Bug 414665 - agmorgan)
137 * pam_pwdb has been removed from the suggested pam.conf template. I've
138   replaced it with pam_unix. (Bug 227565 - agmorgan)
139 * pam_limits - Richard M. Yumul reported that "<domain> -" didn't
140   work, first fix suggested by Werner Puschitz (Bug 404953 - agmorgan)
141 * Nicolay Pelov suggested a simple fix for freebsd support (Bug 407282
142   - agmorgan)
143 * Michel D'HOOGE submitted documentation fixes (Bug 408961 - agmorgan)
144 * fix for module linking directions (Bug 133545 - agmorgan)
145 * fix for glibc-2.2.2 compilation of pam_issue (Bug 133542 - agmorgan)
146 * fix pam_userdb to make and link both .o files it needs - converse()
147   wasn't being linked! (Bug 132880 - agmorgan)
148 * added some sys-admin documentation for the pam_tally module (Bug
149   126210 - agmorgan).
150 * added a link to module examples from the module writers doc (Bug
151   131192 - agmorgan).
152 * fixed a small security hole (more of a user confusion issue) with
153   the unix and pwdb password helper binaries. The beef is described in
154   the bug report, but no uid change was possible so no-one should
155   think they need to issue a security bulletin over this one! (Bug
156   112540 - agmorgan)
157 * pam_lastlog needs to be linked with -lutil, also removed ambiguity
158   from sysadmin guide regarding this module being a 'session' module
159   (Bug 131549 - agmorgan).
160 * pam_cracklib needs to be linked with -lcrypt (old password checking)
161   (Bug 131601 - agmorgan).
162 * fixes for static library builds and also the examples when linked
163   with the debugging build of the libraries. (Bug 131783 - agmorgan)
164 * fixed URL for original RFC to a cached kernel.org file. (Bug 131503
165   - agmorgan)
166 * quoted the $CRACKLIB_DICTPATH test in configure.in (Bug 130130 -
167   agmorgan).
168 * improved handling of the setcred/close_session and update chauthtok
169   stack. *Warning* This is a backwardly incompatable change, but 'more
170   sane' than before. (Bug 129775 - agmorgan)
171 * bumped the version number, and added some code to assist in making
172   documentation releases (Bug 129644 - agmorgan).
173
174 0.74: Sun Jan 21 22:36:08 PST 2001
175
176 * made 0.74 release (Bug 129642 - agmorgan)
177 * libpam - cleaned up a few non-static functions to be static and added
178   support for libpam to enforce things like pam_[gs]et_data() and
179   AUTHTOK rules for using the API. Also documented pam_[gs]et_item()
180   a little better including return codes (Bugs 129027, 128576 -
181   agmorgan).
182 * pam_access - fixed the non-default config file option (Bug 127561 -
183   agmorgan)
184 * pam.8 manual page clarified with respect to the default location for
185   finding modules, also added some text describing the [...] control
186   syntax. (Bug 127625 - agmorgan)
187 * md5.h ia64 fixes for pam_unix and pam_pwdb (Bug 127700 - agmorgan)
188 * removed requirement for c++ from the configure{.in,} files (Bug
189   128298 - agmorgan)
190 * removed subdirectories from man page redirections (124396 - baggins)
191 * per David Lee, fixed non-POSIX shell command in modules/pam_filter/Makefile
192   (Bug 126440 - vorlon)
193 * modify format of pam_unix log messages to include service name
194   (Bug 126423 - vorlon)
195 * prevent pam_unix from logging unknown usernames (Bug 126431 - vorlon)
196 * changed format of pam_unix 'authentication failure' log messages to make
197   them clearer and more consistent (Bug 126036 - vorlon)
198 * improved portability of pam_unix by eliminating Linux-specific utmp
199   defines in PAM_getlogin() (Bug 125704 - vorlon)
200 * removed static variables from pam_tally (Bug 117434 - agmorgan)
201 * added copyright message to pam_access module from original logdaemon
202   sources (Bug 125022 - agmorgan)
203 * configure.in - removed the GCC -Wtraditional flag (Bug 124923 - agmorgan)
204 * pam_mail - use PAM_PATH_MAILDIR as the location of mail spool
205   (Bug 124397 - baggins)
206 * _pam_aconf.h.in, configure.in - added PAM_PATH_MAILDIR set via
207   --with-mailspool=dir option (default is _PAM_MAILDIR if defined
208   in paths.h otherwise /var/spool/mail (Bug 124397 - baggins)
209 * removed unnecessary CVS Log tags from all over the source
210   (Bug 124391 - baggins)
211 * pam_tally - check for PAM_TTY if PAM_RHOST is not set when writing
212   to faillog (Bug 124394 - baggins)
213 * use O_NOFOLLOW if available when opening debug log (Bug 124385 - baggins)
214 * pam_cracklib - removed comments about pam_unix not working with
215   pam_cracklib, added information about use_authtok parameter
216   (Bug 124388 - baggins)
217 * pam_userdb - fixed wrong definition of struct pam_module (was pam_wheel)
218   (Bug 124386 - baggins)
219 * fixed example/Makefile include path (Bug 124187, 127563(?) - agmorgan)
220 * pam_userdb compiles on RH5x. Also removed circular dependency on
221   configure.in. Also bumped revision number to 0.74. (Bug 124136 -
222   agmorgan)
223
224 0.73: Sat Dec  2 00:04:04 PST 2000
225
226 * updated documentaion revisions and added 'make release' support
227   to the top level Makefile (Bug 124132 - agmorgan).
228 * documented Qmail support in pam_mail (Bug 109219 - baggins)
229 * add change_uid option to pam_limits, and set real uid only if
230   this option is present (Bug 124062 - baggins)
231 * pam_limits - set real uid to the user for who we set limits.
232   (Bug 123972 - baggins)
233 * removed static variables from pam_limits (thread safe now). (Bug
234   117450 - agmorgan).
235 * removed static variable from pam_wheel (module should be thread safe
236   now). (Bug 112906 - agmorgan)
237 * added support for '/' symbols in pam_time and pam_group config files
238   (support for modern terminal devices). Fixed infinite loop problem
239   with '\\[^\n]' in these files. (Bug 116076 - agmorgan)
240 * avoid potential SIGPIPE when writing to helper binaries with (Bug
241   123399 - agmorgan)
242 * replaced bogus logic in the pam_cracklib module for determining if
243   the replacement is too similar to the old password (Bug 115055 -
244   agmorgan)
245 * added accessconf=<filename> feature to pam_access - request from
246   Aldrin Martoq and Meelis Roos (Bugs 111927,117240 - agmorgan)
247 * fix for pam_limit module not dealing with all limits Adam J. Richter
248   (Bug 119554 - agmorgan)
249 * comment fix describing fail_delay callback in _pam_types.h (Bug
250   112646 - agmorgan)
251 * "likeauth" fix for pam_unix and pam_pwdb which (Bug 113596 - agmorgan)
252 * fix for pam_unix (support.c) to avoid segfault with NULL password
253   (Bug 113238 - vorlon)
254 * fix to pam_unix_passwd: try repeatedly to get a lock on the password
255   file, instead of failing immediately (Bug 108845 - fix vorlon)
256 * fix to pam_shells: logged information was not formatted correctly
257   (extra comma) (Bug 111491 - fix vorlon)
258 * fix for C++ application support (Bug 111645 - fix agmorgan)
259 * fix for typo in pam_client.h (Bug 111648 - fix agmorgan)
260 * removal of -lpam from pam_mkhomedir Makefile (Bug 116380 - fix agmorgan)
261 * autoconf support [Task ID 15788, Bug ID 108297 - agmorgan with help!]
262  - bugfix for libpamc.h include file [Bug ID 117476 - agmorgan]
263  - bugfix for pam_filter.h inclusion [Bug ID 117474 - agmorgan]
264
265 0.72: Mon Dec 13 22:41:11 PST 1999
266
267 * patches from Debian (Ben Collins): pam_ftp supports event driven
268   conversations now; pwdb_chkpwd cleanup; pam_warn static compile fix;
269   user_db compiler warnings removed; debian defs file; pam_mail can
270   now be used as a session module
271 * ndbm compilation option for user_db module (fix explained by Richard Khoo)
272 * pam_cracklib bug fix
273 * packaging fixes & build from scratch stuff (Konst Bulatnikov & Frodo
274   Looijaard)
275 * -ldl appended to the libpam.so compilation make rule. (Charles Seeger)
276 * Red Hat security patch for pam_pwdb forwarded by Debian! (Ben
277   Collins. Fix provided by Andrey as it caught the problem earlier in the
278   code.)
279 * heuristic to prevent leaking filedescriptors to an agent. [This needs
280   to be better supported perhaps by an additional libpamc API function?]
281 * pam_userdb segfault fix from (Ben Collins)
282 * PAM draft spec extras added at request of 'sen_ml'
283
284 0.71: Sun Nov  7 20:21:19 PST 1999
285
286 * added -lc to linker pass for pam_nologin module (glibc is weird).
287 * various header changes to lower the number of warnings on glibc
288   systems (Dan Yefimov)
289 * merged a bunch of Debian fixes/patches/documentation (Ben Collins)
290   things touched: libpam (minor); doc/modules/pam_unix.sgml; pam_env
291   (plus docs); pam_mkhomedir (new module for new home directories on
292   the fly...); pam_motd (new module); pam_limits (adjust to match
293   docs); pam_issue (new module + doc) [Some of these were also
294   submitted by Thorsten Kukuk]
295 * small hack to lower the number of warnings that pam_client.h was
296   generating.
297 * debian and SuSE apparently can use the pam_ftp module, so
298   removed the obsolete comment about this from the docs. (Thorsten
299   Kukuk)
300
301 0.70: Fri Oct  8 22:05:30 PDT 1999
302
303 * bug fix for parsing of value=action tokens in libpam/pam_misc.c was
304   segfaulting (Jan Rekorajski and independently Matthew Melvin)
305 * numerous fixes from Thorsten Kukuk (icluding much needed fixes for
306   bitrot in modules and some documentation) that got included in SuSE 6.2.
307 * reentrancy issues in pam_unix and pam_cracklib resolved (Jan Rekorajski)
308 * added hosts_equiv_rootok module option to pam_rhosts module (Tim Berger)
309 * added comment about 'expose_account' module argument to admin and
310   module writers' docs (request from Michael K Johnson).
311 * myriad of bug fixes for libpamc - library now built by default and
312   works with the biomouse fingerprint scanner agent/module
313   (distributed separately).
314
315 0.69: Sun Aug  1 20:25:37 PDT 1999
316
317 * c++ header #ifdef'ing for pam_appl.h (Tuomo Pyhala)
318 * added pam_userdb module (Cristian Gafton)
319 * minor documentation changes
320 * added in revised pam_client library (libpamc). Not installed by
321   default yet, since the example agent/module combo is not very secure.
322 * glibc fixes (Thorsten Kukuk, Adam J. Richter)
323
324 0.68: Sun Jul  4 23:04:13 PDT 1999
325
326 * completely new pam_unix module from Jan Rekorajski and Stephen Langasek
327 * Jan Rekorajski pam_mail - support for Maildir format mailboxes
328 * Jan Rekorajski pam_cracklib - support for old password comparison
329 * Jan Rekorajski bug fix for pam_pwdb setcred reusing auth retval
330 * Andrey's pam_tally patch (lstat -> fstat)
331 * Robert Milkowski's additional pam_tally patches to **change format of
332   /var/log/faillog** to one from shadow-utils, add new option "per_user"
333   for pam_tally module, failure time logging, support for fail_line
334   field, and support for fail_locktime field with new option
335   no_lock_time.
336 * pam_tally: clean up the tally application too.
337 * Marcin Korzonek added process priority settings to pam_limits (bonus
338   points for adding to documentation!)
339 * Andrey's pam_pwdb patch (cleanup + md5 endian fubar fix)
340 * more binary prompt preparations (make misc conv more compatible with spec)
341 * modified callback hook for fail delay to be more useful with event
342   driven applications (changed function prototype - suspect no one
343   will notice). Documented this in app developer guide.
344 * documentation for pam_access from Tim Berger
345 * syntax fixes for the documentation - a long time since I've built it :*(
346   added some more names to the CREDITS file.
347
348 0.67: Sat Jun 19 14:01:24 PDT 1999
349
350 * [dropped libpam_client - libpamc will be in the next release and
351    conforms to the developing spec in doc/specs/draft-morgan-pam.raw.
352    Sorry if you are keeping a PAM tree in CVS. CVS is a pain for
353    directories, but this directory was actually not referenced by
354    anything so the disruption should be light.]
355 * updates to pam_tally from Tim
356 * multiple updates from Stephen Langasek to pam_unix
357 * pam_filter had some trouble compiling (bug report from Sridhar)
358 * pam_wheel now attempts to identify the wheel group for the local
359   system instead of blindly assuming it is gid=0. In the case that
360   there is no "wheel" group, we default to assuming gid=0 is what was
361   meant - former behavior. (courtesy of Sridhar)
362 * NIS+ changes to pam_unix module from Dmitry O Panov
363 * hopefully, a fix for redefinition of LOG_AUTHPRIV (bug report Luke
364   Kenneth Casson Leighton)
365 * fix for minor typo in pam_wheel documentation (Jacek Kopecky)
366 * slightly more explanation of the [x=y] pam.conf syntax in the sys
367   admin guide.
368
369 0.66: Mon Dec 28 20:22:23 PST 1998 <morgan@linux.kernel.org>
370
371 * Started using cvs to keep track of changes to Linux-PAM.  This will
372   likely break some of the automated building stuff (RPMs etc..).
373 * security bug fix to pam_unix and pam_tally from Andrey.
374 * modules make file is now more automatic.  It should be possible to
375   unpack an external module in the modules directory and have it automatically
376   added to the build process.  Also added a modules/download-all script
377   that will make such downloading easier.  I'm happy to receive patches to
378   this file, informing the distribution of places from which to enrich itself.
379 * removed pam_system_log stuff.  Thought about it long and hard: a
380   bad idea.  If libc cannot guarantee a thread safe syslog, it needs
381   to be fixed and compatibility with other PAM libraries was
382   unnecessarily strained.
383 * SAG documentation changes: Seth Chaiklin
384 * rhosts: problems with NIS lookup failures with the root-uid check.
385   As a work-around, I've partially eliminated the need for the lookup
386   by supplying two new arguments: no_uid_check, superuser=<username>.
387   As a general rule this is more pluggable, since this module might be
388   used as an authentication scheme for a network service that does not
389   need root privilege...
390 * authenticate retval -> setcred for pam_pwdb (likeauth arg).
391 * pam_pwdb event driven support
392 * non openlog pam_listfile logging
393 * BUGFIX: close filedescriptor in pam_group and pam_time (Emmanuel Galanos)
394 * Chris Adams' mailhash change for pam_mail module
395 * fixed malloc failure check in pam_handlers.c (follow up to comment
396   by Brad M. Garcia).
397 * update to _pam_compat.h (Brad M. Garcia)
398 * support static modules in libpam again (Brad M. Garcia)
399 * libpam/pam_misc.c for egcs to grok the code (Brad M. Garcia)
400 * added a solaris-2.5.1 defs file (revived by Derrick J Brashear)
401 * pam_listfile logs failed attempts
402 * added a comment (Michael K Johnson pointed it out) about sgml2latex
403   having a new syntax.  I'll make it the change real when I upgrade...
404 * a little more text to the RFC, spelling fix from William J Buffam.
405 * minor changes to pam_securetty to accommodate event driven support.
406
407 0.65: Sun Apr  5 22:29:09 PDT 1998 <morgan@linux.kernel.org>
408
409 * added event driven programming extensions to libpam
410  - added PAM_INCOMPLETE handling to libpam/pam_dispatch.c
411  - added PAM_CONV_AGAIN which is a new conversation response that
412    should be mapped to PAM_INCOMPLETE by the module.
413  - ensured that the pam_get_user() function can resume
414  - changes to pam_strerror to accommodate above return codes
415  - clean up _pam_former_state at pam_end()
416  - ensured that former state is correctly initialized
417  - added resumption tests to pam_authenticate(), pam_chauthtok()
418  - added PAM_FAIL_DELAY item for pausing on failure
419
420 * improved _pam_macros.h so that macros can be used as single commands
421   (Andrey)
422
423 * reimplemented logging to avoid bad interactions with libc.  Added
424   new functions, pam_[,v]system_log() to libpam's API.  A programmer
425   can check for this function's availablility by checking if
426   HAVE_PAM_SYSTEM_LOG is #defined.
427
428 * removed the reduce conflict from pam_conv1 creation -- I can sleep
429   again now. :^]
430
431 * made building of static and dynamic libpam separate.  This is
432   towards making it possible to build both under Solaris (for Derrick)
433
434 * made USE_CRACKLIB a condition in unix module (Luke Kenneth Casson Leighton)
435
436 * automated (quiet) config installation (Andrey)
437
438 0.64: Thu Feb 19 23:30:24 PST 1998 Andrew Morgan <morgan@linux.kernel.org>
439
440 * miscellaneous patches for building under Solaris (Derrick J Brashear)
441
442 * removed STATIC support from a number of module Makefiles.  Notably,
443   these modules are those that use libpwdb and caused difficulties
444   satisfying the build process. (Please submit patches to fix this...;)
445
446 * reomved the union for binary packet conversations from
447   (_pam_types.h).  This is now completely implemented in libpam_client.
448
449 * Andrey's patch for working environment variable handling in
450   sh_secret module.
451
452 * made the libpam_misc conversation function a bit more flexible with
453   respect to binary conversations.
454
455 * added top level define (DEBUG_REL) for compiling in the form of
456   a debugging release.  I use this on a Red Hat 4.2 system with little
457   chance of crashing the system as a whole.  (Andrey has another
458   implementation of this -- with a spec file to match..)
459
460 0.63: Wed Jan 28 22:55:30 PST 1998 Andrew Morgan <morgan@linux.kernel.org>
461
462 * added libpam_client "convention" library.  This makes explicit the
463   use of PAM_BINARY_PROMPT.  It is a first cut, so don't take it too
464   seriously yet.  Comments/suggestions for improvements are very
465   welcome.  Note, this library does not compile by default.  It will
466   be enabled when it is judged stable.  The library comes with two
467   module/agent pairs and can be used with ssh using a patch available
468   from my pre-release directory [where you got this file.]
469
470 * backward compatibility patch for libpam/pam_handlers.c (PAM_IGNORE
471   was working with neither "requistie" nor "required") and a DEBUG'ing
472   compile time bug with pam_dispatch.c (Savochkin Andrey Vladimirovich)
473
474 * minor Makefile change from (Savochkin Andrey Vladimirovich)
475
476 * added pam_afsauth, pam_afspass, pam_restrict, and pam_syslog hooks
477   (Derrick J Brashear)
478
479 * pam_access use of uname(2) problematic (security problem
480   highlighted by Olaf Kirch).
481
482 * pam_listfile went a bit crazy reading group membersips (problem
483   highlighted by Olaf Kirch and patched independently by Cristian
484   Gafton and Savochkin Andrey Vladimirovich)
485
486 * compatibility hooks for solaris and hpux (Derrick J Brashear)
487
488 * 64 bit Linux/alpha bug fixed in pam_rhosts (Andrew D. Isaacson)
489
490 0.62: Wed Jan 14 14:10:55 PST 1998   Andrew Morgan <morgan@linux.kernel.org>
491
492 * Derrick J Brashear's patches: adds the HP stuff missed in the first
493   patch; adds SunOS support; adds support for the Solaris native ld
494   instead of requiring gnu ld.
495
496 * last line of .rhosts file need not contain a newline. (Bug reported by
497   Thompson Freeman.)
498
499 0.61: Thu Jan  8 22:57:44 PST 1998  Andrew Morgan <morgan@linux.kernel.org>
500
501 * complete rewrite of the "control flag" logic.  Formerly, we were
502   limited to four flags: requisite, required, sufficient, optional.
503   We can now use these keywords _and_ a great deal more besides.
504   The extra logic was inspired by Vipin Samar, a preliminary patch was
505   written by Andy Berkheimer, but I "had some ideas of my own" and
506   that's what I've actually included.  The basic idea is to allow the
507   admin to custom build a control flag with a series of token=value
508   pairs inside square brackets.  Eg., '[default=die success=ok]' which
509   is pretty close to a synonym for 'requisite'.  I'll try to document it
510   better in the sys-admin guide but I'm pretty sure it is a change for
511   the better....  If what is in the sys-admin guide is not good enough
512   for you, just take a look at the source for libpam ;^)
513
514 0.59: Thu Jan  8 22:27:22 PST 1998 Andrew Morgan <morgan@linux.kernel.org>
515
516 * better handling of empty lines in .rhosts file.  (Formerly, we asked
517   the nameserver about them!) Fix from Hugh Daschbach.
518
519 * _broke_some_binary_compatibility_ with previous versions to become
520   compliant with X/Open's XSSO spec.  Specifically, this has been
521   by changing the prototype for pam_strerror().
522
523 * altered the convention for the conversation mechanism to agree
524   with that of Sun.  (number of responses 'now=' number of messages
525   with help from Cristian for finding a bug.. Cristian also found a
526   nasty speradic segfault bug -- Thanks!)
527
528 * added NIS+ support to pam_unix_*
529
530 * fixed a "regular file checking" problem with the ~/.rhosts sanity
531   check.  Added "privategroup" option to permit group write permission
532   on the ~/.rhosts file in the case that the group owner has the same
533   name as the authenticating user.  :*) "promiscuous" and "suppress"
534   were not usable!
535
536 * added glibc compatibility to pam_rhosts_auth (protected __USE_MISC
537   with #ifndef since my libc already defines it!).
538
539 * Security fix from Savochkin Andrey Vladimirovich with suggested
540   modification from Olaf Seibert.
541
542 * preC contains mostly code clean-ups and a number of changes to
543   _pam_macros.
544
545 0.58: whenever
546
547 * pam_getenvlist() has a more robust definition (XSSO) than was previously
548   thought.  It would seem that we no longer need pam_misc_copy_env()
549   which was there to provide the robustness that pam_getenvlist()
550   lacked before...
551
552   Accordingly, I have REMOVED the prototype from libpam_misc. (The
553   function, however, will remain in the library as a wrapper for
554   legacy apps, but will likely be removed from libpam_misc-1.0.) PLEASE
555   FIX YOUR APPS *BEFORE* WE GET THERE!
556
557 * Alexy Nogin reported garbage output from pam_env in the case of
558   a non-existent environment variable.
559
560 * 'fixed' pwdb compilation for pam_wheel.  Not very cleanly
561   done.. Mmmm. Should really clean up the entire source tree...
562
563 * added prototypes for mapping functions
564
565                         <**WARNING**>
566
567   various constants have had there names changed.  Numerical values have
568   been retained but be aware some source old modules/applications will
569   need to be fixed before recompilation.
570
571                         </**WARNING**>
572
573 * appended documentation to README for pam_rhosts module (Nicolai
574   Langfeldt).
575
576 * verified X/Open compatibility of header files - note, where we differ
577   it is at the level of compilation warnings and the use of 'const char *'
578   instead of 'char *'.  Previously, Sun(X/open) have revised their spec
579   to be more 'const'-ervative in the light of comments from Linux-PAM
580   development.
581
582 * Ooops! PAM_AUTHTOKEN_REQD should have been PAM_NEW_AUTHTOK_REQD.
583
584         changed: pam_pwdb(pam_unix_acct) (also bug fix for
585         _shadow_acct_mgmt_exp() return value), pam_stress,
586         libpam/pam_dispatch, blank, xsh.
587
588 * New: PAM_AUTHTOK_EXPIRED - password has expired.
589
590 * Ooops! PAM_CRED_ESTABLISH (etc.) should have been PAM_ESTABLISH_CRED
591   etc... (changed - this may break some people's modules - PLEASE TAKE
592   NOTE!)
593         changed: pam_group, pam_mail, blank, xsh; module and appl
594         docs, pam_setcred manual page.
595
596 * renamed internal _pam_handle structure to be pam_handle as per XSSO.
597
598 * added PAM_RADIO_TYPE  (for multiple choice input method).  Also
599   added PAM_BINARY_{MSG,PROMPT} (for interaction out of sight of user
600   - this could be used for RSA type authentication but is currently
601   just there for experimental purposes).  The _BINARY_ types are now
602   usable with hooks in the libpam_misc conversation function. Still
603   have to add PAM_RADIO_TYPE.
604
605 * added pam_access module (Alexei Nogin)
606
607 * added documentation for pam_lastlog.  Also modified the module to
608   not (by default) print "welcome to your new account" when it cannot
609   find a utmp entry for the user (you can turn this on with the
610   "never" argument).
611
612 * small correction to the pam_fail_delay manual page.  Either the appl or
613   the modules header file will prototype this function.
614
615 * added "bigcrypt" (DEC's C2) algorithm(0) to pam_pwdb. (Andy Phillips)
616
617 * *BSD tweaking for various #include's etc. (pam_lastlog, pam_rhosts,
618   pam_wheel, libpam/pam_handlers). (Michael Smith)
619
620 * added configuration directory $SCONFIGED for module specific
621   configuration files.
622
623 * added two new "linked" man pages (pam.conf(8) and pam.d(8))
624
625 * included a reasonable default for /etc/pam.conf (which can be
626   translated to /etc/pam.d/* files with the pam_conv1 binary)
627
628 * fixed the names of the new configuration files in
629    conf/pam_conv1/pam_conv.y
630
631 * fixed make check.
632
633 * pam_lastlog fixed to handle UID in virgin part of /var/log/lastlog
634   (bug report from Ronald Wahl).
635
636 * grammar fix in pam_cracklib
637
638 * segfault avoided in pam_pwdb (getting user). Updating of passwords
639   that are directed to a "new" database are more robust now (bug noted
640   by Michael K. Johnson).  Added "unix" module argument for migrating
641   passwords from another database to /etc/passwd. (documentation
642   updated).  Removed "bad username []" warning for empty passwords -
643   on again if you supply the 'debug' module argument.
644
645 * ctrl-D respected in conversation function (libpam_misc)
646
647 * Removed -DPAM_FAIL_DELAY_ON from top-level Makefile. Nothing in
648   the distribution uses it.  I guess this change happened a while
649   back, basically I'm trying to make the module parts of the
650   distribution "source compatible" with the RFC definition of PAM.
651   This implementation of PAM is a superset of that definition. I have
652   added the following symbols to the Linux-PAM header files:
653
654         PAM_DATA_SILENT (see _pam_types.h)
655         HAVE_PAM_FAIL_DELAY (see _pam_types.h)
656         PAM_DATA_REPLACE (see _pam_modules.h)
657
658   Any module (or application) that wants to utilize these features,
659   should check (#ifdef) for these tokens before using the associated
660   functionality.  (Credit to Michael K. Johnson for pointing out my
661   earlier omission: not documenting this change :*)
662
663 * first stab at making modules more independent of full library
664   source.  Modules converted:
665         pam_deny
666         pam_permit
667         pam_lastlog
668         pam_pwdb
669
670 * pam_env.c: #include <errno.h> added to ease GNU libc use. (Michael
671   K. Johnson)
672
673 * pam_unix_passwd fixes to shadow aging code (Eliot Frank)
674
675 * added README for pam_tally
676
677 0.57: Fri Apr  4 23:00:45 PST 1997  Andrew Morgan <morgan@parc.power.net>
678
679 * added "nodelay" argument to pam_pwdb.  This can be used to turn off
680   the call to pam_fail_delay that takes effect when the user fails to
681   authenticate themself.
682
683 * added "suppress" argument to pam_rhosts_auth module. This will stop
684   printing the "rlogin failure message" when the user does not have a
685   .rhosts file.
686
687 * Extra fixes for FAKEROOT in Makefiles (Savochkin Andrey
688   Vladimirovich)
689
690 * pam_tally added to tree courtesy of Tim Baverstock
691
692 * pam_rhosts_auth was failing to read NFS mounted .rhosts
693   files. (Fixed by Peter Allgeyer). Refixed and further enhanced
694   (netgroups) by Nicolai Langfeldt. [Credit also to G.Wilford for some
695   changes that were not actually included..]
696
697 * optional (#ifdef PAM_READ_BOTH_CONFS) support for parsing of pam.d/
698   AND pam.conf files (Elliot Lee).
699
700 * Added (and signed) Cristian's PGP key. (I've never met him, but I am
701   convinced the key belongs to the guy that is making the PAM rpms and
702   also producing libpwdb. Please note, I will not be signing anyone
703   else's key without a personal introduction..)
704
705 * fixed erroneous syslog warning in pam_listfile (Savochkin Andrey
706   Vladimirovich, whole file reformatted by Cristian)
707
708 * modified pam_securetty to return PAM_IGNORE in the case that the user's
709   name is not known to the system (was previously, PAM_USER_UNKNOWN). The
710   Rationale is that pam_securetty's sole purpose is to prevent superuser
711   login anywhere other than at the console. It is not its concern that the
712   user is unknown - only that they are _not_ root. Returning
713   PAM_IGNORE, however, insures that the pam_securetty can never be used to
714   "authenticate" a non-existent user. (Cristian Gafton with bug report from
715   Roger Hu)
716
717 * Modified pam_nologin to display the no-login message when the user
718   is not known. The return value in this case is still PAM_USER_UNKNOWN.
719   (Bug report from Cristian Gafton)
720
721 * Added NEED_LCKPWD for pam_unix/ This is used to define the locking
722   functions and should only be turned on if you don't have them in
723   your libc.
724
725 * tidied up pam_lastlog and pam_pwdb: removed function that was never used.
726
727 * Note for package maintainers: I have added $(FAKEROOT) to the list of
728   environment variables.  This should help greatly when you build PAM
729   in a subdirectory.  I've gone through the tree and tried to make
730   everything compatible with it.
731
732 * added pam_env (courtesy of Dave Kinchlea)
733
734 * removed pam_passwd+ from the tree.  It has not been maintained in a
735   long time and running a shell script was basically insecure. I've
736   indicated where you can pick up the source if you want it.
737
738 * #define HAVE_PAM_FAIL_DELAY . Applications can conditionally compile
739   with this if they want to see if the facility is available. It is
740   now always available. (corresponding compilation cleanups..)
741
742 * _pam_sanitize() added to pam_misc. It purges the PAM_AUTHTOK and
743   PAM_OLDAUTHTOK items. (calls replaced in pam_auth and pam_password)
744
745 * pam_rhosts now knows about the '+' entry. Since I think this is a
746   dangerous thing, I have required that the sysadmin supply the
747   "promiscuous" flag for it in the corresponding configuration file
748   before it will work.
749
750 * FULL_LINUX_PAM_SOURCE_TREE exported from the top level make file.
751   If you want to build a module, you can test for this to determine if
752   it should take its directions from above or supply default locations
753   for installation. Etc.
754
755 0.56: Sat Feb 15 12:21:01 PST 1997 <morgan@parc.power.net>
756
757 * pam_handlers.c can now interpret the pam.d/ service config tree:
758         - if /etc/pam.d/ exists /etc/pam.conf is IGNORED
759           (otherwise /etc/pam.conf is treated as before)
760         - given /etc/pam.d/
761           . config files are named (in lower case) by service-name
762           . config files have same syntax as /etc/pam.conf except       
763             that the "service-name" field is not present. (there
764             are thus three manditory fields (and arguments are
765             optional):
766
767                 module-type  control-flag  module-path  optional-args...
768
769             )
770
771 * included conf/pam_conv1 for converting pam.conf to a pam.d/ version
772   1.0 directory tree. This program reads a pam.conf file on the
773   standard input stream and creates ./pam.d/ (in the local directory)
774   and fills it with ./pam.d/"service-name" files.
775
776         *> Note: It will fail if ./pam.d/ already exists.
777
778   PLEASE REPORT ANY BUGS WITH THIS CONVERSION PROGRAM... It currently
779   cannot retain comments from the old conf file, so take care to do this
780   by hand. Also, please email me with the fix that makes the
781   shift/reduce conflict go away...
782
783 * Added default module path to libpam for modules (see pam_handlers.c)
784   it makes use of Makfile defined symbol: DEFAULT_MODULE_PATH which is
785   inhereted from the defs/* variable $(SECUREDIR). Removed module
786   paths from the sample pam.conf file as they are no longer needed.
787
788 * pam_pwdb can now verify read protected passwords when it is not run
789   by root.  This is via a helper binary that is setuid root.
790
791 * pam_permit now prompts for a username if it is not already determined
792
793 * pam_rhosts now honors "debug" and no longer hardwire's "root" as the
794   superuser's name.
795
796 * pam_securetty now honors the "debug" flag
797
798 * trouble parsing extra spaces fixed in pam_time and pam_group
799
800 * added Michael K. Johnson's PGP key to the pgp.keys.asc list
801
802 * pam_end->env not being free()'d: fixed
803
804 * manuals relocated to section 3
805
806 * fixed bug in pam_mail.c, and enhanced to recognize '~' as a prefix
807   to indicate the $HOME of the user (courtesy David
808   Kinchlea). *Changed* from a "session" module to an "auth"
809   module. It cannot be used to authenticate a user, but it can be used
810   in setting credentials.
811
812 * fixed a stupid bug in pam_warn.. Only PAM_SERVICE was being read :*(
813
814 * pam_radius rewritten to exclusively make use of libpwdb. (minor fix
815   to Makefile for cleaning up - AGM)
816
817 * pam_limits extended to limit the total number of logins on a system
818   at any given time.
819
820 * libpam and libpam_misc use $(MAJOR_REL) and $(MINOR_REL) to set their
821   version numbers [defined in top level makefile]
822
823 * bugfix in sed command in defs/redhat.defs (AGM's fault)
824
825 * The following was related to a possibility of buffer overruns in
826   the syslogging code: removed fixed length array from syslogging
827   function in the following modules [capitalized the log identifier
828   so the sysadmin can "know" these are fixed on the local system],
829
830         pam_ftp, pam_stress, pam_rootok, pam_securetty,
831         pam_listfile, pam_shells, pam_warn, pam_lastlog
832   and
833         pam_unix_passwd (where it was definitely _not_ exploitable)
834
835 0.55: Sat Jan  4 14:43:02 PST 1997, Andrew Morgan <morgan@parc.power.net>
836
837 * added "requisite" control_flag to /etc/pam.conf syntax. [See
838   Sys. Admin. Guide for explanation] changes to pam_handlers.c
839
840 * completely new handling of garbled pam.conf lines. The modus
841   operandi now is to assume that any errors in the line are minor.
842   Errors of this sort should *most definitely* lead to the module
843   failing, however, just ignoring the line (as was the case
844   previously) can lead to gaping security holes(! Not foreseen by the
845   RFC). The "motivation" for the RFC's comments about ignoring garbled
846   lines is present in spirit in the new code: basically a garbled line
847   is treated like an instance of the pam_deny.so module.
848   changes to pam_handlers.c and pam_dispatch.c .
849
850 * patched libpam, to (a) call _pam_init_handlers from pam_start() and
851   (b) to log a text error if there are no modules defined for a given
852   service when a call to a module is requested. [pam_start() and
853   pam_dispatch() were changed].
854
855 * patched pam_securetty to deal with "/dev/" prefix on PAM_TTY item.
856
857 * reorganized the modules/Makefile to include *ALL* modules. It is now
858   the responsibility of the modules themselves to test whether they can
859   be compiled locally or not.
860
861 * modified pam_group to add to the getgroups() list rather than overwrite
862   it. [In the case of "HAVE_LIBPWDB" we use the pwdb_..() calls to
863   translate the group names.]. Module now pays attention to
864   PAM_CRED_.. flag(!)
865
866 * identified and removed bugs in field reading code of pam_time and
867   (thus) pam_group.
868
869 * Cristian's patches to pam_listfile module, corresponding change to
870   documentation.
871
872 * I've discovered &ero; for sgml!
873   Added pam_time documentation to the admin guide.
874
875 * added manual pages: pam.8, pam_start.2(=pam_end.2),
876   pam_authenticate.2, pam_setcred.2, pam_strerror.2,
877   pam_open_session.2(=pam_close_session.2) and pam_chauthtok.2 .
878
879 * added new modules:
880
881         - pam_mail (tells the user if they have any new mail
882           and sets their MAIL env variable)
883         - pam_lastlog (reports on the last time this user called
884           this module)
885
886 * new module hooks provided.
887
888 * added a timeout feature to the conversation function in
889   libpam_misc. Documented it in the application developers' guide.
890
891 * fixed bug in pam_misc_paste_env() function..
892
893 * slight modifications to wheel and rhosts writeup.
894
895 * more security issues added to module and application guides.
896
897 --
898 Things present but not mentioned in previous release (sorry)
899
900 * pam_pwdb module now resets the "last_change" entry before updating a
901   password.
902 --
903
904 Sat Nov 30 19:30:20 PST 1996, Andrew Morgan <morgan@parc.power.net>
905
906 * added environment handling to libpam. involved change to _pam_types.h
907   also added supplementary functions to libpam_misc
908
909 * added pam_radius - Cristian
910
911 * slight speed up for pam_rhosts
912
913 * significantly enhanced sys-admin documentation (8 p -> 41 p in
914   PostScript). Added to other documentation too.  Mostly the changes
915   in the other docs concern the new PAM-environment support, there is
916   also some coverage of libpam_misc in the App. Developers' guide.
917
918 * Cristian's patches to pam_limits and pam_pwdb. Fixing bugs. (MORE added)
919   
920 * adopted Cristian's _pam_macros.h file to help with common macros and
921   debugging stuff, gone through tree tidying up debugging lines to use
922   this [not complete].
923
924         - for consistency replaced DROP() with _pam_drop()
925
926 * commented memory debugging in top level makefile
927
928 * added the following modules
929
930     - pam_warn  log information to syslog(3) about service application
931     - pam_ftp   if user is 'ftp' then set PAM_RUSER/PAM_RHOST with password
932     (comment about nologin added to last release's notes)
933
934 * modified the pam_listfile module. It now declares a meaningful static
935   structure name.
936
937 Sun Nov 10 13:26:39 PST 1996, Andrew Morgan <morgan@parc.power.net>
938
939                 **PLEASE *RE*AMEND YOUR PERSONAL LINKS**
940
941   ------->  http://parc.power.net/morgan/Linux-PAM/index.html  <-------
942
943                 **PLEASE *RE*AMEND YOUR PERSONAL LINKS**
944
945 A brief summary of what has changed:
946
947 * many modules have been modified to accomodate fixing the pam_get_user()
948   change. Please take note if you have a module in this distribution.
949
950 * pam_unix is now the pam_unix that Red Hat has been using and which
951   should be fairly well debugged.
952
953    - I've added some #ifdef's to make it compile for me, and also
954      updated it with respect to the libpam-0.53, so have a look at the
955      .../modules/pam_unix/Makefile to enable cracklib and shadow features
956
957         ** BECAUSE OF THIS, I cannot guarantee this code works as it **
958         ** did for Red Hat. Please test and report any problems.     **
959
960 * the pam_unix of .52 (renamed to pam_pwdb) has been enhanced and made
961   more flexible with by implementing it with respect to the new
962   "Password Database Library" see
963
964         http://parc.power.net/morgan/libpwdb/index.html
965
966   modules included in this release that require this library to
967   function are the following:
968
969         - pam_pwdb (ne pam_unix-0.52 + some enhancements)
970         - pam_wheel
971         - pam_limits
972         - pam_nologin
973
974 * Added some optional code for memory debugging. In order to support
975   this you have to enable MEMORY_DEBUG in the top level makefile and
976   also #define MEMORY_DEBUG in your applications when they are compiled.
977   The extra code resides in libpam (compiled if MEMORY_DEBUG is defined)
978   and the macros for malloc etc. are to be found at the end of
979   _pam_types.h
980
981 * used above code to locate two memory leaks in pam_unix module and two
982   in libpam (pam_handlers.h)
983
984 * pam_get_user() now sets the PAM_USER item. After reading the Sun
985   manual page again, it was clear that it should do this. Various
986   modules have been assuming this and now I have modified most of them
987   to account for this change. Additionally, pam_get_user() is now
988   located in the module include file; modules are supposed to be the
989   ones that use it(!) [Note, this is explicitly contrary to the Sun
990   manual page, but in the spirit of the Linux distribution to date.]
991
992 * replaced -D"LINUX" with -D"LINUX_PAM" as this is more explicit and less
993   likely to be confused with -D"linux".
994   Also, modified the libpam #include files to behave more like the Sun
995   ones #ifndef LINUX_PAM.
996
997 * removed <bf/ .. / from documentation titles. This was not giving
998   politically correct html..
999  
1000 ----- My vvvvvvvvvvvvvvvvvvv was a long time ago ;*] -----
1001
1002 Wed Sep  4 23:57:19 PDT 1996 (Andrew Morgan <morgan@physics.ucla.edu>
1003
1004 0. Before I begin, Linux-PAM has a new primary distribution site (kindly
1005 donated by Power Net Inc., Los Angeles)
1006
1007                 **PLEASE AMMEND YOUR PERSONAL LINKS**
1008
1009       ------->  http://www.power.net/morgan/Linux-PAM  <-------
1010
1011                 **PLEASE AMMEND YOUR PERSONAL LINKS**
1012
1013 1. I'm hoping to make the next release a bug-fix release... So please find
1014    all the bugs(! ;^)
1015
1016 2. here are the changes for .52:
1017
1018 * minor changes to module documentation [Incidently, it is now
1019   available on-line from the WWW page above]. More changes to follow in
1020   the next two releases. PLEASE EMAIL me or the list if there is
1021   anything that isn't clear!
1022
1023 * completely changed the unix module. Now a single module for all four
1024   management groups (this meant that I could define all functions as
1025   static that were not part of the pam_sm_... scheme. AGM)
1026
1027   - Shadow support added
1028 PASSWD  - Elliot's account management included, and enhanced by Cristian Gafton.
1029   - MD5 password support added by Cristian Gafton.
1030   - maxtries for authentication now enforced.
1031   - Password changing function in pam_unix now works!
1032     Although obviously, I'm not going to *guarantee* it ;^) .
1033   - stole Marek's locking code from the Red Hat unix module.
1034     [ If you like you can #ifdef it in or out ... ]
1035
1036     You can configure the module more from its Makefile in
1037     0.52/modules/pam_unix/
1038
1039     If you are nervous that it will destroy your /etc/passwd or shadow
1040     files then EDIT the 0.52/modules/pam_unix/pam_unix_pass.-c file.
1041     Here is the warning comment from this file...
1042
1043 -------------8<-----------------
1044 /*                           <WARNING>
1045  *
1046  * Uncomment the following #define if you are paranoid, and do not
1047  * want to risk losing your /etc/passwd or shadow files.
1048  * It works for me (AGM) but there are no guarantees.
1049  *
1050  *                          </WARNING>
1051  */
1052 /* #define TMP__FILE */
1053 ------------->8-----------------
1054
1055   *** If anyone has any trouble, please *say*. Your problem will be
1056       fixed in the next release. Also please feel free to scour the
1057       code for race conditions etc... 
1058
1059 [* The above change requires that you purge your /usr/lib/security
1060    directory of the old pam_unix_XXX.so modules: they will NOT be deleted
1061    with a 'make remove'.]
1062
1063 * the prototype for the cleanup function supplied to pam_set_data used
1064   to return "int". According to Sun it should be "void". CHANGED.
1065
1066 * added some definitions for the 'error_status' mask values that are
1067   passed to the cleanup function associated with each
1068   module-data-item. These numbers were needed to keep up with changing
1069   a data item (see for example the code in pam_unix/support.-c that
1070   manages the maximum number of retries so far). Will see what Sun says
1071   (current indications are positive); this may be undone before 1.0 is
1072   released.  Here are the definitions (from pam_modules.h).
1073
1074 #define PAM_DATA_SILENT    0x40000000     /* used to suppress messages... */
1075 #define PAM_DATA_REPLACE   0x20000000     /* used when replacing a data item */
1076
1077 * Changed the .../conf/pam.conf file. It now points to the new
1078   pam_unix module for 'su' and 'passwd' [can get these as SimpleApps --
1079   I use them for testing. A more extensive selection of applications is
1080   available from Red Hat...]
1081
1082 * corrected a bug in pam_dispatch. Basically, the problem was that if
1083   all the modules were "sufficient" then the return value for this
1084   function was never set. The net effect was that _pam_dispatch_aux
1085   returned success when all the sufficient modules failed. :^( I think
1086   this is the correct fix to a problem that the Red Hat folks had
1087   found...
1088
1089 sopwith* Removed advisory locking from libpam (thanks for the POSIX patch
1090   goes to Josh Wilmes's, my apologies for not using it in the
1091   end.). Advisory locking did not seem sufficiently secure for libpam.
1092   Thanks to Werner Almesberger for identifying the corresponding "denial
1093   of service attack". :*(
1094
1095 * related to fix, have introduced a lock file /var/lock/subsys/PAM
1096   that can be used to indicate the system should pay attention to
1097   advisory locking on /etc/pam.conf file. To implement this you need to
1098   define PAM_LOCKING though. (see .52/libpam)
1099
1100 * modified pam_fail_delay() function. Couldn't find the "not working"
1101   problem indicated by Michael, but modified it to do pseudo-random
1102   delays based on the values indicated by pam_fail_delay() -- the
1103   function "that may eventually go away"... Although Sun is warming to
1104   the idea.
1105
1106 * new modules include:
1107
1108         pam_shells    - authentication for users with a shell listed in
1109                         /etc/shells. Erik Troan <ewt@redhat.com>
1110
1111         pam_listfile  - authentication based on the contents of files.
1112                         Set to be more general than the above in the
1113                         future. UNTESTED. Elliot Lee <@redhat.com>
1114                         [Note, this module compiles with a non-trivial
1115                         warning: AGM]
1116
1117 Thu Aug  8 22:32:15 PDT 1996 (Andrew Morgan <morgan@physics.ucla.edu>)
1118
1119 * modified makefiles to take more of their installation instructions
1120   from the top level makefile. Desired for integration into the Debian
1121   distribution, and generally a good idea.
1122
1123 * fixed memory arithmetic in pam_handlers
1124   -- still need to track down why failure to load modules can lead to
1125   authentication succeding..
1126
1127 * added tags for new modules (smartcards from Alex -- just a promise
1128   at this stage) and a new module from Elliot Lee; pam_securetty
1129
1130 * I have not had time to smooth out the wrinkles with it, but Alex's
1131   pam_unix modifications are provided in pam_unix-alex (in the modules
1132   directory) they will not be compiled by 'make all' and I can't even
1133   say if they do compile... I will try to look at them for .52 but, in
1134   the mean time please feel free to study/fix/discuss what is there.
1135
1136 * pam_rhosts module. Removed code for manually setting the ruser
1137   etc. This was not very secure.
1138
1139 * [remade .ps docs to be in letter format -- my printer complains
1140   about a4]
1141
1142 Sunday July, 7 12:45:00 PST 1996 (Andrew Morgan <morgan@physics.ucla.edu>)
1143
1144 * No longer accompanying the Linux-PAM release with apps installed.
1145   [Will provide what was here in a separate package.. (soon)
1146 lib   Also see http://www.redhat.com/pam for some more (in .rpm form...)]
1147
1148 * renamed libmisc to libpam_misc. It is currently configured to only compile
1149   the static library. For some strange reason (perhaps someone can
1150   investigate) my Linux 2.0.0 kernel with RedHat 3.0.3 system
1151   segfaults when I compile it to be a dynamic library. The segfault
1152   seems to be inside the call to the ** dl_XXX ** function...!?
1153
1154   There is a simple flag in the libpam_misc/Makefile to turn on dynamic
1155   compiles.
1156
1157 * Added a little unofficial code for delay support in libpam (will probably
1158   disappear later..) There is some documentation for it in the pam_modules
1159   doc now. That will obviously go too.
1160
1161 * rewritten pam_time to use *logic* to specify the stringing together of
1162   users/times/terminals etc.. (what was there before was superficially
1163   logical but basically un-predictable!)
1164
1165 * added pam_group. Its syntax is almost identical to pam_time but it
1166   has another field added; a list of groups to make the user a member
1167   of if they pass the previous tests. It seems to not co-exist too well
1168   with the groups in the /etc/group but I hope to have that fixed by
1169   the next release...
1170
1171 * minor re-formatting of pam_modules documentation
1172
1173 * removed ...// since it wasn't being used and didn't look like it
1174   would be!
1175
1176 GCCSunday 23 22:35:00 PST 1996   (Andrew Morgan <morgan@physics.ucla.edu>)
1177
1178 * The major change is the addition of a new module: pam_time for
1179   restricting access on terminals at given times for indicated users
1180   it comes with its own configuration file /etc/security/time.conf
1181   and the sample file simply restricts 'you' from satisfying the blank
1182   application if they try to use blank from any tty*
1183
1184 * Small changes include
1185 - altered pam.conf to demonstrate above new module (try typing username: you)
1186 - very minor changes to the docs (pam_appl and pam_modules)
1187
1188 Saturday June 2 01:40:00 PST 1996  (Andrew Morgan <morgan@physics.ucla.edu>)
1189
1190 *** PLEASE READ THE README, it has changed ***
1191
1192 * NOTE, 'su' exhibits a "system error", when static linking is
1193   used. This is because the pam_unix_... module currently only has
1194   partial static linking support. This is likely to change on Monday
1195   June 3, when Alex makes his latest version availible. I will include
1196   the updated module in next release.
1197
1198 changes for .42:
1199
1200 * modified the way in which libpam/pam_modules.h defines prototypes for
1201   the pam_sm_ functions. Now the module must declare which functions it
1202   is to provide *before* the #include <security/pam_modules.h> line.
1203   (for contrasting examples, see the pam_deny and pam_rootok modules)
1204   This removed the ugly hack of defining functions that are never called
1205   to overcome  warnings... This seems much tidier.
1206 insterted* updated the TODO list. (changed mailing list address)
1207 * updated README in .../modules to reflect modifications to static
1208   compliation protocol
1209 * modified the pam_modules documentation to describe this.
1210 * corrected last argument of pam_get_item( ... ) in
1211   pam_appl/modules.sgml, to "const void **".
1212 * altered GNU GPL's in the documentation, and various other parts of
1213   the distribution. *Please check* that any code you are responsible for
1214   is corrected.
1215 * Added ./Copyright (please check that it is acceptable)
1216 * updated ./README to make current and indicate the new mailing list
1217   address
1218 * have completely rewritten pam_filter. It now runs modular filter
1219   executables (stored in /usr/sbin/pam_filter/) This should make it
1220   trivial for others to write their own filters.. If you want yours
1221   included in the distribution please email the list/me.
1222 * changes to libpam; there was a silly bug with multiple arguments on a
1223   pam.conf line that was broken with a '\<LF>'.
1224 * 'su' rearranged code (to make better use of PAM)
1225   *Also* now uses POSIX signals--this should help the Alpha port.
1226 * 'passwd' now uses getlogin() to determine who's passwords to change.
1227
1228 Sunday May 26 9:00:00 PST 1996 (Andrew Morgan <morgan@physics.ucla.edu>)
1229
1230 * fixed module makefiles to create needed dynamic/static subdirectories
1231
1232 Saturday May 25 20:30:27.8 PST 1996 (Andrew Morgan <morgan@physics.ucla.edu>)
1233
1234 * LOTS has changed regarding how the modules/libpam are built.
1235 *  Michael's mostly complete changes for static support--see below
1236   (Andrew got a little carried away and automated the static linking
1237   of modules---bugs are likely mine ;( )
1238 * Thanks mostly to Michael, libpam now compiles without a single warning :^]
1239 * made static modules/library optional.
1240 CFLAGS* added 'make sterile' to top level makefile. This does extraclean and remove
1241 * added Michael and Joseph to documentation credits (and a subsection for
1242   future documentation of static module support in pam_modules.sgml)
1243 * libpam; many changes to makefiles and also automated the inclusion of
1244   static module objects in pam_static.c
1245 * modified modules for automated static/dynamic support. Added static & 
1246   dynamic subdirectories, as instructed by Michael
1247 * removed an annoying syslog message from pam_filter: "parent exited.."
1248 * updated todo list (anyone know anything about svgalib/X? we probably should
1249   have some support for these...)
1250
1251 Friday May 24 16:30:15 EDT 1996 (Michael K. Johnson <johnsonm@redhat.com>)
1252
1253 * Added first (incomplete) cut at static support.
1254   This includes:
1255    . changes in libpam, including a new file, pam_static.c
1256    . changes to modules including exporting struct of function pointers
1257    . static and dynamic linking can be combined
1258    . right now, the only working combinations are just dynamic
1259      linking and dynamic libpam.so with static modules linked
1260      into libpam.so.  That's on the list of things to fix...
1261    . modules are built differently depending on whether they
1262      are static or dynamic.  Therefore, there are two directories
1263      under each module directory, one for static, and one for
1264      dynamic modules.
1265 * Fixed random brokenness in the Makefiles.  [ foo -nt bar ] is
1266   rather redundant in a makefile, for instance.  Also, passing
1267    on the command line is broken because it cannot be
1268   overridden in any way (even adding important parts) in lower-level
1269   makefiles.
1270 * Unfortunately, fixing some of the brokenness meant that I used
1271   GNU-specific stuff.  However, I *think* that there was GNU-specific
1272   stuff already.  And I think that we should just use the GNU
1273   extensions, because any platform that GNU make doesn't port to
1274   easily will be hard to port to anyway.  It also won't be likely
1275 passwd  to handle autoconf, which was Ted's suggestion for getting
1276   around limitations in standard make...
1277   For now, I suggest that we just use some simple GNU-specific
1278   extensions.
1279
1280 Monday May 20 22:00:00 PST 1996 (Andrew Morgan <morgan@physics.ucla.edu>)
1281
1282 * added some text to pam_modules.sgml
1283 * corrected Marek's name in all documentation
1284 * made pam_stress conform to chauthtok conventions -- ie can now request
1285   old password before proceeding.
1286 * included Alex's latest unix module
1287 * included Al's + password strength checking module
1288 * included pam_rootok module
1289 * fixed too many bugs in libpam.. all subtly related to the argument lists
1290   or use of syslog. Added more debugging lines here too.
1291 * fixed the pam.conf file
1292 * deleted pam_test module. It is pretty old and basically superceeded
1293   by pam_stress
1294
1295 Friday May 9 1:00:00 PST 1996 (Andrew Morgan <morgan@physics.ucla.edu>)
1296
1297 * updated documentaion, added Al Longyear to credits and corrected the
1298   spelling of Jeff's name(!). Most changes to pam.sgml (even added a figure!)
1299 * new module pam_rhosts_auth (from Al Longyear)
1300 * new apps rlogind and ftpd (a patch) from Al.
1301 * modified 'passwd' to not call pam_authenticate (note, none of the
1302   modules respect this convention yet!)
1303 * fixed bug in libpam that caused trouble if the last line of a
1304   pam.conf file ends with a module name and no newline character
1305 * also made more compatable with documentation, in that bad lines in
1306   pam.conf are now ignored rather than causing libpam to return an
1307   error to the app.
1308 * libpam now overwrites the AUTHTOKs when returning from
1309   pam_authenticate and pam_chauthtok calls (as per Sun/RFC too)
1310 * libpam is now installed as libpam.so.XXX in a way that ldconfig can
1311   handle!
1312
1313
1314 Wednesday May 1 22:00:00 PST 1996 (Andrew Morgan <morgan@physics.ucla.edu>)
1315
1316 * removed .../test directory, use .../examples from now on.
1317 * added .../apps directory for fully functional applications
1318   - the apps directory contains directories that actually contain the apps.
1319     the idea is to make application compilation conditional on the presence
1320     of the directory. Note, there are entries in the Makefile for
1321     'login' and 'ftpd' that are ready for installation... Email me if
1322     you want to reserve a directory name for an application you are
1323     working on...
1324 * similar changes to .../modules makefile [entries for pam_skey and
1325   pam_kerberos created---awaiting the directories.] Email me if you
1326   want to register another module...
1327 * minor changes to docs.. Not really worth reprinting them quite yet!
1328   [save the trees]
1329 * added misc_conv to libmisc. it is a generic conversation function
1330   for text based applications. [would be nice to see someone create
1331   an Xlib and/or svgalib version]
1332 * fixed ctrl-z/c bug with pam_filter module [try xsh with the default
1333   pam.conf file]
1334 * added 'required' argument to 'pam_stress' module.
1335 * added a TODO list... other suggestions to the list please.
1336
1337 Saturday April 7 00:00:00 PST 1996 ( Andrew Morgan <morgan@physics.ucla.edu> )
1338
1339 * Alex and Marek please note I have altered _pam_auth_unix a little, to
1340   make it get the passwords with the "proper method" (and also fixed it
1341   to not have as many compiler warnings)
1342 * updated the conf/pam.conf file
1343 * added new example application examples/xsh.c (like blank but invokes
1344   /bin/sh)
1345 * Marc's patches for examples/blank.c (and AGM's too)
1346 * fixed stacking of modules in libpam/pam_handlers.c
1347 * fixed RESETing in libpam/pam_item.c
1348 * added new module modules/pam_filter/ to demonstrate the possibility
1349   of inserting an arbitrary filter between the terminal and the
1350   application that could do customized logging etc... (see use of
1351   bin/xsh as defined in conf/pam.conf)
1352
1353
1354 Saturday March 16 19:00:00 PST 1996 ( Andrew Morgan <morgan@physics.ucla.edu> )
1355
1356 These notes are for 0.3 I don't think I've left anything important
1357 out, but I will use emacs 'C-x v a' next time! (Thanks Jeff)
1358
1359         * not much has changed with the functionality of the Linux-PAM lib
1360           .../libpam
1361                 - pam_password calls module twice with different arguments
1362                 - added const to some of the function arguments
1363                 - added PAM_MAX_MES_ to <security/_pam_types.h>
1364                 - was a lot over zealous about purging old passwords...
1365                   I have removed much of this from source to make it
1366                   more compatible with SUN.
1367                 - moved some PAM_... tokens to pam_modules.h from _pam_types.h
1368                   (no-one should notice)
1369
1370         * added three modules: pam_permit pam_deny pam_stress
1371           no prizes for guessing what the first two do. The third is
1372           a reasonably complete (functional) module. Is intended for testing
1373           applications with.
1374
1375         * fixed a few pieces of examples/blank.c so that it works (with
1376           pam_stress)
1377
1378         * ammended the documentation. Looking better, but suggestions/comments
1379           very welcome!
1380
1381 Sunday March 10 10:50:00 PST 1996 ( Andrew Morgan <morgan@physics.ucla.edu> )
1382
1383 These notes are for Linux-PAM release 0.21.  They cover what's changed
1384 since I relased 0.2.
1385
1386         * am now using RCS
1387         * substantially changed ./README
1388         * fixed bug reading \\\n in pam.conf file
1389         * small changes to documentation
1390         * added `blank' application to ./examples (could be viewed as
1391           a `Linux-PAM aware' application template.)
1392         * oops. now including pam_passwd.o and pam_session.o in pamlib.so
1393         * compute md5 checksums for all the source when making a release
1394             - added `make check' and `make RCScheck' to compute md5 checksums
1395         * create a second tar file with all the RCS files in.
1396         * removed the .html and .txt docs, supplying sgml sources instead.
1397             - see README for info on where to get .ps files
1398
1399 Thursday March 6 0:44:?? PST 1996 ( Andrew Morgan <morgan@physics.ucla.edu> )
1400
1401 These notes are for Linux-PAM release 0.2.  They cover what's changed
1402 since Marc Ewing relased 0.1.
1403
1404 **** Please note. All of the directories in this release have been modified
1405 **** slightly to conform to the new pamlib. A couple of new directories have
1406 **** been added. As well as some documentation. If some of your code
1407 **** was in the previous release. Feel free to update it, but please
1408 **** try to conform to the new headers and Makefiles.
1409
1410 * Andrew Morgan (morgan@physics.ucla.edu) is making this release
1411  availible, Marc has been busy...!
1412
1413 * Marc's pam-0.1/lib has been (quietly) enhanced and integrated into
1414  Alex Yurie's collected tree of library and module code
1415  (linux-pam.prop.1.tar.gz). Most of the changes are to do with error
1416  checking. Some more robustness in the reading of the pam.conf file
1417  and the addition of the pam_get_user() function.
1418
1419 * The pam_*.h files have been reorganized to logically enforce the
1420  separation of modules from applications. [Don't panic! Apart from
1421  changing references of the form
1422
1423         #include "pam_appl.h"
1424
1425  to
1426
1427         #include <security/pam_appl.h>
1428
1429  The reorganization should be backwardly compatable (ie. a module
1430  written for SUN will be as compatable as it was before with the
1431  previous version ;)~ ]
1432
1433  (All of the source in this tree now conforms to this scheme...)
1434
1435  The new reorganization means that modules can be compiled with a
1436  single header, <security/pam_modules.h>, and applications with
1437  <security/pam_appl.h>.
1438
1439 * I have tried to remove all the compiler warnings from the updated
1440  "pamlib/*.c" files. On my system, (with a slightly modified <dlfcn.h>
1441  email me if it interests you..) there are only two warnings that
1442  remain: they are that ansi does not permit void --> fn ptr
1443  assignment. K&Rv2 doesn't mention this....? As a matter of principle,
1444  if anyone knows how to get rid of that warning... please
1445  tell. Thanks! "-pedantic"
1446
1447 * you can "make all" as a plain user, but
1448
1449 * to "make install" you must be root. The include files are placed in
1450  /usr/include/security. The libpam.so library is installed in /usr/lib
1451  and the modules in /usr/lib/security. The two test binaries
1452  are installed in the Linux-PAM-0.2/bin directory and a chance is given to
1453  replace your /etc/pam.conf file with the one in Linux-PAM-0.2/conf.
1454
1455 * I have included some documentation (pretty preliminary at the
1456 moment) which I have been working on in .../doc .
1457
1458 I have had a little trouble with the modules, but atleast there are no
1459 segfaults! Please try it out and discuss your results... I actually
1460 hope it all works for you. But, Email any bugs/suggestions to the
1461 Linux-PAM list: linux-pam@mit.edu .....
1462
1463 Regards,
1464
1465 Andrew Morgan
1466 (morgan@physics.ucla.edu)
1467
1468
1469 Sat Feb 17 17:30:24 EST 1996 (Alexander O. Yuriev alex@bach.cis.temple.edu)
1470
1471         * conf directory created with example of pam_conf
1472         * stable code from pam_unix is added to modules/pam_unix
1473         * test/test.c now requests username and password and attempts
1474           to perform authentication
1475