tramp version 2.2.6-24.3 User Manual

This file documents tramp version 2.2.6-24.3, a remote file editing package for Emacs.

tramp stands for `Transparent Remote (file) Access, Multiple Protocol'. This package provides remote file editing, similar to Ange-FTP.

The difference is that Ange-FTP uses FTP to transfer files between the local and the remote host, whereas tramp uses a combination of rsh and rcp or other work-alike programs, such as ssh/scp.

You can find the latest version of this document on the web at

The latest release of tramp is available for download, or you may see Obtaining Tramp for more details, including the Git server details.

tramp also has a Savannah Project Page.

There is a mailing list for tramp, available at, and archived at the tramp Mail Archive. Older archives are located at SourceForge Mail Archive and The Mail Archive.

Overview What tramp can and cannot do.
For the end user:
Obtaining Tramp How to obtain tramp.
History History of tramp.
Configuration Configuring tramp for use.
Usage An overview of the operation of tramp.
Bug Reports Reporting Bugs and Problems.
Frequently Asked Questions Questions and answers from the mailing list.
For the developer:
Files directories and localnames How file names, directories and localnames are mangled and managed.
Traces and Profiles How to Customize Traces.
Issues Debatable Issues and What Was Decided.
GNU Free Documentation License The license for this documentation.
Function Index tramp functions.
Variable Index User options and variables.
Concept Index An item for each concept.

Detailed Node Listing

Configuring tramp for use

Using tramp
Filename Syntax tramp filename conventions.
Alternative Syntax URL-like filename syntax.
Filename completion Filename completion.
Ad-hoc multi-hops Declaring multiple hops in the file name.
Remote processes Integration with other Emacs packages.
Cleanup remote connections Cleanup remote connections.
How file names, directories and localnames are mangled and managed
Localname deconstruction Breaking a localname into its components.
External packages Integration with external Lisp packages.

Copyright © 1999–2013 Free Software Foundation, Inc.

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, with the Front-Cover texts being “A GNU Manual”, and with the Back-Cover Texts as in (a) below. A copy of the license is included in the section entitled “GNU Free Documentation License”.

(a) The FSF's Back-Cover Text is: “You have the freedom to copy and modify this GNU manual.”