Note: you can only build on your host OS. You cannot cross compile.

• ovftool (VMWare) on your path
• librsync https://github.com/charlievieth/librsync
• cmake

Stembuild applies a binary diff to a source vhd and creates a stemcell. The binary diff creation is dependent upon rdiff (located in librsync), and is why stembuild cannot be cross compiled. This is because one of the rdiff dependencies (POP3) is not supported in windows. In order to get around this, a shim has been written in go that is not dependent upon POP3.

Cmake is used to create the necessary header files so that compilation can succeed. You should only have to generate these files once since we only care about the rdiff files.

To generate the correct files in linux:

1. check out the correct librsync branch
2. (Linux and Darwin) mingw64-fseeko64-v2.0.0
3. (Windows) mingw64-fseeko64-v2.0.0-windows
4. open cmake
5. set source folder to librsync
6. set destination folder to librsync/build
7. set CMAKE_INSTALL_PREFIX=librsync/install
8. set CMAKE_BUILD_TYPE=release
9. click configure
10. click generate (this generates the .h files)
11. copy all source and header files from librsync/src into stembuild/rdiff/
12. copy all source and header files from librsync/build/src into stembuild/rdiff/
13. remove rdiff/rdiff.c (this is because we have rewritten this in go rdiff.go)

Other environments are similar. Use your best judgment or fill in the details here. The windows branch does attempt to build the rdiff executable and does not require the BZIP2 and ZLIB libraries

librsync: ERROR: (rs_file_copy_cb) seek failed: Invalid argument
renaming stemcell to bosh-stemcell-1200.9.4-build.7-vsphere-esxi-windows2012R2-go_agent.tgz
librsync: ERROR: (rs_job_complete) patch job failed: IO error
Error: RS_IO_ERROR: IO error

This is because you did not use the correct branch when compiling. Use the Windows branch for Windows, and the default branch for the others.