$Id: README,v 1.3 2006/03/02 23:22:30 jirka Exp $

netrw is a simple (but powerful) tool for transporting data over the
internet. Its main purpose is to simplify and speed up file transfers to
hosts without an FTP server. It can also be used for uploading data to
some other user. It is something like one-way netcat (nc) with some nice
features concerning data transfers. Netrw can compute and check message
digest (MD5, SHA-1, and some others) of all the data being transferred, it
can also print information on progress and average speed. At the end it
sums up the transfer.


Typical usage of netrw tool
===========================

Let's suppose you want to send a file named data.zip from host.domain.org
to server.somewhere.net. There are several ways how this can be done. The
first and the second example are the same for Unix-like OSs as well as for
Windows "OS". In case of Windows, it's better and safer to use -i and -o
parameters rather than I/O redirection. The third example is only usable on
Unix-like systems because Windows (not speaking about cygwin and other
similar tools) has no ssh.

* basic and the most usual scenario:
    1. on server.somewhere.net run

        $ netread 1234 >data.zip
       or
        $ netread -o data.zip 1234

    2. on host.domain.org run

        $ netwrite server.somewhere.net 1234 <data.zip
       or
        $ netwrite -i data.zip server.somewhere.net 1234

* when the server is protected by firewall (and the host is not) or when
  you want the connection to be initiated by reader, you have to use
  this scenario:
    1. on host.domain.org run

        $ netwrite -f 1234 <data.zip
       or
        $ netwrite -f -i data.zip 1234

    2. on server.somewhere.net run

        $ netread -f server.somewhere.net 1234 >data.zip
       or
        $ netread -f server.somewhere.net -o data.zip 1234

* when you are both writer and reader, you can run the following
  commands on one of the two machines only:
    * on host.domain.org run

        $ ssh server.somewhere.net 'netread 1234 >data.zip' &>/dev/null &
        $ netwrite server.somewhere.net 1234 <data.zip

    * OR on server.somewhere.net run

        $ netread 1234 >data.zip 2>/dev/null &
        $ ssh host.domain.org 'netwrite server.somewhere.net 1234 <data.zip'

When you want to send more than one file, you have to use a bit
complicated commands:

    * On Unix-like systems you can make use of tar and pipes:

        $ netread 1234 | tar xf -
        $ tar cf - <some_files> | netwrite server.somewhere.net 1234

    * Windows: first you have to compress those files into one file (e.g.,
      using WinZip), send the compressed file to the remote host (as it is
      described above) and there you have to uncompress it.

