STTY

Control terminal settings

 

USupported on Unix

 

NSupported in Synergy .NET
xcall STTY(setting_flag[, seconds])

Arguments

setting_flag

One of the following terminal setting controls: (n)

0 = Restore stty attributes to their original settings (before Synergy DBL modified them) on Unix, or allow console.readline to echo characters on .NET.

1 = Set the Synergy DBL standard stty settings.

2 = Don’t restore terminal attributes on the SPAWN or SHELL subroutines at runtime exit. (Unix only)

3 = Restore terminal attributes on the SPAWN or SHELL subroutines and at runtime exit. (Unix only)

4 = Enable stty of a serial device used in the OPEN statement. (Unix only)

5 = Disable stty of a serial device used in the OPEN statement. (Unix only)

6 = Change device open time-out to seconds. (Unix only)

7 = Restore the terminal attributes on the SPAWN or SHELL subroutines even if the runtime is set to not affect terminal attributes. (Unix only)

seconds

(optional) The number of seconds for the runtime to wait to open a device before returning a “Device in use” ($ERR_DEVUSE) error.

Discussion

The STTY subroutine sets or unsets the terminal settings.

On Unix, you can reset setting 7 by calling STTY with setting 3.

Note

For settings 3 and 7, terminal attributes are only restored on SPAWN if SPAWN’s second argument is passed.

The Synergy .NET runtime supports setting_flag values of 0 and 1. STTY(0) is required for a console.readline to echo characters on .NET. The ACCEPT, GET, and READS statements and the W_ routines should not be used while STTY(0) is in effect.

For .NET terminal applications that use Synergy windowing API routines or UI Toolkit, the only value supported for setting_flag is 1.