commit a14d14d75b3e2c6450de44261160660ef089b477 Author: Martin Lund Date: Sat Sep 27 11:35:17 2014 +0200 Initial import diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..549200d --- /dev/null +++ b/.gitignore @@ -0,0 +1,25 @@ +*.tar.xz +src/gotty +src/*.o +Makefile.in +Makefile +aclocal.m4 +autom4te.cache/ +configure +compile +depcomp +install-sh +missing +src/Makefile.in +src/Makefile +config.log +config.status +src/.deps/ +src/include/config.h +src/include/config.h.in +src/include/config.h.in~ +src/include/stamp-h1 +*.swp +man/*.1 +man/*.5 +gotty-* diff --git a/AUTHORS b/AUTHORS new file mode 100644 index 0000000..1f04f2d --- /dev/null +++ b/AUTHORS @@ -0,0 +1 @@ +Martin Lund diff --git a/COPYING b/COPYING new file mode 100644 index 0000000..d159169 --- /dev/null +++ b/COPYING @@ -0,0 +1,339 @@ + GNU GENERAL PUBLIC LICENSE + Version 2, June 1991 + + Copyright (C) 1989, 1991 Free Software Foundation, Inc., + 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + Preamble + + The licenses for most software are designed to take away your +freedom to share and change it. By contrast, the GNU General Public +License is intended to guarantee your freedom to share and change free +software--to make sure the software is free for all its users. This +General Public License applies to most of the Free Software +Foundation's software and to any other program whose authors commit to +using it. (Some other Free Software Foundation software is covered by +the GNU Lesser General Public License instead.) You can apply it to +your programs, too. + + When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge for +this service if you wish), that you receive source code or can get it +if you want it, that you can change the software or use pieces of it +in new free programs; and that you know you can do these things. + + To protect your rights, we need to make restrictions that forbid +anyone to deny you these rights or to ask you to surrender the rights. +These restrictions translate to certain responsibilities for you if you +distribute copies of the software, or if you modify it. + + For example, if you distribute copies of such a program, whether +gratis or for a fee, you must give the recipients all the rights that +you have. You must make sure that they, too, receive or can get the +source code. And you must show them these terms so they know their +rights. + + We protect your rights with two steps: (1) copyright the software, and +(2) offer you this license which gives you legal permission to copy, +distribute and/or modify the software. + + Also, for each author's protection and ours, we want to make certain +that everyone understands that there is no warranty for this free +software. If the software is modified by someone else and passed on, we +want its recipients to know that what they have is not the original, so +that any problems introduced by others will not reflect on the original +authors' reputations. + + Finally, any free program is threatened constantly by software +patents. We wish to avoid the danger that redistributors of a free +program will individually obtain patent licenses, in effect making the +program proprietary. To prevent this, we have made it clear that any +patent must be licensed for everyone's free use or not licensed at all. + + The precise terms and conditions for copying, distribution and +modification follow. + + GNU GENERAL PUBLIC LICENSE + TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION + + 0. This License applies to any program or other work which contains +a notice placed by the copyright holder saying it may be distributed +under the terms of this General Public License. The "Program", below, +refers to any such program or work, and a "work based on the Program" +means either the Program or any derivative work under copyright law: +that is to say, a work containing the Program or a portion of it, +either verbatim or with modifications and/or translated into another +language. (Hereinafter, translation is included without limitation in +the term "modification".) Each licensee is addressed as "you". + +Activities other than copying, distribution and modification are not +covered by this License; they are outside its scope. The act of +running the Program is not restricted, and the output from the Program +is covered only if its contents constitute a work based on the +Program (independent of having been made by running the Program). +Whether that is true depends on what the Program does. + + 1. You may copy and distribute verbatim copies of the Program's +source code as you receive it, in any medium, provided that you +conspicuously and appropriately publish on each copy an appropriate +copyright notice and disclaimer of warranty; keep intact all the +notices that refer to this License and to the absence of any warranty; +and give any other recipients of the Program a copy of this License +along with the Program. + +You may charge a fee for the physical act of transferring a copy, and +you may at your option offer warranty protection in exchange for a fee. + + 2. You may modify your copy or copies of the Program or any portion +of it, thus forming a work based on the Program, and copy and +distribute such modifications or work under the terms of Section 1 +above, provided that you also meet all of these conditions: + + a) You must cause the modified files to carry prominent notices + stating that you changed the files and the date of any change. + + b) You must cause any work that you distribute or publish, that in + whole or in part contains or is derived from the Program or any + part thereof, to be licensed as a whole at no charge to all third + parties under the terms of this License. + + c) If the modified program normally reads commands interactively + when run, you must cause it, when started running for such + interactive use in the most ordinary way, to print or display an + announcement including an appropriate copyright notice and a + notice that there is no warranty (or else, saying that you provide + a warranty) and that users may redistribute the program under + these conditions, and telling the user how to view a copy of this + License. (Exception: if the Program itself is interactive but + does not normally print such an announcement, your work based on + the Program is not required to print an announcement.) + +These requirements apply to the modified work as a whole. If +identifiable sections of that work are not derived from the Program, +and can be reasonably considered independent and separate works in +themselves, then this License, and its terms, do not apply to those +sections when you distribute them as separate works. But when you +distribute the same sections as part of a whole which is a work based +on the Program, the distribution of the whole must be on the terms of +this License, whose permissions for other licensees extend to the +entire whole, and thus to each and every part regardless of who wrote it. + +Thus, it is not the intent of this section to claim rights or contest +your rights to work written entirely by you; rather, the intent is to +exercise the right to control the distribution of derivative or +collective works based on the Program. + +In addition, mere aggregation of another work not based on the Program +with the Program (or with a work based on the Program) on a volume of +a storage or distribution medium does not bring the other work under +the scope of this License. + + 3. You may copy and distribute the Program (or a work based on it, +under Section 2) in object code or executable form under the terms of +Sections 1 and 2 above provided that you also do one of the following: + + a) Accompany it with the complete corresponding machine-readable + source code, which must be distributed under the terms of Sections + 1 and 2 above on a medium customarily used for software interchange; or, + + b) Accompany it with a written offer, valid for at least three + years, to give any third party, for a charge no more than your + cost of physically performing source distribution, a complete + machine-readable copy of the corresponding source code, to be + distributed under the terms of Sections 1 and 2 above on a medium + customarily used for software interchange; or, + + c) Accompany it with the information you received as to the offer + to distribute corresponding source code. (This alternative is + allowed only for noncommercial distribution and only if you + received the program in object code or executable form with such + an offer, in accord with Subsection b above.) + +The source code for a work means the preferred form of the work for +making modifications to it. For an executable work, complete source +code means all the source code for all modules it contains, plus any +associated interface definition files, plus the scripts used to +control compilation and installation of the executable. However, as a +special exception, the source code distributed need not include +anything that is normally distributed (in either source or binary +form) with the major components (compiler, kernel, and so on) of the +operating system on which the executable runs, unless that component +itself accompanies the executable. + +If distribution of executable or object code is made by offering +access to copy from a designated place, then offering equivalent +access to copy the source code from the same place counts as +distribution of the source code, even though third parties are not +compelled to copy the source along with the object code. + + 4. You may not copy, modify, sublicense, or distribute the Program +except as expressly provided under this License. Any attempt +otherwise to copy, modify, sublicense or distribute the Program is +void, and will automatically terminate your rights under this License. +However, parties who have received copies, or rights, from you under +this License will not have their licenses terminated so long as such +parties remain in full compliance. + + 5. You are not required to accept this License, since you have not +signed it. However, nothing else grants you permission to modify or +distribute the Program or its derivative works. These actions are +prohibited by law if you do not accept this License. Therefore, by +modifying or distributing the Program (or any work based on the +Program), you indicate your acceptance of this License to do so, and +all its terms and conditions for copying, distributing or modifying +the Program or works based on it. + + 6. Each time you redistribute the Program (or any work based on the +Program), the recipient automatically receives a license from the +original licensor to copy, distribute or modify the Program subject to +these terms and conditions. You may not impose any further +restrictions on the recipients' exercise of the rights granted herein. +You are not responsible for enforcing compliance by third parties to +this License. + + 7. If, as a consequence of a court judgment or allegation of patent +infringement or for any other reason (not limited to patent issues), +conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot +distribute so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you +may not distribute the Program at all. For example, if a patent +license would not permit royalty-free redistribution of the Program by +all those who receive copies directly or indirectly through you, then +the only way you could satisfy both it and this License would be to +refrain entirely from distribution of the Program. + +If any portion of this section is held invalid or unenforceable under +any particular circumstance, the balance of the section is intended to +apply and the section as a whole is intended to apply in other +circumstances. + +It is not the purpose of this section to induce you to infringe any +patents or other property right claims or to contest validity of any +such claims; this section has the sole purpose of protecting the +integrity of the free software distribution system, which is +implemented by public license practices. Many people have made +generous contributions to the wide range of software distributed +through that system in reliance on consistent application of that +system; it is up to the author/donor to decide if he or she is willing +to distribute software through any other system and a licensee cannot +impose that choice. + +This section is intended to make thoroughly clear what is believed to +be a consequence of the rest of this License. + + 8. If the distribution and/or use of the Program is restricted in +certain countries either by patents or by copyrighted interfaces, the +original copyright holder who places the Program under this License +may add an explicit geographical distribution limitation excluding +those countries, so that distribution is permitted only in or among +countries not thus excluded. In such case, this License incorporates +the limitation as if written in the body of this License. + + 9. The Free Software Foundation may publish revised and/or new versions +of the General Public License from time to time. Such new versions will +be similar in spirit to the present version, but may differ in detail to +address new problems or concerns. + +Each version is given a distinguishing version number. If the Program +specifies a version number of this License which applies to it and "any +later version", you have the option of following the terms and conditions +either of that version or of any later version published by the Free +Software Foundation. If the Program does not specify a version number of +this License, you may choose any version ever published by the Free Software +Foundation. + + 10. If you wish to incorporate parts of the Program into other free +programs whose distribution conditions are different, write to the author +to ask for permission. For software which is copyrighted by the Free +Software Foundation, write to the Free Software Foundation; we sometimes +make exceptions for this. Our decision will be guided by the two goals +of preserving the free status of all derivatives of our free software and +of promoting the sharing and reuse of software generally. + + NO WARRANTY + + 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY +FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN +OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES +PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED +OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF +MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS +TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE +PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, +REPAIR OR CORRECTION. + + 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR +REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, +INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING +OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED +TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY +YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER +PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE +POSSIBILITY OF SUCH DAMAGES. + + END OF TERMS AND CONDITIONS + + How to Apply These Terms to Your New Programs + + If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these terms. + + To do so, attach the following notices to the program. It is safest +to attach them to the start of each source file to most effectively +convey the exclusion of warranty; and each file should have at least +the "copyright" line and a pointer to where the full notice is found. + + + Copyright (C) + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License along + with this program; if not, write to the Free Software Foundation, Inc., + 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. + +Also add information on how to contact you by electronic and paper mail. + +If the program is interactive, make it output a short notice like this +when it starts in an interactive mode: + + Gnomovision version 69, Copyright (C) year name of author + Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. + This is free software, and you are welcome to redistribute it + under certain conditions; type `show c' for details. + +The hypothetical commands `show w' and `show c' should show the appropriate +parts of the General Public License. Of course, the commands you use may +be called something other than `show w' and `show c'; they could even be +mouse-clicks or menu items--whatever suits your program. + +You should also get your employer (if you work as a programmer) or your +school, if any, to sign a "copyright disclaimer" for the program, if +necessary. Here is a sample; alter the names: + + Yoyodyne, Inc., hereby disclaims all copyright interest in the program + `Gnomovision' (which makes passes at compilers) written by James Hacker. + + , 1 April 1989 + Ty Coon, President of Vice + +This General Public License does not permit incorporating your program into +proprietary programs. If your program is a subroutine library, you may +consider it more useful to permit linking proprietary applications with the +library. If this is what you want to do, use the GNU Lesser General +Public License instead of this License. diff --git a/ChangeLog b/ChangeLog new file mode 100644 index 0000000..e69de29 diff --git a/INSTALL b/INSTALL new file mode 100644 index 0000000..2099840 --- /dev/null +++ b/INSTALL @@ -0,0 +1,370 @@ +Installation Instructions +************************* + +Copyright (C) 1994-1996, 1999-2002, 2004-2013 Free Software Foundation, +Inc. + + Copying and distribution of this file, with or without modification, +are permitted in any medium without royalty provided the copyright +notice and this notice are preserved. This file is offered as-is, +without warranty of any kind. + +Basic Installation +================== + + Briefly, the shell command `./configure && make && make install' +should configure, build, and install this package. The following +more-detailed instructions are generic; see the `README' file for +instructions specific to this package. Some packages provide this +`INSTALL' file but do not implement all of the features documented +below. The lack of an optional feature in a given package is not +necessarily a bug. More recommendations for GNU packages can be found +in *note Makefile Conventions: (standards)Makefile Conventions. + + The `configure' shell script attempts to guess correct values for +various system-dependent variables used during compilation. It uses +those values to create a `Makefile' in each directory of the package. +It may also create one or more `.h' files containing system-dependent +definitions. Finally, it creates a shell script `config.status' that +you can run in the future to recreate the current configuration, and a +file `config.log' containing compiler output (useful mainly for +debugging `configure'). + + It can also use an optional file (typically called `config.cache' +and enabled with `--cache-file=config.cache' or simply `-C') that saves +the results of its tests to speed up reconfiguring. Caching is +disabled by default to prevent problems with accidental use of stale +cache files. + + If you need to do unusual things to compile the package, please try +to figure out how `configure' could check whether to do them, and mail +diffs or instructions to the address given in the `README' so they can +be considered for the next release. If you are using the cache, and at +some point `config.cache' contains results you don't want to keep, you +may remove or edit it. + + The file `configure.ac' (or `configure.in') is used to create +`configure' by a program called `autoconf'. You need `configure.ac' if +you want to change it or regenerate `configure' using a newer version +of `autoconf'. + + The simplest way to compile this package is: + + 1. `cd' to the directory containing the package's source code and type + `./configure' to configure the package for your system. + + Running `configure' might take a while. While running, it prints + some messages telling which features it is checking for. + + 2. Type `make' to compile the package. + + 3. Optionally, type `make check' to run any self-tests that come with + the package, generally using the just-built uninstalled binaries. + + 4. Type `make install' to install the programs and any data files and + documentation. When installing into a prefix owned by root, it is + recommended that the package be configured and built as a regular + user, and only the `make install' phase executed with root + privileges. + + 5. Optionally, type `make installcheck' to repeat any self-tests, but + this time using the binaries in their final installed location. + This target does not install anything. Running this target as a + regular user, particularly if the prior `make install' required + root privileges, verifies that the installation completed + correctly. + + 6. You can remove the program binaries and object files from the + source code directory by typing `make clean'. To also remove the + files that `configure' created (so you can compile the package for + a different kind of computer), type `make distclean'. There is + also a `make maintainer-clean' target, but that is intended mainly + for the package's developers. If you use it, you may have to get + all sorts of other programs in order to regenerate files that came + with the distribution. + + 7. Often, you can also type `make uninstall' to remove the installed + files again. In practice, not all packages have tested that + uninstallation works correctly, even though it is required by the + GNU Coding Standards. + + 8. Some packages, particularly those that use Automake, provide `make + distcheck', which can by used by developers to test that all other + targets like `make install' and `make uninstall' work correctly. + This target is generally not run by end users. + +Compilers and Options +===================== + + Some systems require unusual options for compilation or linking that +the `configure' script does not know about. Run `./configure --help' +for details on some of the pertinent environment variables. + + You can give `configure' initial values for configuration parameters +by setting variables in the command line or in the environment. Here +is an example: + + ./configure CC=c99 CFLAGS=-g LIBS=-lposix + + *Note Defining Variables::, for more details. + +Compiling For Multiple Architectures +==================================== + + You can compile the package for more than one kind of computer at the +same time, by placing the object files for each architecture in their +own directory. To do this, you can use GNU `make'. `cd' to the +directory where you want the object files and executables to go and run +the `configure' script. `configure' automatically checks for the +source code in the directory that `configure' is in and in `..'. This +is known as a "VPATH" build. + + With a non-GNU `make', it is safer to compile the package for one +architecture at a time in the source code directory. After you have +installed the package for one architecture, use `make distclean' before +reconfiguring for another architecture. + + On MacOS X 10.5 and later systems, you can create libraries and +executables that work on multiple system types--known as "fat" or +"universal" binaries--by specifying multiple `-arch' options to the +compiler but only a single `-arch' option to the preprocessor. Like +this: + + ./configure CC="gcc -arch i386 -arch x86_64 -arch ppc -arch ppc64" \ + CXX="g++ -arch i386 -arch x86_64 -arch ppc -arch ppc64" \ + CPP="gcc -E" CXXCPP="g++ -E" + + This is not guaranteed to produce working output in all cases, you +may have to build one architecture at a time and combine the results +using the `lipo' tool if you have problems. + +Installation Names +================== + + By default, `make install' installs the package's commands under +`/usr/local/bin', include files under `/usr/local/include', etc. You +can specify an installation prefix other than `/usr/local' by giving +`configure' the option `--prefix=PREFIX', where PREFIX must be an +absolute file name. + + You can specify separate installation prefixes for +architecture-specific files and architecture-independent files. If you +pass the option `--exec-prefix=PREFIX' to `configure', the package uses +PREFIX as the prefix for installing programs and libraries. +Documentation and other data files still use the regular prefix. + + In addition, if you use an unusual directory layout you can give +options like `--bindir=DIR' to specify different values for particular +kinds of files. Run `configure --help' for a list of the directories +you can set and what kinds of files go in them. In general, the +default for these options is expressed in terms of `${prefix}', so that +specifying just `--prefix' will affect all of the other directory +specifications that were not explicitly provided. + + The most portable way to affect installation locations is to pass the +correct locations to `configure'; however, many packages provide one or +both of the following shortcuts of passing variable assignments to the +`make install' command line to change installation locations without +having to reconfigure or recompile. + + The first method involves providing an override variable for each +affected directory. For example, `make install +prefix=/alternate/directory' will choose an alternate location for all +directory configuration variables that were expressed in terms of +`${prefix}'. Any directories that were specified during `configure', +but not in terms of `${prefix}', must each be overridden at install +time for the entire installation to be relocated. The approach of +makefile variable overrides for each directory variable is required by +the GNU Coding Standards, and ideally causes no recompilation. +However, some platforms have known limitations with the semantics of +shared libraries that end up requiring recompilation when using this +method, particularly noticeable in packages that use GNU Libtool. + + The second method involves providing the `DESTDIR' variable. For +example, `make install DESTDIR=/alternate/directory' will prepend +`/alternate/directory' before all installation names. The approach of +`DESTDIR' overrides is not required by the GNU Coding Standards, and +does not work on platforms that have drive letters. On the other hand, +it does better at avoiding recompilation issues, and works well even +when some directory options were not specified in terms of `${prefix}' +at `configure' time. + +Optional Features +================= + + If the package supports it, you can cause programs to be installed +with an extra prefix or suffix on their names by giving `configure' the +option `--program-prefix=PREFIX' or `--program-suffix=SUFFIX'. + + Some packages pay attention to `--enable-FEATURE' options to +`configure', where FEATURE indicates an optional part of the package. +They may also pay attention to `--with-PACKAGE' options, where PACKAGE +is something like `gnu-as' or `x' (for the X Window System). The +`README' should mention any `--enable-' and `--with-' options that the +package recognizes. + + For packages that use the X Window System, `configure' can usually +find the X include and library files automatically, but if it doesn't, +you can use the `configure' options `--x-includes=DIR' and +`--x-libraries=DIR' to specify their locations. + + Some packages offer the ability to configure how verbose the +execution of `make' will be. For these packages, running `./configure +--enable-silent-rules' sets the default to minimal output, which can be +overridden with `make V=1'; while running `./configure +--disable-silent-rules' sets the default to verbose, which can be +overridden with `make V=0'. + +Particular systems +================== + + On HP-UX, the default C compiler is not ANSI C compatible. If GNU +CC is not installed, it is recommended to use the following options in +order to use an ANSI C compiler: + + ./configure CC="cc -Ae -D_XOPEN_SOURCE=500" + +and if that doesn't work, install pre-built binaries of GCC for HP-UX. + + HP-UX `make' updates targets which have the same time stamps as +their prerequisites, which makes it generally unusable when shipped +generated files such as `configure' are involved. Use GNU `make' +instead. + + On OSF/1 a.k.a. Tru64, some versions of the default C compiler cannot +parse its `' header file. The option `-nodtk' can be used as +a workaround. If GNU CC is not installed, it is therefore recommended +to try + + ./configure CC="cc" + +and if that doesn't work, try + + ./configure CC="cc -nodtk" + + On Solaris, don't put `/usr/ucb' early in your `PATH'. This +directory contains several dysfunctional programs; working variants of +these programs are available in `/usr/bin'. So, if you need `/usr/ucb' +in your `PATH', put it _after_ `/usr/bin'. + + On Haiku, software installed for all users goes in `/boot/common', +not `/usr/local'. It is recommended to use the following options: + + ./configure --prefix=/boot/common + +Specifying the System Type +========================== + + There may be some features `configure' cannot figure out +automatically, but needs to determine by the type of machine the package +will run on. Usually, assuming the package is built to be run on the +_same_ architectures, `configure' can figure that out, but if it prints +a message saying it cannot guess the machine type, give it the +`--build=TYPE' option. TYPE can either be a short name for the system +type, such as `sun4', or a canonical name which has the form: + + CPU-COMPANY-SYSTEM + +where SYSTEM can have one of these forms: + + OS + KERNEL-OS + + See the file `config.sub' for the possible values of each field. If +`config.sub' isn't included in this package, then this package doesn't +need to know the machine type. + + If you are _building_ compiler tools for cross-compiling, you should +use the option `--target=TYPE' to select the type of system they will +produce code for. + + If you want to _use_ a cross compiler, that generates code for a +platform different from the build platform, you should specify the +"host" platform (i.e., that on which the generated programs will +eventually be run) with `--host=TYPE'. + +Sharing Defaults +================ + + If you want to set default values for `configure' scripts to share, +you can create a site shell script called `config.site' that gives +default values for variables like `CC', `cache_file', and `prefix'. +`configure' looks for `PREFIX/share/config.site' if it exists, then +`PREFIX/etc/config.site' if it exists. Or, you can set the +`CONFIG_SITE' environment variable to the location of the site script. +A warning: not all `configure' scripts look for a site script. + +Defining Variables +================== + + Variables not defined in a site shell script can be set in the +environment passed to `configure'. However, some packages may run +configure again during the build, and the customized values of these +variables may be lost. In order to avoid this problem, you should set +them in the `configure' command line, using `VAR=value'. For example: + + ./configure CC=/usr/local2/bin/gcc + +causes the specified `gcc' to be used as the C compiler (unless it is +overridden in the site shell script). + +Unfortunately, this technique does not work for `CONFIG_SHELL' due to +an Autoconf limitation. Until the limitation is lifted, you can use +this workaround: + + CONFIG_SHELL=/bin/bash ./configure CONFIG_SHELL=/bin/bash + +`configure' Invocation +====================== + + `configure' recognizes the following options to control how it +operates. + +`--help' +`-h' + Print a summary of all of the options to `configure', and exit. + +`--help=short' +`--help=recursive' + Print a summary of the options unique to this package's + `configure', and exit. The `short' variant lists options used + only in the top level, while the `recursive' variant lists options + also present in any nested packages. + +`--version' +`-V' + Print the version of Autoconf used to generate the `configure' + script, and exit. + +`--cache-file=FILE' + Enable the cache: use and save the results of the tests in FILE, + traditionally `config.cache'. FILE defaults to `/dev/null' to + disable caching. + +`--config-cache' +`-C' + Alias for `--cache-file=config.cache'. + +`--quiet' +`--silent' +`-q' + Do not print messages saying which checks are being made. To + suppress all normal output, redirect it to `/dev/null' (any error + messages will still be shown). + +`--srcdir=DIR' + Look for the package's source code in directory DIR. Usually + `configure' can determine that directory automatically. + +`--prefix=DIR' + Use DIR as the installation prefix. *note Installation Names:: + for more details, including other options available for fine-tuning + the installation locations. + +`--no-create' +`-n' + Run the configure checks, but stop before creating any output + files. + +`configure' also accepts some other, not widely useful, options. Run +`configure --help' for more details. diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..67733be --- /dev/null +++ b/LICENSE @@ -0,0 +1,14 @@ +Copyright (c) 2014 Martin Lund + +Go TTY is free software: you can redistribute it and/or modify it under the +terms of the GNU General Public License as published by the Free Software +Foundation, version 2 of the License. + +Go TTY is distributed in the hope that it will be useful, but WITHOUT ANY +WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS +FOR A PARTICULAR PURPOSE. See the GNU General Public License for more +details. + +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 +. diff --git a/Makefile.am b/Makefile.am new file mode 100644 index 0000000..af437a6 --- /dev/null +++ b/Makefile.am @@ -0,0 +1 @@ +SUBDIRS = src diff --git a/README b/README new file mode 100644 index 0000000..69cc843 --- /dev/null +++ b/README @@ -0,0 +1,82 @@ +=== Go TTY - The Really Simple TTY Terminal Application === + + +1. Introduction + + Go TTY or "gotty" is a really simple TTY terminal application which + features a very simple commandline interface to easily connect to TTY + devices for basic input/output. + + If you are looking for an advanced terminal application which supports + modem configuration and various protocols to support filetransfers etc. + please look elsewhere. + + However, if all you need is to get going and establish that simple terminal + connection to your TTY device then Go TTY might be your perfect choice. + + Go TTY was created by the author because he needed a no-nonsense simple TTY + terminal application to go do quick debugging. + + Let's Go TTY! + + +2. Interface + + The commandline interface is really simple and pretty much self explanatory + (output from 'gotty --help'): + + + Usage: gotty [] + + Options: + -b, --baudrate Baud rate (default: 115200) + -d, --databits 5|6|7|8 Data bits (default: 8) + -f, --flow hard|soft|none Flow control (default: none) + -s, --stopbits 1|2 Stop bits (default: 1) + -p, --parity even|odd|none Parity (default: none) + -n, --no-autoconnect Disable automatic connect + -v, --version Display version + -h, --help Display help + + In session, press ctrl-g + ctrl-q to quit. + + + The only option which requires a bit of elaboration is the --no-autoconnect + option. + + By default the gotty application automatically connects to the provided + device if present. If the device is not present it will simply wait for it + to appear and then connect. If the connection is lost (eg. device + disconnects) it will simply wait for the device to reappear and then + reconnect. + + However, if the --no-autoconnect option is provided the gotty application + will simply exit if the device is not present and it will also exit if an + an established connection is lost (ie. no reconnect). + + +3. Installation + + Please see INSTALL file for details on how to install Go TTY. + + +4. Contributing + + Go TTY is open source. If you want to help out with the project please join + in. Any contributions (code, doc, ideas, etc.) are welcome. + + The source is available on github: + + https://github.com/lundmar/gotty + + Here you can also find an issue tracker. + + +5. License + + Build Gear is GPLv2. See COPYING file for license details. + + +6. Authors + + See AUTHORS file for list of authors. diff --git a/autogen.sh b/autogen.sh new file mode 100755 index 0000000..9b56201 --- /dev/null +++ b/autogen.sh @@ -0,0 +1 @@ +autoreconf --force -v --install diff --git a/configure.ac b/configure.ac new file mode 100644 index 0000000..fad3e96 --- /dev/null +++ b/configure.ac @@ -0,0 +1,11 @@ +AC_PREREQ([2.68]) +AC_INIT([Go TTY], [0.1], [], [gotty], [http://github.com/lundmar/gotty]) +AC_CONFIG_HEADERS([src/include/config.h]) +AM_INIT_AUTOMAKE([1.11 foreign dist-xz no-dist-gzip -Wall -Werror]) +AM_SILENT_RULES([yes]) +AC_PROG_CC +AC_LANG([C]) +AC_PROG_INSTALL +AC_CONFIG_FILES([Makefile]) +AC_CONFIG_FILES([src/Makefile]) +AC_OUTPUT diff --git a/src/Makefile.am b/src/Makefile.am new file mode 100644 index 0000000..c9b173f --- /dev/null +++ b/src/Makefile.am @@ -0,0 +1,2 @@ +bin_PROGRAMS = gotty +gotty_SOURCES = tty.c options.c device.c main.c diff --git a/src/device.c b/src/device.c new file mode 100644 index 0000000..f94ada2 --- /dev/null +++ b/src/device.c @@ -0,0 +1,38 @@ +/* + * Go TTY - The Really Simple Terminal Application + * + * Copyright (c) 2014 Martin Lund + * + * This program is free software; you can redistribute it and/or + * modify it under the terms of the GNU General Public License + * as published by the Free Software Foundation; either version 2 + * of the License, or (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program; if not, write to the Free Software + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA + * 02110-1301, USA. + */ + +#include +#include +#include +#include "gotty/options.h" + +void wait_for_device(void) +{ + struct stat status; + + /* Loop until device pops up */ + while (true) + { + sleep(1); + if (stat(option.device, &status) == 0) + return; + } +} diff --git a/src/include/gotty/device.h b/src/include/gotty/device.h new file mode 100644 index 0000000..91e8bd5 --- /dev/null +++ b/src/include/gotty/device.h @@ -0,0 +1,27 @@ +/* + * Go TTY - The Really Simple Terminal Application + * + * Copyright (c) 2014 Martin Lund + * + * This program is free software; you can redistribute it and/or + * modify it under the terms of the GNU General Public License + * as published by the Free Software Foundation; either version 2 + * of the License, or (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program; if not, write to the Free Software + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA + * 02110-1301, USA. + */ + +#ifndef DEVICE_H +#define DEVICE_H + +void wait_for_device(void); + +#endif diff --git a/src/include/gotty/options.h b/src/include/gotty/options.h new file mode 100644 index 0000000..56c2593 --- /dev/null +++ b/src/include/gotty/options.h @@ -0,0 +1,41 @@ +/* + * Go TTY - The Really Simple Terminal Application + * + * Copyright (c) 2014 Martin Lund + * + * This program is free software; you can redistribute it and/or + * modify it under the terms of the GNU General Public License + * as published by the Free Software Foundation; either version 2 + * of the License, or (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program; if not, write to the Free Software + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA + * 02110-1301, USA. + */ + +#ifndef OPTIONS_H +#define OPTIONS_H + +#include +#include +#include + +/* Options */ +struct option_t +{ + char device[256]; + bool no_autoconnect; + struct termios tio; +}; + +extern struct option_t option; + +void parse_options(int argc, char *argv[]); + +#endif diff --git a/src/include/gotty/print.h b/src/include/gotty/print.h new file mode 100644 index 0000000..4cb7129 --- /dev/null +++ b/src/include/gotty/print.h @@ -0,0 +1,49 @@ +/* + * Go TTY - The Really Simple Terminal Application + * + * Copyright (c) 2014 Martin Lund + * + * This program is free software; you can redistribute it and/or + * modify it under the terms of the GNU General Public License + * as published by the Free Software Foundation; either version 2 + * of the License, or (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program; if not, write to the Free Software + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA + * 02110-1301, USA. + */ + +#ifndef PRINT_H +#define PRINT_H + +#define ANSI_COLOR_GRAY "\x1b[1;30m" +#define ANSI_COLOR_RED "\x1b[1;31m" +#define ANSI_COLOR_GREEN "\x1b[1;32m" +#define ANSI_COLOR_YELLOW "\x1b[1;33m" +#define ANSI_COLOR_BLUE "\x1b[1;34m" +#define ANSI_COLOR_PINK "\x1b[1;35m" +#define ANSI_COLOR_CYAN "\x1b[1;36m" +#define ANSI_COLOR_WHITE "\x1b[1;37m" +#define ANSI_COLOR_RESET "\x1b[0m" + +#define gotty_printf(format, args...) \ + fprintf (stdout, "\n\033[300D" ANSI_COLOR_YELLOW "[gotty] " format ANSI_COLOR_RESET "\033[300D\n", ## args); \ + fflush(stdout); + +#ifdef DEBUG +#define debug_printf(format, args...) \ + fprintf (stdout, "[debug] " format, ## args) +#define debug_printf_raw(format, args...) \ + fprintf (stdout, "" format, ## args) +#else +#define debug_printf(format, args...) +#define debug_printf_raw(format, args...) +#endif + +#endif diff --git a/src/include/gotty/tty.h b/src/include/gotty/tty.h new file mode 100644 index 0000000..8aef162 --- /dev/null +++ b/src/include/gotty/tty.h @@ -0,0 +1,28 @@ +/* + * Go TTY - The Really Simple Terminal Application + * + * Copyright (c) 2014 Martin Lund + * + * This program is free software; you can redistribute it and/or + * modify it under the terms of the GNU General Public License + * as published by the Free Software Foundation; either version 2 + * of the License, or (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program; if not, write to the Free Software + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA + * 02110-1301, USA. + */ + +#ifndef TTY_H +#define TTY_H + +void configure_stdout(void); +int connect_tty(void); + +#endif diff --git a/src/main.c b/src/main.c new file mode 100644 index 0000000..ba1886c --- /dev/null +++ b/src/main.c @@ -0,0 +1,50 @@ +/* + * Go TTY - The Really Simple Terminal Application + * + * Copyright (c) 2014 Martin Lund + * + * This program is free software; you can redistribute it and/or + * modify it under the terms of the GNU General Public License + * as published by the Free Software Foundation; either version 2 + * of the License, or (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program; if not, write to the Free Software + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA + * 02110-1301, USA. + */ + +#include +#include "gotty/options.h" +#include "gotty/tty.h" +#include "gotty/device.h" + +int main(int argc, char *argv[]) +{ + int status; + + /* Parse options */ + parse_options(argc, argv); + + /* Configure output terminal */ + configure_stdout(); + + /* Connect to tty device */ + if (option.no_autoconnect) + status = connect_tty(); + else + { + while (true) + { + wait_for_device(); + status = connect_tty(); + } + } + + return status; +} diff --git a/src/options.c b/src/options.c new file mode 100644 index 0000000..f8321f7 --- /dev/null +++ b/src/options.c @@ -0,0 +1,344 @@ +/* + * Go TTY - The Really Simple Terminal Application + * + * Copyright (c) 2014 Martin Lund + * + * This program is free software; you can redistribute it and/or + * modify it under the terms of the GNU General Public License + * as published by the Free Software Foundation; either version 2 + * of the License, or (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program; if not, write to the Free Software + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA + * 02110-1301, USA. + */ + +#include +#include +#include +#include +#include +#include +#include +#include +#include "config.h" +#include "gotty/options.h" +#include "gotty/print.h" + +struct option_t option = +{ + "", /* Device name */ + false, /* No autoconnect */ +}; + +void print_options_help(char *argv[]) +{ + printf("Usage: %s [] \n", argv[0]); + printf("\n"); + printf("Options:\n"); + printf(" -b, --baudrate Baud rate (default: 115200)\n"); + printf(" -d, --databits 5|6|7|8 Data bits (default: 8)\n"); + printf(" -f, --flow hard|soft|none Flow control (default: none)\n"); + printf(" -s, --stopbits 1|2 Stop bits (default: 1)\n"); + printf(" -p, --parity even|odd|none Parity (default: none)\n"); + printf(" -n, --no-autoconnect Disable automatic connect\n"); + printf(" -v, --version Display version\n"); + printf(" -h, --help Display help\n"); + printf("\n"); + printf("In session, press ctrl-g + ctrl-q to quit.\n"); + printf("\n"); +} + +void parse_options(int argc, char *argv[]) +{ + int c; + int baudrate; + int databits; + int stopbits; + + if (argc == 1) + { + print_options_help(argv); + exit(0); + } + + /* Set default termios settings: + * (115200 baud, 8 data bits, no flow control, 1 stop bit, no parity) */ + bzero(&option.tio, sizeof(option.tio)); + option.tio.c_cflag = B115200 | CS8; + + while (1) + { + static struct option long_options[] = + { + {"baudrate", required_argument, 0, 'b'}, + {"databits", required_argument, 0, 'd'}, + {"flow", required_argument, 0, 'f'}, + {"stopbits", required_argument, 0, 's'}, + {"parity", required_argument, 0, 'p'}, + {"no-autoconnect", no_argument, 0, 'n'}, + {"version", no_argument, 0, 'v'}, + {"help", no_argument, 0, 'h'}, + {0, 0, 0, 0 } + }; + + /* getopt_long stores the option index here */ + int option_index = 0; + + /* Parse argument using getopt_long */ + c = getopt_long(argc, argv, "b:d:f:s:p:nvh", long_options, &option_index); + + /* Detect the end of the options */ + if (c == -1) + break; + + switch (c) + { + case 0: + /* If this option sets a flag, do nothing else now */ + if (long_options[option_index].flag != 0) + break; + printf("option %s", long_options[option_index].name); + if (optarg) + printf(" with arg %s", optarg); + printf("\n"); + break; + + case 'b': + baudrate = atoi(optarg); + switch (baudrate) + { + case 0: + baudrate = B0; + break; + case 50: + baudrate = B50; + break; + case 75: + baudrate = B75; + break; + case 110: + baudrate = B110; + break; + case 134: + baudrate = B134; + break; + case 150: + baudrate = B150; + break; + case 300: + baudrate = B300; + break; + case 600: + baudrate = B600; + break; + case 1200: + baudrate = B1200; + break; + case 2400: + baudrate = B2400; + break; + case 4800: + baudrate = B4800; + break; + case 9600: + baudrate = B9600; + break; + case 19200: + baudrate = B19200; + break; + case 38400: + baudrate = B38400; + break; + case 57600: + baudrate = B57600; + break; + case 115200: + baudrate = B115200; + break; + case 230400: + baudrate = B230400; + break; + case 460800: + baudrate = B460800; + break; + case 500000: + baudrate = B500000; + break; + case 576000: + baudrate = B576000; + break; + case 921600: + baudrate = B921600; + break; + case 1000000: + baudrate = B1000000; + break; + case 1152000: + baudrate = B1152000; + break; + case 1500000: + baudrate = B1500000; + break; + case 2000000: + baudrate = B2000000; + break; + case 2500000: + baudrate = B2500000; + break; + case 3000000: + baudrate = B3000000; + break; + case 3500000: + baudrate = B3500000; + break; + case 4000000: + baudrate = B4000000; + break; + default: + printf("Error: Invalid baud rate.\n"); + exit(EXIT_FAILURE); + } + + cfsetispeed(&option.tio, baudrate); + cfsetospeed(&option.tio, baudrate); + + break; + + case 'd': + databits = atoi(optarg); + option.tio.c_cflag &= ~CSIZE; + switch (databits) + { + case 5: + option.tio.c_cflag |= CS5; + break; + case 6: + option.tio.c_cflag |= CS6; + break; + case 7: + option.tio.c_cflag |= CS7; + break; + case 8: + option.tio.c_cflag |= CS8; + break; + default: + printf("Error: Invalid data bits.\n"); + exit(EXIT_FAILURE); + } + break; + + case 'f': + if (strcmp("hard", optarg) == 0) + { + option.tio.c_cflag |= CRTSCTS; + option.tio.c_iflag &= ~(IXON | IXOFF | IXANY); + } + else if (strcmp("soft", optarg) == 0) + { + option.tio.c_cflag &= ~CRTSCTS; + option.tio.c_iflag |= IXON | IXOFF; + } + else if (strcmp("none", optarg) == 0) + { + option.tio.c_cflag &= ~CRTSCTS; + option.tio.c_iflag &= ~(IXON | IXOFF | IXANY); + } + else + { + printf("Error: Invalid flow control.\n"); + exit(EXIT_FAILURE); + } + break; + + case 's': + stopbits = atoi(optarg); + switch (stopbits) + { + case 1: + option.tio.c_cflag &= ~CSTOPB; + break; + case 2: + option.tio.c_cflag |= CSTOPB; + break; + default: + printf("Error: Invalid stop bits.\n"); + exit(EXIT_FAILURE); + } + break; + + case 'p': + if (strcmp("odd", optarg) == 0) + { + option.tio.c_cflag |= PARENB; + option.tio.c_cflag |= PARODD; + } + else if (strcmp("even", optarg) == 0) + { + option.tio.c_cflag |= PARENB; + option.tio.c_cflag &= ~PARODD; + } + else if (strcmp("none", optarg) == 0) + option.tio.c_cflag &= ~PARENB; + else + { + printf("Error: Invalid parity.\n"); + exit(EXIT_FAILURE); + } + break; + + case 'n': + option.no_autoconnect = true; + break; + + case 'v': + printf("Go TTY v%s\n", VERSION); + printf("Copyright (c) 2014 Martin Lund\n"); + printf("\n"); + printf("License GPLv2: GNU GPL version 2 or later .\n"); + printf("This is free software: you are free to change and redistribute it.\n"); + printf("There is NO WARRANTY, to the extent permitted by law.\n"); + exit(0); + break; + + case 'h': + print_options_help(argv); + exit(0); + break; + + case '?': + /* getopt_long already printed an error message */ + exit(1); + break; + + default: + exit(1); + } + } + + /* Assume first non-option is the tty device name */ + if (optind < argc) + strcpy(option.device, argv[optind++]); + + if (strlen(option.device) == 0) + { + printf("Error: Missing device name.\n"); + exit(EXIT_FAILURE); + } + + /* Print any remaining command line arguments (unknown options) */ + if (optind < argc) + { + printf("%s: unknown arguments: ", argv[0]); + while (optind < argc) + printf("%s ", argv[optind++]); + printf("\n"); + exit(EXIT_FAILURE); + } +} diff --git a/src/tty.c b/src/tty.c new file mode 100644 index 0000000..ad4ea9d --- /dev/null +++ b/src/tty.c @@ -0,0 +1,181 @@ +/* + * Go TTY - The Really Simple Terminal Application + * + * Copyright (c) 2014 Martin Lund + * + * This program is free software; you can redistribute it and/or + * modify it under the terms of the GNU General Public License + * as published by the Free Software Foundation; either version 2 + * of the License, or (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program; if not, write to the Free Software + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA + * 02110-1301, USA. + */ + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include "gotty/tty.h" +#include "gotty/print.h" +#include "gotty/options.h" + +#define MAX(x, y) (((x) > (y)) ? (x) : (y)) + +#define CTRLG 0x07 +#define CTRLQ 0x11 + +static int fd; +struct termios stdio, old_stdio, old_tio; + +void configure_stdout(void) +{ + /* Save current stdout settings */ + if (tcgetattr(STDOUT_FILENO, &old_stdio) < 0) + { + printf("Error: Saving current stdio settings failed\n"); + exit(EXIT_FAILURE); + } + + /* Prepare stdio settings */ + bzero(&stdio, sizeof(stdio)); + + /* Control, input, output, local modes for stdio */ + stdio.c_cflag = 0; + stdio.c_iflag = 0; + stdio.c_oflag = 0; + stdio.c_lflag = 0; + + /* Control characters */ + stdio.c_cc[VTIME] = 0; /* Inter-character timer unused */ + stdio.c_cc[VMIN] = 1; /* Blocking read until 1 character received */ + + /* Activate stdio settings */ + tcsetattr(STDOUT_FILENO, TCSANOW, &stdio); + tcsetattr(STDOUT_FILENO, TCSAFLUSH, &stdio); +} + +void restore(void) +{ + static int i=0; + + tcflush(STDOUT_FILENO, TCIOFLUSH); + tcsetattr(STDOUT_FILENO, TCSANOW, &old_stdio); + tcsetattr(STDOUT_FILENO, TCSAFLUSH, &old_stdio); + + tcsetattr(fd, TCSANOW, &old_tio); + tcsetattr(fd, TCSAFLUSH, &old_tio); + + gotty_printf("Disconnected\n"); +} + +int connect_tty(void) +{ + int console = 0; + fd_set rdfs; /* Read file descriptor set */ + int maxfd; /* Maximum file desciptor used */ + char c, c0 = 0, c1 = 0; + static bool first = true; + int status; + + /* Open tty device */ + fd = open(option.device, O_RDWR | O_NOCTTY ); + if (fd <0) + { + perror(option.device); + exit(EXIT_FAILURE); + } + + /* Make sure device is of tty type */ + if (!isatty(fd)) + { + printf("Error: Not a tty device"); + exit(EXIT_FAILURE); + } + + gotty_printf("Connected"); + + /* Save current port settings */ + if (tcgetattr(fd, &old_tio) < 0) + { + printf("Error: Saving current port settings failed\n"); + exit(EXIT_FAILURE); + } + + /* Make sure we restore settings on exit */ + if (first) + { + atexit(&restore); + first = false; + } + + /* Control, input, output, local modes for tty device */ + option.tio.c_cflag |= CLOCAL | CREAD; + option.tio.c_oflag = 0; + option.tio.c_lflag = 0; + + /* Control characters */ + option.tio.c_cc[VTIME] = 0; /* Inter-character timer unused */ + option.tio.c_cc[VMIN] = 1; /* Blocking read until 1 character received */ + + /* Activate new port settings */ + tcsetattr(fd, TCSANOW, &option.tio); + tcsetattr(fd, TCSAFLUSH, &option.tio); + + maxfd = MAX(fd, console) + 1; /* Maximum bit entry (fd) to test */ + + /* Input loop */ + while (true) + { + FD_ZERO(&rdfs); + FD_SET(fd, &rdfs); + FD_SET(console, &rdfs); + + /* Block until input becomes available */ + select(maxfd, &rdfs, NULL, NULL, NULL); + if (FD_ISSET(fd, &rdfs)) + { + /* Input from tty device ready */ + if (read(fd, &c, 1) > 0) + { + /* Print received tty character to stdout */ + putchar(c); + fflush(stdout); + } else + { + if (!option.no_autoconnect) + gotty_printf("Disconnected"); + return(EXIT_FAILURE); + } + } + if (FD_ISSET(console, &rdfs)) + { + /* Input from stdin ready */ + status = read(console, &c, 1); + + /* Exit upon ctrl-g ctrl-q sequence */ + c1 = c0; + c0 = c; + if ((c0 == CTRLQ) && (c1 == CTRLG)) + exit(EXIT_SUCCESS); + + /* Forward input to tty device */ + status = write(fd, &c, 1); + } + } + + return(EXIT_SUCCESS); +}