head	1.5;
access;
symbols;
locks; strict;
comment	@# @;


1.5
date	96.11.10.20.11.22;	author morgan;	state Exp;
branches;
next	1.4;

1.4
date	96.11.10.02.33.01;	author morgan;	state Exp;
branches;
next	1.3;

1.3
date	96.06.24.05.47.31;	author morgan;	state Exp;
branches;
next	1.2;

1.2
date	96.06.02.08.05.47;	author morgan;	state Exp;
branches;
next	1.1;

1.1
date	96.05.26.04.37.31;	author morgan;	state Exp;
branches;
next	;


desc
@some comments for converting dynamic modules to compile statically
@


1.5
log
@update for .53
@
text
@This directory contains the modules.

If you want to reserve a module name please email <pam-list@@redhat.com>
and announce its name. Andrew Morgan, <morgan@@parc.power.net>, will
add it to the Makefile in the next release of Linux-PAM.

As of Linux-PAM-0.40 modules can optionally conform to the static
modules conventions.

This file was updated for Linux-PAM-0.53.

The conventions are as follows:

There are only 6 functions that a module may declare as "public" they
fall into 4 managment groups as follows:

	functions					Management group
	------------------------------------------	----------------
	pam_sm_authenticate, pam_sm_setcred,		PAM_SM_AUTH
	pam_sm_acct_mgmt,				PAM_SM_ACCOUNT
	pam_sm_open_session, pam_sm_close_session,	PAM_SM_SESSION
	pam_sm_chauthtok				PAM_SM_PASSWORD

If a module contains definitions for any of the above functions, it
must supply definitions for all of the functions in the corresponding
management group.

The header file that defines the ANSI prototypes for these functions
is <security/pam_modules.h> . In the case that the module wishes to
offer the functions of a given managment group, it must #define
PAM_SM_XXX, where XXX is one of the above four tokens. These
definitions must occur *prior* to the 
#include <security/pam_modules.h> line.

The pam_sm_... functions should be defined to be of type 'PAM_EXTERN int'.

In the case that a module is being compiled with PAM_STATIC #define'd
it should also define a globally accessible structure
_"NAME"_modstruct containing references to each of the functions
defined by the module. (this structure is defined in
<security/pam_modules.h>.  "NAME" is the title of the module
(eg. "pam_deny")

If a module wants to be included in the static libpam.a its Makefile
should execute "register_static" with appropriate arguments (in this
directory).

[
For SIMPLE working examples, see

	./modules/pam_deny/* and ./modules/pam_rootok/* 
.]

Andrew Morgan
96/11/10
@


1.4
log
@changed email address
@
text
@d48 5
a52 2
[ for working examples, see .../modules/pam_deny/* and
.../modules/pam_rootok/* ]
d55 1
a55 1
96/11/9
@


1.3
log
@changed the mailing list address
@
text
@d4 1
a4 1
and announce its name. Andrew Morgan, <morgan@@physics.ucla.edu>, will
d10 1
a10 3
This file was updated for Linux-PAM-0.42.

	**NOTE THESE CONVENTIONS ARE LIKELY TO CHANGE**.
d52 1
a52 1
96/5/31
@


1.2
log
@changes for .42 to update the protocol for statically defining modules
@
text
@d3 2
a4 2
If you want to reserve a module name please email "linux-pam@@mit.edu"
and announce its name. Andrew Morgan, "morgan@@physics.ucla.edu", will
@


1.1
log
@Initial revision
@
text
@d10 2
d14 1
a14 1
The conventions are loosely as follows:
d16 2
a17 1
There are only 6 functions that a module may declare as "public" they are:
d19 26
a44 16
	pam_sm_authenticate, pam_sm_setcred,
	pam_sm_acct_mgmt,
	pam_sm_open_session, pam_sm_close_session,
	pam_sm_chauthtok

All modules must define all of the functions in at least one of the
lines above. A module can define all of these functions...

These functions should be defined to be of type 'PAM_EXTERN int' (
PAM_EXTERN is defined in <security/pam_modules.h> )

In the case that a module is being compiled with STATIC #define'd it
should also define a globally accessible structure _"NAME"_modstruct
containing references to each of the functions defined by the
module. (this structure is defined in <security/pam_modules.h>. "NAME"
is the title of the module (eg. "pam_deny")
d50 2
a51 4
Static modules must statically define all the unused module
functions--to shut gcc up...

[ for a working example, see .../modules/pam_rootok/* ]
d54 1
@
