summaryrefslogtreecommitdiffstats
path: root/git.txt
diff options
context:
space:
mode:
authorJunio C Hamano <gitster@pobox.com>2021-01-25 15:32:33 -0800
committerJunio C Hamano <gitster@pobox.com>2021-01-25 15:32:33 -0800
commit7887f9b4eb248358cc8e6937ceb87b9f072ce9e5 (patch)
treed5670ef418f9f7d4a5780ee5d3d01696abb477aa /git.txt
parentd5cfc8f5a014ca40c71c8355aa37074cc885297e (diff)
downloadgit-htmldocs-7887f9b4eb248358cc8e6937ceb87b9f072ce9e5.tar.gz
Autogenerated HTML docs for v2.30.0-335-ge63628
Diffstat (limited to 'git.txt')
-rw-r--r--git.txt24
1 files changed, 23 insertions, 1 deletions
diff --git a/git.txt b/git.txt
index a6d4ad081..d36e6fd48 100644
--- a/git.txt
+++ b/git.txt
@@ -13,7 +13,7 @@ SYNOPSIS
[--exec-path[=<path>]] [--html-path] [--man-path] [--info-path]
[-p|--paginate|-P|--no-pager] [--no-replace-objects] [--bare]
[--git-dir=<path>] [--work-tree=<path>] [--namespace=<name>]
- [--super-prefix=<path>]
+ [--super-prefix=<path>] [--config-env <name>=<envvar>]
<command> [<args>]
DESCRIPTION
@@ -80,6 +80,28 @@ config file). Including the equals but with an empty value (like `git -c
foo.bar= ...`) sets `foo.bar` to the empty string which `git config
--type=bool` will convert to `false`.
+--config-env=<name>=<envvar>::
+ Like `-c <name>=<value>`, give configuration variable
+ '<name>' a value, where <envvar> is the name of an
+ environment variable from which to retrieve the value. Unlike
+ `-c` there is no shortcut for directly setting the value to an
+ empty string, instead the environment variable itself must be
+ set to the empty string. It is an error if the `<envvar>` does not exist
+ in the environment. `<envvar>` may not contain an equals sign
+ to avoid ambiguity with `<name>`s which contain one.
++
+This is useful for cases where you want to pass transitory
+configuration options to git, but are doing so on OS's where
+other processes might be able to read your cmdline
+(e.g. `/proc/self/cmdline`), but not your environ
+(e.g. `/proc/self/environ`). That behavior is the default on
+Linux, but may not be on your system.
++
+Note that this might add security for variables such as
+`http.extraHeader` where the sensitive information is part of
+the value, but not e.g. `url.<base>.insteadOf` where the
+sensitive information can be part of the key.
+
--exec-path[=<path>]::
Path to wherever your core Git programs are installed.
This can also be controlled by setting the GIT_EXEC_PATH