mirror of
https://github.com/tio/tio.git
synced 2026-05-01 14:57:59 +02:00
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.
This commit is contained in:
parent
f5f7ba7d8a
commit
9dd21af867
19 changed files with 79 additions and 99 deletions
4
.gitignore
vendored
4
.gitignore
vendored
|
|
@ -1,6 +1,6 @@
|
||||||
*.tar.xz
|
*.tar.xz
|
||||||
src/*.o
|
src/*.o
|
||||||
src/gotty
|
src/tio
|
||||||
Makefile.in
|
Makefile.in
|
||||||
Makefile
|
Makefile
|
||||||
aclocal.m4
|
aclocal.m4
|
||||||
|
|
@ -20,4 +20,4 @@ src/include/config.h.in
|
||||||
src/include/config.h.in~
|
src/include/config.h.in~
|
||||||
src/include/stamp-h1
|
src/include/stamp-h1
|
||||||
*.swp
|
*.swp
|
||||||
/gotty-*
|
/tio-*
|
||||||
|
|
|
||||||
21
ChangeLog
21
ChangeLog
|
|
@ -1,21 +1,4 @@
|
||||||
=== Go TTY v1.5 ===
|
=== tio v1.6 ===
|
||||||
|
|
||||||
Changes since Go TTY v1.4:
|
Changes since tio v1.5:
|
||||||
|
|
||||||
* Added log feature
|
|
||||||
|
|
||||||
Added "--log <filename>" 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.
|
|
||||||
|
|
|
||||||
2
LICENSE
2
LICENSE
|
|
@ -11,5 +11,5 @@ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||||
GNU General Public License for more details.
|
GNU General Public License for more details.
|
||||||
|
|
||||||
You should have received a copy of the GNU General Public License version 2
|
You should have received a copy of the GNU General Public License version 2
|
||||||
along with gotty, in a file named COPYING. If not, see
|
along with tio, in a file named COPYING. If not, see
|
||||||
<http://www.gnu.org/licenses/>.
|
<http://www.gnu.org/licenses/>.
|
||||||
|
|
|
||||||
35
README
35
README
|
|
@ -1,25 +1,22 @@
|
||||||
=== Go TTY - The Really Simple TTY Terminal Application ===
|
=== tio - the simple TTY terminal I/O application ===
|
||||||
|
|
||||||
|
|
||||||
1. Introduction
|
1. Introduction
|
||||||
|
|
||||||
Go TTY or "gotty" is a really simple TTY terminal application which
|
"tio" is a simple TTY terminal application which features a straightfoward
|
||||||
features a simple commandline interface to easily connect to TTY devices
|
commandline interface to easily connect to TTY devices for basic
|
||||||
for basic input/output.
|
input/output.
|
||||||
|
|
||||||
Go TTY was created because the author needed a simple no-nonsense TTY
|
|
||||||
terminal application to go do quick debugging.
|
|
||||||
|
|
||||||
Let's Go TTY! - http://gotty.io
|
|
||||||
|
|
||||||
|
It was created because the author needed a simple no-nonsense TTY
|
||||||
|
terminal application to easily connect to various terminal TTY devices.
|
||||||
|
|
||||||
2. Usage
|
2. Usage
|
||||||
|
|
||||||
The commandline interface is straightforward as reflected in the output
|
The commandline interface is straightforward as reflected in the output
|
||||||
from 'gotty --help':
|
from 'tio --help':
|
||||||
|
|
||||||
|
|
||||||
Usage: gotty [<options>] <tty device>
|
Usage: tio [<options>] <tty device>
|
||||||
|
|
||||||
Options:
|
Options:
|
||||||
-b, --baudrate <bps> Baud rate (default: 115200)
|
-b, --baudrate <bps> Baud rate (default: 115200)
|
||||||
|
|
@ -39,23 +36,23 @@
|
||||||
The only option which requires a bit of elaboration is the --no-autoconnect
|
The only option which requires a bit of elaboration is the --no-autoconnect
|
||||||
option.
|
option.
|
||||||
|
|
||||||
By default gotty automatically connects to the provided device if present.
|
By default tio automatically connects to the provided device if present.
|
||||||
If the device is not present it will wait for it to appear and then
|
If the device is not present it will wait for it to appear and then
|
||||||
connect. If the connection is lost (eg. device disconnects) it will wait
|
connect. If the connection is lost (eg. device disconnects) it will wait
|
||||||
for the device to reappear and then reconnect.
|
for the device to reappear and then reconnect.
|
||||||
|
|
||||||
However, if the --no-autoconnect option is provided gotty will exit if the
|
However, if the --no-autoconnect option is provided tio will exit if the
|
||||||
device is not present or exit if an established connection is lost.
|
device is not present or exit if an established connection is lost.
|
||||||
|
|
||||||
Go TTY features full bash autocompletion support.
|
Tio features full bash autocompletion support.
|
||||||
|
|
||||||
|
|
||||||
3. Download
|
3. Download
|
||||||
|
|
||||||
Find the latest release tarball at http://gotty.io
|
Find the latest release tarball at http://tio.github.io
|
||||||
|
|
||||||
The latest source is available on github:
|
The latest source is available on github:
|
||||||
https://github.com/gotty/gotty
|
https://github.com/tio/tio
|
||||||
|
|
||||||
|
|
||||||
4. Installation
|
4. Installation
|
||||||
|
|
@ -71,18 +68,18 @@
|
||||||
|
|
||||||
5. Contributing
|
5. Contributing
|
||||||
|
|
||||||
Go TTY is open source. Any contributions (bug fixes, doc, ideas, etc.) are
|
Tio is open source. Any contributions (bug fixes, doc, ideas, etc.) are
|
||||||
welcome.
|
welcome.
|
||||||
|
|
||||||
|
|
||||||
6. Support
|
6. Support
|
||||||
|
|
||||||
Submit bug reports on github: https://github.com/gotty/gotty/issues
|
Submit bug reports on github: https://github.com/tio/tio/issues
|
||||||
|
|
||||||
|
|
||||||
7. License
|
7. License
|
||||||
|
|
||||||
Go TTY is GPLv2+. See COPYING file for license details.
|
Tio is GPLv2+. See COPYING file for license details.
|
||||||
|
|
||||||
|
|
||||||
8. Authors
|
8. Authors
|
||||||
|
|
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
AC_PREREQ([2.68])
|
AC_PREREQ([2.68])
|
||||||
AC_INIT([Go TTY], [1.5], [], [gotty], [http://gotty.io])
|
AC_INIT([tio], [1.6], [], [tio], [http://tio.github.io])
|
||||||
AC_CONFIG_HEADERS([src/include/config.h])
|
AC_CONFIG_HEADERS([src/include/config.h])
|
||||||
AM_INIT_AUTOMAKE([1.11 foreign dist-xz no-dist-gzip -Wall -Werror])
|
AM_INIT_AUTOMAKE([1.11 foreign dist-xz no-dist-gzip -Wall -Werror])
|
||||||
AM_SILENT_RULES([yes])
|
AM_SILENT_RULES([yes])
|
||||||
|
|
|
||||||
|
|
@ -1 +1 @@
|
||||||
dist_man_MANS = gotty.1
|
dist_man_MANS = tio.1
|
||||||
|
|
|
||||||
|
|
@ -1,20 +1,20 @@
|
||||||
.TH "gotty" "1" "30 September 2014"
|
.TH "tio" "1" "30 September 2014"
|
||||||
|
|
||||||
.SH "NAME"
|
.SH "NAME"
|
||||||
gotty \- The really simple TTY terminal application
|
tio \- The simple TTY terminal I/O application
|
||||||
|
|
||||||
.SH "SYNOPSIS"
|
.SH "SYNOPSIS"
|
||||||
.PP
|
.PP
|
||||||
.B gotty
|
.B tio
|
||||||
[<options>] <tty device>
|
[<options>] <tty device>
|
||||||
|
|
||||||
.SH "DESCRIPTION"
|
.SH "DESCRIPTION"
|
||||||
.PP
|
.PP
|
||||||
.B Go TTY
|
.B tio
|
||||||
or
|
or
|
||||||
.B gotty
|
.B tio
|
||||||
is a really simple TTY terminal application which features a simple commandline
|
is a simple TTY terminal application which features a straightforward
|
||||||
interface to easily connect to TTY devices for basic input/output.
|
commandline interface to easily connect to TTY devices for basic input/output.
|
||||||
|
|
||||||
.SH "OPTIONS"
|
.SH "OPTIONS"
|
||||||
|
|
||||||
|
|
@ -67,17 +67,17 @@ In session, press ctrl-g + q to quit.
|
||||||
.TP
|
.TP
|
||||||
The most common use is without options. For example:
|
The most common use is without options. For example:
|
||||||
|
|
||||||
gotty /dev/ttyUSB0
|
tio /dev/ttyUSB0
|
||||||
.TP
|
.TP
|
||||||
Which corresponds to:
|
Which corresponds to:
|
||||||
|
|
||||||
gotty -b 115200 -d 8 -f none -s 1 -p none /dev/ttyUSB0
|
tio -b 115200 -d 8 -f none -s 1 -p none /dev/ttyUSB0
|
||||||
.TP
|
.TP
|
||||||
It is recommended to connect serial tty devices by id. For example:
|
It is recommended to connect serial tty devices by id. For example:
|
||||||
|
|
||||||
gotty /dev/serial/by-id/usb-FTDI_TTL232R-3V3_FTGQVXBL-if00-port0
|
tio /dev/serial/by-id/usb-FTDI_TTL232R-3V3_FTGQVXBL-if00-port0
|
||||||
.PP
|
.PP
|
||||||
Using serial devices by id ensures that gotty automatically reconnects to the
|
Using serial devices by id ensures that tio automatically reconnects to the
|
||||||
correct serial device if the device is disconnected and then reconnected.
|
correct serial device if the device is disconnected and then reconnected.
|
||||||
|
|
||||||
.SH "AUTHOR"
|
.SH "AUTHOR"
|
||||||
|
|
@ -1,16 +1,16 @@
|
||||||
bin_PROGRAMS = gotty
|
bin_PROGRAMS = tio
|
||||||
gotty_SOURCES = tty.c \
|
tio_SOURCES = tty.c \
|
||||||
options.c \
|
options.c \
|
||||||
time.c \
|
time.c \
|
||||||
main.c \
|
main.c \
|
||||||
log.c \
|
log.c \
|
||||||
include/gotty/tty.h \
|
include/tio/tty.h \
|
||||||
include/gotty/options.h \
|
include/tio/options.h \
|
||||||
include/gotty/time.h \
|
include/tio/time.h \
|
||||||
include/gotty/print.h \
|
include/tio/print.h \
|
||||||
include/gotty/log.h
|
include/tio/log.h
|
||||||
|
|
||||||
if ENABLE_BASH_COMPLETION
|
if ENABLE_BASH_COMPLETION
|
||||||
bashcompletiondir=@BASH_COMPLETION_DIR@
|
bashcompletiondir=@BASH_COMPLETION_DIR@
|
||||||
dist_bashcompletion_DATA=bash-completion/gotty
|
dist_bashcompletion_DATA=bash-completion/tio
|
||||||
endif
|
endif
|
||||||
|
|
|
||||||
|
|
@ -1,8 +1,8 @@
|
||||||
#
|
#
|
||||||
# Bash completion script for gotty.
|
# Bash completion script for tio.
|
||||||
#
|
#
|
||||||
|
|
||||||
_gotty()
|
_tio()
|
||||||
{
|
{
|
||||||
local cur prev opts base
|
local cur prev opts base
|
||||||
COMPREPLY=()
|
COMPREPLY=()
|
||||||
|
|
@ -100,5 +100,5 @@ _gotty()
|
||||||
return 0
|
return 0
|
||||||
}
|
}
|
||||||
|
|
||||||
# Bind completion to gotty command
|
# Bind completion to tio command
|
||||||
complete -o default -F _gotty gotty
|
complete -o default -F _tio tio
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
/*
|
/*
|
||||||
* Go TTY - The Really Simple Terminal Application
|
* tio - the simple TTY terminal I/O application
|
||||||
*
|
*
|
||||||
* Copyright (c) 2014-2016 Martin Lund
|
* Copyright (c) 2014-2016 Martin Lund
|
||||||
*
|
*
|
||||||
|
|
@ -1,7 +1,7 @@
|
||||||
/*
|
/*
|
||||||
* Go TTY - The Really Simple Terminal Application
|
* tio - the simple TTY terminal I/O application
|
||||||
*
|
*
|
||||||
* Copyright (c) 2014 Martin Lund
|
* Copyright (c) 2014-2016 Martin Lund
|
||||||
*
|
*
|
||||||
* This program is free software; you can redistribute it and/or
|
* This program is free software; you can redistribute it and/or
|
||||||
* modify it under the terms of the GNU General Public License
|
* modify it under the terms of the GNU General Public License
|
||||||
|
|
@ -1,7 +1,7 @@
|
||||||
/*
|
/*
|
||||||
* Go TTY - The Really Simple Terminal Application
|
* tio - the simple TTY terminal I/O application
|
||||||
*
|
*
|
||||||
* Copyright (c) 2014 Martin Lund
|
* Copyright (c) 2014-2016 Martin Lund
|
||||||
*
|
*
|
||||||
* This program is free software; you can redistribute it and/or
|
* This program is free software; you can redistribute it and/or
|
||||||
* modify it under the terms of the GNU General Public License
|
* modify it under the terms of the GNU General Public License
|
||||||
|
|
@ -1,7 +1,7 @@
|
||||||
/*
|
/*
|
||||||
* Go TTY - The Really Simple Terminal Application
|
* tio - the simple TTY terminal I/O application
|
||||||
*
|
*
|
||||||
* Copyright (c) 2014 Martin Lund
|
* Copyright (c) 2014-2016 Martin Lund
|
||||||
*
|
*
|
||||||
* This program is free software; you can redistribute it and/or
|
* This program is free software; you can redistribute it and/or
|
||||||
* modify it under the terms of the GNU General Public License
|
* modify it under the terms of the GNU General Public License
|
||||||
|
|
@ -1,7 +1,7 @@
|
||||||
/*
|
/*
|
||||||
* Go TTY - The Really Simple Terminal Application
|
* tio - the simple TTY terminal I/O application
|
||||||
*
|
*
|
||||||
* Copyright (c) 2014 Martin Lund
|
* Copyright (c) 2014-2016 Martin Lund
|
||||||
*
|
*
|
||||||
* This program is free software; you can redistribute it and/or
|
* This program is free software; you can redistribute it and/or
|
||||||
* modify it under the terms of the GNU General Public License
|
* modify it under the terms of the GNU General Public License
|
||||||
|
|
@ -1,5 +1,5 @@
|
||||||
/*
|
/*
|
||||||
* Go TTY - The Really Simple Terminal Application
|
* tio - the simple TTY terminal I/O application
|
||||||
*
|
*
|
||||||
* Copyright (c) 2014-2016 Martin Lund
|
* Copyright (c) 2014-2016 Martin Lund
|
||||||
*
|
*
|
||||||
|
|
@ -23,8 +23,8 @@
|
||||||
#include <stdlib.h>
|
#include <stdlib.h>
|
||||||
#include <string.h>
|
#include <string.h>
|
||||||
#include <errno.h>
|
#include <errno.h>
|
||||||
#include "gotty/options.h"
|
#include "tio/options.h"
|
||||||
#include "gotty/print.h"
|
#include "tio/print.h"
|
||||||
|
|
||||||
static FILE *fp;
|
static FILE *fp;
|
||||||
static bool error = false;
|
static bool error = false;
|
||||||
|
|
|
||||||
10
src/main.c
10
src/main.c
|
|
@ -1,7 +1,7 @@
|
||||||
/*
|
/*
|
||||||
* Go TTY - The Really Simple Terminal Application
|
* tio - the simple TTY terminal I/O application
|
||||||
*
|
*
|
||||||
* Copyright (c) 2014 Martin Lund
|
* Copyright (c) 2014-2016 Martin Lund
|
||||||
*
|
*
|
||||||
* This program is free software; you can redistribute it and/or
|
* This program is free software; you can redistribute it and/or
|
||||||
* modify it under the terms of the GNU General Public License
|
* modify it under the terms of the GNU General Public License
|
||||||
|
|
@ -21,9 +21,9 @@
|
||||||
|
|
||||||
#include <stdio.h>
|
#include <stdio.h>
|
||||||
#include <stdlib.h>
|
#include <stdlib.h>
|
||||||
#include "gotty/options.h"
|
#include "tio/options.h"
|
||||||
#include "gotty/tty.h"
|
#include "tio/tty.h"
|
||||||
#include "gotty/log.h"
|
#include "tio/log.h"
|
||||||
|
|
||||||
int main(int argc, char *argv[])
|
int main(int argc, char *argv[])
|
||||||
{
|
{
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,7 @@
|
||||||
/*
|
/*
|
||||||
* Go TTY - The Really Simple Terminal Application
|
* tio - the simple TTY terminal I/O application
|
||||||
*
|
*
|
||||||
* Copyright (c) 2014 Martin Lund
|
* Copyright (c) 2014-2016 Martin Lund
|
||||||
*
|
*
|
||||||
* This program is free software; you can redistribute it and/or
|
* This program is free software; you can redistribute it and/or
|
||||||
* modify it under the terms of the GNU General Public License
|
* modify it under the terms of the GNU General Public License
|
||||||
|
|
@ -29,8 +29,8 @@
|
||||||
#include <termios.h>
|
#include <termios.h>
|
||||||
#include <limits.h>
|
#include <limits.h>
|
||||||
#include "config.h"
|
#include "config.h"
|
||||||
#include "gotty/options.h"
|
#include "tio/options.h"
|
||||||
#include "gotty/print.h"
|
#include "tio/print.h"
|
||||||
|
|
||||||
struct option_t option =
|
struct option_t option =
|
||||||
{
|
{
|
||||||
|
|
@ -318,7 +318,7 @@ void parse_options(int argc, char *argv[])
|
||||||
break;
|
break;
|
||||||
|
|
||||||
case 'v':
|
case 'v':
|
||||||
printf("Go TTY v%s\n", VERSION);
|
printf("tio v%s\n", VERSION);
|
||||||
printf("Copyright (c) 2014-2016 Martin Lund\n");
|
printf("Copyright (c) 2014-2016 Martin Lund\n");
|
||||||
printf("\n");
|
printf("\n");
|
||||||
printf("License GPLv2: GNU GPL version 2 or later <http://gnu.org/licenses/gpl-2.0.html>.\n");
|
printf("License GPLv2: GNU GPL version 2 or later <http://gnu.org/licenses/gpl-2.0.html>.\n");
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,7 @@
|
||||||
/*
|
/*
|
||||||
* Go TTY - The Really Simple Terminal Application
|
* tio - the simple TTY terminal I/O application
|
||||||
*
|
*
|
||||||
* Copyright (c) 2014 Martin Lund
|
* Copyright (c) 2014-2016 Martin Lund
|
||||||
*
|
*
|
||||||
* This program is free software; you can redistribute it and/or
|
* This program is free software; you can redistribute it and/or
|
||||||
* modify it under the terms of the GNU General Public License
|
* modify it under the terms of the GNU General Public License
|
||||||
|
|
|
||||||
18
src/tty.c
18
src/tty.c
|
|
@ -1,7 +1,7 @@
|
||||||
/*
|
/*
|
||||||
* Go TTY - The Really Simple Terminal Application
|
* tio - the simple TTY terminal I/O application
|
||||||
*
|
*
|
||||||
* Copyright (c) 2014 Martin Lund
|
* Copyright (c) 2014-2016 Martin Lund
|
||||||
*
|
*
|
||||||
* This program is free software; you can redistribute it and/or
|
* This program is free software; you can redistribute it and/or
|
||||||
* modify it under the terms of the GNU General Public License
|
* modify it under the terms of the GNU General Public License
|
||||||
|
|
@ -31,11 +31,11 @@
|
||||||
#include <termios.h>
|
#include <termios.h>
|
||||||
#include <stdbool.h>
|
#include <stdbool.h>
|
||||||
#include <errno.h>
|
#include <errno.h>
|
||||||
#include "gotty/tty.h"
|
#include "tio/tty.h"
|
||||||
#include "gotty/print.h"
|
#include "tio/print.h"
|
||||||
#include "gotty/options.h"
|
#include "tio/options.h"
|
||||||
#include "gotty/time.h"
|
#include "tio/time.h"
|
||||||
#include "gotty/log.h"
|
#include "tio/log.h"
|
||||||
|
|
||||||
static int connected = false;
|
static int connected = false;
|
||||||
struct termios new_stdout, old_stdout, old_tio;
|
struct termios new_stdout, old_stdout, old_tio;
|
||||||
|
|
@ -120,7 +120,7 @@ void disconnect_tty(void)
|
||||||
{
|
{
|
||||||
if (tainted)
|
if (tainted)
|
||||||
putchar('\n');
|
putchar('\n');
|
||||||
color_printf("[gotty %s] Disconnected", current_time());
|
color_printf("[tio %s] Disconnected", current_time());
|
||||||
close(fd);
|
close(fd);
|
||||||
connected = false;
|
connected = false;
|
||||||
}
|
}
|
||||||
|
|
@ -156,7 +156,7 @@ int connect_tty(void)
|
||||||
tcflush(fd, TCIOFLUSH);
|
tcflush(fd, TCIOFLUSH);
|
||||||
|
|
||||||
/* Print connect status */
|
/* Print connect status */
|
||||||
color_printf("[gotty %s] Connected", current_time());
|
color_printf("[tio %s] Connected", current_time());
|
||||||
connected = true;
|
connected = true;
|
||||||
tainted = false;
|
tainted = false;
|
||||||
bzero(&c_stdin[0], 3);
|
bzero(&c_stdin[0], 3);
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue