git-lfs(1) -- Work with large files in Git repositories
=======================================================

## SYNOPSIS

`git lfs` <command> [<args>]

## DESCRIPTION

Git LFS is a system for managing and versioning large files in
association with a Git repository.  Instead of storing the large files
within the Git repository as blobs, Git LFS stores special "pointer
files" in the repository, while storing the actual file contents on a
Git LFS server.  The contents of the large file are downloaded
automatically when needed, for example when a Git branch containing
the large file is checked out.

Git LFS works by using a "smudge" filter to look up the large file
contents based on the pointer file, and a "clean" filter to create a
new version of the pointer file when the large file's contents change.
It also uses a `pre-push` hook to upload the large file contents to
the Git LFS server whenever a commit containing a new large file
version is about to be pushed to the corresponding Git server.

## COMMANDS

Like Git, Git LFS commands are separated into high level ("porcelain")
commands and low level ("plumbing") commands.

### High level commands (porcelain)

* git-lfs-env(1):
    Display the Git LFS environment.
* git-lfs-checkout(1):
    Populate working copy with real content from Git LFS files.
* git lfs clone:
    Efficiently clone a Git LFS-enabled repository.
* git-lfs-fetch(1):
    Download Git LFS files from a remote.
* git-lfs-fsck(1):
    Check Git LFS files for consistency.
* git-lfs-install(1):
    Install Git LFS configuration.
* git-lfs-lock(1):
    Set a file as "locked" on the Git LFS server.
* git-lfs-locks(1):
    List currently "locked" files from the Git LFS server.
* git-lfs-logs(1):
    Show errors from the git-lfs command.
* git-lfs-ls-files(1):
    Show information about Git LFS files in the index and working tree.
* git-lfs-migrate(1):
    Migrate history to or from git-lfs
* git-lfs-prune(1):
    Delete old Git LFS files from local storage
* git-lfs-pull(1):
    Fetch LFS changes from the remote & checkout any required working tree files.
* git-lfs-push(1):
    Push queued large files to the Git LFS endpoint.
* git-lfs-status(1):
    Show the status of Git LFS files in the working tree.
* git-lfs-track(1):
    View or add Git LFS paths to Git attributes.
* git-lfs-uninstall(1):
    Uninstall Git LFS by removing hooks and smudge/clean filter configuration.
* git-lfs-unlock(1):
    Remove "locked" setting for a file on the Git LFS server.
* git-lfs-untrack(1):
    Remove Git LFS paths from Git Attributes.
* git-lfs-update(1):
    Update Git hooks for the current Git repository.
* git lfs version:
    Report the version number.

### Low level commands (plumbing)

* git-lfs-clean(1):
    Git clean filter that converts large files to pointers.
* git-lfs-pointer(1):
    Build and compare pointers.
* git-lfs-pre-push(1):
    Git pre-push hook implementation.
* git-lfs-smudge(1):
    Git smudge filter that converts pointer in blobs to the actual content.
