From 2187fc7c62ffad7cb514d061899d57cfd95438dc Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Wed, 14 Jan 2004 21:51:32 +0000 Subject: Add UUCP locking Add documentation git-svn-id: file:///home/lennart/svn/public/bidilink/trunk@7 9cde1c1d-e4d0-0310-8a68-bf217395ea82 --- doc/README.html.in | 139 +++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 139 insertions(+) create mode 100644 doc/README.html.in (limited to 'doc/README.html.in') diff --git a/doc/README.html.in b/doc/README.html.in new file mode 100644 index 0000000..f9f2cc2 --- /dev/null +++ b/doc/README.html.in @@ -0,0 +1,139 @@ + + + + + +bidilink @PACKAGE_VERSION@ + + + + +

bidilink @PACKAGE_VERSION@

+ +

Copyright 2003 Lennart Poettering <@PACKAGE_BUGREPORT@>

+ + + +

License

+ +

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., 675 Mass Ave, Cambridge, MA 02139, USA.

+ +

News

+ +
Wed Jan 14 2004:
+ +

Version 0.1 released, initial release.

+ +

Overview

+ +

bidilink is a general purpose Unix tool for linking two +bidirectional data streams together. It extends the standard Unix +"filter" paradigma to bidrectional streams.

+ +

Status

+ +

Version @PACKAGE_VERSION@ is more or less stable. Its has the following stream drivers:

+ + + +

More drivers are planned, including:

+ + + +

Documentation

+ +

Have a look on the man page bidilink(1). (An XSLT capable browser is required)

+ +

Usage examples

+ +

Forward a serial port of another machine to a local pseudo TTY, which is compatible with pppd and minicom:

+ +
bidilink "exec:ssh OTHERMACHINE bidilink tty:/dev/ttyS0" pty:/dev/rmodem
+ +

This will create a symbolic link /dev/rmodem to the +allocated pseudo TTY device. Point your application to the device to +use the forwarded port. This requires that bidilink is +installed on both the local machine and the remote machine.

+ +

Bind a local serial port to a local TCP port:

+ +
bidilink tty:/dev/ttyS0 tcp-server:4711
+ +

Use telnet localhost 4711 to connect to the device

+ +

Bind a remote serial port to a local pseudo TTY:

+ +
bidilink pty:/dev/rmodem tcp-client:OTHERMACHINE:4711
+ +

This may be used as client to the server trick descibed above.

+ +

Open a local Unix socket (SOCK_STREAM) to the Internet:

+ +
bidilink tcp-server:4711 unix-client:/tmp/.esd/socket
+ +

Requirements

+ +

A recent Linux distribution. Probably, it is simple to port bidilink to other platforms, but this has not been done yet.

+ +

Installation

+ +

As this package is made with the GNU autotools you should run +./configure inside the distribution directory for configuring +the source tree. After that you should run make for +compilation and make install (as root) for installation of +bidilink.

+ +

Acknowledgements

+ +

None so far

+ +

Download

+ +

The newest release is always available from @PACKAGE_URL@

+ +

The current release is @PACKAGE_VERSION@

+ +

Get bidilink's development sources from the Subversion repository.

+ +
+
Lennart Poettering <@PACKAGE_BUGREPORT@>, January 2004
+ +
$Id$
+ + + -- cgit