.\" %%%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 .\" Updated 2005-02-27, Akihiro MOTOKI .\" .TH PTSNAME 3 2013\-06\-21 "" "Linux Programmer's Manual" .SH 名前 ptsname, ptsname_r \- スレーブ擬似端末の名前を取得する .SH 書式 .nf \fB#define _XOPEN_SOURCE\fP /* feature_test_macros(7) 参照 */ .br \fB#include \fP .sp \fBchar *ptsname(int \fP\fIfd\fP\fB);\fP .sp \fB#define _GNU_SOURCE\fP /* feature_test_macros(7) 参照 */ .br \fB#include \fP .sp \fBint ptsname_r(int \fP\fIfd\fP\fB, char *\fP\fIbuf\fP\fB, size_t \fP\fIbuflen\fP\fB);\fP .fi .SH 説明 \fBptsname\fP() 関数は \fIfd\fP で参照されるマスタ擬似端末 (pts) デバイスに対応する スレーブ擬似端末デバイスの名前を返す。 \fBptsname_r\fP() 関数は \fBptsname\fP() のリエントラントなバージョンである。 この関数は、スレーブ疑似端末デバイスの名前を、ヌルで終端された文字列の形で \fIbuf\fP で指定されたバッファーに格納して返す。 \fIbuflen\fP 引き数には \fIbuf\fP のバイト数を指定する。 .SH 返り値 成功の場合、 \fBptsname\fP() は静的記憶領域の文字列へのポインターを返す。 この記憶領域はこの後の \fBptsname\fP() の呼び出しで上書きされる。 このポインターを free してはいけない。 エラーの場合は NULL を返す。 .\" 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 で規定されている。 \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.79 の一部 である。プロジェクトの説明とバグ報告に関する情報は http://www.kernel.org/doc/man\-pages/ に書かれている。