Documentation / git-credential-cache.txton commit Merge branch 'da/user-useconfigonly' into HEAD (e9ef83a)
   1git-credential-cache(1)
   2=======================
   3
   4NAME
   5----
   6git-credential-cache - Helper to temporarily store passwords in memory
   7
   8SYNOPSIS
   9--------
  10-----------------------------
  11git config credential.helper 'cache [options]'
  12-----------------------------
  13
  14DESCRIPTION
  15-----------
  16
  17This command caches credentials in memory for use by future Git
  18programs. The stored credentials never touch the disk, and are forgotten
  19after a configurable timeout.  The cache is accessible over a Unix
  20domain socket, restricted to the current user by filesystem permissions.
  21
  22You probably don't want to invoke this command directly; it is meant to
  23be used as a credential helper by other parts of Git. See
  24linkgit:gitcredentials[7] or `EXAMPLES` below.
  25
  26OPTIONS
  27-------
  28
  29--timeout <seconds>::
  30
  31        Number of seconds to cache credentials (default: 900).
  32
  33--socket <path>::
  34
  35        Use `<path>` to contact a running cache daemon (or start a new
  36        cache daemon if one is not started). Defaults to
  37        `~/.git-credential-cache/socket`. If your home directory is on a
  38        network-mounted filesystem, you may need to change this to a
  39        local filesystem. You must specify an absolute path.
  40
  41CONTROLLING THE DAEMON
  42----------------------
  43
  44If you would like the daemon to exit early, forgetting all cached
  45credentials before their timeout, you can issue an `exit` action:
  46
  47--------------------------------------
  48git credential-cache exit
  49--------------------------------------
  50
  51EXAMPLES
  52--------
  53
  54The point of this helper is to reduce the number of times you must type
  55your username or password. For example:
  56
  57------------------------------------
  58$ git config credential.helper cache
  59$ git push http://example.com/repo.git
  60Username: <type your username>
  61Password: <type your password>
  62
  63[work for 5 more minutes]
  64$ git push http://example.com/repo.git
  65[your credentials are used automatically]
  66------------------------------------
  67
  68You can provide options via the credential.helper configuration
  69variable (this example drops the cache time to 5 minutes):
  70
  71-------------------------------------------------------
  72$ git config credential.helper 'cache --timeout=300'
  73-------------------------------------------------------
  74
  75GIT
  76---
  77Part of the linkgit:git[1] suite