reset-port Command

For Windows: Not Supported

The reset-port BASIC program restarts suspended output and drains both the input and output terminal buffers.

Syntax

reset-port port.number {(options}

reset-port tty.name {(options}

Parameter(s)

port.number

PIB associated to the device to restart. This command may not be issued against its own port.

tty.name

Device name to reset. This form can be used on any serial device on the system, even if not connected to the D3 virtual machine.

options

f

Suspends output option acts as if the device had sent an x-off (CTRL+S).

i

Drains input buffer. All characters waiting to be read from the device are removed. If no option is specified, this option is part of the default.

n

Restarts output and acts as if the device had sent an x-on (CTRL+Q). If no option is specified, this option is part of the default.

o

Drains output buffer. All characters waiting to be sent to the device are removed (lost). If no option is specified, this option is part of the default.

r

Resets to raw mode.

No other characteristic of the device is altered by the reset-port command. Restarting suspending output is useful when a port is stopped by a x-off and a x-on command that was never sent.

The D3 process must be connected to the D3 virtual machine. Otherwise, the tty.name form of the command must be specified.

Raw Mode

Normal D3 operations require that the device is used in raw mode, that is, where UNIX does not do any preprocessing or postprocessing to the data exchanged with the device. However, some UNIX operations sometimes reprogram the device and leave it in a state incompatible with D3. The most common symptom is a double echo (that is, a command is echoed one character at a time, as usual, but, when pressing ENTER, the command displays again and nothing happens). To correct this situation, issue a reset-port line (r, which attempts to reset the device to a suitable state.

Example(s)

reset-port 25

 

reset-port /dev/tty26

See Also

Hung Port, list-lines Command, Port Number, reset-port Command, set-baud Command, set-port Command, setport Command, System Privileges, wheres Command, xonoff Command