.\" %%%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 2020\-06\-09 "" "Linux Programmer's Manual" .SH 名前 ptsname, ptsname_r \- スレーブ擬似端末の名前を取得する .SH 書式 \fB#include \fP .PP \fBchar *ptsname(int \fP\fIfd\fP\fB);\fP .br \fBint ptsname_r(int \fP\fIfd\fP\fB, char *\fP\fIbuf\fP\fB, size_t \fP\fIbuflen\fP\fB);\fP .PP .RS -4 glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照): .RE .PP .ad l \fBptsname\fP(): .br .RS 4 glibc 2.24 以降: _XOPEN_SOURCE\ >=\ 500 || (_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED) .br glibc 2.23 以前: _XOPEN_SOURCE .RE .PP \fBptsname_r\fP(): _GNU_SOURCE .ad .SH 説明 \fBptsname\fP() 関数は、ファイルディスクリプター \fIfd\fP で参照されるマスタ擬似端末 (pts) デバイスに対応する スレーブ擬似端末デバイスの名前を返す。 .PP \fBptsname_r\fP() 関数は \fBptsname\fP() のリエントラントなバージョンである。 この関数は、スレーブ疑似端末デバイスの名前を、ヌルで終端された文字列の形で \fIbuf\fP で指定されたバッファーに格納して返す。 \fIbuflen\fP 引数には \fIbuf\fP のバイト数を指定する。 .SH 返り値 成功の場合、 \fBptsname\fP() は静的記憶領域の文字列へのポインターを返す。 この記憶領域はこの後の \fBptsname\fP() の呼び出しで上書きされる。 このポインターを free してはいけない。 エラーの場合は NULL を返す。 .PP .\" In glibc, the error number is not only returned as the return value .\" but also stored in errno. But this is not true for musl libc. 成功の場合、 \fBptsname_r\fP() は 0 を返す。 エラーの場合、0 以外の値を返し、エラーを示すため、エラー番号が返される。 .SH エラー .TP \fBEINVAL\fP .\" glibc commit 8f0a947cf55f3b0c4ebdf06953c57eff67a22fa9 (\fBptsname_r\fP() only) \fIbuf\fP is NULL. (This error is returned only for glibc 2.25 and earlier.) .TP \fBENOTTY\fP \fIfd\fP がマスタ疑似端末デバイスを参照していない。 .TP \fBERANGE\fP (\fBptsname_r\fP() のみ) \fIbuf\fP が小さすぎる。 .SH バージョン \fBptsname\fP() は、バージョン 2.1 以降の glibc で提供されている。 .SH 属性 この節で使用されている用語の説明については、 \fBattributes\fP(7) を参照。 .TS allbox; lb lb lb l l l. インターフェース 属性 値 T{ \fBptsname\fP() T} Thread safety MT\-Unsafe race:ptsname T{ \fBptsname_r\fP() T} Thread safety MT\-Safe .TE .SH 準拠 \fBptsname\fP(): POSIX.1\-2001, POSIX.1\-2008. .PP \fBptsname\fP() は UNIX 98 疑似端末仕様の一部である (\fBpts\fP(4) を参照のこと)。 .PP .\" FIXME . for later review when Issue 8 is one day released .\" http://austingroupbugs.net/tag_view_page.php?tag_id=8 .\" http://austingroupbugs.net/view.php?id=508 \fBptsname_r\fP() は Linux による拡張であり、 POSIX.1 の次のメジャーバージョン (Issue 8) に含めるように提案されている。この関数についての記載があるものとして 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 プロジェクトのリリース 5.10 の一部である。プロジェクトの説明とバグ報告に関する情報は \%https://www.kernel.org/doc/man\-pages/ に書かれている。