gilbertchen/acrosync-library

rsync client library

acrosync-library

Acrosync is a new cross-platform rsync client for Windows/Max/iOS/Android that we built from scratch, without taking any code from the open source rsync project.

This is the library behind Acrosync, which implements a large portion of the client-side of the (undocumented) rsync protocol, including the famous delta sync algorithm.

PhotoBackup, our iOS app for uploading photos and videos to computers, uses a slightly modified version of this library.

Features

• Talks the rsync protocol version 29 (rsync 2.6.4+) and version 30 (rsync 3.x.x).
• Written in C++ and builds on Win32, Mac OS X, Linux, iOS, and Android.
• The only dependencies are libssh2 and openssl.
• Can connect to the rsync server either via ssh, or via the rsync daemon protocol.
• For ssh connections, supports both password login and public key authentication (with or without a passphrase).
• Symbolic links are supported.

Build Instructions

First you'll need to install openssl and libssh2. Assume we're on a linux machine and these two packages are already installed in the default locations.

Run the following command to build the test programs:

$ python qi/qi-make.py test

You will find a new executable build-linux/rsync/t_rsync_client which can download a remote directory using the rsync over ssh protocol:

$ build-linux/rsync/t_rsync_client <server> <username> <password> <remote dir> <local dir>

The same build command works for Mac and Windows, but you will need to install openssl and libssh2 to a subdirectory named install-mac or install-win under the top level directory.

Here the build system is written with Qi-Make, a tool that we developed by extending the basic syntax of make. The file qi/qi_build.h contains actual rules for building intermediate objects and final test programs. It should be fairly easy to make changes for your own build environments.

License

This library is licensed under the Reciprocal Public License. If this license does not work for you, a commercial license is available for a one-time fee or on a subscription basis. Contact [email protected] for licensing details.

acrosync-library's Issues

How to use it on Android?

Sorry, I don't quite understand how to use the library.
Can I import the library to my android project and package into a APK?

Please consider dual licensing this valuable library?

As I'm sure you are aware, it is very difficult to find anything besides rsync itself that speaks the rsync protocol.

Unfortunately, (as I'm sure you are also aware) the RPL is not particularly compatible with all that many other FOSS licenses. In fact, it is my understanding it is not compatible with the OpenSSL (SSLeay) license, nor the Apache license (due to the patents clauses), and your code has OpenSSL as a dependency.

Now, admittedly, not very many software packages have ever really been compatible with the original OpenSSL license. However, it looks as though the OpenSSL transition to the Apache License is in fact (already, or very nearly) complete!

So, I thought it might not hurt to politely ask if you might possibly be willing to do the same—that is, perhaps do something such as dual license this library (or at least the rsync-related portions) under the RPL and the Apache license?

Thank you,
Geoff

Consider AGPL licensing?

Hi there,

An AGPL license should give you similar protection to RPL with the additional benefit that it can be used in other free software projects. You can still dual-license your code for commercial use to commercial entities.

If you’d like to support free and open software, please consider this as an option.

Thanks!

Unable to build on windows

python 2.7.6
openssl :1.0.2l
libssh2 installed
Osx: Windows 7
Error: there is no action named 'compile' within 'rsync\rsync_io.cpp'

Unable to build

Running command python qi/qi-make.py test produces following error
Error: exception '<type 'exceptions.OSError'>' was raised updating action 'compile(rsync/rsync_io.cpp)'. Failed to update 1 action(s).

Python version 2.7.6
Openssl version 1.0.1f
Operating system: Ubuntu 14 LTS (kernel 3.13.0-32-generic)
Libssh2 - installed