rtime(3)

НАИМЕНОВАНИЕ
rtime - получение времени с удалённого узла

БИБЛИОТЕКА
Стандартная библиотека языка C (libc, -lc)

СИНТАКСИС
#include <rpc/auth_des.h>

int rtime(struct sockaddr_in *addrp, struct rpc_timeval *timep,
          struct rpc_timeval *timeout);

ОПИСАНИЕ
Для получения времени с удалённого компьютера функция использует протокол Time Server Protocol, описанный в RFC 868.

Time Server Protocol возвращает время в секундах начиная с 1 января 1900 года 00:00:00 UTC. Данная функция самостоятельно вычитает подходящую константу для того, чтобы преобразовать результат в секундах от начала Эпохи — 1970-01-01 00:00:00 +0000 (UTC).

Если timeout не равно NULL, то будет использоваться сокет udp/time (порт 37), иначе — сокет tcp/time (порт 37).

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
On success, 0 is returned, and the obtained 32-bit time value is stored in timep->tv_sec. In case of error -1 is returned, and errno is set to indicate the error.

ОШИБКИ
Могут возникнуть все ошибки задействованных в работе функций (sendto(2), poll(2), recvfrom(2), connect(2), read(2)), а также:

EIO Количество возвращённых байт не равно 4.

ETIMEDOUT
    Время ожидания, указанное в таймауте, превышено.

АТРИБУТЫ
Описание терминов данного раздела смотрите в attributes(7).
Интерфейс | Атрибут | Значение
rtime() | Безвредность в нитях | MT-Safe

ПРИМЕЧАНИЯ
Поддерживается только IPv4.

Некоторые версии in.timed поддерживают только TCP. Попробуйте пример программы с установленной в 1 значением use_tcp.

ПРОГРАММНЫЕ ОШИБКИ
rtime() в glibc 2.2.5 и ниже на 64-битных компьютерах работает некорректно.

ПРИМЕРЫ
Для этого примера требуется поднятие и открытие порта 37. Вы можете проверить это, убедившись в том, что в файле /etc/inetd.conf запись time раскомментирована.

Программа подключается к компьютеру с именем «linux». Использование «localhost» не сработает. В качестве результата будет возвращено локальное время компьютера «linux».

    #include <errno.h>
    #include <netdb.h>
    #include <stdio.h>
    #include <stdlib.h>
    #include <string.h>
    #include <time.h>

    #include <rpc/auth_des.h>

    static int use_tcp = 0;
    static const char servername[] = "linux";

    int
    main(void)
    {
        int                 ret;
        time_t              t;
        struct hostent      *hent;
        struct rpc_timeval  time1 = {0, 0};
        struct rpc_timeval  timeout = {1, 0};
        struct sockaddr_in  name;

        memset(&name, 0, sizeof(name));
        sethostent(1);
        hent = gethostbyname(servername);
        memcpy(&name.sin_addr, hent->h_addr, hent->h_length);

        ret = rtime(&name, &time1, use_tcp ? NULL : &timeout);
        if (ret < 0)
            perror("rtime error");
        else {
            t = time1.tv_sec;
            printf("%s\n", ctime(&t));
        }

        exit(EXIT_SUCCESS);
    }

СМОТРИТЕ ТАКЖЕ
ntpdate(1), inetd(8)

ПЕРЕВОД
Русский перевод этой страницы руководства разработал(и) aereiae <aereiae@gmail.com>, Azamat Hackimov <azamat.hackimov@gmail.com>, Dmitriy S. Seregin <dseregin@59.ru>, Katrin Kutepova <blackkatelv@gmail.com>, Lockal <lockalsash@gmail.com>, Yuri Kozlov <yuray@komyakino.ru>, Баринов Владимир и Иван Павлов <pavia00@gmail.com>

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

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