| Value | Meaning |
|---|---|
| GIT_CHECKOUT_NONE0 | default is a dry run, no actual updates |
| GIT_CHECKOUT_SAFE1u << 0 | Allow safe updates that cannot overwrite uncommitted data. If the uncommitted changes don't conflict with the checked out files, the checkout will still proceed, leaving the changes intact. Mutually exclusive with GIT_CHECKOUT_FORCE. GIT_CHECKOUT_FORCE takes precedence over GIT_CHECKOUT_SAFE. |
| GIT_CHECKOUT_FORCE1u << 1 | Allow all updates to force working directory to look like index. Mutually exclusive with GIT_CHECKOUT_SAFE. GIT_CHECKOUT_FORCE takes precedence over GIT_CHECKOUT_SAFE. |
| GIT_CHECKOUT_RECREATE_MISSING1u << 2 | Allow checkout to recreate missing files |
| GIT_CHECKOUT_ALLOW_CONFLICTS1u << 4 | Allow checkout to make safe updates even if conflicts are found |
| GIT_CHECKOUT_REMOVE_UNTRACKED1u << 5 | Remove untracked files not in index (that are not ignored) |
| GIT_CHECKOUT_REMOVE_IGNORED1u << 6 | Remove ignored files not in index |
| GIT_CHECKOUT_UPDATE_ONLY1u << 7 | Only update existing files, don't create new ones |
| GIT_CHECKOUT_DONT_UPDATE_INDEX1u << 8 | Normally checkout updates index entries as it goes; this stops that. Implies GIT_CHECKOUT_DONT_WRITE_INDEX. |
| GIT_CHECKOUT_NO_REFRESH1u << 9 | Don't refresh index/config/etc before doing checkout |
| GIT_CHECKOUT_SKIP_UNMERGED1u << 10 | Allow checkout to skip unmerged files |
| GIT_CHECKOUT_USE_OURS1u << 11 | For unmerged files, checkout stage 2 from index |
| GIT_CHECKOUT_USE_THEIRS1u << 12 | For unmerged files, checkout stage 3 from index |
| GIT_CHECKOUT_DISABLE_PATHSPEC_MATCH1u << 13 | Treat pathspec as simple list of exact match file paths |
| GIT_CHECKOUT_SKIP_LOCKED_DIRECTORIES1u << 18 | Ignore directories in use, they will be left empty |
| GIT_CHECKOUT_DONT_OVERWRITE_IGNORED1u << 19 | Don't overwrite ignored files that exist in the checkout target |
| GIT_CHECKOUT_CONFLICT_STYLE_MERGE1u << 20 | Write normal merge files for conflicts |
| GIT_CHECKOUT_CONFLICT_STYLE_DIFF31u << 21 | Include common ancestor data in diff3 format files for conflicts |
| GIT_CHECKOUT_DONT_REMOVE_EXISTING1u << 22 | Don't overwrite existing files or folders |
| GIT_CHECKOUT_DONT_WRITE_INDEX1u << 23 | Normally checkout writes the index upon completion; this prevents that. |
| GIT_CHECKOUT_UPDATE_SUBMODULES1u << 16 | Recursively checkout submodules with same options (NOT IMPLEMENTED) |
| GIT_CHECKOUT_UPDATE_SUBMODULES_IF_CHANGED1u << 17 | Recursively checkout submodules if HEAD moved in super repo (NOT IMPLEMENTED) |
There are some additional flags to modify the behavior of checkout:
- GIT_CHECKOUT_ALLOW_CONFLICTS makes SAFE mode apply safe file updates even if there are conflicts (instead of cancelling the checkout).
- GIT_CHECKOUT_REMOVE_UNTRACKED means remove untracked files (i.e. not in target, baseline, or index, and not ignored) from the working dir.
- GIT_CHECKOUT_REMOVE_IGNORED means remove ignored files (that are also untracked) from the working directory as well.
- GIT_CHECKOUT_UPDATE_ONLY means to only update the content of files that already exist. Files will not be created nor deleted. This just skips applying adds, deletes, and typechanges.
- GIT_CHECKOUT_DONT_UPDATE_INDEX prevents checkout from writing the updated files' information to the index.
- Normally, checkout will reload the index and git attributes from disk before any operations. GIT_CHECKOUT_NO_REFRESH prevents this reload.
- Unmerged index entries are conflicts. GIT_CHECKOUT_SKIP_UNMERGED skips files with unmerged index entries instead. GIT_CHECKOUT_USE_OURS and GIT_CHECKOUT_USE_THEIRS to proceed with the checkout using either the stage 2 ("ours") or stage 3 ("theirs") version of files in the index.
- GIT_CHECKOUT_DONT_OVERWRITE_IGNORED prevents ignored files from being overwritten. Normally, files that are ignored in the working directory are not considered "precious" and may be overwritten if the checkout target contains that file.
- GIT_CHECKOUT_DONT_REMOVE_EXISTING prevents checkout from removing files or folders that fold to the same name on case insensitive filesystems. This can cause files to retain their existing names and write through existing symbolic links.
Checkout behavior flags
In libgit2, checkout is used to update the working directory and index to match a target tree. Unlike git checkout, it does not move the HEAD commit for you - use git_repository_set_head or the like to do that.
Checkout looks at (up to) four things: the "target" tree you want to check out, the "baseline" tree of what was checked out previously, the working directory for actual files, and the index for staged changes.
You give checkout one of three strategies for update:
- GIT_CHECKOUT_NONE is a dry-run strategy that checks for conflicts, etc., but doesn't make any actual changes.
- GIT_CHECKOUT_FORCE is at the opposite extreme, taking any action to make the working directory match the target (including potentially discarding modified files).
- GIT_CHECKOUT_SAFE is between these two options, it will only make modifications that will not lose changes.
| target == baseline | target != baseline |
workdir exists and | no action | conflict (notify | is != baseline | notify dirty MODIFIED | and cancel checkout) |
To emulate git checkout, use GIT_CHECKOUT_SAFE with a checkout notification callback (see below) that displays information about dirty files. The default behavior will cancel checkout on conflicts.
To emulate git checkout-index, use GIT_CHECKOUT_SAFE with a notification callback that cancels the operation if a dirty-but-existing file is found in the working directory. This core git command isn't quite "force" but is sensitive about some types of changes.
To emulate git checkout -f, use GIT_CHECKOUT_FORCE.