# # File: README # Author: G. Paul Ziemba # SCCS: @(#)README 1.7 9/29/94 # Purpose: Describe the tcpr package # # Legal: You may copy, modify, and distribute this software # (the tcpr package) freely as long as this file # is included in its entirety. # # This software is provided free of charge, with no # warranty of any kind, either expressed or implied. # Use at your own risk. # Contents of this file: 1. Introduction 2. Bug reports 3. Where to get it 4. Platforms 5. Acknowledgements Introduction ------------ Tcpr is a set of perl scripts that enable you to run ftp and telnet commands across a firewall. Forwarding takes place at the application level, so it's easy to control. Tcpr consists of an inetd-type server that interprets commands, a relay program, and a client that talks to the server. The client asks the server for a relay connection to some specified remote host at a specified TCP port number; the server invokes the relay program and returns a proxy port number to the client. The client then invokes telnet or ftp, telling them to connect to the relay host at the proxy port number. The relay program then transfers data between the client host and the remote host. Special handling is implemented for the FTP data connection, so everything works properly. Bug reports ----------- Please email bug reports, comments, and patches to: tcpr-bugs@alantec.com. Where to get it --------------- Tcpr is available from the following servers via anonymous ftp: ftp.alantec.com pub/tcpr ftp.cs.umb.edu pub/security ftp.psg.com pub/unix/netware grasp1.univ-lyon1.fr pub/unix/network/tcpip/security ftp.denet.dk pub/misc/tcpr Platforms --------- Tcpr is known to work on SunOS 4.1. I haven't tested it on other platforms, so I can't say if it'll work right out of the box for them. It's all perl, but the output format of the netstat and ifconfig commands might vary, and there isn't much flexibility in the parser for that yet. Acknowledgements ---------------- The tcpr package is based on a relay program written by Kazumasa Utashiro, . The relay program originally was to be invoked manually on the relay host, giving a port number which the user then used as an argument to the ftp or telnet program. I modified the relay program to select an outgoing interface based on some simple routing computations, and wrote a client and server to automate the process. Many thanks to the maintainers of the ftp sites mentioned above, listed in reverse alphabetical order (-: Christophe.Wolfhugel John P. Rouillard Kim H|glund Randy Bush