NOMBRE

       ttyslot - encuentra la posición de la terminal de usuario actual en algún archivo

SINOPSIS

       #include <unistd.h> /* Vea NOTAS */

       int ttyslot(void);

   Requisitos de Macros de Prueba de Características para glibc (véase feature_test_macros(7)):

       ttyslot():
           Desde glibc 2.24:
               _DEFAULT_SOURCE
           From glibc 2.20 to 2.23:
               _DEFAULT_SOURCE ||
               _XOPEN_SOURCE && _XOPEN_SOURCE < 500
           Glibc 2.19 and earlier:
               _BSD_SOURCE ||
               _XOPEN_SOURCE && _XOPEN_SOURCE < 500

DESCRIPCIÓN

       La función legacy ttyslot()  devuelve el índice de la entrada de usuario actual en algún fichero.

       Entonces "¿En qué fichero?" te preguntarás. Bueno, veamos algo de historia.

   Historia Antigua
       Solía  haber  un  archivo /etc/ttys en UNIX V6, que era leído por el programa init(1)  para descubrir qué
       hacer con cada línea terminal.  Cada línea consistía en tres caracteres.  El primer  caracter  podía  ser
       '0'  ó  '1',  donde '0' significaba "ignorar".  El segundo caracter denotaba la terminal: '8' significaba
       "/dev/tty8".  El tercer caracter era un argumento para getty(8)  que indicaba la secuencia de velocidades
       de línea a probar ('-' era: comienza a probar 110 baudios). De modo que la típica línea  era  "18-".   Un
       cuelgue  en  alguna  línea  se  resolvía  cambiando el '1' a '0', señalando a init, cambiando otra vez, y
       volviendo a señalar a init de nuevo.

       En UNIX V7 el formato se cambió: aquí el segundo caracter era un argumento a getty(8)   que  indicaba  la
       secuencia  de  velocidades  de  línea  a  probar  ('0'  era: cicla sobre 300-1200-150-110 baudios; '4' se
       destinaba a la consola en línea DECwriter)  mientras que el resto de la línea contenía el nombre del tty.
       De modo que una línea típica era "14console".

       Later systems have more elaborate syntax.  System V-like systems have /etc/inittab instead.

   Historia Antigua (2)
       Por otro lado, está el archivo /etc/utmp que listaba las personas que estaban conectadas en ese  momento.
       Es  mantenido por login(1).  Tiene un tamaño fijo, y el índice apropiado en el archivo estaba determinado
       por login(1)  usando la llamada ttyslot()  para hallar el número de la línea en /etc/ttys (contando desde
       1).

   La semántica de ttyslot
       Thus, the function ttyslot()  returns the index of the controlling terminal of the calling process in the
       file /etc/ttys, and that is (usually) the same as the index of the entry for the current user in the file
       /etc/utmp.  BSD still has the /etc/ttys file, but System V-like systems do not, and hence cannot refer to
       it.  Thus, on such systems the documentation says that ttyslot()  returns the current user's index in the
       user accounting data base.

VALOR DEVUELTO

       If successful, this function returns the slot number.  On error (e.g., if none of the file descriptors 0,
       1 or 2 is associated with a terminal that occurs in this data base)  it returns 0 on UNIX V6 and  V7  and
       BSD-like systems, but -1 on System V-like systems.

ATRIBUTOS

       Para obtener una explicación de los términos usados en esta sección, véase attributes(7).
       ┌───────────┬────────────────────┬───────────┐
       │ Interfaz  │ Atributo           │ Valor     │
       ├───────────┼────────────────────┼───────────┤
       │ ttyslot() │ Seguridad del hilo │ MT-Unsafe │
       └───────────┴────────────────────┴───────────┘

CONFORME A

       SUSv1; marked as LEGACY in SUSv2; removed in POSIX.1-2001.  SUSv2 requires -1 on error.

NOTAS

       El  archivo  utmp  se  encuentra  en  diversos  lugares  en  distintos  sistemas, por ejemplo: /etc/utmp,
       /var/adm/utmp, /var/run/utmp.

       La implementación de glibc2 de esta función lee  el  archivo  _PATH_TTYS,  definido  en  <ttyent.h>  como
       "/etc/ttys".  Devuelve  0 en caso de error.  Como los sistemas Linux no suelen tener "/etc/ttys", siempre
       devolverá 0.

       On BSD-like systems and Linux, the declaration of ttyslot()  is provided by <unistd.h>.  On System V-like
       systems, the declaration is provided by <stdlib.h>.  Since  glibc  2.24,  <stdlib.h>  also  provides  the
       declaration with the following feature test macro definitions:

           (_XOPEN_SOURCE >= 500 ||
                   (_XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED))
               && ! (_POSIX_C_SOURCE >= 200112L || _XOPEN_SOURCE >= 600)

       Minix también tiene fttyslot(fd).

VÉASE TAMBIÉN

       getttyent(3), ttyname(3), utmp(5)

COLOFÓN

       Esta página es parte de la versión 5.10 del proyecto Linux man-pages. Puede encontrar una descripción del
       proyecto,   información   sobre   cómo   informar   errores  y  la  última  versión  de  esta  página  en
       https://www.kernel.org/doc/man-pages/.

TRADUCCIÓN

       La traducción al español de esta página del  manual  fue  creada  por  Jorge  Rodriguez  (A.K.A.  Tiriel)
       <tiriel@users.sourceforge.net>

       Esta  traducción  es  documentación  libre;  lea  la GNU General Public License Version 3 o posterior con
       respecto a las condiciones de copyright.  No existe NINGUNA RESPONSABILIDAD.

       Si encuentra algún error en la traducción de esta página  del  manual,  envíe  un  correo  electrónico  a
       debian-l10n-spanish@lists.debian.org.

GNU                                            15 Septiembre 2017                                     TTYSLOT(3)