HP-UX Reference (11i v3 07/02) - 3 Library Functions N-Z (vol 7)

pam_strerror(3) pam_strerror(3)

NAME

pam_strerror - get PAM error message string

SYNOPSIS

cc [ ﬂag ... ] ﬁle ...

-lpam [ library ... ]

#include <security/pam_appl.h>

const char *pam_strerror(pam_handle_t *

pamh, int errnum);

DESCRIPTION

pam_strerror()

maps the PAM error number in errnum to a PAM error message string, and returns a

pointer to that string. The application should not free or modify the string returned.

The pamh argument is the PAM handle obtained by a prior call to

pam_start() .Ifpam_start()

returns an error, a NULL PAM handle should be passed.

APPLICATION USAGE

Refer to pam(3) for information on thread-safety of PAM interfaces.

ERRORS

pam_strerror() returns NULL if errnum is out-of-range.