pam_error(3)

pam_error3

Display error messages to the user

Usage

#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);

Overview

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

PAM_BUF_ERR

Memory buffer error.

PAM_CONV_ERR

Conversation failure.

PAM_SUCCESS

Error message was displayed.

PAM_SYSTEM_ERR

System error.

Releases

10 releases since Debian 5.0 (Lenny); the text changed 8 times.

  1. 5.0
  2. 6.0
  3. 7
  4. 8–9
  5. 10
  6. 11
  7. 12
  8. 13
  9. Arch

Standards

The pam_error and pam_verror functions are Linux-PAM extensions.

From pam 1.7.3-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.