NAME

       grabserial - Serial line reader

SYNOPSIS

       grabserial

DESCRIPTION

       Grabserial  is  a  small program which reads a serial port and writes the data to standard
       output. The main purpose of this tool is to collect messages written to the serial console
       from a target board running Linux, and save the messages on a host machine.

USAGE

       grabserial [options] <config_file>

OPTIONS

       -h, --help
               Print this message

       -d, --device=<devpath>
               Set the device to read (default '/dev/ttyS0')

       -b, --baudrate=<val>
               Set the baudrate (default 115200)

       -w, --width=<val>
               Set the data bit width (default 8)

       -p, --parity=<val>
               Set the parity (default N)

       -s, --stopbits=<val>
               Set the stopbits (default 1)

       -x, --xonxoff
               Enable software flow control (default off)

       -r, --rtscts
               Enable RTS/CTS flow control (default off)

       -f, --force-reset
               Force pyserial to reset device parameters

       --endtime=<secs>
               End the program after the specified seconds have elapsed.

       --command=<cmd>
               Send a command to the port before reading

       -t, --time
               Print time for each line received.  The time is
               when the first character of each line is
               received by grabserial

       --systime
               Print system time for each line received. The time
               is the absolute local time when the first character
               of each line is received by grabserial

       -m, --match=<pat>
               Specify a regular expression pattern to match to
               set a base time.  Time values for lines after the
               line matching the pattern will be relative to
               this base time.

       -i, --instantpat=<pat>
               Specify a regular expression pattern to have its time
               reported at end of run.  Works mid-line.

       -q, --quitpat=<pat>
               Specify a regular expression pattern to end the
               program. Works mid-line.

       -l, --launchtime
               Set base time from launch of program.

       -o, --output=<name>
               Output data to the named file.

       -v, --verbose
               Show verbose runtime messages

       -V, --version
               Show version number and exit

Example

       grabserial -e 30 -t -m ^Linux version.*
              This  will grab serial input for 30 seconds, displaying the time for each line, and
              re-setting the base time when the line starting with "Linux version" is seen.

AUTHOR

       This manual page was written by Nobuhiro Iwamatsu <iwamatsu@debian.org>,  for  the  Debian
       GNU/Linux system (but may be used by others).

                                             MAY 2015                               GRABSERIAL(1)