ИМЯ

rtime - получение времени с удалённого узла

LIBRARY

Standard C library ( 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 <[email protected]>, Azamat Hackimov <[email protected]>, Dmitriy S. Seregin <[email protected]>, Katrin Kutepova <[email protected]>, Lockal <[email protected]>, Yuri Kozlov <[email protected]>, Баринов Владимир и Иван Павлов <[email protected]>
Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.
Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на [email protected]