.\"
.TH RTIME 3 2010-02-25 "GNU" "Linux Programmer's Manual"
.\"O .SH NAME
-.SH ̾Á°
+.SH 名前
.\"O rtime \- get time from a remote machine
-rtime \- ¥ê¥â¡¼¥È¥Þ¥·¥ó¤«¤é»þ¹ï¤ò¼èÆÀ¤¹¤ë
+rtime \- リモートマシンから時刻を取得する
.\"O .SH SYNOPSIS
-.SH ½ñ¼°
+.SH 書式
.nf
.B "#include <rpc/des_crypt.h>"
.sp
.BI " struct rpc_timeval *" timeout );
.fi
.\"O .SH DESCRIPTION
-.SH ÀâÌÀ
+.SH 説明
.\"O This function uses the Time Server Protocol as described in
.\"O RFC\ 868 to obtain the time from a remote machine.
-¤³¤Î´Ø¿ô¤Ï RFC\ 868 ¤Ëµ½Ò¤µ¤ì¤Æ¤¤¤ë¥¿¥¤¥à¥µ¡¼¥Ð¥×¥í¥È¥³¥ë¤ò»ÈÍѤ·¡¢
-¥ê¥â¡¼¥È¥Þ¥·¥ó¤«¤é»þ¹ï¤ò¼èÆÀ¤¹¤ë¡£
+この関数は RFC\ 868 に記述されているタイムサーバプロトコルを使用し、
+リモートマシンから時刻を取得する。
.LP
.\"O The Time Server Protocol gives the time in seconds since
.\"O 00:00:00 UTC, 1 Jan 1900,
.\"O and this function subtracts the appropriate constant in order to
.\"O convert the result to seconds since the
.\"O Epoch, 1970-01-01 00:00:00 +0000 (UTC).
-¥¿¥¤¥à¥µ¡¼¥Ð¥×¥í¥È¥³¥ë¤Ï 00:00:00 UTC, 1 Jan 1900 ¤«¤éÉÿô¤òÄ󶡤¹¤ë¤Î¤Ç¡¢
-¤³¤Î´Ø¿ô¤ÏŬÀÚ¤ÊÄê¿ôÃͤò°ú¤¯¤³¤È¤Ë¤è¤ê¡¢
-Ä󶡤µ¤ì¤¿Ãͤò Unix ¤Ë¤ª¤±¤ë»þ¹ïµª¸µ (1970-01-01 00:00:00 +0000 (UTC))
-¤«¤éÉÿô¤ËÊÑ´¹¤¹¤ë¡£
+タイムサーバプロトコルは 00:00:00 UTC, 1 Jan 1900 から秒数を提供するので、
+この関数は適切な定数値を引くことにより、
+提供された値を Unix における時刻紀元 (1970-01-01 00:00:00 +0000 (UTC))
+から秒数に変換する。
.LP
.\"O When
.\"O .I timeout
.\"O is non-NULL, the udp/time socket (port 37) is used.
.I timeout
-¤¬ NULL ¤Ç¤Ê¤¤¾ì¹ç¡¢udp/time ¥½¥±¥Ã¥È (¥Ý¡¼¥È 37) ¤¬»ÈÍѤµ¤ì¤ë¡£
+が NULL でない場合、udp/time ソケット (ポート 37) が使用される。
.\"O Otherwise, the tcp/time socket (port 37) is used.
-¤½¤ì°Ê³°¤Î¾ì¹ç¡¢tcp/time ¥½¥±¥Ã¥È (¥Ý¡¼¥È 37) ¤¬»ÈÍѤµ¤ì¤ë¡£
+それ以外の場合、tcp/time ソケット (ポート 37) が使用される。
.\"O .SH "RETURN VALUE"
-.SH ÊÖ¤êÃÍ
+.SH 返り値
.\"O On success, 0 is returned, and the obtained 32-bit time value is stored in
.\"O .IR timep\->tv_sec .
-À®¸ù¤·¤¿¾ì¹ç¤Ï¡¢0 ¤¬ÊÖ¤µ¤ì¤Æ¡¢ÆÀ¤é¤ì¤¿ 32 ¥Ó¥Ã¥È¤Î»þ¹ïÃͤÏ
+成功した場合は、0 が返されて、得られた 32 ビットの時刻値は
.I timep\->tv_sec
-¤Ë³ÊǼ¤µ¤ì¤ë¡£
+に格納される。
.\"O In case of error \-1 is returned, and
.\"O .I errno
.\"O is set appropriately.
-¥¨¥é¡¼¤Î¾ì¹ç¤Ï¡¢\-1 ¤¬ÊÖ¤µ¤ì¤Æ¡¢
+エラーの場合は、\-1 が返されて、
.I errno
-¤¬Å¬ÀÚ¤ËÀßÄꤵ¤ì¤ë¡£
+が適切に設定される。
.\"O .SH ERRORS
-.SH ¥¨¥é¡¼
+.SH ã\82¨ã\83©ã\83¼
.\"O All errors for underlying functions
.\"O .RB ( sendto (2),
.\"O .BR poll (2),
.\"O .BR read (2))
.\"O can occur.
.\"O Moreover:
-ÆâÉô¤Ç»ÈÍѤ·¤Æ¤¤¤ë´Ø¿ô
+内部で使用している関数
.RB ( sendto (2),
.BR poll (2),
.BR recvfrom (2),
.BR connect (2),
.BR read (2))
-¤ÎÁ´¤Æ¤Î¥¨¥é¡¼¤¬µ¯¤³¤ë²ÄǽÀ¤¬¤¢¤ë¡£
-¹¹¤Ë¼¡¤Î¥¨¥é¡¼¤¬µ¯¤³¤ë²ÄǽÀ¤¬¤¢¤ë:
+の全てのエラーが起こる可能性がある。
+更に次のエラーが起こる可能性がある:
.TP
.B EIO
.\"O The number of returned bytes is not 4.
-ÊÖ¤µ¤ì¤¿¥Ð¥¤¥È¿ô¤¬ 4 ¥Ð¥¤¥È¤Ç¤Ê¤¤¡£
+返されたバイト数が 4 バイトでない。
.TP
.B ETIMEDOUT
.\"O The waiting time as defined in timeout has expired.
-timeout ¤ÇÄêµÁ¤µ¤ì¤¿ÂÔ¤Á»þ´Ö¤Î´ü¸Â¤¬Àڤ줿¡£
+timeout で定義された待ち時間の期限が切れた。
.\"O .SH "NOTES"
-.SH Ãí°Õ
+.SH 注意
.\"O Only IPv4 is supported.
-IPv4 ¤Î¤ß¤¬¥µ¥Ý¡¼¥È¤µ¤ì¤Æ¤¤¤ë¡£
+IPv4 のみがサポートされている。
.LP
.\"O Some
.\"O .I in.timed
.\"O .I use_tcp
.\"O set to 1.
.I in.timed
-¤Î¥Ð¡¼¥¸¥ç¥ó¤Ë¤è¤Ã¤Æ¤Ï TCP ¤·¤«¥µ¥Ý¡¼¥È¤·¤Æ¤¤¤Ê¤¤¤â¤Î¤â¤¢¤ë¡£
+のバージョンによっては TCP しかサポートしていないものもある。
.I use_tcp
-¤ò 1 ¤ËÀßÄꤷ¤Æ¡¢Îã¤Ë¤¢¤ë¥×¥í¥°¥é¥à¤ò»î¤¹¤³¤È¡£
+を 1 に設定して、例にあるプログラムを試すこと。
.LP
.\"O Libc5 uses the prototype
.\"O .br
.\"O .I <sys/time.h>
.\"O instead of
.\"O .IR <rpc/auth_des.h> .
-libc5 ¤Ï¥×¥í¥È¥¿¥¤¥×
+libc5 はプロトタイプ
.br
int rtime(struct sockaddr_in *, struct timeval *, struct timeval *);
.br
-¤ò»È¤¤¡¢
+を使い、
.I <rpc/auth_des.h>
-¤ÎÂå¤ï¤ê¤Ë
+の代わりに
.I <sys/time.h>
-¤òɬÍפȤ¹¤ë¡£
+を必要とする。
.\"O .SH "BUGS"
-.SH ¥Ð¥°
+.SH ã\83\90ã\82°
.\"O .BR rtime ()
.\"O in glibc and earlier does not work properly on 64-bit machines.
-glibc 2.2.5 °ÊÁ°¤Î
+glibc 2.2.5 以前の
.BR rtime ()
-¤Ï¡¢64 ¥Ó¥Ã¥È¥Þ¥·¥ó¤ÇÀµ³Î¤ËÆ°ºî¤·¤Ê¤¤¡£
+は、64 ビットマシンで正確に動作しない。
.\"O .SH "EXAMPLE"
-.SH Îã
+.SH 例
.\"O This example requires that port 37 is up and open.
.\"O You may check
.\"O that the time entry within
.\"O .I /etc/inetd.conf
.\"O is not commented out.
-¤³¤ÎÎã¤Ç¤Ï¥Ý¡¼¥È 37 ¤¬¥¢¥Ã¥×¤µ¤ì¤Æ¥ª¡¼¥×¥ó¤µ¤ì¤Æ¤¤¤ëɬÍפ¬¤¢¤ë¡£
+この例ではポート 37 がアップされてオープンされている必要がある。
.I /etc/inetd.conf
-¤Î time ¥¨¥ó¥È¥ê¤¬¥³¥á¥ó¥È¥¢¥¦¥È¤µ¤ì¤Æ¤¤¤Ê¤¤¤³¤È¤ò³Îǧ¤·¤Æ¤Û¤·¤¤¡£
+の time エントリがコメントアウトされていないことを確認してほしい。
.br
.\"O The program connects to a computer called "linux".
.\"O Using "localhost" does not work.
.\"O The result is the localtime of the computer "linux".
-¤³¤Î¥×¥í¥°¥é¥à¤Ï "linux" ¤È¤¤¤¦¥³¥ó¥Ô¥å¡¼¥¿¤ËÀܳ¤¹¤ë¡£
-"localhost" ¤ò»È¤Ã¤¿¾ì¹ç¤ÏÆ°ºî¤·¤Ê¤¤¡£
-·ë²Ì¤Ï¥³¥ó¥Ô¥å¡¼¥¿ "linux" ¤Î¥í¡¼¥«¥ë»þ¹ï¤Ç¤¢¤ë¡£
+このプログラムは "linux" というコンピュータに接続する。
+"localhost" を使った場合は動作しない。
+結果はコンピュータ "linux" のローカル時刻である。
.sp
.nf
#include <stdio.h>
}
.fi
.\"O .SH "SEE ALSO"
-.SH ´ØÏ¢¹àÌÜ
+.SH 関連項目
.\" .BR netdate (1),
.BR ntpdate (1),
.\" .BR rdate (1),