gitian-builder/README.md

# Gitian

Read about the project goals at the "project home page":https://gitian.org/ .

This package can do a deterministic build of a package inside a VM.

## Deterministic build inside a VM

This performs a build inside a VM, with deterministic inputs and outputs.  If the build script takes care of all sources of non-determinism (mostly caused by timestamps), the result will always be the same.  This allows multiple independent verifiers to sign a binary with the assurance that it really came from the source they reviewed.

## Synopsis:

Install prereqs:

    sudo apt-get install python-vm-builder qemu-kvm apt-cacher
    sudo service apt-cacher start

Create the base VM for use in further builds (requires sudo, please review the script):

    bin/make-base-vm

Copy any additional build inputs into a directory named _inputs_.

Then execute the build using a YAML description file (can be run as non-root):

    bin/gbuild <package>-desc.yml

The resulting report will appear in result/\<package\>-res.yml
initial 14 years ago			`# Gitian`

			`Read about the project goals at the "project home page":https://gitian.org/ .`

			`This package can do a deterministic build of a package inside a VM.`

			`## Deterministic build inside a VM`

			`This performs a build inside a VM, with deterministic inputs and outputs. If the build script takes care of all sources of non-determinism (mostly caused by timestamps), the result will always be the same. This allows multiple independent verifiers to sign a binary with the assurance that it really came from the source they reviewed.`

use apt cacher, minor cleanup 14 years ago			`## Synopsis:`
initial 14 years ago
use apt cacher, minor cleanup 14 years ago			`Install prereqs:`
initial 14 years ago
use apt cacher, minor cleanup 14 years ago			`sudo apt-get install python-vm-builder qemu-kvm apt-cacher`
			`sudo service apt-cacher start`
initial 14 years ago
use apt cacher, minor cleanup 14 years ago			`Create the base VM for use in further builds (requires sudo, please review the script):`
initial 14 years ago
			`bin/make-base-vm`

use apt cacher, minor cleanup 14 years ago			`Copy any additional build inputs into a directory named _inputs_.`
initial 14 years ago
use apt cacher, minor cleanup 14 years ago			`Then execute the build using a YAML description file (can be run as non-root):`
initial 14 years ago
use apt cacher, minor cleanup 14 years ago			`bin/gbuild <package>-desc.yml`

			`The resulting report will appear in result/\<package\>-res.yml`