Variable: tramp-default-proxies-alist

tramp-default-proxies-alist is a customizable variable defined in tramp.el.gz.

Value

nil

Documentation

Route to be followed for specific host/user pairs.

This is an alist of items (HOST USER PROXY). The first matching item specifies the proxy to be passed for a file name located on a remote target matching USER@HOST. HOST and USER are regular expressions, which could also cover a domain (USER%DOMAIN) or port (HOST#PORT). PROXY must be a Tramp filename without a localname part. Method and user name on PROXY are optional, which is interpreted with the default values.

PROXY can contain the patterns %h and %u, which are replaced by the strings matching HOST or USER (without DOMAIN and PORT parts), respectively.

If an entry is added while parsing ad-hoc hop definitions, PROXY carries the non-nil text property tramp-ad-hoc.

HOST, USER or PROXY could also be Lisp forms, which will be evaluated. The result must be a string or nil, which is interpreted as a regular expression which always matches.

Probably introduced at or before Emacs version 23.1.

Source Code

;; Defined in /usr/src/emacs/lisp/net/tramp.el.gz
(defcustom tramp-default-proxies-alist nil
  ;; FIXME: This is not an "alist", because its elements are not of
  ;; the form (KEY . VAL) but (KEY1 KEY2 VAL).
  "Route to be followed for specific host/user pairs.
This is an alist of items (HOST USER PROXY).  The first matching
item specifies the proxy to be passed for a file name located on
a remote target matching USER@HOST.  HOST and USER are regular
expressions, which could also cover a domain (USER%DOMAIN) or
port (HOST#PORT).  PROXY must be a Tramp filename without a
localname part.  Method and user name on PROXY are optional,
which is interpreted with the default values.

PROXY can contain the patterns %h and %u, which are replaced by
the strings matching HOST or USER (without DOMAIN and PORT parts),
respectively.

If an entry is added while parsing ad-hoc hop definitions, PROXY
carries the non-nil text property `tramp-ad-hoc'.

HOST, USER or PROXY could also be Lisp forms, which will be
evaluated.  The result must be a string or nil, which is
interpreted as a regular expression which always matches."
  :type '(repeat (list (choice :tag "Host regexp" regexp sexp)
		       (choice :tag "User regexp" regexp sexp)
		       (choice :tag " Proxy name" string (const nil))))
  :link '(info-link :tag "Tramp manual" "(tramp) Multi-hops"))