(defcustom tramp-mode t
"Whether Tramp is enabled.
If it is set to nil, all remote file names are used literally."
- :group 'tramp
:type 'boolean)
(defcustom tramp-verbose 3
8 connection properties
9 test commands
10 traces (huge)."
- :group 'tramp
:type 'integer)
(defcustom tramp-backup-directory-alist nil
gives the same backup policy for Tramp files on their hosts like the
policy for local files."
- :group 'tramp
:type '(repeat (cons (regexp :tag "Regexp matching filename")
(directory :tag "Backup directory name"))))
"Put auto-save files in this directory, if set.
The idea is to use a local directory so that auto-saving is faster.
This setting has precedence over `auto-save-file-name-transforms'."
- :group 'tramp
:type '(choice (const :tag "Use default" nil)
(directory :tag "Auto save directory name")))
(or (tramp-compat-funcall 'w32-shell-name) "/bin/sh"))
"Use this program for encoding and decoding commands on the local host.
This shell is used to execute the encoding and decoding command on the
-local host, so if you want to use `~' in those commands, you should
-choose a shell here which groks tilde expansion. `/bin/sh' normally
+local host, so if you want to use \"~\" in those commands, you should
+choose a shell here which groks tilde expansion. \"/bin/sh\" normally
does not understand tilde expansion.
For encoding and decoding, commands like the following are executed:
Note that this variable is not used for remote commands. There are
mechanisms in tramp.el which automatically determine the right shell to
use for the remote host."
- :group 'tramp
:type '(file :must-match t))
;; Suppress `shell-file-name' for w32 systems.
(if (tramp-compat-funcall 'w32-shell-dos-semantics) "/c" "-c"))
"Use this switch together with `tramp-encoding-shell' for local commands.
See the variable `tramp-encoding-shell' for more information."
- :group 'tramp
:type 'string)
;; Suppress `shell-file-name' for w32 systems.
"Use this switch together with `tramp-encoding-shell' for interactive shells.
See the variable `tramp-encoding-shell' for more information."
:version "24.1"
- :group 'tramp
:type '(choice (const nil) string))
(defvar tramp-methods nil
"Default method to use for transferring files.
See `tramp-methods' for possibilities.
Also see `tramp-default-method-alist'."
- :group 'tramp
:type 'string)
(defcustom tramp-default-method-alist nil
empty string for the user name.
See `tramp-methods' for a list of possibilities for METHOD."
- :group 'tramp
:type '(repeat (list (choice :tag "Host regexp" regexp sexp)
(choice :tag "User regexp" regexp sexp)
(choice :tag "Method name" string (const nil)))))
\"~/.ssh/config\" would be overwritten. Also see `tramp-default-user-alist'.
This variable is regarded as obsolete, and will be removed soon."
- :group 'tramp
:type '(choice (const nil) string))
(defcustom tramp-default-user-alist nil
If the file name does not specify the method, lookup is done using the
empty string for the method name."
- :group 'tramp
:type '(repeat (list (choice :tag "Method regexp" regexp sexp)
(choice :tag " Host regexp" regexp sexp)
(choice :tag " User name" string (const nil)))))
(defcustom tramp-default-host (system-name)
"Default host to use for transferring files.
Useful for su and sudo methods mostly."
- :group 'tramp
:type 'string)
(defcustom tramp-default-host-alist nil
If the file name does not specify the method, lookup is done using the
empty string for the method name."
- :group 'tramp
:version "24.4"
:type '(repeat (list (choice :tag "Method regexp" regexp sexp)
(choice :tag " User regexp" regexp sexp)
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."
- :group 'tramp
:type '(repeat (list (choice :tag "Host regexp" regexp sexp)
(choice :tag "User regexp" regexp sexp)
(choice :tag " Proxy name" string (const nil)))))
(defcustom tramp-save-ad-hoc-proxies nil
"Whether to save ad-hoc proxies persistently."
- :group 'tramp
:version "24.3"
:type 'boolean)
proxies only, see `tramp-default-proxies-alist'. If the local
host runs a registered shell, it shall be added to this list, too."
:version "24.3"
- :group 'tramp
:type '(repeat (regexp :tag "Host regexp")))
(defcustom tramp-local-host-regexp
"Host names which are regarded as local host.
If the local host runs a chrooted environment, set this to nil."
:version "27.1"
- :group 'tramp
:type '(choice (const :tag "Chrooted environment" nil)
(regexp :tag "Host regexp")))
(if (memq system-type '(windows-nt)) "\r\n" "\n")
"String used for end of line in local processes."
:version "24.1"
- :group 'tramp
:type 'string)
(defcustom tramp-rsh-end-of-line "\n"
"String used for end of line in rsh connections.
I don't think this ever needs to be changed, so please tell me about it
if you need to change this."
- :group 'tramp
:type 'string)
(defcustom tramp-login-prompt-regexp
The regexp should match at end of buffer.
Sometimes the prompt is reported to look like \"login as:\"."
- :group 'tramp
:type 'regexp)
(defcustom tramp-shell-prompt-pattern
This regexp must match both `tramp-initial-end-of-output' and
`tramp-end-of-output'."
- :group 'tramp
:type 'regexp)
(defcustom tramp-password-prompt-regexp
The `sudo' program appears to insert a `^@' character into the prompt."
:version "24.4"
- :group 'tramp
:type 'regexp)
(defcustom tramp-wrong-passwd-regexp
"\\).*")
"Regexp matching a `login failed' message.
The regexp should match at end of buffer."
- :group 'tramp
:type 'regexp)
(defcustom tramp-yesno-prompt-regexp
The confirmation should be done with yes or no.
The regexp should match at end of buffer.
See also `tramp-yn-prompt-regexp'."
- :group 'tramp
:type 'regexp)
(defcustom tramp-yn-prompt-regexp
The confirmation should be done with y or n.
The regexp should match at end of buffer.
See also `tramp-yesno-prompt-regexp'."
- :group 'tramp
:type 'regexp)
(defcustom tramp-terminal-prompt-regexp
"Regular expression matching all terminal setting prompts.
The regexp should match at end of buffer.
The answer will be provided by `tramp-action-terminal', which see."
- :group 'tramp
:type 'regexp)
(defcustom tramp-operation-not-permitted-regexp
"Regular expression matching keep-date problems in (s)cp operations.
Copying has been performed successfully already, so this message can
be ignored safely."
- :group 'tramp
:type 'regexp)
(defcustom tramp-copy-failed-regexp
t)
"\\)\\s-*")
"Regular expression matching copy problems in (s)cp operations."
- :group 'tramp
:type 'regexp)
(defcustom tramp-process-alive-regexp
check regularly the status of the associated process.
The answer will be provided by `tramp-action-process-alive',
`tramp-action-out-of-band', which see."
- :group 'tramp
:type 'regexp)
(defconst tramp-temp-name-prefix "tramp."
Do not change the value by `setq', it must be changed only via
Customize. See also `tramp-change-syntax'."
- :group 'tramp
:version "26.1"
:package-version '(Tramp . "2.3.3")
:type '(choice (const :tag "Default" default)
(defcustom tramp-ignored-file-name-regexp nil
"Regular expression matching file names that are not under Tramp’s control."
:version "27.1"
- :group 'tramp
:type '(choice (const nil) regexp))
(defconst tramp-completion-file-name-regexp-default
Please raise a bug report via \"M-x tramp-bug\" if your system needs
this variable to be set as well."
- :group 'tramp
:type '(choice (const nil) integer))
;; Logging in to a remote host normally requires obtaining a pty. But
"Overrides `process-connection-type' for connections from Tramp.
Tramp binds `process-connection-type' to the value given here before
opening a connection to a remote host."
- :group 'tramp
:type '(choice (const nil) (const t) (const pty)))
(defcustom tramp-connection-timeout 60
This can be overwritten for different connection types in `tramp-methods'.
The timeout does not include the time reading a password."
- :group 'tramp
:version "24.4"
:type 'integer)
performed, or when several asynchronous processes will be started
in a short time frame. In those cases it is recommended to
let-bind this variable."
- :group 'tramp
:version "24.4"
:type '(choice (const nil) integer))
have been gone since last remote command execution. A value of t
would require an immediate reread during filename completion, nil
means to use always cached values for the directory contents."
- :group 'tramp
:type '(choice (const nil) (const t) integer))
;;; Internal Variables:
(list signal
(get signal 'error-message)
(apply #'format-message fmt-string arguments)))))
- (signal signal (list (apply #'format-message fmt-string arguments)))))
+ (signal signal (list (substring-no-properties
+ (apply #'format-message fmt-string arguments))))))
(defsubst tramp-error-with-buffer
(buf vec-or-proc signal fmt-string &rest arguments)
"Whether to use `auth-source-search' for completion of user and host names.
This could be disturbing, if it requires a password / passphrase,
as for \"~/.authinfo.gpg\"."
- :group 'tramp
:version "27.1"
:type 'boolean)