termios

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

名前

termios, tcgetattr, tcsetattr, tcsendbreak, tcdrain, tcflush, tcflow, cfmakeraw, cfgetospeed, cfgetispeed, cfsetispeed, cfsetospeed, cfsetspeed - ターミナル属性の取得・設定、ライン制御、ボーレートの取得・設定  

ライブラリ

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

書式

#include <termios.h>
#include <unistd.h>

int tcgetattr(int fd, struct termios *termios_p);
int tcsetattr(int fd, int optional_actions,
              const struct termios *termios_p);

int tcsendbreak(int fd, int duration);
int tcdrain(int fd);
int tcflush(int fd, int queue_selector);
int tcflow(int fd, int action);

void cfmakeraw(struct termios *termios_p);

speed_t cfgetispeed(const struct termios *termios_p);
speed_t cfgetospeed(const struct termios *termios_p);

int cfsetispeed(struct termios *termios_p, speed_t speed);
int cfsetospeed(struct termios *termios_p, speed_t speed);
int cfsetspeed(struct termios *termios_p, speed_t speed);

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

cfsetspeed(), cfmakeraw():

    Since glibc 2.19:
        _DEFAULT_SOURCE
    glibc 2.19 and earlier:
        _BSD_SOURCE
 

説明

termios 関数群は、非同期通信ポートを制御するための汎用 ターミナルインターフェースである。  

termios 構造体

ここに示されている関数の多くは、引数に termios_p を用いる。 この引数は termios 構造体へのポインターである。 この構造体には少なくとも以下に示すメンバが含まれる:

tcflag_t c_iflag;      /* input modes */
tcflag_t c_oflag;      /* output modes */
tcflag_t c_cflag;      /* control modes */
tcflag_t c_lflag;      /* local modes */
cc_t     c_cc[NCCS];   /* special characters */

以下に、これらのフィールドに割り当て可能な値について説明する。 最初の 4 つのビットマスクフィールドでは、 関係するフラグの定義のいくつかは、特定の機能検査マクロ (feature_test_macros(7) 参照) が定義された場合にのみ公開される。 必要な機能検査マクロは角括弧 ("[]") 内に書かれている。

以下の説明で、 "POSIX にはない" は その値が POSIX.1-2001 で規定されていないことを意味し、 "XSI" はその値が POSIX.1-2001 の XSI 拡張で 規定されていることを意味する。

c_iflag フラグには以下の要素を指定できる:

IGNBRK
入力中の BREAK 信号を無視する。
BRKINT
If IGNBRK is set, a BREAK is ignored. If it is not set but BRKINT is set, then a BREAK causes the input and output queues to be flushed, and if the terminal is the controlling terminal of a foreground process group, it will cause a SIGINT to be sent to this foreground process group. When neither IGNBRK nor BRKINT are set, a BREAK reads as a null byte ('\0'), except when PARMRK is set, in which case it reads as the sequence \377 \0 \0.
IGNPAR
フレームエラーおよびパリティエラーを無視する。
PARMRK
If this bit is set, input bytes with parity or framing errors are marked when passed to the program. This bit is meaningful only when INPCK is set and IGNPAR is not set. The way erroneous bytes are marked is with two preceding bytes, \377 and \0. Thus, the program actually reads three bytes for one erroneous byte received from the terminal. If a valid byte has the value \377, and ISTRIP (see below) is not set, the program might confuse it with the prefix that marks a parity error. Therefore, a valid byte \377 is passed to the program as two bytes, \377 \377, in this case.
If neither IGNPAR nor PARMRK is set, read a character with a parity error or framing error as \0.
INPCK
入力のパリティチェックを有効にする。
ISTRIP
8 ビット目を落とす。
INLCR
入力の NL (New Line: 改行文字) を CR (Carriage Return: 復帰文字) に 置き換える。
IGNCR
入力の CR を無視する。
ICRNL
(IGNCR が設定されていない場合) 入力の CR を NL に置き換える。
IUCLC
(POSIX にはない) 入力の大文字を小文字に置き換える。
IXON
出力の XON/XOFF フロー制御を有効にする。
IXANY
(XSI) 任意の文字を入力すると、停止していた出力を再開する (デフォルトでは、START 文字でのみ出力が再開される)。
IXOFF
入力の XON/XOFF フロー制御を有効にする。
IMAXBEL
(POSIX にはない) 入力キューが一杯の時にベルを鳴らす。 Linux ではこのビットは実装されておらず、 常にセットされているかのように振舞う。
IUTF8 (Linux 2.6.4 以降)
(POSIX にはない) 入力が UTF8 である; これにより cooked mode で文字削除 (character-erase) を 正しく機能させることができる。

c_oflag フラグには以下の要素を指定できる:

OPOST
実装に依存した出力処理を有効にする。
OLCUC
(POSIX にはない) 出力時に小文字を大文字に変換する。
ONLCR
(XSI) 出力の NL を CR-NL に置き換える。
OCRNL
出力の CR を NL に置き換える。
ONOCR
0 桁目で CR を出力しない。
ONLRET
The NL character is assumed to do the carriage-return function; the kernel's idea of the current column is set to 0 after both NL and CR.
OFILL
転送時間を遅らせるのではなく、補填文字 (fill character) を送る。 (訳注:特定の文字に対して、端末側の処理を待つために転送を一定時間 遅らせることができる。また、 OFILL を指定すると 転送を遅らせる代わりに補填文字を送る。)
OFDEL
Fill character is ASCII DEL (0177). If unset, fill character is ASCII NUL ('\0'). (Not implemented on Linux.)
NLDLY
NL の遅延を設定する。値は NL0 (遅延なし) および NL1 である。 [_BSD_SOURCE か _SVID_SOURCE か _XOPEN_SOURCE が必要]
CRDLY
CR の遅延を設定する。値は CR0 (遅延なし), CR1, CR2,CR3 である。 [_BSD_SOURCE か _SVID_SOURCE か _XOPEN_SOURCE が必要]
TABDLY
水平タブ (horizontal tab) の遅延を設定する。 値は TAB0, TAB1, TAB2, TAB3 (または XTABS; ただし「バグ」を参照) である。 [_BSD_SOURCE か _SVID_SOURCE か _XOPEN_SOURCE が必要] XTAB3 (これは XTABS と同じである) の値はタブをスペース何個に変換するかを示す (タブは 8 桁毎に止まる)。
BSDLY
後退 (backspace) の遅延を設定する。 値は BS0 (遅延なし) あるいは BS1 である。 (実装されたことはない) [_BSD_SOURCE か _SVID_SOURCE か _XOPEN_SOURCE が必要]
VTDLY
垂直タブ (vertical tab) の遅延を設定する。 値は VT0 (遅延なし) あるいは VT1 である。
FFDLY
頁送り (form feed) の遅延を設定する。 値は FF0 (遅延なし) あるいは FF1 である。 [_BSD_SOURCE か _SVID_SOURCE か _XOPEN_SOURCE が必要]

c_cflag フラグは以下の通り:

CBAUD
(POSIX にはない) ボーレートマスク (4+1 ビット)。 [_BSD_SOURCE か _SVID_SOURCE が必要]
CBAUDEX
(POSIX にはない) 追加のボーレートマスク (1 ビット)。 CBAUD に含まれている。 [_BSD_SOURCE か _SVID_SOURCE が必要]
(POSIX では、 termios 構造体に格納されたボーレートは正確なものではなく、 ボーレートを操作するために cfgetispeed() と cfsetispeed() が提供されている。 c_cflag 内の CBAUD で選択されたビットを使うシステムもあれば、 sg_ispeed や sg_ospeed といった独立したフィールドを使うものもある。)
CSIZE
文字サイズを設定する。 値は CS5, CS6, CS7, CS8 である。
CSTOPB
ストップビットを 1 ではなく 2 にする。
CREAD
受信を有効にする。
PARENB
出力にパリティを付加し、入力のパリティチェックを行う。
PARODD
設定されると、入力および出力に対するパリティが奇数パリティとなる。 設定されない場合、偶数パリティが使用される。
HUPCL
最後のプロセスがデバイスをクローズした後、モデムの制御線を low にする (切断する)。
CLOCAL
モデムの制御線を無視する。
LOBLK
(POSIX にはない) 現在のシェル層以外からの出力を抑制する。
 shl (シェル層) で用いられる。(Linux では実装されていない)
CIBAUD
(not in POSIX) Mask for input speeds. The values for the CIBAUD bits are the same as the values for the CBAUD bits, shifted left IBSHIFT bits. [requires _BSD_SOURCE or _SVID_SOURCE] (Not implemented in glibc, supported on Linux via TCGET* and TCSET* ioctls; see ioctl_tty(2))
CMSPAR
(POSIX にはない) (一部のシリアルデバイスでサポートされている) 「スティック (stick)」パリティ (マーク/スペース パリティ)を使用する。 PARODD が設定された場合パリティビットは常に 1 となり、 設定されない場合は常に 0 となる。 [_BSD_SOURCE か _SVID_SOURCE が必要]
CRTSCTS
(not in POSIX) Enable RTS/CTS (hardware) flow control. [requires _BSD_SOURCE or _SVID_SOURCE]

c_lflag フラグは以下の通り:

ISIG
INTR, QUIT, SUSP, DSUSP の文字を受信した時、対応するシグナルを 発生させる。
ICANON
カノニカルモードを有効にする (下記参照)。
XCASE
(not in POSIX; not supported under Linux) If ICANON is also set, terminal is uppercase only. Input is converted to lowercase, except for characters preceded by \. On output, uppercase characters are preceded by \ and lowercase characters are converted to uppercase. [requires _BSD_SOURCE or _SVID_SOURCE or _XOPEN_SOURCE]
ECHO
入力された文字をエコーする。
ECHOE
ICANON も同時に設定された場合、ERASE 文字は前の文字を削除し、 WERASE 文字は前の単語を削除する。
ECHOK
ICANON も同時に設定された場合、KILL 文字は現在の行を削除する。
ECHONL
ICANON も同時に設定された場合、 ECHO が設定されていなくても NL 文字をエコーする。
ECHOCTL
(not in POSIX) If ECHO is also set, terminal special characters other than TAB, NL, START, and STOP are echoed as ^X, where X is the character with ASCII code 0x40 greater than the special character. For example, character 0x08 (BS) is echoed as ^H. [requires _BSD_SOURCE or _SVID_SOURCE]
ECHOPRT
(POSIX にはない) ICANON および ECHO が同時に設定されている場合、 削除された文字も表示される。 [_BSD_SOURCE か _SVID_SOURCE が必要]
ECHOKE
(POSIX にはない) ICANON も設定された場合、 KILL が行の各文字を消去する代わりにエコーされる。 これは ECHOE および ECHOPRT を指定することと等しい。 [_BSD_SOURCE か _SVID_SOURCE が必要]
DEFECHO
(not in POSIX) Echo only when a process is reading. (Not implemented on Linux.)
FLUSHO
(POSIX にはない; Linux では対応していない) 出力をフラッシュする。このフラグは DISCARD 文字を入力することで切替えられる。 [_BSD_SOURCE か _SVID_SOURCE が必要]
NOFLSH
INT, QUIT, SUSP 文字に対応するシグナルを発生する際の 入力・出力キューのフラッシュを無効にする。
TOSTOP
バックグラウンドプロセスのプロセスグループで制御端末へ 文字を出力しようとしているプロセスに対して SIGTTOU シグナルを送る。
PENDIN
(POSIX にはない; Linux では対応していない) 次の文字を読み込んだ時、入力キュー中の全文字を再表示する。 (bash(1) は入力行をこのように処理している。) [_BSD_SOURCE か _SVID_SOURCE が必要]
IEXTEN
実装依存の入力処理を有効にする。 このフラグは、特殊文字である EOL2, LNEXT, REPRINT, WERASE や、 IUCLC フラグを有効にするために必要である。

c_cc 配列は端末特殊文字を定義している。 シンボルの一覧 (初期値) と意味は以下の通り。

VDISCARD
(POSIX にはない; Linux では対応していない; 017, SI, Ctrl-O) 未送信バッファーの内容の破棄/保存を切り替える。 IEXTEN がセットされている場合に認識し、入力には渡されない。
VDSUSP
(POSIX にはない; Linux では対応していない; 031, EM, Ctrl-Y) 遅延中断文字 (DSUSP)。 ユーザープログラムから文字が読み込まれた時に SIGTSTP シグナルを送る。 IEXTEN と ISIG がセットされていて、システムがジョブ制御に対応している 場合に 認識し、入力には渡されない。
VEOF
(004, EOT, Ctrl-D) ファイル終端文字 (EOF)。 より正確には、tty バッファーの内容を行末を待たずにユーザープログラムに送る。 これが行の最初の文字だった場合、ユーザープログラムの read(2) は 0 を 返し、 ファイル終端であることを知らせる。 ICANON がセットされている場合に認識し、 入力には渡されない。
VEOL
(0, NUL) 追加の行末文字 (EOL)。 ICANON がセットされている場合に認識する。
VEOL2
(POSIX にはない; 0, NUL) 追加の行末文字 (EOL2)。 ICANON がセットされている場合に認識する。
VERASE
(0177, DEL, rubout か 010, BS, Ctrl-H か #) 消去文字 (ERASE)。 これにより、直前の未消去文字を消去する。 しかし、EOF や行頭を超えては消去しない。 ICANON がセットされている場合に認識し、入力には渡されない。
VINTR
(003, ETX, Ctrl-C か 0177, DEL, rubout) 割り込み文字 (INTR)。 SIGINT シグナルを送る。 ISIG がセットされている場合に認識し、入力には渡されない。
VKILL
(025, NAK, Ctrl-U か Ctrl-X か @) 完全消去文字 (KILL)。 直前の EOF か行頭以降の全ての入力を消去する。 ICANON がセットされている場合に認識し、入力には渡されない。
VLNEXT
(POSIX にはない; 026, SYN Ctrl-V) リテラル (LNEXT)。 次の入力文字をエスケープし、特別な意味があっても解釈しない。 IEXTEN がセットされている場合に認識し、入力には渡されない。
VMIN
非カノニカル読み込み時の最小文字数 (MIN)。
VQUIT
(034, FS, Ctrl-\) Quit character (QUIT). Send SIGQUIT signal. Recognized when ISIG is set, and then not passed as input.
VREPRINT
(POSIX にはない; 022, DC2, Ctrl-R) まだ読み込んでいない文字列を再表示する (REPRINT)。 ICANON と IEXTEN がセットされている場合に認識し、入力には渡されない。
VSTART
(021, DC1, Ctrl-Q) 開始文字 (START)。停止文字で停止した出力を再開する。 IXON がセットされている場合に認識し、入力には渡されない。
VSTATUS
(not in POSIX; not supported under Linux; status request: 024, DC4, Ctrl-T). Status character (STATUS). Display status information at terminal, including state of foreground process and amount of CPU time it has consumed. Also sends a SIGINFO signal (not supported on Linux) to the foreground process group.
VSTOP
(023, DC3, Ctrl-S) 停止文字 (STOP)。 開始文字が入力されるまで出力を停止する。 IXON が設定されている場合に認識し、入力には渡されない。
VSUSP
(032, SUB, Ctrl-Z) 中断文字 (SUSP)。 SIGTSTP シグナルを送る。 ISIG がセットされている場合に認識し、入力には渡されない。
VSWTCH
(POSIX にはない; Linux では対応していない; 0, NUL) スイッチ文字 (SWTCH)。 System V で (シェルのジョブ制御の前にあった) shell layers での シェルの切り替えに用いられる。
VTIME
非カノニカル読み込み時のタイムアウト時間 (1/10 秒単位) (TIME)。
VWERASE
(POSIX にはない; 027, ETB, Ctrl-W) 単語消去 (WERASE)。 ICANON と IEXTEN がセットされている場合に認識し、入力には渡されない。

対応する c_cc 要素の値を _POSIX_VDISABLE に設定することで、 それぞれの端末制御文字を無効にすることができる。

The above symbolic subscript values are all different, except that VTIME, VMIN may have the same value as VEOL, VEOF, respectively. In noncanonical mode, the special character meaning is replaced by the timeout meaning. For an explanation of VMIN and VTIME, see the description of noncanonical mode below.  

端末の設定の取得と変更

tcgetattr() gets the parameters associated with the object referred by fd, and stores them in the termios structure referenced by termios_p. This function may be invoked from a background process; however, the terminal attributes may be subsequently changed by a foreground process.

tcsetattr() sets the parameters associated with the terminal (unless support is required from the underlying hardware that is not available) from the termios structure referred to by termios_p. optional_actions specifies when the changes take effect:

TCSANOW
ただちに変更が有効となる。
TCSADRAIN
fd への出力がすべて転送された後に変更が有効になる。このオプションは 出力に影響するパラメーターを変更する時に使用するべきである。
TCSAFLUSH
パラメーターを変更する前に、 fd への出力がすべて転送され、受信したがまだ読み込んでいないすべての 入力が破棄される。
 

カノニカルモードと非カノニカルモード

The setting of the ICANON canon flag in c_lflag determines whether the terminal is operating in canonical mode (ICANON set) or noncanonical mode (ICANON unset). By default, ICANON is set.

カノニカルモードでは、以下のような動作となる。

•
入力は行単位に行われる。 行区切り文字が打ち込まれた時点で、入力行が利用可能となる。 行区切り文字は NL, EOL, EOL2 および行頭での EOF である。 EOF 以外の場合、 read(2) が返すバッファーに行区切り文字も含められる。
•
行編集が有効となる (ERASE, KILL が効果を持つ。 IEXTEN フラグが設定された場合は、 WERASE, REPRINT, LNEXT も効果を持つ)。 read(2) は最大でも 1行の入力しか返さない。 read(2) が要求したバイト数が現在の入力行のバイト数よりも少ない場合、 要求したのと同じバイト数だけが読み込まれ、 残りの文字は次回の read(2) で読み込まれる。
•
The maximum line length is 4096 chars (including the terminating newline character); lines longer than 4096 chars are truncated. After 4095 characters, input processing (e.g., ISIG and ECHO* processing) continues, but any input data after 4095 characters up to (but not including) any terminating newline is discarded. This ensures that the terminal can always receive more input until at least one line can be read.

In noncanonical mode input is available immediately (without the user having to type a line-delimiter character), no input processing is performed, and line editing is disabled. The read buffer will only accept 4095 chars; this provides the necessary space for a newline char if the input mode is switched to canonical. The settings of MIN (c_cc[VMIN]) and TIME (c_cc[VTIME]) determine the circumstances in which a read(2) completes; there are four distinct cases:

MIN == 0, TIME == 0 (ポーリングリード)
データが利用可能であれば、 read(2) はすぐに返る。このときの返り値は、そのとき利用可能なバイト数か read(2) の要求バイト数のうち小さい方となる。 利用可能なデータがない場合 read(2) は 0 を返す。
MIN > 0, TIME == 0 (ブロッキングリード)
read(2) は、利用可能なデータが MIN バイトに達するまで停止する。返り値は最大でも要求バイト数である。
MIN == 0, TIME > 0 (タイムアウト付きの読み込み)
TIME はタイマーの上限を規定し、単位は 1/10 秒である。 タイマーは read(2) が呼ばれた時点で開始される。 read(2) が返るのは、少なくとも 1バイトのデータが利用可能となった時点、 またはタイマーが時間切れとなった時点である。 入力が全くなくタイマーが時間切れとなった場合、 read(2) は 0 を返す。 read(2) の呼び出し時にすでに利用可能なデータがある場合、 その呼び出しは呼び出し直後にそのデータが到着したかのように振る舞う。
MIN > 0, TIME > 0 (バイト間のタイムアウト付きの読み出し)
TIME はタイマーの上限を規定し、単位は 1/10 秒である。 入力の最初のバイトが利用可能になった後は、 新たに 1バイト受信する度にタイマーがリセットされる。 read(2) は以下の条件のいずれかを満たした場合に返る。
•
MIN バイトのデータを受信した。
•
バイト間タイマーが時間切れになった。
•
read(2) で要求されたバイト数のデータを受信した (POSIX ではこの終了条件は規定されておらず、 他のいくつかの実装では read(2) はこの条件では返らない)。
タイマーは最初のバイトが利用可能になった時点で開始されるので、 少なくとも 1 バイトは読み出される。 read() の呼び出し時にすでに利用可能なデータがある場合、 その呼び出しは呼び出し直後にそのデータが到着したかのように振る舞う。

POSIX では、 O_NONBLOCK ファイル状態フラグが MIN や TIME の設定よりも優先されるかは規定されていない。 O_NONBLOCK が設定された場合、 非カノニカルモードの read(2) は MIN や TIME の設定に関わらずすぐに返る。 また、利用可能なデータがない場合、 POSIX では、は非カノニカルモードの read(2) が 0 を返す方法も、 errno に EAGAIN を設定して -1 を返すことも認められている。  

Raw mode

cfmakeraw() は、端末を昔の Version 7 端末ドライバの "raw" モードのように設定する。 入力は文字単位に可能であり、エコーが無効となり、 端末の入出力文字に対する特殊処理はすべて無効となる。 端末の属性は以下のように設定される:

termios_p->c_iflag &= ~(IGNBRK | BRKINT | PARMRK | ISTRIP
                | INLCR | IGNCR | ICRNL | IXON);
termios_p->c_oflag &= ~OPOST;
termios_p->c_lflag &= ~(ECHO | ECHONL | ICANON | ISIG | IEXTEN);
termios_p->c_cflag &= ~(CSIZE | PARENB);
termios_p->c_cflag |= CS8;
 

ライン制御

tcsendbreak() は端末が非同期のシリアルデータ転送を用いている場合に、 連続した0のビット列を一定間隔で転送する。 duration が 0 の場合は、0 のビットを 0.25 秒以上、 0.5 秒以下の間隔で転送する。 duration が 0 でない場合は、 0 のビットを実装依存の時間間隔で送る。

端末が非同期のシリアルデータ転送モードでない場合、 tcsendbreak() は何も行わずに戻る。

tcdrain() は fd が行っている出力の転送が完了するまで待つ。

tcflush() は fd が行っているデータの出力でまだ転送されていないもの、あるいは受信し たがまだ入力していないものを破棄する。いずれを行うかは queue_selector の値で定める:

TCIFLUSH
受信したが読んでいないデータをフラッシュする。
TCOFLUSH
書いたが送信していないデータをフラッシュする。
TCIOFLUSH
受信したが読んでいないデータ・書いたが送信していないデータ両方 をフラッシュする。

tcflow() は fd で指定されたオブジェクトにおけるデータの送信あるいは受信を一時的に中断する。 送信と受信のどちらかは、 actionで決まる:

TCOOFF
出力の中断。
TCOON
中断した出力の再開。
TCIOFF
STOP 文字の送信。 STOP 文字は端末デバイスからシステムへのデータ送信を停止する。
TCION
START 文字の送信。 START 文字は端末デバイスからシステムへのデータ送信を開始する。

端末ファイルがオープンされたときのデフォルトでは、 入力も出力も中断されていない。  

ライン速度

ボーレート関数は termios 構造体中の入出力ボーレートを 取得、設定するために提供される。 設定された値は tcsetattr() の呼び出しが成功するまでは有効ではない。

速度を B0 に設定した場合、モデムは停止 (hang up) する。 B38400 に該当する実際のビットレートは setserial(8) で 変更できる。

入力および出力ボーレートは termios 構造体に格納される。

cfgetospeed() は termios_p が示している termios 構造体に格納されている 出力ボーレートを返す。

cfsetospeed() は termios_p で示されている termios 構造体中の出力ボーレートを speed に設定する。値は以下のいずれかでなければならない:

B0
B50
B75
B110
B134
B150
B200
B300
B600
B1200
B1800
B2400
B4800
B9600
B19200
B38400
B57600
B115200
B230400
B460800
B500000
B576000
B921600
B1000000
B1152000
B1500000
B2000000

These constants are additionally supported on the SPARC architecture:

B76800
B153600
B307200
B614400

These constants are additionally supported on non-SPARC architectures:

B2500000
B3000000
B3500000
B4000000

Due to differences between architectures, portable applications should check if a particular Bnnn constant is defined prior to using it.

The zero baud rate, B0, is used to terminate the connection. If B0 is specified, the modem control lines shall no longer be asserted. Normally, this will disconnect the line. CBAUDEX is a mask for the speeds beyond those defined in POSIX.1 (57600 and above). Thus, B57600 & CBAUDEX is nonzero.

Setting the baud rate to a value other than those defined by Bnnn constants is possible via the TCSETS2 ioctl; see ioctl_tty(2).

cfgetispeed() は termios 構造体中の入力ボーレートを返す。

cfsetispeed() sets the input baud rate stored in the termios structure to speed, which must be specified as one of the Bnnn constants listed above for cfsetospeed(). If the input baud rate is set to the literal constant 0 (not the symbolic constant B0), the input baud rate will be equal to the output baud rate.

cfsetspeed() は 4.4BSD による拡張である。この関数は cfsetispeed() と同じ引数をとり、入出力両方の速度を設定する。  

返り値

cfgetispeed() は termios 構造体中の入力ボーレートを返す。

cfgetospeed() は termios 構造体中の出力ボーレートを返す。

他のすべての関数の戻り値:

0
実行成功。
-1
実行失敗。 errno がエラーの種類を示す。

Note that tcsetattr() returns success if any of the requested changes could be successfully carried out. Therefore, when making multiple changes, it may be necessary to follow this call with a further call to tcgetattr() to check that all changes have been performed successfully.  

属性

この節で使用されている用語の説明については、 attributes(7) を参照。
インターフェース属性値
tcgetattr(), tcsetattr(), tcdrain(), tcflush(), tcflow(), tcsendbreak(), cfmakeraw(), cfgetispeed(), cfgetospeed(), cfsetispeed(), cfsetospeed(), cfsetspeed() Thread safetyMT-Safe
 

標準規格

tcgetattr()
tcsetattr()
tcsendbreak()
tcdrain()
tcflush()
tcflow()
cfgetispeed()
cfgetospeed()
cfsetispeed()
cfsetospeed()
POSIX.1-2008.
cfmakeraw()
cfsetspeed()
BSD.
 

歴史

tcgetattr()
tcsetattr()
tcsendbreak()
tcdrain()
tcflush()
tcflow()
cfgetispeed()
cfgetospeed()
cfsetispeed()
cfsetospeed()
POSIX.1-2001.
cfmakeraw()
cfsetspeed()
BSD.
 

注意

UNIX V7 and several later systems have a list of baud rates where after the values B0 through B9600 one finds the two constants EXTA, EXTB ("External A" and "External B"). Many systems extend the list with much higher baud rates.

tcsendbreak() で duration に 0 以外を指定した場合の効果は様々である。 SunOS は duration*N 秒のブレークを規定している。ここで N は 0.25 以上 0.5 未満である。 Linux, AIX, DU, Tru64 は duration ミリ秒のブレークを送信する。 FreeBSD, NetBSD, HP-UX, MacOS は duration の値を無視する。 Solaris と UnixWare では、非ゼロの duration を指定した tcsendbreak() の振る舞いは tcdrain() と同様である。  

バグ

On the Alpha architecture before Linux 4.16 (and glibc before glibc 2.28), the XTABS value was different from TAB3 and it was ignored by the N_TTY line discipline code of the terminal driver as a result (because as it wasn't part of the TABDLY mask).  

関連項目

reset(1), setterm(1), stty(1), tput(1), tset(1), tty(1), ioctl_console(2), ioctl_tty(2), cc_t(3type), speed_t(3type), tcflag_t(3type), setserial(8)


 

Index

名前
ライブラリ
書式
説明
termios 構造体
端末の設定の取得と変更
カノニカルモードと非カノニカルモード
Raw mode
ライン制御
ライン速度
返り値
属性
標準規格
歴史
注意
バグ
関連項目

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