НАИМЕНОВАНИЕ

       ttyslot - поиск слота текущего терминала пользователя в определённом файле

БИБЛИОТЕКА

       Стандартная библиотека языка C (libc, -lc)

ОБЗОР

       #include <unistd.h>       /* See NOTES */

       int ttyslot(void);

   Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

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

ОПИСАНИЕ

       Исходная функция ttyslot() возвращает индекс записи текущего пользователя в определённом файле.

       «В каком файле?» — спросите вы. Что же, для начала обратимся к истории.

   Доисторические времена
       There  used  to be a file /etc/ttys in UNIX V6, that was read by the init(1)  program to find out what to
       do with each terminal line.  Each line consisted of three characters.  The first character was either '0'
       or '1', where '0' meant "ignore".  The second character denoted the terminal: '8' stood for  "/dev/tty8".
       The  third character was an argument to getty(8)  indicating the sequence of line speeds to try ('-' was:
       start trying 110 baud).  Thus a typical line was "18-".  A hang on some line was solved by  changing  the
       '1' to a '0', signaling init, changing back again, and signaling init again.

       In UNIX V7 the format was changed: here the second character was the argument to getty(8)  indicating the
       sequence  of  line  speeds  to try ('0' was: cycle through 300-1200-150-110 baud; '4' was for the on-line
       console DECwriter)  while the rest of the line contained the name of the tty.  Thus a  typical  line  was
       "14console".

       В последующих системах синтаксис был ещё разнообразней. В системах, основанных на System V, использовался
       /etc/inittab.

   Доисторические времена (2)
       С  другой  стороны, существовал файл /etc/utmp, в котором перечислены люди, вошедшие в систему. Этот файл
       управлялся с помощью login(1). Он имел фиксированную длину, а соответствующий индекс в файле  определялся
       login(1) с помощью вызова ttyslot() и нахождения номера строки в /etc/ttys (начиная с 1).

   Семантика ttyslot
       Таким  образом, функция ttyslot() возвращает из файла /etc/ttys индекс управляющего терминала вызывающего
       процесса, который является таким  же  (обычно),  что  и  индекс  записи  текущего  пользователя  в  файле
       /etc/utmp.  В  BSD  файл  /etc/ttys все ещё был, однако в System V его уже не было, и из-за этого на него
       невозможно было ссылаться. Поэтому в подобных системах в документации указано, что  ttyslot()  возвращает
       индекс текущего пользователя на основании базы данных пользователей.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

       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.

АТРИБУТЫ

       Описание терминов данного раздела смотрите в attributes(7).
       ┌────────────────────────────────────────────────────────────────────┬──────────────────────┬───────────┐
       │ Интерфейс                                                          │ Атрибут              │ Значение  │
       ├────────────────────────────────────────────────────────────────────┼──────────────────────┼───────────┤
       │ ttyslot()                                                          │ Безвредность в нитях │ MT-Unsafe │
       └────────────────────────────────────────────────────────────────────┴──────────────────────┴───────────┘

ВЕРСИИ

       Файл  utmp  в  различных  системах  может  находиться  в  различных  местах:  /etc/utmp,   /var/adm/utmp,
       /var/run/utmp.

СТАНДАРТЫ

       Отсутствуют.

ИСТОРИЯ

       SUSv1;  в  SUSv2  отмечена  как  УСТАРЕВШАЯ;  удалена  в POSIX.1-2001. SUSv2 требует возврата -1 в случае
       ошибки.

       Реализация этой функции в glibc2 читает файл _PATH_TTYS, определённый в  <ttyent.h>  как  «/etc/ttys».  В
       случае  ошибки  она  возвращает  0.  Так как в системах Linux файла «/etc/ttys» обычно нет, то она всегда
       возвращает 0.

       В BSD-подобных системах и Linux объявление ttyslot() находится в файле <unistd.h>.  В  System  V-подобных
       системах  объявление  находится в файле <stdlib.h>. Начиная с glibc 2.24 в <stdlib.h> также поместили это
       объявление под следующий макрос тестирования свойств:

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

       В Minix также есть fttyslot(fd).

СМОТРИТЕ ТАКЖЕ

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

ПЕРЕВОД

       Русский перевод этой страницы  руководства  разработал(и)  Azamat  Hackimov  <azamat.hackimov@gmail.com>,
       Dmitry    Bolkhovskikh    <d20052005@yandex.ru>,    Yuri   Kozlov   <yuray@komyakino.ru>,   Иван   Павлов
       <pavia00@gmail.com> и Kirill Rekhov <krekhov.dev@gmail.com>

       Этот перевод является свободной программной документацией; он распространяется на условиях  общедоступной
       лицензии  GNU  (GNU  General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или
       более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

       Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите  об  этом
       разработчику(ам)   по   его(их)  адресу(ам)  электронной  почты  или  по  адресу  списка рассылки русских
       переводчиков.

Справочные страницы Linux 6.9.1                   2 мая 2024 г.                                       ttyslot(3)