pam_putenv 子例程

在线编辑

用途

定义 PAM 环境变量。

库

PAM 库 (libpam.a)

语法

#include <security/pam_appl.h>

int pam_putenv (PAMHandle, NameValue)
pam_handle_t *PAMHandle;
const char *NameValue;

描述

pam_putenv 子例程在 PAM 句柄 PAMHandle中设置和删除环境变量。 应用程序可以通过调用 pam_getenv () 或 pam_getenvlist () 来检索定义的变量，并将它们添加到用户的会话中。 如果已定义具有相同名称的变量，那么旧值将替换为新值。

参数

项 描述
PAMHandle 从先前对 pam_start ()的调用中获取的 PAM 认证句柄。
NameValue 要存储在 PAM 句柄的环境部分中的格式为 name=value 的字符串。 对于传入字符串的格式，将显示以下行为:
名称=值
在环境中创建或覆盖变量的值。
名称=
将变量设置为空字符串。
名称
从环境中删除变量 (如果当前已定义)。

返回值

成功完成后， pam_putenv 将返回 PAM_SUCCESS。 如果例程失败，那么将根据实际错误返回 PAM_SYSTEM_ERR 或 PAM_BUF_ERR 。

错误代码

项 描述
PAM_SYSTEM_ERR 发生系统错误。
PAM_BUF_ERR 发生内存错误。