libgit2

git_submodule_ignore

Version:

Get the ignore rule that will be used for the submodule.

These values control the behavior of git_submodule_status() for this submodule. There are four ignore values:

  • GIT_SUBMODULE_IGNORE_NONE will consider any change to the contents of the submodule from a clean checkout to be dirty, including the addition of untracked files. This is the default if unspecified.
    • GIT_SUBMODULE_IGNORE_UNTRACKED examines the contents of the working tree (i.e. call git_status_foreach() on the submodule) but UNTRACKED files will not count as making the submodule dirty.
    • GIT_SUBMODULE_IGNORE_DIRTY means to only check if the HEAD of the submodule has moved for status. This is fast since it does not need to scan the working tree of the submodule at all.
    • GIT_SUBMODULE_IGNORE_ALL means not to open the submodule repo. The working directory will be consider clean so long as there is a checked out version present.

plus the special GIT_SUBMODULE_IGNORE_RESET which can be used with git_submodule_set_ignore() to revert to the on-disk setting.

Signature

git_submodule_ignore_t git_submodule_ignore(git_submodule *submodule);

Parameters

In
submodule

The submodule to check

Returns

The current git_submodule_ignore_t valyue what will be used for this submodule.

Versions