Developer Guide and Reference

ID 767251
Date 10/31/2024
Public
Document Table of Contents

PXFTCSETATTR

POSIX Subroutine: Writes new terminal settings. This routine is only available for Linux.

Module

USE IFPOSIX

CALL PXFTCSETATTR (ifildes,ioptacts,jtermios,ierror)

ifildes

(Input) INTEGER(4). The file descriptor associated with the terminal.

ioptacts

(Input) INTEGER(4). Specifies when the terminal changes take effect.

jtermios

(Input) INTEGER(4). A handle for structure termios. Contains the new terminal settings.

ierror

(Output) INTEGER(4). The error status.

If successful, ierror is set to zero; otherwise, an error code.

The PXFTCSETATTR subroutine copies all terminal parameters from structure termiosinto the terminal associated with ifildes. When the terminal settings will change depends on the value of ioptacts, which must be one of the following constant names:

Constant 1

Action

TCSANOW

The changes occur immediately.

TCSADRAIN

The changes occur after all output written to ifildes has been transmitted.

TCSAFLUSH

The changes occur after all output written to ifildes has been transmitted, and all input that had been received but not read has been discarded.

1These names can be used in PXFCONST or IPXFCONST.

NOTE:

To get a handle for an instance of the termiosstructure, use PXFSTRUCTCREATE with the string 'termios' for the structure name.