NAME

pam-client - A command line PAM client

SYNOPSIS

pam-client [--help] --login login [--password password] [--service svc]

DESCRIPTION

pam-client is a simple command line utility useful for testing the PAM configuration for use with Net::Radius::Server(3) to authenticate remote users. pam-client allows for the display and enumeration of all the PAM-specific information available to Net::Radius::Server::PAM(3) match and set methods.

The following options are recognized (See Getopt::Long(3) for information on how to specify them in the command line):

--help

Produces this documentation.

--login login

The login or username for which authentication and authorization with PAM will be attempted.

--password password

The password associated to the username. It will be prompted if not specified.

--service svc

The service identifier to use for the PAM interaction. Defaults to test.

pam-client goes through each phase of the authentication and authorization process as specified by PAM, sending to STDOUT the relevant diagnostics.

HISTORY

$Log$
Revision 1.1  2006/11/13 17:45:45  lem
Add initial version of the pam-client utility

LICENSE AND WARRANTY

This code and all accompanying software comes with NO WARRANTY. You use it at your own risk.

This code and all accompanying software can be used freely under the same terms as Perl version 5.8.6 itself.

AUTHOR

Luis E. Muñoz <luismunoz@cpan.org>

SEE ALSO

The Linux-PAM Guides for System Administrators and Application Developers, for guidance in how does PAM work in your system.

perl(1), Net::Radius::Server(3), Net::Radius::Server::PAM(3), Authen::PAM(3), Getopt::Long(3), pam(8).