Sous-routine pam_setcred

Editer en ligne

Objectif

Etablit, modifie ou supprime les données d'identification de l'utilisateur pour l'authentification.

Bibliothèque

Bibliothèque PAM (libpam.a)

Syntaxe

#include <security/pam_appl.h>

int pam_setcred (PAMHandle, Flags)
pam_handle_t *PAMHandle;
int Flags;

Descriptif

La sous-routine pam_setcred permet de modifier les données d'identification de l'utilisateur PAM pour la session PAM en cours. Des fonctions telles que l'établissement, la suppression, le renouvellement et l'actualisation des données d'identification sont définies.

Paramètres

Article Descriptif
PAMhandle Descripteur PAM représentant la session d'authentification d'utilisateur en cours. Ce descripteur est obtenu par un appel à pam_start ().
Flags Les indicateurs sont utilisés pour définir les options pam_setcred . Les indicateurs reconnus sont les suivants:
  • PAM_SILENT
    • Aucun message ne doit être affiché.
  • PAM_CRED*
    • Définit les données d'identification de l'utilisateur. Il s'agit de la valeur par défaut.
  • PAM_DELETE_CRED*
    • Supprime les données d'identification de l'utilisateur.
  • PAM_REINITIALIZE_CRED*
    • Renouvelle les données d'identification de l'utilisateur.
  • PAM_REFRESH_CRED*
    • Actualisez les données d'identification de l'utilisateur, en étendant leur durée de vie.
*Mutually exclusive, mais peut être logiquement OR'd avec PAM_SILENT. Si l'un d'entre eux n'est pas défini, PAM_ÉTABLIS_CRED est utilisé.

Valeurs renvoyées

Une fois l'opération terminée, pam_setcred renvoie PAM_SUCCESS. Si la routine échoue, une erreur différente est renvoyée, en fonction de l'erreur réelle.

Codes d'erreur

Article Descriptif
PAM_CRED_UNAVAIL Les données d'identification de l'utilisateur sont introuvables.
PAM_CRED_EXPIRED Les données d'identification de l'utilisateur ont expiré.
PAM_CRED_ERR Une erreur s'est produite lors de la définition des données d'identification de l'utilisateur.
PAM_USER_INCONNU L'utilisateur est inconnu.
PAM_OPEN_ERR L'un des modules d'authentification PAM n'a pas pu être chargé.
PAM_SYMBOL_ERR Un élément nécessaire n'est pas disponible pour un module PAM.
PAM_SERVICE_ERR Une erreur s'est produite dans un module PAM.
PAM_SYSTEM_ERR Une erreur système s'est produite.
PAM_BUF_ERR Une erreur de mémoire s'est produite.
PAM_CONV_ERR Une erreur de conversation s'est produite.
PAM_PERM_DENIED Les droits d'accès ont été refusés à l'utilisateur.