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