The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

IO::BlockSync - Syncronize changed blocks

VERSION

Version 0.002

SYNOPSIS

BlockSync can some of the same stuff that bigsync (by Egor Egorov) can - it's just written in perl.

BlockSync copies data from source file to destination file (can be a block device) and calculates checksum on each block it copies. On all runs after the first only the changed blocks will be copied.

Perl module:

    use IO::BlockSync;
    BlockSync( src => 'sfile', dst => 'dfile', chk => 'cfile' );

Executable:

    blocksync -s /source/file -d /destination/file

INSTALLATION

When installing this module you install the IO::BlockSync Perl module and the blocksync command.

CPAN

Install directly from CPAN mirror:

    cpan IO::BlockSync

Or see How to install CPAN modules.

Local dir

You can get a copy of this module from GitHub:

    git clone https://github.com/thordreier/perl-IO-BlockSync.git

Then you can just use CPAN to install the module and take care of dependencies:

    cpan .

Or manual install (you need to fix dependencies manually):

    perl Makefile.PL
    make
    make test
    make install

Debian/Ubuntu

If you want to use as many packages from your distro as possible instead of getting them from CPAN you can run this command before any of the ones above:

    apt-get install \
        libnamespace-clean-perl \
        liblog-log4perl-perl \
        libmoo-perl \
        libmoosex-log-log4perl-perl \
        libmoox-options-perl \
        libtry-tiny-perl

USAGE AND DOCUMENTATION

Perl module

After installing, you can find documentation for this module with the perldoc command:

    perldoc IO::BlockSync

This documentation can also be found on GitHub or meta::cpan

Executable

After installing, you can find documentation for the executable with one of these commands:

    blocksync --help
    blocksync --man
    perldoc $(which blocksync)

Documentation can also be found on GitHub or meta::cpan

LICENSE AND COPYRIGHT

This software is copyright (c) 2019 by Thor Dreier-Hansen.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

Terms of the Perl programming language system itself:

See http://dev.perl.org/licenses/ for more information.