tio

Changes since tio v1.19:

• Added more error handling of terminal calls

  Also removed duplicate terminal flushing calls.

• Revert "Added support for non-standard baud rates"

  This reverts commit deec83a4eeddd5c3b2d4df041aede2bceb8867da.

  Reverting because supporting non-standard or arbitrary baud rates is
  troublesome because the c library provides no means of doing so and even
  if bare metal linux kernel interface is used it will not work on all
  Linux kernels version.

Changes since tio v1.18:

• Rearranged key commands

  Rearranged the key commands:

  ctrl-t c (clear screen) is now
  ctrl-t l which is similar to the well known shell ctrl-l

  ctrl-t i (show settings information) is now
  ctrl-t c (show configuration)

  Updated man page accordingly.

• Added "ctrl-t c" key command to clear screen

Changes since tio v1.17:

• Updated man page

• Added support for non-standard baud rates

  Only enabled when possible, that is, when the BOTHER definition is
  available.

  It is untested but it should work as described here:
  https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=683826

  Some Cypress USB<->serial devices supposedly supports arbitrary speeds.

• Generate baudrate switch cases based on detection

  Support a single source of baud rate configuration as discussed in
  https://github.com/tio/tio/issues/45 .

  To do so, autogeneration of the switch cases which do the baud rate
  option value check and configuration/conversion in tty_configure() is
  introduced via a single macro.

  Just to be safe, this change also enables configure detection of all
  baud rates, including the ones previously assumed supported by most/all
  systems (POSIX).

• Minor cleanup

• Exit when not a tty device in autoconnect mode

Jakub Wilk:

• Added non-standard baud rates that are defined on FreeBSD
• Capitalized "GitHub" in README

Changes since tio v1.16:

• Compacted tty_configure() a bit

• Fixed automatic baud rate enablement

• Minor cleanups

• Added autodetection of available baud rates

  Various platforms support different baud rates.

  To avoid adding platform specific handling generic baud rate detection
  tests are introduced in the configure script. Successfully detected baud
  rates are automatically enabled. This applies to both the C code and the
  bash completion script.

  Note:
  Baud rates below 57600 are defined by POSIX-1 and supported by most
  platforms so only baud rate 57600 and above are tested.

• Updated bash-completion

• Fixed printf() format type

• Added Travis build configuration

Jakub Wilk:

• Generated bash completion at configure time
• Reduce code duplication in baud rate detection
• Add support for baud rates 200 and 1800
• Fixed baudrate type

Changes since tio v1.15:

• Updated man page
• Updated README
• Removed obsolete packaging files
• Removed use of deprecated bzero()

Changes since tio v1.14:

• Removed + to remove potential confusion

• Added input digit checks

• Fixed license string

• Introduced tty_configure()

  Moved tty configuration actions to tty_configure() in tty.c. This way
  options.c is strictly about parsing options nothing else.

• Function names cleanup

• Updated AUTHORS file

  Added Nick who created the new tio package for Arch Linux.

• Fixed tx/rx counters type

Jakob Haufe:

• Include config.h before standard headers

  This makes use of 8d6d202 (Enable large file support) for real.

Jakub Wilk:

• Fixed printf directives for tx/rx counters

  In 9a66de0affda, types of tx/rx counters were changed from "long" to
  "unsigned long", but their printf directives remained "%ld".
  Change them to "%lu" to match the actual types.

Changes since tio v1.13:

• Fixed tio_printf macro

• Fixed launch hints

  Fixed launch hints not being printed in no autoconnect mode.

• Added 'ctrl-t ?' to list available commands

• Fixed log mechanism

  To avoid echoing only log what is received from tty device.

• Improved tio output

  Added titles and indentation to commands output for clearer separation
  when firing commands repeatedly.

  Also added print of tio version and quit command hint at launch.

• Cleaned up tio print mechanism

Jakub Wilk:

• Fixed grammar

  "allow" is a transitive verb, which requires an object,
  so "allow to " is ungrammatical.

• Fixed typo

Changes since tio v1.12:

• Fixed some error prints

• Fixed error printing for no autoconnect mode

  Always print errors but only print silent errors when in no autoconnect
  mode.

• Added key command for showing session settings

  A new key command "ctrl-t i" is added to allow the user to display the
  various session settings information (baudrate, databits, log file, etc.).

  This is useful in case you have a running session but have forgotten
  what the settings are.

Changes since tio v1.11:

• Consolidated command key handling

• Moved delay mechanism into separate function

• Retired obsolete usleep()

  Replaced with nanosleep()

• Added simple tx/rx statistics command (ctrl-t s)

  To display the total number of bytes transmitted/received simply perform the
  'ctrl-t s' command sequence.

  This feature can be useful when eg. trying to detect non-printable
  characters.

• Further simplification of key handling

  Changed so that the "ctrl-t ctrl-t" sequence is now simply "ctrl-t t" to
  send the ctrl-t key code. This is inspired by screen which does similar
  to send its command key code (ctrl-a a).

  This change also allows to easier add new key commands if needed.

  Updated man page accordingly.

• Cleaned up and simplified key handling

Jakub Wilk:

• Insert output delay only if something was output

Changes since tio v1.10:

• Enabled large file support (LFS)

  Added autotools AC_SYS_LARGEFILE to support 64 bit file size handling.

• Updated tio title

Changes since tio v1.9:

• Introduced lock on device file

  Tio will now test for and obtain an advisory lock on the tty device file
  to prevent starting multiple sessions on the same tty device.

• Updated AUTHORS

Jakub Wilk:

• Treat EOF on stdin as error

Changes since tio v1.8:

• Cleanup of error handling

  Introduced consistent way of handling errors and printing error messages.

  Also upgraded some warnings to errors.

• Updated localtime() error message

• Cleanup

Jakub Wilk:

• Fix error handling for select()

  Previously the error handling code for select() was unreachable.

• Removed unneeded quotes from AM_CFLAGS

• Expanded tabs

• Fixed setting "tainted"

  Set "tainted" if and only if any character was read from the device.

  Ctrl-t is no longer sent to the device on exit, so the trick to avoid
  its echo is not necessary.

  Characters read from stdin don't directly affect output, so they
  shouldn't enable "tainted".

• Used \r in color_printf()

  \033[300D is an unusual way to move the cursor back to column 1.
  Use straightforward \r instead.

• Added missing \r\n to warning messages

  \n alone is not enough, because the terminal is in raw mode.

Changes since tio v1.7:

• Fixed enablement of compiler warnings

• Fixed log_open() prototype

• Fixed index error wrt ctrl-t detection

• Fixed handling of ctrl-t

  Before, when exercising the quit key sequence (ctrl-t + q) the ctrl-t code
  (0x14) would be sent.

  This is now fixed so that it is not sent.

  However, in case it is needed to send ctrl-t to the device it is possible by
  simply repeating the ctrl-t.

  Meaning, ctrl-t + ctrl-t = ctrl-t sent to device.

• Improved error handling

  Fixes a memory leak and avoids aggressive busy looping when problems
  accessing tty device.

• Removed redundant log_close() call

• Enabled compiler warnings

Jakub Wilk:

• Stopped copying arguments to fixed-size buffers

  Don't needlessly copy command-line arguments into fixed-size buffers.

  Previously the program crashed if an overlong pathname was provided on
  the command line. Also, some systems (such as GNU Hurd) don't define
  MAXPATHLEN at all.

• Added const to log_open() prototype

• Completed the ^g to ^t transition

  In 72a287f18995 the escape key was changed from ^g to ^t, but some
  code and comments still referred to the old key.

• Used HTTPS for tio.github.io

• Man page beautification

• Bumped date in man page

• Improve man page formatting

  Use regular font for metacharacters such as "[]", "," or "|";
  use italic font for metavariables.

• Fixed hyphen vs minus vs em-dash confusion in man page

  • prints as hyphen;
    • prints as minus sign;
      \em prints as em-dash.

Changes since tio v1.6:

• Changed escape key from ^g to ^t

  After renaming to "tio" it makes sense to change the escape key
  accordingly. Hence, the new escape key is ^t.

  Meaning, in session, its now ctrl-t + q to quit.

Jakub Wilk:

• Fixed silly "tio or tio" in man page
• Fixed typo

Changes since gotty v1.5:

• Renamed "gotty" to "tio"

  Renamed to "tio" because it is shorter and this new name also more
  precisely reflects what the program is - a simple TTY terminal I/O
  application.

  "tio" can be considered short for terminal I/O or TTY I/O or a
  combination of the two, whichever you prefer.

  Also, wanted to avoid naming conflicts with other projects.

Changes since Go TTY v1.4:

• Added log feature

  Added "--log " option which writes all activity to specified
  file.

• Add support for configurable bash completion path

  Rewrote the configure script to support the following options:

  --with-bash-completion-dir=PATH
  --without-bash-completion-dir

Jakob Haufe:

• Don't hardcode path for bash completions

  Instead, use pkg-config to find out where the completions should go.

Changes since Go TTY v1.3:

• Fix tty device file accessibility test

  Fixes ending up in a freeze when a tty device exists but is not
  readable.

Changes since Go TTY v1.2:

• Do not quit on error

  This makes gotty more robust in the sense it will not quit when an error
  occurs but simply continue to try reconnect.

• Updated version text

• Updated AUTHORS file

• Cleanup man page examples

• Updated LICENSE file

• Reverted back to tar.xz only distribution

• Updated README

Jakub Wilk:

• Clarified README that the license is GPLv2+
• Stripped trailing whitespace from man page
• Fixed typo

Jakob Haufe:

• Add missing declaration
• Add missing include

Changes since Go TTY v1.1:

• Enabled .tar.gz distribution support

  Github does not allow releases including .tar.xz anymore so we have to
  also enable old school .tar.gz.

• Added AUTHORS file

• Added unit for baudrate

• Renamed --char-delay to --output-delay

  Renaming to make the naming more specific for the feature.

• Fixed man page for whatis

Jesper Larsen:

• Added packaging files for Ubuntu

Jeppe Ledet-Pedersen:

• Add option for setting inter-character delay

Thanks to Jesper and Jeppe for their contributions.

Changes since Go TTY v1.0:

• Flush I/O data on connect

  Make sure there is no stale I/O data on tty device upon connect.

• Updated README