=pod

=head1 NAME

sum - tools for safely copying files across the network

=head1 INVOCATION

sum-send [input-filename]
sum-recv [output-filename]

=head1 DESCRIPTION

Executing

 sum-send a | sum-recv b

copies file a to b.  If b would end up having a different checksum than a,
sum-recv leaves the original b intact.

Of course, typically one invokes something like ssh instead of a vanilla pipe.

In case no arguments are given, stdin resp. stdout is used.

See the hosts listed in include/install.mk for typical usage scenarios.

An example of a authorized_keys file is in svn on infix,
trunk/systems/lovelace/home/truus/.ssh/authorized_keys .

=head1 PORTABILITY

Solaris doesn't ship md5sum(1).  (GNU/Linux distributions usually use the
implementation as shipped with GNU coreutils.)  Perhaps cksum(1) works for you.
Solaris's read doesn't know about -r.  Perhaps you can use bash on solaris.

=head1 AUTHOR

This manpage: Joost van Baal.
The sum suite: Wessel Dankers.

=head1 VERSION

$Id: uvt-sum.pod 12266 2007-01-16 14:25:25Z joostvb $
$URL: https://infix.uvt.nl/its-id/trunk/sources/uvt-sum/man/uvt-sum.pod $

=cut