Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] getutent, getutid, getutline, pututline, setutent, endutent, utmpname - Accéder aux enregistrements utmp. [size=18] [b]Résumé[/b] [/size] [b]#include <utmp.h>[/b] [b]struct utmp getutent (void);[/b] [b][/b] [b][i]struct utmp getutid (struct utmp * ut );[/i][/b] [b][/b] [b][i]struct utmp getutline (struct utmp ut );[/i][/b] [b][i]void pututline (struct utmp * ut );[/i][/b] [b]void setutent (void);[/b] [b][/b] [b]void endutent (void);[/b] [b][i]void utmpname (const char * file );[/i][/b] [size=18] [b]Description[/b] [/size] [b]utmpname()[/b] indique le nom du fichier au format utmp à utiliser avec les autres fonctions. Si [b]utmpname()[/b] n'est pas appelé avant les autres fonctions, elles utiliseront le fichier [b]_PATH_UTMP[/b], défini dans [i]<paths.h>[/i]. [b]setutent()[/b] ramène le pointeur au début du fichier utmp. Il est généralement conseillé d'appeler cette fonction au début du programme. [b]endutent()[/b] ferme le fichier utmp. Ceci devrait être appelé une fois que le programme a terminé ses accès au fichier. [b]getutent()[/b] lit une ligne du fichier utmp, à la position courante. Elle renvoie un pointeur sur une structure contenant les divers champs de la ligne. [b]getutid()[/b] effectue une recherche dans le fichier utmp, à partir de la position courante, en se basant sur [i]ut[/i]. Si [i]ut[/i]->ut_type vaut [b]RUN_LVL[/b], [b]BOOT_TIME[/b], [b]NEW_TIME[/b], ou [b]OLD_TIME[/b], [b]getutid()[/b] recherchera le premier enregistrement dont le champ ut_type corresponde à [i]ut[/i]->ut_type. Si [i]ut[/i]->ut_type vaut [b]INIT_PROCESS[/b], [b]LOGIN_PROCESS[/b], [b]USER_PROCESS[/b], ou [b]DEAD_PROCESS[/b], [b]getutid()[/b] recherchera le premier enregistrement dont le champ ut_id corresponde à [i]ut[/i]->ut_id. [b]getutline()[/b] effectue une recherche dans le fichier utmp, à partir de la position courante. Elle examine les enregistrements dont le champ ut_type soit [b]USER_PROCESS[/b] ou [b]LOGIN_PROCESS[/b] et renvoie le premier dont le champ [b]ut_line[/b] corresponde à [i]ut[/i]->[b]ut_line[/b]. [b]pututline()[/b] écrit la structure utmp [i]ut[/i] dans le fichier utmp. Elle utilise [b]getutid()[/b] pour rechercher l'emplacement ou insérer le nouvel enregistrement. Si elle ne trouve pas d'emplacement approprié [b]pututline()[/b] ajoutera le nouvel enregistrement à la fin du fichier. [size=18] [b]Valeur renvoyée[/b] [/size] [b]getutent[/b](), [b]getutid[/b](), [b]getutline[/b]() et [b]pututline[/b]() renvoient un pointeur sur une [b]struct[/b] utmp statique, définie dans [i]<utmp.h>[/i] comme ci-dessous, ou NULL en cas d'erreur. .nf struct utmp { short ut_type; /* Type de connexion / pid_t ut_pid; / PID de la connexion / char ut_line[12]; / Périphérique de connexion / char ut_id[4]; / Nom de tty abrégé / time_t ut_time; / Heure de connexion / char ut_user[8]; / Nom d'utilisateur / char ut_host[16]; / Nom d'hôte distant / long ut_addr; / Adresse IP d'hôte distant / }; .fi [size=18] [b]Exemple[/b] [/size] L'exemple suivant ajoute et retire un enregistrement utmp, en supposant qu'il est invoqué depuis un pseudo-terminal. Dans une véritable application, il faudrait vérifier les valeurs renvoyées par [b]getpwuid[/b]() et [b]ttyname[/b](). .nf #include <string.h> #include <stdlib.h> #include <pwd.h> #include <unistd.h> #include <utmp.h> int main (int argc, char argv []) { struct utmp entry; system ("echo Avant d ajouter un enregistrement :;who"); entry . ut_type = USER_PROCESS; entry . ut_pid = getpid(); strcpy (entry . ut_line, ttyname (0) + strlen ("/dev/")); /* ne fonctionne qu'avec les pseudo tty /dev/tty[pqr][0-9a-z] / strcpy (entry . ut_id, ttyname (0) + strlen ("/dev/tty")); time (& entry.ut_time); strcpy (entry . ut_user, getpwuid (getuid ()) -> pw_name); memset (entry . ut_host, 0, UT_HOSTSIZE); entry . ut_addr = 0; setutent (); pututline (& entry); system ("echo Apres l ajout :;who"); entry . ut_type = DEAD_PROCESS; memset (entry.ut_line, 0, UT_LINESIZE); entry . ut_time = 0; memset (entry . ut_user, 0, UT_NAMESIZE); setutent (); pututline (& entry); system ("echo Apres suppression de l enregistrement :;who"); endutent (); return (0); } .fi [size=18] [b]Fichiers[/b] [/size] /var/run/utmp - Base de données des utilisateurs connectés. [b][/b] /var/log/wtmp - Base de données des connexions passées. [size=18] [b]Conformité[/b] [/size] XPG 2, SVID 2, Linux FSSTND 1.2     Dans XPG2 et SVID2 la fonction [i]pututline()[/i] est décrite comme de type void, et c'est les cas sur de nombreux systèmes (AIX, HPUX, Linux libc5). HPUX introduit une nouvelle fonction [i]_pututline()[/i] avec le prototype fourni plus haut pour [i]pututline()[/i] (comme avec la libc5 de Linux).     Toutes ces fonctions sont obsolètes maintenant sur les systèmes non-Linux. POSIX 1003.1-2001, comme XPG4.2, ne propose aucune de ces fonctions, mais utilise plutôt [b]#include <utmpx.h>[/b] [b]struct utmpx getutxent(void);[/b] [b][/b] [b]struct utmpx getutxid(const struct utmpx );[/b] [b][/b] [b]struct utmpx getutxline(const struct utmpx );[/b] [b][/b] [b]struct utmpx pututxline(const struct utmpx );[/b] [b][/b] [b]void setutxent(void);[/b] [b][/b] [b]void endutxent(void);[/b] La structure [i]utmpx[/i] est un sur-ensemble de la structure [i]utmp[/i], avec des champs supplémentaires, et une version plus large des champs existants. Les fichiers correspondants sont souvent [i]/var//utmpx[/i] et [b]/var//wtmpx .[/b]     D'un autre côté, la GlibC sous Linux n'utilise pas [i]utmpx[/i] car sa structure [i]utmp[/i] est déjà assez grande. Les fonctions [i]getutxent[/i] etc. sont des alias pour [i]getutent[/i] etc. [size=18] [b]Voir aussi[/b] [/size] [b]utmp (5)[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier