The third batch
[git/gitster.git] / Documentation / config / credential.txt
blob80a7c777720793a5e53b71603926e3de5d0acd8a
1 credential.helper::
2         Specify an external helper to be called when a username or
3         password credential is needed; the helper may consult external
4         storage to avoid prompting the user for the credentials. This is
5         normally the name of a credential helper with possible
6         arguments, but may also be an absolute path with arguments or, if
7         preceded by `!`, shell commands.
9 Note that multiple helpers may be defined. See linkgit:gitcredentials[7]
10 for details and examples.
12 credential.interactive::
13         By default, Git and any configured credential helpers will ask for
14         user input when new credentials are required. Many of these helpers
15         will succeed based on stored credentials if those credentials are
16         still valid. To avoid the possibility of user interactivity from
17         Git, set `credential.interactive=false`. Some credential helpers
18         respect this option as well.
20 credential.useHttpPath::
21         When acquiring credentials, consider the "path" component of an http
22         or https URL to be important. Defaults to false. See
23         linkgit:gitcredentials[7] for more information.
25 credential.sanitizePrompt::
26         By default, user names and hosts that are shown as part of the
27         password prompt are not allowed to contain control characters (they
28         will be URL-encoded by default). Configure this setting to `false` to
29         override that behavior.
31 credential.protectProtocol::
32         By default, Carriage Return characters are not allowed in the protocol
33         that is used when Git talks to a credential helper. This setting allows
34         users to override this default.
36 credential.username::
37         If no username is set for a network authentication, use this username
38         by default. See credential.<context>.* below, and
39         linkgit:gitcredentials[7].
41 credential.<url>.*::
42         Any of the credential.* options above can be applied selectively to
43         some credentials. For example, "credential.https://example.com.username"
44         would set the default username only for https connections to
45         example.com. See linkgit:gitcredentials[7] for details on how URLs are
46         matched.
48 credentialCache.ignoreSIGHUP::
49         Tell git-credential-cache--daemon to ignore SIGHUP, instead of quitting.
51 credentialStore.lockTimeoutMS::
52         The length of time, in milliseconds, for git-credential-store to retry
53         when trying to lock the credentials file. A value of 0 means not to retry at
54         all; -1 means to try indefinitely. Default is 1000 (i.e., retry for
55         1s).