SETSERIAL(8)

NAME
setserial - get/set Linux serial port information

SYNOPSIS
setserial [ -abgqvVW ] serial-device [ cmd [ arg ]] [ cmd ]

DESCRIPTION
Setserial is a program which allows you to look at and change various attributes of a serial device, including its port, its IRQ, and other serial port options.
Starting with Linux 0.99 pl10, only the COM1-4 ports are configured, using the default IRQ of 4 and 3. So, if you have any other serial ports provided by other boards (such as an AST Fourport), or if COM3-4 have been a non-standard IRQ so that you can use time simultaneously with COM1-2, you *must* use this program in order to configure those serial ports.
Setserial is normally run from the file /etc/rc.serial.

  OPTIONS

-a  Display all possible information about the port.

-b  Display boot-time level of information.

-g  Get and display serial information for all serial ports on the machine.

-q  Quiet flag.

-v  Verbose flag.

-V  Display current version and exit.

-W  Do wild interrupt initialisation and exit.

  COMMANDS
Note: * means that the command takes an argument. ^ means that the command can be preceded by '^' to turn off the option.

* port
    Set the I/O port.

* irq
    Set the interrupt.

* uart
    Set the UART type (none, 8250, 16450, 16550, 16550A).

* baud_base
    Set the base baud rate in CLOCK_FREQ / 16.

* divisor
    Set the custom divisor. See spd_custom.

^ fourport
    Configure the port as an AST Fourport.

autoconfigure
    Automatically configure the serial port.

^ auto_irq
    Try to determine the irq during autoconfiguration.

^ skip_test
    Skip the UART test during autoconfiguration.

^ sak
    Set the break key as the Secure Attention Key.

^ session_lockout
    Lock out callout port across different sessions.

^ pgrp_lockout
    Lock out callout port across different process groups.

^ termios_restore
    Restore termios after dialin port unblocks.

spd_hi
    Use 56kb instead of 38.4kb.

spd_vhi
    Use 115kb instead of 38.4kb.

spd_cust
    Use the custom divisor to set the speed at 38.4kb. (Baud rate = baud_base / custom_divisor.)

spd_normal
    Use 38.4kb when a baud rate of 38.4kb is selected.

NOTES
Use a leading '0x' for hex numbers.
CAUTION: Using an invalid port can lock up your machine!

FILES
/etc/rc.local

SEE ALSO
tty(4), ttys(4), kernel/chr_drv/serial.c

AUTHOR
Rick Sladkey (jrs@world.std.com)
High speed modifications by: Michael K. Johnson (johnsonm@stolaf.edu)
Re-written by: Theodore Ts'o (tytso@mit.edu), 1/1/93