pam_error(3) — Linux manual page

PAM_ERROR(3)                 Linux-PAM Manual                PAM_ERROR(3)

NAME         top

       pam_error, pam_verror - display error messages to the user

SYNOPSIS         top

       #include <security/pam_ext.h>

       int pam_error(pam_handle_t *pamh, const char *fmt, ...);

       int pam_verror(pam_handle_t *pamh, const char *fmt, va_list args);

DESCRIPTION         top

       The pam_error function prints error messages through the
       conversation function to the user.

       The pam_verror function performs the same task as pam_error() with
       the difference that it takes a set of arguments which have been
       obtained using the stdarg(3) variable argument list macros.

RETURN VALUES         top

       PAM_BUF_ERR
           Memory buffer error.

       PAM_CONV_ERR
           Conversation failure.

       PAM_SUCCESS
           Error message was displayed.

       PAM_SYSTEM_ERR
           System error.

SEE ALSO         top

       pam_info(3), pam_vinfo(3), pam_prompt(3), pam_vprompt(3), pam(8)

STANDARDS         top

       The pam_error and pam_verror functions are Linux-PAM extensions.

COLOPHON         top

       This page is part of the linux-pam (Pluggable Authentication
       Modules for Linux) project.  Information about the project can be
       found at ⟨http://www.linux-pam.org/⟩.  If you have a bug report
       for this manual page, see ⟨//www.linux-pam.org/⟩.  This page was
       obtained from the project's upstream Git repository
       ⟨https://github.com/linux-pam/linux-pam.git⟩ on 2023-12-22.  (At
       that time, the date of the most recent commit that was found in
       the repository was 2023-12-18.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there is
       a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

Linux-PAM Manual                12/22/2023                   PAM_ERROR(3)

HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH.