posix_openpt

Section: C Library Functions (3)
Updated: 2026-02-08
Index JM Home Page roff page
 

名前

posix_openpt - 疑似端末 (pseudoterminal) デバイスをオープンする  

ライブラリ

標準 C ライブラリ (libc,~-lc)  

書式

#include <stdlib.h>
#include <fcntl.h>

int posix_openpt(int flags);

glibc 向けの機能検査マクロの要件 (feature_test_macros(7) 参照):

posix_openpt():

    _XOPEN_SOURCE >= 600
 

説明

posix_openpt() 関数は使用されていない疑似端末マスタデバイスをオープンし、 そのデバイスを参照するために使うファイルディスクリプターを返す。

flags 引数は、以下のフラグのうち 0 個以上の OR をとったビットマスクである。

O_RDWR
読み書きのためにデバイスをオープンする。 普通はこのフラグを指定する。
O_NOCTTY
このデバイスをプロセスの制御端末としない。
 

返り値

成功した場合、 posix_openpt() は、未使用のファイルディスクリプターのうち最小の値のファイルディスクリプター (非負の整数) を返す。失敗した場合、-1 が返されて、エラーを示すために errno が設定される。  

エラー

open(2) を参照すること。  

属性

この節で使用されている用語の説明については、 attributes(7) を参照。
インターフェース属性値
posix_openpt() Thread safetyMT-Safe
 

標準規格

POSIX.1-2008.  

歴史

glibc 2.2.1. POSIX.1-2001.

It is part of the UNIX 98 pseudoterminal support (see pts(4)).  

注意

Some older UNIX implementations that support System V (aka UNIX 98) pseudoterminals don't have this function, but it can be easily implemented by opening the pseudoterminal multiplexer device:

int
posix_openpt(int flags)
{
    return open("/dev/ptmx", flags);
}

posix_openpt() を呼び出すと、対応する擬似端末スレーブデバイスのパス 名が生成される。スレーブデバイスのパス名は ptsname(3) を使って取得 できる。スレーブデバイスのパス名はマスターデバイスがオープンされている 間だけ存在する。  

関連項目

open(2), getpt(3), grantpt(3), ptsname(3), unlockpt(3), pts(4), pty(7)


 

Index

名前
ライブラリ
書式
説明
返り値
エラー
属性
標準規格
歴史
注意
関連項目

This document was created by man2html, using the manual pages.