OSDN Git Service

(split) LDP: Update the version to 3.53 in PO files
[linuxjm/LDP_man-pages.git] / release / man3 / ftime.3
index e7d4b93..e5f8617 100644 (file)
@@ -1,9 +1,8 @@
-.\" Hey Emacs! This file is -*- nroff -*- source.
-.\"
 .\" Copyright (c) 1993 Michael Haardt
-.\" (u31b3hs@pool.informatik.rwth-aachen.de)
+.\" (michael@moria.de)
 .\" Fri Apr  2 11:32:09 MET DST 1993
 .\"
+.\" %%%LICENSE_START(GPLv2+_DOC_FULL)
 .\" This is free documentation; you can redistribute it and/or
 .\" modify it under the terms of the GNU General Public License as
 .\" published by the Free Software Foundation; either version 2 of
 .\" GNU General Public License for more details.
 .\"
 .\" You should have received a copy of the GNU General Public
-.\" License along with this manual; if not, write to the Free
-.\" Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139,
-.\" USA.
+.\" License along with this manual; if not, see
+.\" <http://www.gnu.org/licenses/>.
+.\" %%%LICENSE_END
 .\"
 .\" Modified Sat Jul 24 14:23:14 1993 by Rik Faith (faith@cs.unc.edu)
 .\" Modified Sun Oct 18 17:31:43 1998 by Andries Brouwer (aeb@cwi.nl)
 .\" 2008-06-23, mtk, minor rewrites, added some details
 .\"
-.\" Japanese Version Copyright (c) 1997 HIROFUMI Nishizuka
-.\"    all rights reserved.
-.\" Translated Thu Dec 25 10:53:32 JST 1997
-.\"    by HIROFUMI Nishizuka <nishi@rpts.cl.nec.co.jp>
+.\"*******************************************************************
 .\"
-.\" Updated Tue Jul  8 JST 1999 by Kentaro Shirakata <argrath@ub32.org>
-.\" Updated Fri Dec 21 JST 2001 by Kentaro Shirakata <argrath@ub32.org>
-.\" Updated Wed Jul 30 JST 2008 by Kentaro Shirakata <argrath@ub32.org>
+.\" This file was generated with po4a. Translate the source file.
 .\"
-.TH FTIME 3 2010-02-25 "GNU" "Linux Programmer's Manual"
-.SH Ì¾Á°
-ftime \- ÆüÉդȻþ´Ö¤òÊÖ¤¹
-.SH ½ñ¼°
-.B "#include <sys/timeb.h>"
+.\"*******************************************************************
+.TH FTIME 3 2010\-02\-25 GNU "Linux Programmer's Manual"
+.SH 名前
+ftime \- 日付と時間を返す
+.SH 書式
+\fB#include <sys/timeb.h>\fP
 .sp
-.BI "int ftime(struct timeb *" tp );
-.SH ÀâÌÀ
-¤³¤Î´Ø¿ô¤Ï¸½ºß¤Î»þ¹ï¤ò¡¢µª¸µ (Epoch; 1970-01-01 00:00:00 +0000 (UTC))
-¤«¤é¤ÎÉÿô¤È¥ß¥êÉÿô¤ÇÊÖ¤¹¡£
-»þ¹ï¤Ï
-.I tp
-¤ÇÊÖ¤µ¤ì¡¢¤³¤ì¤Ï°Ê²¼¤Î¤è¤¦¤ËÄêµÁ¤µ¤ì¤Æ¤¤¤ë:
+\fBint ftime(struct timeb *\fP\fItp\fP\fB);\fP
+.SH 説明
+この関数は現在の時刻を、紀元 (Epoch; 1970\-01\-01 00:00:00 +0000 (UTC))  からの秒数とミリ秒数で返す。 時刻は
+\fItp\fP で返され、これは以下のように定義されている:
 .sp
 .in +4n
 .nf
@@ -62,52 +54,29 @@ struct timeb {
 .fi
 .in
 .LP
-¤³¤³¤Ç¡¢\fItime\fP ¤Ïµª¸µ (the Epoch) ¤«¤é¤ÎÉÿô¡¢
-\fImillitm\fP ¤Ï µª¸µ¤«¤é \fItime\fP Éø夫¤é¤Î¥ß¥êÉÿô¤Ç¤¢¤ë¡£
-\fItimezone\fP ¥Õ¥£¡¼¥ë¥É¤Ï¥°¥ê¥Ë¥Ã¥¸¤«¤éÀ¾¼þ¤ê¤Îʬ¤Ç·×¬¤µ¤ì¤ë
-¥í¡¼¥«¥ë¥¿¥¤¥à¥¾¡¼¥ó¤Ç¤¢¤ë(Éé¿ô¤Î¾ì¹ç¤Ï¥°¥ê¥Ë¥Ã¥¸¤«¤é¤ÎÅì²ó¤ê¤Îʬ¤ò
-¼¨¤¹)¡£
-\fIdstflag\fP ¥Õ¥£¡¼¥ë¥É¤Ï¡¢¤â¤· 0 ¤Ç¤Ê¤±¤ì¤Ð°ìǯ¤Î°ìÉô¤Ç²Æ»þ´Ö¤¬
-¸ºß¤¹¤ë¤³¤È¤ò¼¨¤¹¥Õ¥é¥°¤Ç¤¢¤ë¡£
+ここで、\fItime\fP は紀元 (the Epoch) からの秒数、 \fImillitm\fP は 紀元から \fItime\fP 秒後からのミリ秒数である。
+\fItimezone\fP フィールドはグリニッジから西周りの分で計測される ローカルタイムゾーンである(負数の場合はグリニッジからの東回りの分を 示す)。
+\fIdstflag\fP フィールドは、もし 0 でなければ一年の一部で夏時間が 存在することを示すフラグである。
 .LP
-POSIX.1-2001 ¤Ç¤Ï¡¢\fItimezone\fP ¤È \fIdstflag\fP ¤ÎÆâÍƤÏ̤ÄêµÁ¤Ç¤¢¤ë;
-¤³¤ì¤ËÍê¤ë¤Î¤ÏÈò¤±¤ë¤³¤È¡£
-\"O .SH "RETURN VALUE"
-.SH ÊÖ¤êÃÍ
-\"O This function always returns 0.
-¤³¤Î´Ø¿ô¤Ï¾ï¤Ë 0 ¤òÊÖ¤¹¡£
-(POSIX.1-2001 »ÅÍ͵ڤӤ¤¤¯¤Ä¤«¤Î¥·¥¹¥Æ¥à¤Î¥É¥­¥å¥á¥ó¥È¤Ç¤Ï¡¢
-¥¨¥é¡¼»þ¤Ë \-1 ¤òÊÖ¤¹¡£)
-\"O .SH "CONFORMING TO"
-.SH ½àµò
-4.2BSD, POSIX.1-2001.
-POSIX.1-2008 ¤Ç¤Ï
-.BR ftime ()
-¤Î»ÅÍͤ¬ºï½ü¤µ¤ì¤Æ¤¤¤ë¡£
+POSIX.1\-2001 では、\fItimezone\fP と \fIdstflag\fP の内容は未定義である; これに頼るのは避けること。
+.SH 返り値
+この関数は常に 0 を返す。 (POSIX.1\-2001 仕様及びいくつかのシステムのドキュメントでは、 エラー時に \-1 を返す。)
+.SH 準拠
+4.2BSD, POSIX.1\-2001.  POSIX.1\-2008 では \fBftime\fP()  の仕様が削除されている。
 
-¤³¤Î´Ø¿ô¤Ï¸Å¤¤¤â¤Î¤Ç¤¢¤ë¡£»È¤Ã¤Æ¤Ï¤Ê¤é¤Ê¤¤¡£
-ÉÃñ°Ì¤Î»þ´Ö¤Ç½½Ê¬¤Ê¤é¡¢
-.BR time (2)
-¤¬ÍøÍѤǤ­¤ë¡£
-.BR gettimeofday (2)
-¤Ç¥Þ¥¤¥¯¥íÉä¬ÆÀ¤é¤ì¤ë¡£
-.BR clock_gettime (2)
-¤Ç¥Ê¥ÎÉä¬ÆÀ¤é¤ì¤ë¤¬¡¢¹­¤¯ÍøÍѲÄǽ¤ÊÌõ¤Ç¤Ï¤Ê¤¤¡£
-\"O .SH BUGS
-.SH ¥Ð¥°
+この関数は古いものである。使ってはならない。 秒単位の時間で十分なら、 \fBtime\fP(2)  が利用できる。 \fBgettimeofday\fP(2)
+でマイクロ秒が得られる。 \fBclock_gettime\fP(2)  でナノ秒が得られるが、広く利用可能な訳ではない。
+.SH バグ
 .LP
-\"O glibc 2.1.1 is correct again.
-\fImillitm\fP ¥Õ¥£¡¼¥ë¥É¤Ï¡¢libc4 ¤È libc5 ¤Ç¤ÏÀµ¤·¤¯Æ°ºî¤¹¤ë¡£
-¤·¤«¤·¡¢½é´ü¤Î glibc2 ¤Ç¤Ï¥Ð¥°¤¬¤¢¤ê¡¢¾ï¤Ë 0 ¤òÊÖ¤¹¡£
-glibc 2.1.1 ¤«¤éºÆ¤ÓÀµ¾ï¤Ë¤Ê¤Ã¤¿¡£
-\"O .\" .SH HISTORY
-\"O .\" The
-\"O .\" .B ftime()
-\"O .\" function appeared in 4.2BSD.
-.\" .SH Îò»Ë
+.\" .SH HISTORY
+.\" The
 .\" .BR ftime ()
-.\" ´Ø¿ô¤Ï 4.2BSD ¤Ë¸½¤ì¤¿¡£
-\"O .SH "SEE ALSO"
-.SH ´ØÏ¢¹àÌÜ
-.BR gettimeofday (2),
-.BR time (2)
+.\" function appeared in 4.2BSD.
+\fImillitm\fP フィールドは、libc4 と libc5 では正しく動作する。 しかし、初期の glibc2 ではバグがあり、常に 0 を返す。
+glibc 2.1.1 から再び正常になった。
+.SH 関連項目
+\fBgettimeofday\fP(2), \fBtime\fP(2)
+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。