EN JA
PAM_CHAUTHTOK(3)
PAM_CHAUTHTOK(3) FreeBSD Library Functions Manual PAM_CHAUTHTOK(3)

名称

pam_chauthtokPAM フレームワーク中でパスワードに関連する機能を実行する

ライブラリ

Pluggable Authentication Module Library (libpam, -lpam)

書式

#include < sys/types.h>
#include < security/pam_appl.h>

int
pam_chauthtok( pam_handle_t *pamh, int flags);

解説

pam_chauthtok() 関数は、 pamh 引数によって指定される pam コンテキストに関連しているユーザのために認証トークンを変更することを試みます。

flags 引数は、バイナリまたは 0 以上の次の値です:

PAM_SILENT
あらゆるメッセージを出力しません。
PAM_CHANGE_EXPIRED_AUTHTOK
期限が切れた、それらの認証トークンだけを変更します。

その他のビットが設定されるなら、 pam_chauthtok() は、 PAM_SYMBOL_ERR を返します。

戻り値

pam_chauthtok() 関数は、次の値の 1 つを返します:
[ PAM_ABORT]
一般的な失敗。
[ PAM_AUTHTOK_DISABLE_AGING]
時効のために無効にされた認証トークン。
[ PAM_AUTHTOK_ERR]
認証トークンの失敗。
[ PAM_AUTHTOK_LOCK_BUSY]
認証トークンのロックビジー。
[ PAM_AUTHTOK_RECOVERY_ERR]
古い認証トークンの復旧に失敗した。
[ PAM_BUF_ERR]
メモリバッファエラー。
[ PAM_CONV_ERR]
会話の失敗。
[ PAM_PERM_DENIED]
パーミッション (許可) が拒否されました。
[ PAM_SERVICE_ERR]
サービスモジュールでのエラー。
[ PAM_SYMBOL_ERR]
無効のシンボル。
[ PAM_SYSTEM_ERR]
システムエラー。
[ PAM_TRY_AGAIN]
再試行。

関連項目

pam(3), pam_strerror(3)

規格

X/Open Single Sign-On Service (XSSO) - Pluggable Authentication Modules, June 1997.

作者

pam_chauthtok() 関数とこのマニュアルページは、 DARPA CHATS 研究プログラムの一環として、 DARPA/SPAWAR 契約 N66001-01-C-8035 (“CBOSS”) の下で ThinkSec AS と Network Associates Laboratories, the Security Research Division of Network Associates, Inc. によって FreeBSD プロジェクトのために開発されました。

OpenPAM ライブラリは、 Dag-Erling Smørgrav <des@des.no>によって保守されています。

September 7, 2013 FreeBSD