-.\" Hey Emacs! This file is -*- nroff -*- source.
+.\" %%%LICENSE_START(PUBLIC_DOMAIN)
.\" This page is in the public domain. - aeb
+.\" %%%LICENSE_END
.\"
.\" 2004-12-17, mtk, added description of ptsname_r() + ERRORS
.\"
+.\"*******************************************************************
+.\"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.\"
.\" Japanese Version Copyright (c) 2003 Akihiro MOTOKI
.\" all rights reserved.
.\" Translated 2003-07-08, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
.\" Updated 2005-02-27, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
-.\"
-.\"WORD: pseudoterminal µ¼»÷üËö
.\"
-.TH PTSNAME 3 2008-09-03 "" "Linux Programmer's Manual"
-.\"O .SH NAME
-.\"O ptsname, ptsname_r \- get the name of the slave pseudoterminal
-.SH ̾Á°
-ptsname, ptsname_r \- ¥¹¥ì¡¼¥Öµ¼»÷üËö¤Î̾Á°¤ò¼èÆÀ¤¹¤ë
-.\"O .SH SYNOPSIS
-.SH ½ñ¼°
+.TH PTSNAME 3 2013\-06\-21 "" "Linux Programmer's Manual"
+.SH 名前
+ptsname, ptsname_r \- スレーブ擬似端末の名前を取得する
+.SH 書式
.nf
-.\"O .BR "#define _XOPEN_SOURCE" " /* See feature_test_macros(7) */"
-.BR "#define _XOPEN_SOURCE" " /* feature_test_macros(7) »²¾È */"
+\fB#define _XOPEN_SOURCE\fP /* feature_test_macros(7) 参照 */
.br
-.B #include <stdlib.h>
+\fB#include <stdlib.h>\fP
.sp
-.BI "char *ptsname(int " fd ");"
+\fBchar *ptsname(int \fP\fIfd\fP\fB);\fP
.sp
-.\"O .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */"
-.BR "#define _GNU_SOURCE" " /* feature_test_macros(7) »²¾È */"
+\fB#define _GNU_SOURCE\fP /* feature_test_macros(7) 参照 */
.br
-.B #include <stdlib.h>
+\fB#include <stdlib.h>\fP
.sp
-.BI "int ptsname_r(int " fd ", char *" buf ", size_t " buflen ");"
+\fBint ptsname_r(int \fP\fIfd\fP\fB, char *\fP\fIbuf\fP\fB, size_t \fP\fIbuflen\fP\fB);\fP
.fi
-.\"O .SH DESCRIPTION
-.SH ÀâÌÀ
-.\"O The
-.\"O .BR ptsname ()
-.\"O function returns the name of the slave pseudoterminal device
-.\"O corresponding to the master referred to by
-.\"O .IR fd .
-.BR ptsname ()
-´Ø¿ô¤Ï
-.I fd
-¤Ç»²¾È¤µ¤ì¤ë¥Þ¥¹¥¿µ¼»÷üËö (pts) ¥Ç¥Ð¥¤¥¹¤ËÂбþ¤¹¤ë
-¥¹¥ì¡¼¥Öµ¼»÷üËö¥Ç¥Ð¥¤¥¹¤Î̾Á°¤òÊÖ¤¹¡£
+.SH 説明
+\fBptsname\fP() 関数は \fIfd\fP で参照されるマスタ擬似端末 (pts) デバイスに対応する スレーブ擬似端末デバイスの名前を返す。
-.\"O The
-.\"O .BR ptsname_r ()
-.\"O function is the reentrant equivalent of
-.\"O .BR ptsname ().
-.\"O It returns the name of the slave pseudoterminal device as a
-.\"O null-terminated string in the buffer pointed to by
-.\"O .IR buf .
-.\"O The
-.\"O .I buflen
-.\"O argument specifies the number of bytes available in
-.\"O .IR buf .
-.BR ptsname_r ()
-´Ø¿ô¤Ï
-.BR ptsname ()
-¤Î¥ê¥¨¥ó¥È¥é¥ó¥È¤Ê¥Ð¡¼¥¸¥ç¥ó¤Ç¤¢¤ë¡£
-¤³¤Î´Ø¿ô¤Ï¡¢¥¹¥ì¡¼¥Öµ¿»÷üËö¥Ç¥Ð¥¤¥¹¤Î̾Á°¤ò¡¢
-NULL ¤Ç½ªÃ¼¤µ¤ì¤¿Ê¸»úÎó¤Î·Á¤Ç
-.I buf
-¤Ç»ØÄꤵ¤ì¤¿¥Ð¥Ã¥Õ¥¡¤Ë³ÊǼ¤·¤ÆÊÖ¤¹¡£
-.I buflen
-°ú¤¿ô¤Ë¤Ï
-.I buf
-¤Î¥Ð¥¤¥È¿ô¤ò»ØÄꤹ¤ë¡£
-.\"O .SH "RETURN VALUE"
-.SH ÊÖ¤êÃÍ
-.\"O On success,
-.\"O .BR ptsname ()
-.\"O returns a pointer to a string in static storage which will be
-.\"O overwritten by subsequent calls.
-.\"O This pointer must not be freed.
-.\"O On failure, a NULL pointer is returned.
-À®¸ù¤Î¾ì¹ç¡¢
-.BR ptsname ()
-¤ÏÀÅŪµ²±Îΰè¤Îʸ»úÎó¤Ø¤Î¥Ý¥¤¥ó¥¿¤òÊÖ¤¹¡£
-¤³¤Îµ²±Îΰè¤Ï¤³¤Î¸å¤Î
-.BR ptsname ()
-¤Î¸Æ¤Ó½Ð¤·¤Ç¾å½ñ¤¤µ¤ì¤ë¡£
-¤³¤Î¥Ý¥¤¥ó¥¿¤ò free ¤·¤Æ¤Ï¤¤¤±¤Ê¤¤¡£
-¥¨¥é¡¼¤Î¾ì¹ç¤Ï NULL ¥Ý¥¤¥ó¥¿¤òÊÖ¤¹¡£
+\fBptsname_r\fP() 関数は \fBptsname\fP() のリエントラントなバージョンである。 この関数は、スレーブ疑似端末デバイスの名前を、
+NULL で終端された文字列の形で \fIbuf\fP で指定されたバッファに格納して返す。 \fIbuflen\fP 引き数には \fIbuf\fP
+のバイト数を指定する。
+.SH 返り値
+成功の場合、 \fBptsname\fP() は静的記憶領域の文字列へのポインタを返す。 この記憶領域はこの後の \fBptsname\fP()
+の呼び出しで上書きされる。 このポインタを free してはいけない。 エラーの場合は NULL ポインタを返す。
-.\"O On success,
-.\"O .BR ptsname_r ()
-.\"O returns 0.
-.\"O On failure, a nonzero value is returned
-.\"O and
-.\"O .I errno
-.\"O is set to indicate the error.
-.\"O .\" In fact the errno value is also returned as the function
-.\"O .\" result -- MTK, Dec 04
-À®¸ù¤Î¾ì¹ç¡¢
-.BR ptsname_r ()
-¤Ï 0 ¤òÊÖ¤¹¡£
-¥¨¥é¡¼¤Î¾ì¹ç¡¢0 °Ê³°¤ÎÃͤòÊÖ¤·¡¢
-.I errno
-¤ò¥¨¥é¡¼¤ò¼¨¤¹ÃͤËÀßÄꤹ¤ë¡£
-.\" ¼ÂºÝ¤Ë¤Ï¡¢errno ¤ÎÃͤ¬´Ø¿ô¤Î·ë²Ì¤ÎÊÖ¤êÃͤȤ·¤Æ¤âÊÖ¤µ¤ì¤ë¡£-- MTK, Dec 04
-.\"O .SH ERRORS
-.SH ¥¨¥é¡¼
-.TP
-.B EINVAL
-.\"O .RB ( ptsname_r ()
-.\"O only)
-.\"O .I buf
-.\"O is NULL.
-.RB ( ptsname_r ()
-¤Î¤ß)
-.I buf
-¤¬ NULL ¤Ç¤¢¤ë¡£
-.TP
-.B ENOTTY
-.\"O .I fd
-.\"O does not refer to a pseudoterminal master device.
-.I fd
-¤¬¥Þ¥¹¥¿µ¿»÷üËö¥Ç¥Ð¥¤¥¹¤ò»²¾È¤·¤Æ¤¤¤Ê¤¤¡£
-.TP
-.B ERANGE
-.\"O .RB ( ptsname_r ()
-.\"O only)
-.\"O .I buf
-.\"O is too small.
-.RB ( ptsname_r ()
-¤Î¤ß)
-.I buf
-¤¬¾®¤µ¤¹¤®¤ë¡£
-.\"O .SH VERSIONS
-.SH ¥Ð¡¼¥¸¥ç¥ó
-.\"O .BR ptsname ()
-.\"O is provided in glibc since version 2.1.
-.BR ptsname ()
-¤Ï¡¢¥Ð¡¼¥¸¥ç¥ó 2.1 °Ê¹ß¤Î glibc ¤ÇÄ󶡤µ¤ì¤Æ¤¤¤ë¡£
-.\"O .SH "CONFORMING TO"
-.SH ½àµò
-.\"O .BR ptsname ()
-.\"O is part of the UNIX 98 pseudoterminal support (see
-.\"O .BR pts (4)).
-.\"O This function is specified in POSIX.1-2001.
-.BR ptsname ()
-¤Ï UNIX 98 µ¿»÷üËö»ÅÍͤΰìÉô¤Ç¤¢¤ë
-.RB ( pts (4)
-¤ò»²¾È¤Î¤³¤È)¡£¤³¤Î´Ø¿ô¤Ï POSIX.1-2001 ¤Çµ¬Äꤵ¤ì¤Æ¤¤¤ë¡£
+.\" In fact the errno value is also returned as the function
+.\" result -- MTK, Dec 04
+成功の場合、 \fBptsname_r\fP() は 0 を返す。 エラーの場合、0 以外の値を返し、 \fIerrno\fP をエラーを示す値に設定する。
+.SH エラー
+.TP
+\fBEINVAL\fP
+(\fBptsname_r\fP() のみ) \fIbuf\fP が NULL である。
+.TP
+\fBENOTTY\fP
+\fIfd\fP がマスタ疑似端末デバイスを参照していない。
+.TP
+\fBERANGE\fP
+(\fBptsname_r\fP() のみ) \fIbuf\fP が小さすぎる。
+.SH バージョン
+\fBptsname\fP() は、バージョン 2.1 以降の glibc で提供されている。
+.SH 属性
+.SS "マルチスレッディング (pthreads(7) 参照)"
+\fBptsname\fP() 関数はスレッドセーフではない。
+.LP
+\fBptsname_r\fP() 関数はスレッドセーフである。
+.SH 準拠
+\fBptsname\fP() は UNIX 98 疑似端末仕様の一部である (\fBpts\fP(4) を参照のこと)。この関数は POSIX.1\-2001
+で規定されている。
-.\"O .BR ptsname_r ()
-.\"O is a Linux extension.
-.\"O A version of this function is documented on Tru64 and HP-UX, but
-.\"O on those implementations, \-1 is returned on error, with
-.\"O .I errno
-.\"O set to indicate the error.
-.\"O Avoid using this function in portable programs.
-.BR ptsname_r ()
-¤Ï Linux ¤Ë¤è¤ë³ÈÄ¥¤Ç¤¢¤ë¡£
-¤³¤Î´Ø¿ô¤Ë¤Ä¤¤¤Æ¤ÎµºÜ¤¬¤¢¤ë¤â¤Î¤È¤·¤Æ Tru64 ¤È HP-UX ¤¬¤¢¤ë¤¬¡¢
-¤³¤ì¤é¤Î OS ¤Ç¤Î¼ÂÁõ¤Ç¤Ï¥¨¥é¡¼¤Î¾ì¹ç \-1 ¤òÊÖ¤·¡¢
-.I errno
-¤Ë¥¨¥é¡¼¤ò¼¨¤¹ÃͤòÀßÄꤹ¤ë¡£
-°Ü¿¢¤ò¹Íθ¤·¤¿¥×¥í¥°¥é¥à¤Ç¤Ï¤³¤Î´Ø¿ô¤Î»ÈÍѤÏÈò¤±¤ë¤³¤È¡£
-.\"O .SH "SEE ALSO"
-.SH ´ØÏ¢¹àÌÜ
-.BR grantpt (3),
-.BR posix_openpt (3),
-.BR ttyname (3),
-.BR unlockpt (3),
-.BR pts (4),
-.BR pty (7)
+\fBptsname_r\fP() は Linux による拡張である。 この関数についての記載があるものとして Tru64 と HP\-UX があるが、
+これらの OS での実装ではエラーの場合 \-1 を返し、 \fIerrno\fP にエラーを示す値を設定する。
+移植を考慮したプログラムではこの関数の使用は避けること。
+.SH 関連項目
+\fBgrantpt\fP(3), \fBposix_openpt\fP(3), \fBttyname\fP(3), \fBunlockpt\fP(3), \fBpts\fP(4),
+\fBpty\fP(7)
+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.53 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。
OSDN Git Service
