userhelper − Une interface d’aide pour pam.

userhelper [ -t ] [ -w prog args ] [ -c ] [ −f nom−complet ] [ −o bureau ] [ −p téléphone-bureau ] [ −h téléphone-perso ] [ −s shell ] [ nom-utilisateur ]

NOTEZ que ce programme n’est PAS prévu pour une utilisation interactive. Si vous voulez modifier cette information sur la ligne de commandes, utilisez passwd(1), chfn(1), ou chsh(1).

Ce programme fournit une interface de base pour modifier le mot de passe d’utilisateur, l’information gecos, et le shell. La différence principale entre ce programme et ses équivalents traditionnels est que l’invite apparaît sur la sortie standard pour faciliter la tâche d’un programme graphique qui voudrait l’utiliser comme un processus fils.

La sortie est de la forme :

<nombre> <chaîne>

où le nombre est le type d’invite renvoyé via pamlib, et la chaîne de caractères est l’invite à fournir à l’utilisateur.

Les nombres d’invites peuvent valoir :

1

Afficher l’invite avec une entrée visible.

2

Afficher l’invite avec une entrée invisible.

3

Message d’information

4

Message d’erreur.

5

Nombre de messages envoyés dans ce bloc jusqu’à présent.

-t

Authentification en mode texte au lieu des types de message numérotés décrits ci-dessus ; utilisé uniquement avec -w.

-w

Spécifier un nom de programme et les arguments à lui passer. userhelper recherchera dans le fichier /etc/security/console.apps/nom_programme le nom d’utilisateur à authentifier qui est stocké par USER=valeur (valeur vaut d’habitude « root » ou le lexème magique « utilisateur » qui indique d’authentifier l’utilisateur courant) et le programme à exécuter qui est stocké par PROGRAM=valeur (valeur doit être un chemin absolu ou il sera ignoré). Si USER n’est pas spécifié, le nom de l’utilisateur courant est utilisé, et si PROGRAM n’est pas spécifié, userhelper recherchera nom_programme dans /sbin et /usr/sbin/. userhelper authentifiera ensuite l’utilisateur via pam et exécutera par après le programme nommé. Si SESSION=true est spécifié, alors userhelper établit une session pam et utilisera fork et exec, et ensuite attendra la terminaison du fils ; sinon, il effectue un simple exec sur le fils. userhelper est normalement appelé à partir de consolehelper via un lien symbolique. Si FALLBACK=true est spécifié, le programme sera lancé en tant qu’utilisateur si l’authentification échoue. L’authentification sera ensuite retentée deux fois (trois fois au total) à moins que quelque chose d’autre que RETRY=2 soit spécifié.

-c

Modifier le mot de passe de l’utilisateur courant. Notez que cette option ne peut être utilisée avec n’importe quelle autre option. Cela est dû à la limitation de l’interface de pamlib.

-f

Spécifier un Nom Complet.

-o

Spécifier un nouveau Bureau.

-p

Spécifier un nouveau Téléphone de Bureau.

-h

Spécifier un nouveau Téléphone Personnel.

-s

Spécifier un nouveau shell

Une valeur de retour non nulle indique qu’une erreur s’est produite. Ces erreurs sont :

1

L’authentification des mots de passe a échoué.

2

Un ou plusieurs champs GECOS est invalide. Cela se produit quand un « : » est fourni dans l’un des champs.

3

Erreur de réinitialisation de mot de passe.

4

Certains fichiers système sont verrouillés.

5

Utilisateur inconnu.

6

Droits insuffisants.

7

Appel invalide au programme.

8

Le shell fourni n’est pas valide (c.-Ã -d. qu’il n’existe pas dans /etc/shells).

9

Mémoire insuffisante.

10

N’a pas pu trouver le programme.

11

Ãchec de exec bien que le programme existe.

255

Erreur inconnue.

/etc/passwd

Les informations gecos et shell est stockée dans ce fichier.

/etc/shells

Ce fichier est examiné pour voir si le nouveau shell fourni est valide.

userpasswd(1), userinfo(1), consolehelper(8), chfn(1), chsh(1), passwd(5)

Otto Hammersmith <otto@redhat.com>
Michael K. Johnson <johnsonm@redhat.com>

Frédéric Delanoy <delanoy_f at yahoo.com>, 2000.