Documentation / config / ssh.txton commit Merge branch 'ds/feature-macros' (f4f8dfe)
   1ssh.variant::
   2        By default, Git determines the command line arguments to use
   3        based on the basename of the configured SSH command (configured
   4        using the environment variable `GIT_SSH` or `GIT_SSH_COMMAND` or
   5        the config setting `core.sshCommand`). If the basename is
   6        unrecognized, Git will attempt to detect support of OpenSSH
   7        options by first invoking the configured SSH command with the
   8        `-G` (print configuration) option and will subsequently use
   9        OpenSSH options (if that is successful) or no options besides
  10        the host and remote command (if it fails).
  11+
  12The config variable `ssh.variant` can be set to override this detection.
  13Valid values are `ssh` (to use OpenSSH options), `plink`, `putty`,
  14`tortoiseplink`, `simple` (no options except the host and remote command).
  15The default auto-detection can be explicitly requested using the value
  16`auto`.  Any other value is treated as `ssh`.  This setting can also be
  17overridden via the environment variable `GIT_SSH_VARIANT`.
  18+
  19The current command-line parameters used for each variant are as
  20follows:
  21+
  22--
  23
  24* `ssh` - [-p port] [-4] [-6] [-o option] [username@]host command
  25
  26* `simple` - [username@]host command
  27
  28* `plink` or `putty` - [-P port] [-4] [-6] [username@]host command
  29
  30* `tortoiseplink` - [-P port] [-4] [-6] -batch [username@]host command
  31
  32--
  33+
  34Except for the `simple` variant, command-line parameters are likely to
  35change as git gains new features.