summaryrefslogtreecommitdiffstats
path: root/gitcredentials.txt
diff options
context:
space:
mode:
authorJunio C Hamano <gitster@pobox.com>2020-05-08 15:27:04 -0700
committerJunio C Hamano <gitster@pobox.com>2020-05-08 15:27:04 -0700
commit2b43cff1c1e6418402997ad8a78ff0a401a5957a (patch)
treed11eea5eb084d04a628671597a15e2df94d553c8 /gitcredentials.txt
parentdd4c178beaaa13be1f0211908f194c136b341973 (diff)
downloadgit-htmldocs-2b43cff1c1e6418402997ad8a78ff0a401a5957a.tar.gz
Autogenerated HTML docs for v2.26.2-593-gb9946
Diffstat (limited to 'gitcredentials.txt')
-rw-r--r--gitcredentials.txt16
1 files changed, 11 insertions, 5 deletions
diff --git a/gitcredentials.txt b/gitcredentials.txt
index 1814d2d23..0d0f7149b 100644
--- a/gitcredentials.txt
+++ b/gitcredentials.txt
@@ -216,20 +216,26 @@ Here are some example specifications:
----------------------------------------------------
# run "git credential-foo"
-foo
+[credential]
+ helper = foo
# same as above, but pass an argument to the helper
-foo --bar=baz
+[credential]
+ helper = "foo --bar=baz"
# the arguments are parsed by the shell, so use shell
# quoting if necessary
-foo --bar="whitespace arg"
+[credential]
+ helper = "foo --bar='whitespace arg'"
# you can also use an absolute path, which will not use the git wrapper
-/path/to/my/helper --with-arguments
+[credential]
+ helper = "/path/to/my/helper --with-arguments"
# or you can specify your own shell snippet
-!f() { echo "password=`cat $HOME/.secret`"; }; f
+[credential "https://example.com"]
+ username = your_user
+ helper = "!f() { test \"$1\" = get && echo \"password=$(cat $HOME/.secret)\"; }; f"
----------------------------------------------------
Generally speaking, rule (3) above is the simplest for users to specify.