PRISTINE-LFS(1)

NAME
pristine-lfs - store pristine tarballs in Git LFS

SYNOPSIS

pristine-lfs [-h]

pristine-lfs [OPTIONS] commit [OPTIONS] tarball [upstream]

pristine-lfs [OPTIONS] checkout tarball

pristine-lfs [OPTIONS] list tarball

DESCRIPTION

pristine-lfs can store pristine upstream tarballs in Git leveraging Git LFS. Instead of storing the potentially large tarballs within the Git repository as blobs, Git LFS only stores specially prepared metadata in the repository, while storing the actual file contents out of band on a Git LFS server.

Using pristine-lfs allows Debian packages to be built entirely using sources in version control, without the need to keep copies of upstream tarballs.

pristine-lfs supports tarballs compressed with gzip, bzip2, lzma and xz.

COMMANDS

pristine-lfs commit tarball [upstream]
    pristine-lfs commit stores the specified tarball using Git LFS, and commits its metadata to version control. The pristine-lfs checkout command can later be used to recreate the original tarball based on the information stored in Git LFS. The data are not submitted to the server until git push command is issued.

    The upstream parameter is ignored and is supported for compatibility with pristine-tar.

    If tarball already exists previously, it will only be overwritten if it does not match a hash of the tarball that has been committed to version control.

pristine-lfs checkout tarball
    This regenerates a copy of the specified tarball using information previously saved in version control by pristine-lfs commit.

pristine-lfs list
    This lists tarballs that pristine-lfs is able to checkout from version control.

OPTIONS

-m MESSAGE, --message=MESSAGE
    Use the given MESSAGE as the commit message for the metadate commits. Applies to commit command.

-v, --verbose
    Be more verbose.

--debug
    Show all sorts of debugging information. Implies --verbose.

-h  Show this help message and exit.

ENVIRONMENT

TMPDIR
    Specifies a location to place temporary files, other than the default.

SEE ALSO

git-lfs(1), pristine-tar(1)

AUTHOR
Andrej Shadura <andrew.shadura@collabora.co.uk>