.\" -*- coding: UTF-8 -*- .\" Copyright (c) 1993 Michael Haardt (michael@cantor.informatik.rwth-aachen.de), .\" Fri Apr 2 11:32:09 MET DST 1993 .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\" Modified 1993-07-25 by Rik Faith (faith@cs.unc.edu) .\" Modified 1995-02-26 by Michael Haardt .\" Modified 1996-07-20 by Michael Haardt .\" Modified 1997-07-02 by Nicolás Lichtmaier .\" Modified 2004-10-31 by aeb, following Gwenole Beauchesne .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH utmp 5 "3 Mayo 2023" "Páginas de manual de Linux 6.05.01" .SH NOMBRE utmp, wtmp \- registro de sesiones .SH SINOPSIS .nf \fB#include \fP .fi .SH DESCRIPCIÓN El archivo \fIutmp\fP nos permite obtener información acerca de qué usuarios están usando el sistema actualmente. No todas las aplicaciones usan el registro de utmp por lo que puede haber usuarios que no figuren. .PP \fBAtención:\fP \fIutmp\fP no debe ser modificable ya que muchos programas del sistema dependen (tontamente) de su integridad. Corre el riesgo de tener registros del sistema ("logs" en inglés) incorrectos e incluso modificaciones indeseadas de archivos del sistema si deja que cualquiera pueda escribir en \fIutmp\fP. .PP El archivo es una secuencia de estructuras de \fIutmp\fP, declaradas a continuación en el archivo \fI\fP (esto es sólo una posible definición ya que los detalles dependen de la versión de libc): .PP .in +4n .EX /* Values for ut_type field, below */ \& #define EMPTY 0 /* Record does not contain valid info (formerly known as UT_UNKNOWN on Linux) */ #define RUN_LVL 1 /* Change in system run\-level (see \fBinit\fP(1)) */ #define BOOT_TIME 2 /* Time of system boot (in \fIut_tv\fP) */ #define NEW_TIME 3 /* Time after system clock change (in \fIut_tv\fP) */ #define OLD_TIME 4 /* Time before system clock change (in \fIut_tv\fP) */ #define INIT_PROCESS 5 /* Process spawned by \fBinit\fP(1) */ #define LOGIN_PROCESS 6 /* Session leader process for user login */ #define USER_PROCESS 7 /* Normal process */ #define DEAD_PROCESS 8 /* Terminated process */ #define ACCOUNTING 9 /* Not implemented */ \& #define UT_LINESIZE 32 #define UT_NAMESIZE 32 #define UT_HOSTSIZE 256 \& struct exit_status { /* Type for ut_exit, below */ short e_termination; /* Process termination status */ short e_exit; /* Process exit status */ }; \& struct utmp { short ut_type; /* Type of record */ pid_t ut_pid; /* PID of login process */ char ut_line[UT_LINESIZE]; /* Device name of tty \- "/dev/" */ char ut_id[4]; /* Terminal name suffix, or inittab(5) ID */ char ut_user[UT_NAMESIZE]; /* Username */ char ut_host[UT_HOSTSIZE]; /* Hostname for remote login, or kernel version for run\-level messages */ struct exit_status ut_exit; /* Exit status of a process marked as DEAD_PROCESS; not used by Linux init(1) */ /* The ut_session and ut_tv fields must be the same size when compiled 32\- and 64\-bit. This allows data files and shared memory to be shared between 32\- and 64\-bit applications. */ #if __WORDSIZE == 64 && defined __WORDSIZE_COMPAT32 int32_t ut_session; /* Session ID (\fBgetsid\fP(2)), used for windowing */ struct { int32_t tv_sec; /* Seconds */ int32_t tv_usec; /* Microseconds */ } ut_tv; /* Time entry was made */ #else long ut_session; /* Session ID */ struct timeval ut_tv; /* Time entry was made */ #endif \& int32_t ut_addr_v6[4]; /* Internet address of remote host; IPv4 address uses just ut_addr_v6[0] */ char __unused[20]; /* Reserved for future use */ }; \& /* Backward compatibility hacks */ #define ut_name ut_user #ifndef _NO_UT_TIME #define ut_time ut_tv.tv_sec #endif #define ut_xtime ut_tv.tv_sec #define ut_addr ut_addr_v6[0] .EE .in .PP Esta estructura nos da el nombre del fichero especial asociado con el terminal del usuario, el nombre del usuario y el momento de inicio de sesión en el formato definido en \fBtime\fP(2). Los campos del tipo cadena terminan con bytes nulos ( (\[aq]\e0\[aq]) si no completan la totalidad del campo. .PP Las primeras entradas que se crean siempre proceden del procesamiento de \fBinittab\fP(5) por parte de \fBinit\fP(1). Sin embargo, antes de que se procese una entrada, \fBinit\fP(1) limpia utmp asignando a \fBut_type\fP el valor \fBDEAD_PROCESS\fP, limpiando los campos \fBut_user\fP, \fBut_host\fP y \fBut_time\fP con caracteres nulos para cada registro cuyo campo \fBut_type\fP no sea \fBDEAD_PROCESS\fP ni \fBRUN_LVL\fP y donde no exista ningún proceso con PID \fBut_pid\fP. Si no se puede encontrar ningún registro vacío con el \fBut_id\fP que se necesita, \fBinit\fP(1) crea uno nuevo. Asigna un valor a \fBut_id\fP a partir del inittab, a \fBut_pid\fP y a \fBut_time\fP a partir de los valores actuales y asigna a \fBut_type\fP el valor \fBINIT_PROCESS\fP. .PP \fBmingetty\fP(8) (o \fBagetty\fP(8)) busca la entrada por el PID, cambia el valor de \fIut_type\fP a \fBLOGIN_PROCESS\fP, cambia \fIut_time\fP, asigna un valor a \fIut_line\fP y espera a que se establezca la conexión. Una vez que se produjo la autentifiación del usuario, \fBlogin\fP(1), cambia el valor de \fIut_type\fP a \fBUSER_PROCESS\fP, cambia \fIut_time\fP y asigna un valor a \fIut_host\fP y a \fIut_addr\fP. Dependiendo de \fBmingetty\fP(8) (o \fBagetty\fP(8)) y \fBlogin\fP(8), los registros se pueden buscar por \fIut_line\fP en lugar de por \fIut_pid\fP, como sería preferible. .PP Cuando \fBinit\fP(1) detecta que un proceso ha terminado, busca su entrada utmp mediante \fBut_pid\fP, asigna a \fBut_type\fP el valor \fBDEAD_PROCESS\fP y limpia \fBut_user\fP, \fBut_host\fP y \fBut_time\fP con bytes nulos. .PP \fBxterm\fP(1) y otros emuladores de terminal crean directamente un registro \fBUSER_PROCESS\fP y generan \fBut_id\fP con los caracteres siguientes de la cadena \fI/dev/[pt]ty\fP. Si encuentran un \fBDEAD_PROCESS\fP para este ID, lo reutilizan; en caso contrario, crean una nueva entrada. Si pueden, las marcarán como \fBDEAD_PROCESS\fP al terminar y se aconseja que también rellenen con bytes nulos los campos \fIut_line\fP, \fIut_time\fP, \fIut_user\fP y \fIut_host\fP. .PP \fBtelnetd\fP(8) establece una entrada \fBLOGIN_PROCESS\fP y deja el resto a \fBlogin\fP(1), como es habitual. Después de que termine la sesión de telnet, \fBtelnetd\fP(8) limpia utmp de la forma descrita. .PP El archivo \fBwtmp\fP registra todos los inicios y finales de sesión. Su formato es como el de \fButmp\fP salvo que un nombre nulo de usuario indica el fin de sesión en la terminal asociada. Además, el nombre de terminal \fB\[ti]\fP con nombre de usuario \fBshutdown\fP o \fBreboot\fP indica un cierre (shutdown) o reinicio del sistema y el par de nombres de terminal \fB|\fP/\fB}\fP registra la fecha antigua/nueva del sistema cuando la cambia \fBdate\fP(1). \fBwtmp\fP se gestiona a través de \fBlogin\fP(1), \fBinit\fP(1) y algunas versiones de \fBgetty\fP(8) (por ejemplo: \fBmingetty\fP(8) o \fBagetty\fP(8)) Ninguno de estos programas crea el archivo, por lo que si se borra se desactiva el mantenimiento de los registros. .SH ARCHIVOS \fI/var/run/utmp\fP .br \fI/var/log/wtmp\fP .SH VERSIONES POSIX.1 no define la estructura de \fIutmp\fP, en cambio la define para \fIutmpx\fP (como parte de la extensión XSI) detallando especificaciones para los campos \fIut_type\fP, \fIut_pid\fP, \fIut_line\fP, \fIut_id\fP, \fIut_user\fP y \fIut_tv\fP. Tampoco define la longitud de los campos \fIut_line\fP y \fIut_user\fP. .PP Linux define que la estructura de \fIutmpx\fP debe ser idéntica a la de \fIutmp\fP. .SH ESTÁNDARES Linux. .SH HISTORIAL Las entradas de utmp no son conformes nia v7/BSD ni a System V sino que son una mezcla de ambos. .PP v7/BSD tiene un menor número de campo; principalmente no tiene \fIut_type\fP lo que provoca que las aplicaciones nativas de este sistema muestren (entre otras cosas) algunas sesiones muertas. Es más, no dispone de un archivos para configurar la reserva de entradas para sesiones al no disponer de campos \fIut_id\fP. .PP En Linux (igual que en System V), el campo \fIut_id\fP de un registro nunca cambiará una vez que se le haya asignado un valor, lo que reserva esa entrada sin necesidad de un fichero de configuración. Limpiar el campo \fIut_id\fP puede producir condiciones de carrera que den lugar a entradas utmp corruptas y a potenciales problemas de seguridad. La semántica de System V no necesita la limpieza de los campos mencionados anteriormente rellenándolos con bytes nulos, pero esto permite ejecutar muchos programas que suponen una semántica BSD y que no modifican utmp. Linux usa las convenciones de BSD para los contenidos de las líneas, tal y como se ha descrito anteriormente. .PP .\" mtk: What is the referrent of "them" in the following sentence? .\" System V only uses the type field to mark them and logs .\" informative messages such as \fB"new time"\fP in the line field. System V no tiene los campos \fIut_host\fP ni \fIut_addr_v6\fP. .SH NOTAS A diferencia de otros sistemas, donde el registro de información en utmp se puede deshabilitar borrando el fichero, en Linux este fichero siempre debe existir. Si quiere deshabilitar \fBwho\fP(1) elimine el permiso de lectura de utmp de los permisos correspondientes a "otros". .PP El formato del fichero depende de la arquitectura de la máquina, por lo que se recomienda que sea procesado únicamente en la arquitectura en que fue creado. .PP Tenga en cuenta que en plataformas \fIbiarch\fP (aquellas que pueden ejecutar aplicaciones de 32 y de 64 bits tales como x86\-64,ppc64,s390x,etc...), \fIut_tv\fP tiene el mismo tamaño en el mode de 32\-bits y en el de 64\-bits. Lo mismo ocurre con \fIut_session\fP y \fIut_time\fP si existen. Esto permite que se comparta memoria y datos entre aplicaciones de distinto tipo. Este se consigue al modificar el tipo de \fIut_session\fP a \fIint32_t\fP y el de \fIut_tv\fP a una estructura con dos campos \fIint32_t\fP: \fItv_sec\fP y \fItv_usec\fP. Como \fIut_tv\fP puede no ser igual que \fIstruct timeval\fP en lugar de la llamada: .PP .in +4n .EX gettimeofday((struct timeval *) &ut.ut_tv, NULL); .EE .in .PP se recomienda definir este campo con el siguiente método: .PP .in +4n .EX struct utmp ut; struct timeval tv; \& gettimeofday(&tv, NULL); ut.ut_tv.tv_sec = tv.tv_sec; ut.ut_tv.tv_usec = tv.tv_usec; .EE .in .\" .PP .\" Note that the \fIutmp\fP struct from libc5 has changed in libc6. .\" Because of this, .\" binaries using the old libc5 struct will corrupt .\" .IR /var/run/utmp " and/or " /var/log/wtmp . .\" .SH BUGS .\" This man page is based on the libc5 one, things may work differently now. .SH "VÉASE TAMBIÉN" \fBac\fP(1), \fBdate\fP(1), \fBinit\fP(1), \fBlast\fP(1), \fBlogin\fP(1), \fBlogname\fP(1), \fBlslogins\fP(1), \fBusers\fP(1), \fButmpdump\fP(1), \fBwho\fP(1), \fBgetutent\fP(3), \fBgetutmp\fP(3), \fBlogin\fP(3), \fBlogout\fP(3), \fBlogwtmp\fP(3), \fBupdwtmp\fP(3) .PP .SH TRADUCCIÓN La traducción al español de esta página del manual fue creada por Juan Piernas , Miguel Pérez Ibars y Marcos Fouces . .PP Esta traducción es documentación libre; lea la .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Version 3 .UE o posterior con respecto a las condiciones de copyright. No existe NINGUNA RESPONSABILIDAD. .PP Si encuentra algún error en la traducción de esta página del manual, envíe un correo electrónico a .MT debian-l10n-spanish@lists.debian.org .ME .