modemu2k: A C repository from martijndeb

modemu2k is a fork of modemu, originally developed by Toru Egashira

(Travis Build status
<https://travis-ci.org/theimpossibleastronaut/modemu2k>)


What is modemu2k?
---------------

modemu2k adds telnet capability to a comm program. It can redirect
telnet I/O to a pty so that a comm program can handle the pty as a tty
with a real modem, and allows you to use a comm program's scripting
and file transfer features over telnet.

Maintainer: Andy Alt <andy400-dev@yahoo.com>
License: GNU GPL 3
Home page: <https://github.com/theimpossibleastronaut/modemu2k>

Other contact/chat room: <https://gitter.im/modemu2k/Lobby>


Translation
-----------

If you're interested in translating the output messages for modemu2k,
see the [TRANSLATE.md](TRANSLATE.md) document.


Compilation
-----------

./configure
    Use ./configure --help to see extra options

make

`make install` is optional. The binary can be run from the src/
directory.

Making SOCKSified or Termified Modemu2k may require changes to
src/Makefile.am.


Sample Usage
------------

Note: while in the program if backspace doesn't work, use CTRL+H.

1) Stand alone usage

  Invoked with no option,

  > modemu2k

  modemu2k reads from standard input and writes to standard output.
  Input

  > atd"localhost

  (prompt ">" is not shown) You will see your host's login prompt
  (if a server is running). When you disconnect, you will get "NO
  CARRIER" indication. Then input

  > at%q

  to quit modemu2k.

2) With a comm program

  (This example uses XC as the comm program)

  Invoke with "-c" option,

  > modemu2k -c "xc -l tty%s"

  you see XC runs. Go to the terminal mode and input

  > atd"localhost

  Yes, modemu2k makes the comm program a telnet client.

  To quit modemu2k, just quit the comm program.

(*) Almost all file xfer protocols require 8bit through connection,
which means Modemu2k must be in the binary transmission mode.  See %B
command description in the man page.

More details are in the QuickStart guide
<https://github.com/theimpossibleastronaut/modemu2k/blob/master/QuickStart>
martijndeb/modemu2k
