Variable: tramp-use-connection-share

tramp-use-connection-share is a customizable variable defined in tramp-sh.el.gz.

Value

t

Documentation

Whether to use connection share in ssh or PuTTY.

Set it to t, if you want Tramp to apply respective options. These are tramp-ssh-controlmaster-options for ssh, and "-share" for PuTTY. Set it to nil, if you use Control* or Proxy* options in your ssh configuration. Set it to suppress if you want to disable settings in your
"~/.ssh/config" file or in your PuTTY session.

This variable was added, or its default value changed, in Emacs 30.1.

Probably introduced at or before Emacs version 30.1.

Aliases

tramp-use-ssh-controlmaster-options (obsolete since 30.1)

Source Code

;; Defined in /usr/src/emacs/lisp/net/tramp-sh.el.gz
(defcustom tramp-use-connection-share (not (eq system-type 'windows-nt))
  "Whether to use connection share in ssh or PuTTY.
Set it to t, if you want Tramp to apply respective options.  These
are `tramp-ssh-controlmaster-options' for ssh, and \"-share\" for PuTTY.
Set it to nil, if you use Control* or Proxy* options in your ssh
configuration.
Set it to `suppress' if you want to disable settings in your
\"~/.ssh/config\" file or in your PuTTY session."
  :group 'tramp
  :version "30.1"
  :type '(choice (const :tag "Set ControlMaster" t)
                 (const :tag "Don't set ControlMaster" nil)
                 (const :tag "Suppress ControlMaster" suppress))
  ;; Check with (safe-local-variable-p 'tramp-use-connection-share 'suppress)
  :safe (lambda (val) (and (memq val '(t nil suppress)) t))
  :link '(info-link :tag "Tramp manual" "(tramp) Using ssh connection sharing"))