.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 1995 Mark D. Roth (roth@uiuc.edu) .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\" References consulted: .\" Linux libc source code .\" Solaris manpages .\" .\" Modified Thu Jul 25 14:43:46 MET DST 1996 by Michael Haardt .\" .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH getutent 3 "2 mai 2024" "Pages du manuel de Linux 6.8" .SH NOM getutent, getutid, getutline, pututline, setutent, endutent, utmpname \- Accéder aux enregistrements utmp .SH BIBLIOTHÈQUE Bibliothèque C standard (\fIlibc\fP, \fI\-lc\fP) .SH SYNOPSIS .nf \fB#include \fP .P \fBstruct utmp *getutent(void);\fP \fBstruct utmp *getutid(const struct utmp *\fP\fIut\fP\fB);\fP \fBstruct utmp *getutline(const struct utmp *\fP\fIut\fP\fB);\fP .P \fBstruct utmp *pututline(const struct utmp *\fP\fIut\fP\fB);\fP .P \fBvoid setutent(void);\fP \fBvoid endutent(void);\fP .P \fBint utmpname(const char *\fP\fIfile\fP\fB);\fP .fi .SH DESCRIPTION Les nouvelles applications devraient utiliser les versions «\ utmpx\ » spécifiées par POSIX.1 de ces fonctions\ ; voir STANDARDS. .P \fButmpname\fP() indique le nom du fichier au format utmp à utiliser avec les autres fonctions. Si \fButmpname\fP() n'est pas appelé avant les autres fonctions, elles utiliseront le fichier \fB_PATH_UTMP\fP, défini dans \fI\fP. .P \fBsetutent\fP() 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. .P \fBendutent\fP() ferme le fichier utmp. Ceci devrait être appelé une fois que le programme a terminé ses accès au fichier. .P \fBgetutent\fP() lit une ligne du fichier utmp, à la position courante. Elle renvoie un pointeur sur une structure contenant les divers champs de la ligne. La définition de cette structure peut être consultée dans \fButmp\fP(5). .P \fBgetutid\fP() effectue une recherche dans le fichier utmp, à partir de la position courante, en se basant sur \fIut\fP. Si \fIut\->ut_type\fP vaut \fBRUN_LVL\fP, \fBBOOT_TIME\fP, \fBNEW_TIME\fP, ou \fBOLD_TIME\fP, \fBgetutid\fP() recherchera le premier enregistrement dont le champ \fIut_type\fP correspond à \fIut\->ut_type\fP. Si \fIut\->ut_type\fP vaut \fBINIT_PROCESS\fP, \fBLOGIN_PROCESS\fP, \fBUSER_PROCESS\fP, ou \fBDEAD_PROCESS\fP, \fBgetutid\fP() recherchera le premier enregistrement dont le champ \fIut_id\fP correspond à \fIut\->ut_id\fP. .P \fBgetutline\fP() effectue une recherche dans le fichier utmp, à partir de la position courante. Elle examine les enregistrements dont le champ \fIut_type\fP est \fBUSER_PROCESS\fP ou \fBLOGIN_PROCESS\fP et renvoie le premier dont le champ \fIut_line\fP correspond à \fIut\->ut_line\fP. .P \fBpututline\fP() écrit la structure \fIutmp\fP \fIut\fP dans le fichier utmp. Elle utilise \fBgetutid\fP() pour rechercher l'emplacement ou insérer le nouvel enregistrement. Si elle ne trouve pas d'emplacement approprié pour \fIut\fP, \fBpututline\fP() ajoutera le nouvel enregistrement à la fin du fichier. .SH "VALEUR RENVOYÉE" \fBgetutent\fP(), \fBgetutid\fP() et \fBgetutline\fP() renvoient un pointeur sur une structure \fIutmp\fP, ou NULL en cas d'erreur (ce qui inclut le cas «\ pas d'enregistrement trouvé\ »). Cette structure \fIutmp\fP est allouée statiquement, et peut être écrasée par des appels successifs. .P Si elle réussit, \fBpututline\fP() renvoie \fIut\fP ; si elle échoue, elle renvoie NULL. .P \fButmpname\fP() renvoie \fB0\fP si le nouveau nom a été correctement enregistré, ou \fB\-1\fP si elle échoue. .P En cas d'échec, ces fonctions définissent \fIerrno\fP pour indiquer l'erreur. .SH ERREURS .TP \fBENOMEM\fP Plus assez de mémoire. .TP \fBESRCH\fP Enregistrement non trouvé. .P \fBsetutent\fP(), \fBpututline\fP() et les fonctions \fBgetut*\fP() peuvent également échouer pour les raisons décrites dans \fBopen\fP(2). .SH FICHIERS .TP \fI/var/run/utmp\fP base de données des utilisateurs actuellement connectés .TP \fI/var/log/wtmp\fP base de données des connexions passées. .SH ATTRIBUTS Pour une explication des termes utilisés dans cette section, consulter \fBattributes\fP(7). .TS allbox; lb lb lbx l l l. Interface Attribut Valeur T{ .na .nh \fBgetutent\fP() T} Sécurité des threads T{ .na .nh MT\-Unsafe init race:utent race:utentbuf sig:ALRM timer T} T{ .na .nh \fBgetutid\fP(), \fBgetutline\fP() T} Sécurité des threads T{ .na .nh MT\-Unsafe init race:utent sig:ALRM timer T} T{ .na .nh \fBpututline\fP() T} Sécurité des threads T{ .na .nh MT\-Unsafe race:utent sig:ALRM timer T} T{ .na .nh \fBsetutent\fP(), \fBendutent\fP(), \fButmpname\fP() T} Sécurité des threads MT\-Unsafe race:utent .TE .P Dans la table ci\-dessus, \fIutent\fP dans \fIrace:utent\fP veut dire que si une des fonctions \fBsetutent\fP(), \fBgetutent\fP(), \fBgetutid\fP(), \fBgetutline\fP(), \fBpututline\fP(), \fButmpname\fP() ou \fBendutent\fP() est utilisée en parallèle dans différents fils d'exécution (thread) d'un programme, alors des situations de concurrences de données peuvent se produire. .SH STANDARDS Aucun. .SH HISTORIQUE XPG2, SVr4. .P Dans XPG2 et SVID 2, la fonction \fBpututline\fP() est décrite comme renvoyant « void », et c'est le cas sur de nombreux systèmes (AIX, HP\-UX). HP\-UX introduit une nouvelle fonction \fB_pututline\fP() avec le prototype fourni plus haut pour \fBpututline\fP(). .P Toutes ces fonctions sont maintenant obsolètes sur les systèmes non Linux. POSIX.1\-2001 et POSIX.1\-2008, suivant SUSv1, ne proposent aucune de ces fonctions, mais utilisent plutôt .P .RS 4 .EX \fB#include \fP .P \fBstruct utmpx *getutxent(void);\fP \fBstruct utmpx *getutxid(const struct utmpx *);\fP \fBstruct utmpx *getutxline(const struct utmpx *);\fP \fBstruct utmpx *pututxline(const struct utmpx *);\fP \fBvoid setutxent(void);\fP \fBvoid endutxent(void);\fP .EE .RE .P Ces fonctions sont fournies par la glibc et effectuent les mêmes tâches que leurs équivalents sans le «\ x\ » mais utilisent une structure \fIutmpx\fP, définie sous Linux pour être identique à la structure \fIutmp\fP. Pour être complet, la glibc fournit également \fButmpxname\fP(), bien que cette fonction ne soit pas spécifiée par POSIX.1. .P Sur quelques autres systèmes, la structure \fIutmpx\fP est un surensemble de la structure \fIutmp\fP, avec des champs supplémentaires, et des versions plus grandes des champs existants, et des fichiers sont maintenus en parallèle, souvent \fI/var/*/utmpx\fP et \fI/var/*/wtmpx\fP. .P D'un autre côté, la glibc sous Linux n'utilise pas de fichier \fIutmpx\fP en parallèle car sa structure \fIutmp\fP est déjà assez grande. Les fonctions contenant un « x » listées ci\-dessus sont simplement des alias des fonctions sans le « x » (par exemple, \fBgetutxent\fP() est un alias de \fBgetutent\fP()). .SH NOTES .SS "Notes de la glibc" Les fonctions ci\-dessus ne sont pas sûres dans un contexte de thread. La glibc ajoute les versions réentrantes. .P .nf \fB#include \fP .P \fBint getutent_r(struct utmp *\fP\fIubuf\fP\fB, struct utmp **\fP\fIubufp\fP\fB);\fP \fBint getutid_r(struct utmp *\fP\fIut\fP\fB,\fP \fB struct utmp *\fP\fIubuf\fP\fB, struct utmp **\fP\fIubufp\fP\fB);\fP \fBint getutline_r(struct utmp *\fP\fIut\fP\fB,\fP \fB struct utmp *\fP\fIubuf\fP\fB, struct utmp **\fP\fIubufp\fP\fB);\fP .fi .P Exigences de macros de test de fonctionnalités pour la glibc (consulter \fBfeature_test_macros\fP(7)) : .P \fBgetutent_r\fP(), \fBgetutid_r\fP(), \fBgetutline_r\fP() : .nf _GNU_SOURCE || /* depuis la glibc 2.19 : */ _DEFAULT_SOURCE || /* glibc <= 2.19 : */ _SVID_SOURCE || _BSD_SOURCE .fi .P Ces fonctions sont des extensions GNU, analogues aux fonctions de même nom sans le suffixe «\ _r\ ». Le paramètre \fIubuf\fP fournit à ces fonctions un endroit où stocker leur résultat. Si elles réussissent, elles renvoient \fB0\fP et un pointeur vers le résultat est écrit dans \fI*ubufp\fP. Si elles échouent, ces fonctions renvoient \fB\-1\fP. Il n'y a pas d'équivalent «\ utmpx\ » aux fonctions ci\-dessus. (POSIX.1 ne spécifie pas ces fonctions.) .SH EXEMPLES L'exemple suivant ajoute et retire un enregistrement utmp, en supposant qu'il est invoqué depuis un pseudoterminal. Dans une véritable application, il faudrait vérifier les valeurs renvoyées par \fBgetpwuid\fP(3) et \fBttyname\fP(3). .P .\" SRC BEGIN (getutent.c) .EX #include #include #include #include #include #include \& int main(void) { struct utmp entry; \& system("echo avant l'ajout d'une entrée :;who"); \& entry.ut_type = USER_PROCESS; entry.ut_pid = getpid(); strcpy(entry.ut_line, ttyname(STDIN_FILENO) + strlen("/dev/")); /* correct seulement pour les ptys nommés /dev/tty[pqr][0\-9a\-z] */ strcpy(entry.ut_id, ttyname(STDIN_FILENO) + strlen("/dev/tty")); entry.ut_time = time(NULL); strcpy(entry.ut_user, getpwuid(getuid())\->pw_name); memset(entry.ut_host, 0, UT_HOSTSIZE); entry.ut_addr = 0; setutent(); pututline(&entry); \& system("echo après l'ajout d'une entrée :;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 après le retrait d'une entrée:;who"); \& endutent(); exit(EXIT_SUCCESS); } .EE .\" SRC END .SH "VOIR AUSSI" \fBgetutmp\fP(3), \fButmp\fP(5) .PP .SH TRADUCTION La traduction française de cette page de manuel a été créée par Christophe Blaess , Stéphan Rafin , Thierry Vignaud , François Micaux, Alain Portal , Jean-Philippe Guérard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas François , Florentin Duneau , Simon Paillard , Denis Barbier , David Prévot , Jean-Baptiste Holcroft et Grégoire Scano . .PP Cette traduction est une documentation libre ; veuillez vous reporter à la .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License version 3 .UE concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE. .PP Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à .MT debian-l10n-french@lists.debian.org .ME .