pam_setenv(3)

pam_setenv3

Mirrors setenv(3)

Usage

#include <sys/types.h>

#include <security/pam_appl.h>

int

pam_setenv(pam_handle_t *pamh, const char *name, const char *value, int overwrite);

Overview

The pam_setenv() function sets an environment variable. Its semantics are similar to those of setenv(3), but it modifies the PAM context's environment list instead of the application's.

Return values

The pam_setenv() function returns one of the following values:

[PAM_SUCCESS]

Success.

[PAM_BUF_ERR]

Memory buffer error.

[PAM_SYSTEM_ERR]

System error.

Releases

56 releases since FreeBSD 5.0-RELEASE; the text changed 15 times.

  1. 5.0
  2. 5.1
  3. 5.2–5.2.1
  4. 5.3–5.5
  5. 6.0–6.3
  6. 6.4
  7. 7.0
  8. 7.1–9.1
  9. 9.2
  10. 9.3–10.0
  11. 10.1–11.2
  12. 11.3–11.4
  13. 12.0–12.2
  14. 12.3–13.2
  15. 13.3–14.5
  16. 15.0–16.0

Standards

The pam_setenv() function is an OpenPAM extension.

Authors

The pam_setenv() function and this manual page were developed for the FreeBSD Project by ThinkSec AS and Network Associates Laboratories, the Security Research Division of Network Associates, Inc. under DARPA/SPAWAR contract N66001-01-C-8035 (“CBOSS”), as part of the DARPA CHATS research program.

The OpenPAM library is maintained by Dag-Erling Smørgrav ⟨[email protected]⟩.

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.