TRAMP は `Transparent Remote (file) Access, Multiple Protocol' の略称です。このパッケージは ange-ftp や EFS のような リモートファイルの編集機能を提供します。
ange-ftp と異なるのはファイルの転送方法です。ange-ftp は、ローカル
ホストとリモートホスト間のファイル転送に FTP を使用します。しかし、
TRAMP は rsh と rcp、あるいは他の同じような
プログラム、例えば ssh や scpを使用します。
これは TRAMP のマニュアルのバージョン 2.10 で、最後に更新された のは 2001 年 12 月 11 日 (火)です。
[訳注: 日本語訳のバージョンは $Revision: 2.3 $で、最終更新日時は 2002 年 1 月 15 日 (Tue) です。]
このドキュメントの最新バージョンは web サイト http://tramp.sourceforge.net/ にあります。
このマニュアルには 日本語訳が存在します。
[訳注: そう、あなたが読んでいる、これが日本語訳です :-)]
最新の TRAMP は http://tramp.sourceforge.net/download にあります。詳細は Obtaining TRAMP を参照してください。 CVS サーバーについての説明もあります。
また、 SourceForge Project Page にも TRAMP の情報があります。
TRAMPのためのメーリングリスト tramp-devel@lists.sourceforge.net が存在します。アーカイブは通常の SourceForge アーカイブと同じく、 http://www.mail-archive.com/emacs-rcp@ls6.cs.uni-dortmund.de/ にあります。
エンドユーザー向け:
開発者向け:
--- 詳細なノードの一覧 ---
TRAMP の設定
TRAMP の使い方
リモートバージョンコントロールの内部動作
その他バージョン管理システムに関係する事
ファイル名、ディレクトリ、パス名がどのように変換され(mangled)、管理されるか
[訳注: This is an unofficial translation of the TRAMP copyright into Japanese. It is not legally valid. Only the original English text is the legal one. 以下の日本語の配布条件は非公式なものであり、法的に有効な配布 条件はオリジナル(英語)のものだけです。配布条件の日本語訳は、 ftp://ftp.sra.co.jp/pub/gnu/local-fix/GPL2-j/gpl.text.gz を参考にさせていただきました。]
Copyright (C) 1998, 1999, 2000 Free Software Foundation, Inc.
tramp.el はフリーソフトウェアです。あなたは、Free Software Foundation が公表したGNU 一般公有使用許諾の「バージョン2」或いはそれ以降の各バージョ ンの中からいずれかを選択し、そのバージョンが定める条項に従って本プログラム を再頒布または変更することができます。
tramp.el は有用とは思いますが、頒布にあたっては、市場性及び特定目的適合 性についての暗黙の保証を含めて、いかなる保証も行ないません。詳細については GNU 一般公有使用許諾書をお読みください。
あなたは、GNU Emacs と一緒にGNU 一般公有使用許諾の写しを受け取ってい るはずです。そうでない場合は、Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA へ手紙を書いて ください。
[訳注: 以下がオリジナルの配布条件です。]
Copyright (C) 1998, 1999, 2000 Free Software Foundation, Inc.
tramp.el is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version.
tramp.el is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with GNU Emacs; see the file COPYING. If not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
TRAMP をインストールすると、リモートマシン上のファイルにローカル
ファイルと同じような感覚でアクセスできます。リモートファイルシステム
上のファイルの編集、バージョンコントロール、dired を透過的
に実行することができます。
リモートマシンへのアクセスには、rsh や rlogin、
telnet コマンド、あるいはこれらに類似した接続方法を使用
します。これらのコマンドは ASCII を通過させることが可能でなければ
なりませんが、8-bit クリーンである必要はありません。
このパッケージは別のマシンへの ssh 接続をサポートします。
これは、このパッケージのもっとも一般的な使い方のひとつです。特に
ftpアクセスが許可されていない場合にも、他のマシンへの
比較的セキュアなアクセスが可能となります。
TRAMP によって実行されるアクティビティのほとんどは、リモート ログインが可能で、端末上で実行できることだけを要求します。リモート ファイルにアクセスするために、TRAMP はファイルの内容を一時的 にローカルマシンに転送します。
TRAMP は、さまざまな方法でマシン間のファイル転送をおこないます。 転送方法は簡単に選択でき、あなたのニーズとマシン環境に応じて使い わける事ができます。
もっとも速い転送メソッドは、リモートファイルの転送パッケージ、たとえば
rcp、scp、rsync を使うものです。これらの
メソッドは、ファイルのコピーコマンドがリモートマシンのパスワードをたず
ねない場合にのみ有効です。
もし、リモートコピーメソッドが使えない場合のために、TRAMP は、
シェルを直接利用した符号化転送方法をサポートしています。この方法を使う
ためには、mimencode か uuencode がリモートマシン
上に存在しなければなりません。
上記の制限内であれば、TRAMP は非常にパワフルです。ただし、注意して おかなければならないのは、現在の TRAMP は、エンドユーザー向けの洗練 された製品とはほど遠い状態であるということです。もうしばらくの間は、時々 ちょっと困った事になったり、コードに問題があるかもしれないということを 念頭においておいてください。
すでに開発者が日々の作業に使う事ができる程度には安定しています。しかし、 インストールと設定を覚えるのは、専門用語のせいで若干難しいでしょう。
TRAMP は、まだアクティブに開発をしている最中です。したがって、どんな 些細な問題であっても、ぜひ TRAMP 開発者に報告してください。 See Bug Reports.
このセクションでは、TRAMP を使いリモートファイルにアクセスした時に、 舞台の裏側で何がおこっているかを説明します。
C-x C-f とタイプし、TRAMP のファイル名の一部を入力します。 それから、ファイル名の補完のために <TAB> を押します。これ がそのホストに対する初めての TRAMP の起動の場合、以下のような事 がおこります。
telnet HOST か rsh HOST -l USER あるいは、その他
のリモートホストへ接続するためのツールを起動します。これらのプロセスとの
コミュニケーションは Emacs のバッファを経由しておこなわれます。した
がって、リモートホストからの出力はこのバッファに出力されます。
telnet
の場合)。ログイン名は入力されたファイル名に含まれているので、TRAMP
はログイン名と改行を送信します。
rsh の場合です。telnet の場合はログ
イン名を送信した後に表示されます)。TRAMP はミニバッファにプロン
プトを表示し、パスワードまたはパスフレーズをたずねます。
パスワードかパスフレーズを入力すると、TRAMP はそれをリモートホスト に送信し、次に改行を送信します。
もし、TRAMP が、一定時間(たとえば一分)待っても、これらのメッセージを 発見することができなかったら、リモートシェルのプロンプトを発見できなかっ た旨のメッセージを出力し、リモートホストから送信されたメッセージを表示 します。
もし、TRAMP が「login failed」というメッセージを発見したら、それを 表示し、ログインを中止します。これで再びログインを試みることができます。
/bin/sh を起動します。これは、Bourne シェルと C
シェルでは文法が異なるためです。1
Bourne シェルが起動されたら、TRAMP は確実に動作する環境を準備するため にいくつかのコマンドを送信します。echo をオフにし、シェルプロンプトを設定 したり、その他いくつかの事をおこないます。
TRAMP は cd と ls コマンド、そして時々 globbing
された echo を実行します。これ以外に、ファイルが書き込み可能
かどうか、ディレクトリかどうか等を調べるために test が、しば
しば使用されます。オペレーションをおこなうために、すべてのコマンドの出
力はパースされます。
TRAMP がどのようにファイルの内容を転送するのかという説明は、上を見て ください。
インライン転送のために、TRAMP は mimencode -b /path/to/remote/file
のようなコマンドを実行し、出力がコミュニケーションのためのバッファに
蓄積されるまで待ちます。そして、ファイルの中身を作成するために、出力を
復号化します。
out-of-band 転送のために、TRAMP は
rcp user@host:/path/to/remote/file /tmp/tramp.4711 のような
コマンドを実行します。そして、ローカルな一時ファイル /tmp/tramp.4711
をバッファに読み込み、一時ファイルを削除します。
この説明で、TRAMP を使いファイルをオープンした時に舞台裏でおこっている 事をわかってもらえることを願っています。
TRAMP は、インターネット上でフリーに配布されています。最新版は ftp://ls6-ftp.cs.uni-dortmund.de/pub/src/emacs/tramp.tar.gz からダウンロード可能です。この中には、インストールに必要な TRAMP のすべてのドキュメントとソースコードが含まれています。
冒険家のために TRAMP は CVS からも入手可能です。CVS から入手した バージョンはソースコードの最新バージョンです。したがって、不完全な 機能や新たな問題をかかえているかもしれません。このバージョンは自分 の責任で使用してください。
TRAMP の最新の開発バージョンを CVS (cvs(1)を参照してください)
から入手するためには、以下のコマンドを実行してください(ボールドの文字を
入力してください):
TRAMP の最新の開発バージョンを CVS から入手する方法は、SourceForge
プロジェクトページ (http://sourceforge.net/projects/tramp/) で
一番上のナビゲーションバーにある CVS のリンクをクリックすれば見ることが
出来ます。もしくは以下の例に倣って下さい:
] cd ~/lisp ] cvs -d:pserver:anonymous@cvs.tramp.sourceforge.net:/cvsroot/tramp login (Logging in to anonymous@cvs.tramp.sourceforge.net) CVS password: (just hit RET here) ... ] cvs -z3 -d:pserver:anonymous@cvs.tramp.sourceforge.net:/cvsroot/tramp co tramp
これで、TRAMP の最新バージョンが含まれるディレクトリ ~/lisp/tramp
が作成されるずです。以下のコマンドを実行することにより、最新のバージョン
に更新することができます:
] cd ~/lisp/tramp ] cvs update -d
TRAMP の開発は 1998 年の 11月下旬に始まりました。その当時は、この
パッケージは `rssh.el' と呼ばれていました。ファイルにアクセスするため
のたったひとつのメソッドがあるだけで、ssh を使用しリモート
ホストにログインし、scp でファイルの内容を転送していました。
しばらくして、名前が `rcp.el' に変わり、今は TRAMP と呼ばれています。
これに伴い、リモートシェルを起動しファイルの内容を転送する多くのメソッド
が追加されました。また、VC サポートも追加されました。
もっとも最近の大きな機能追加は、2000年4月のマルチホップメソッドです。
TRAMP をインストールするのは比較的簡単です。すくなくとも、あなたの マシンを一から再構築するよりは。;)
真面目な話、インストール方法は非常にシンプルです。
もっとも簡単な方法は以下の通りです:
~/emacs/を決めます。そのディレクトリに
移動し、tarball を展開してください。~/emacs/tramp/ というディ
レクトリができているはずです。この中には、Lisp コードのための lisp
やドキュメントのための texi というサブディレクトリが含まれています。
make EMACS=emacs all # Emacs ユーザーの場合 make EMACS=xemacs all # XEmacs ユーザーの場合
~/.emacs に追加してください。
(add-to-list 'load-path "~/emacs/tramp/lisp/") (require 'tramp)
~/emacs/tramp/texi/dir というファイルを install-info
コマンド等を使って作成してください。そして、Info の検索パスに、この
ディレクトリを追加してください。
CCC Todo: explain how to use the install-info command. This
works differently in Debian than on other systems. How does one create
a dir file using install-info on Debian?
環境変数 INFOPATH が設定されている場合、ディレクトリ
~/emacs/tramp/texi/ を追加してください。そうでなければ、
このディレクトリを、以下のように Info-default-directory-list
へ追加してください:
(add-to-list 'Info-default-directory-list "~/emacs/tramp/texi/")XEmacs 21 ユーザーは、
Info-default-directory-list でなく
Info-directory-list を使ってください。
XEmacs ユーザーは、fsf-compat パッケージをインストールして
おかなければなりません。パッケージのインストール方法については、
Packages を参照してください。
(もし、このリンクがたどれない場合は、XEmacs のドキュメントを参照して
ください。
http://www.xemacs.org/Documentation/packageGuide.html、XEmacs サイト.)
TRAMP は(通常)インストールするだけで完全に機能します。初期状態では、
リモートホストへの接続に rsh と rcp プログラムを使用
するように設定されています。
ホストによっては、接続を確立するのに問題が起きることがあります。これは、 remote shell の振る舞いによるものです。この詳細については See Remote shell setup, を参照してください。
もし、リモートホストとの接続にこれらのコマンドを使用したくない場合は、 TRAMP のデフォルトの接続と転送メソッドを変更してください。リモート マシンに接続しファイルを転送するのに使うことのできる TRAMP のメソッド がいくつかあります (see Connection types)。
転送メソッドには二つの基本的なタイプがあり、それぞれに長所、短所が
あります。両者ともに、rsh や ssh、telnet
のようなリモートシェルにアクセスするプログラムを使用し、リモートマシン
に接続します。
このコネクションは、TRAMP がローカルマシンからリモートマシンへ透過的 にアクセスするために、さまざまなオペレーションをおこなうために使われます。 ファイルをオープンした時のメソッドが異なるだけです。
リモートファイルを読み込んだり、保存する時には、二つのマシン間でファイル
の内容を転送する必要があります。ファイルの内容は、マシンにログインしたの
と同じコネクションか、rcp や scp、rsync
などのリモートコピープログラムを使用した別のコネクションで転送されます。
前者は インラインメソッド、後者は 外部転送メソッドとよばれます。
外部転送メソッドの性能は、一般にインラインメソッドよりすぐれています。 インライン転送では、データの符号化、復号化をおこなう必要があるからです。
このルールの唯一の例外は、scp を使用する転送メソッドです。
これらのメソッドの実際のファイル転送の性能は高いのですが、転送開始時
の暗号化にかかわるネゴシエーションのオーバーヘッドがファイル転送の性能
を帳消しにします。
外部転送メソッドを使うためには、リモートコピーコマンドが対話的でない、 つまりコマンドがパスワードのためにプロンプトを出力しないことが必要です。 もし、パスワード入力なしのリモートコピーコマンドを使う事ができないので あれば、インラインメソッドを使う必要があります。
インラインメソッドの一種に、マルチホップメソッド があります。 このメソッドを使うと、いくつかのホップを使い、リモートホストへ接続 できます。これは、あなたがセキュアなネットワークの中にいて、要塞ホスト を経由して外部に接続する場合に便利です。
TRAMP のインラインメソッドは大変強力で、外部転送メソッドを使う事が できない状況でも動作します。インラインメソッドは、telnet 経由でリモート マシンに接続している時に動作する唯一のメソッドです(ホスト間でなく ユーザー 間のファイル転送を可能にする、ちょっと変わったメソッド もあります。以下を参照してください)。
これらのメソッドを使うためには、符号化、復号化のためのコマンドがリモート マシン上に存在しなければなりません。ローカルマシン上では、TRAMP は ファイルを復号化、符号化する Emacs の機能を使うか、外部コマンドを使用 します。
TRAMP は ファイル転送のために uuencode を使うことができます。
しかし、これはあまりお勧め できません。uuencode と
uudecode コマンドは標準化されていません。すくなくともいくつかの
マシン、AIX と IRIX では正しく動作しないでしょう。これらのシステム上では、
uuencode が動作しません(tramp-methods のドキュメントの
AIX に関する注意を見てください)。
まとめると、もし、mimencode を使い base64 で符号化されたデータ
を転送するのであれば、最近の Emacs の組み込みコマンドを使用するほうが
性能面で有利です。
rm -- rsh と mimencode
リモートホストに rsh で接続し、マシン間のファイル転送に
base64 符号化を使用します。
このメソッドを使うためには、metamail パッケージに含まれる
mimencode コマンドが必要です。このコマンドはリモートマシン
すべてにインストールされているわけではありません。
sm -- ssh と mimencode
リモートホストに ssh で接続し、マシン間のファイル転送に
base64 符号化を使用します。
よりセキュアな接続をおこなうために ssh パッケージを使用する
こと以外は、前のオプションと同じです。
このメソッドにはふたつのバリエーション、sm1 と sm2
が存在します。これらは ssh1 と ssh2 を明示的に
指定します。もし、これらが何か知らない場合は、このオプションを使う
必要はありません。
tm -- telnet と mimencode
リモートホストに telnet で接続し、マシン間のファイル転送に
base64 符号化を使用します。
このメソッドを使うためには、metamail パッケージに含まれる
mimencode が必要です。
ru -- rsh と uuencode
リモートホストに rsh で接続し、マシン間のファイル転送に
uuencode と uudecode を使用します。
su -- ssh と uuencode
リモートホストに ssh で接続し、マシン間のファイル転送に
uuencode と uudecode を使用します。
上で説明した、ssh と base64 オプションと同様に、
明示的に ssh のバージョンを選択するための su1 と su2
メソッドがあります。
このメソッドは、su プログラムを起動しません。su
を使うメソッドについては下を参照してください。
tu -- telnet と uuencode
リモートホストに telnet で接続し、マシン間のファイル転送に
uuencode と uudecode を使用します。
sum -- su と mimencode
このメソッドは、まったくリモートホストに接続しません。かわりに、
su プログラムを使い他のユーザーになり、ファイルを編集する
ことができます。ファイルの内容を転送するために base64 符号化を使用
します。
suu -- su と uuencode
sum と同様に su を使用し、他のユーザーとしてローカル
ホスト上のファイルを編集することができます。ファイルの内容を転送するため
に uudecode と uudecode を使用します。
sudm -- sudo と mimencode
このメソッドは、sum メソッドに似ていますが、違うユーザーになる
ために su でなく sudo を使用します。
そのユーザーでシェルを起動できるように、sudo が設定されていな
ければならないことに注意してください。ls と mimedecode
の起動の許可だけで十分であればよいのですが、そのように実装するのは簡単では
なく、まだ無理です。
sudu -- sudo と uuencode
このメソッドは、suu メソッドによく似ていますが、違うユーザー
になるために su でなく、sudo を使用します。
外部転送メソッドは複数のチャネルを使用します。オペレーションのために リモートシェルのコネクションを使い、ファイル転送には、外部プログラム を使います。
これは、インライン転送時の、ひとつのコネクションを使った多重化転送のため の符号化、復号化のオーバーヘッドを削減します。
外部転送メソッドを使いたい場合は、ファイルをコピーするための転送ユーティ リティが、パスワード入力なしで実行できなければなりません。
つまり、scp を使う場合や、使っている scp がコマンド
ラインでパスワードを受け付けるバージョンの場合には、ssh-agent
を使う必要があるということです。2
ssh 経由で rsync を使う場合も同様です。
もし、パスワード入力なしで scp を実行することができないが、
コネクションをセキュアにするために ssh を使いたい場合は、
ssh ベースのインラインメソッドを参照してください。
rcp -- rsh と rcp
このメソッドは rsh と rcp を使い、リモートマシン
に接続、ファイル転送をおこないます。おそらく最速のメソッドです。
scp -- ssh と scp
リモートホストへの接続のための ssh や、マシン間のファイル転送
のための scp は、リモートマシンへのセキュアな接続とファイル
アクセスのためには最良のメソッドです。
このオプションの性能も優れています。しかし、小さいファイルのオープン、
クローズを頻繁に繰り返す場合はインラインメソッドより遅くなります。
scpセッション開始時の暗号化のためのハンドシェークのコストは、
符号化、復号化をおこなわない利点を帳消しにします。
rsync -- ssh と rsync
リモートホストにセキュアに接続するために ssh コマンドを、
ファイル転送のために rsync を使うのが、scp
メソッドの特徴です。
両側のホスト上に存在するファイルを転送する場合、rsync は
scp より高性能です。この利点は、ファイルが片側のホストに
しかない場合には失なわれます。
リモートシステムへ書き込む場合、rsync ベースのメソッドは
rcp ベースのメソッドよりかなり速いでしょう。しかし、ローカル
マシンのファイルを読み込む場合は、直接コピーするより速くありません。
scpx -- ssh と scp
想像通り、このメソッドは scp とよく似ています。scp が
リモートホスト上で通常の対話的シェルを起動するのに対して、このオプション
はコネクションをオープンするために ssh -t HOST -l user /bin/sh
を使います。このオプションは、通常のログインシェルがログイン時にいくつか
の質問をおこなうように設定されている場合に役に立ちます。このメソッドは
これらの質問を避け、TRAMP と一緒に動作するより標準的、あるいは非標準的
なログインシェルを起動します。
これまでに説明したメソッドでは不十分な事があります。シンプルなメソッドを 使ってリモートホストに接続できないことがあります。たとえば、セキュアな ネットワークの中にいる場合、外部に接続する前にまず要塞ホストにログイン しなければならないでしょう。もちろん、ターゲットホストは要塞ホストも要求 します。マルチホップのファイル名のフォーマットは、通常の TRAMP の メソッドとすこし異なります。
マルチホップのファイル名は、メソッド名、ホップ数、リモートホスト上の パス名を指定します。メソッドは、インラインコネクションでどのように ファイルが転送されるかを指定します。以下のふたつのマルチホップメソッド が存在します。
multi -- mimencode を使用した base64 符号化
ファイルは base64 符号化されたコネクションを使い転送されます。
符号化と復号化のために、mimencode プログラムを使用します。
しかし、ローカルホスト上では、可能なら Emacs の内部実装を使用します。
multiu -- コマンド uuencode と uudecode を使用する
ファイルは、`uu' 符号化(encoding)を使用したコネクションを使い転送され
ます。符号化と復号化のために、uuencode と uudecode
プログラムを使用します。しかし、ローカルホスト上では、可能なら復号化の
ために lisp 実装を使います。
それぞれのホップは ホップメソッド名、ユーザー名、ホスト名で構成 されます。以下のホップメソッドが(今、現在)存在します。
telnet
ホストへの接続によく知られた telnet プログラムを使用します。
ユーザー名とホスト名はファイル名の中に含まれ、パスワードをたずねられます。
rsh
ホストへの接続に rsh を使用します。rsh がパスワード
をたずねる時以外は、パスワードを入力する必要はありません。
ssh
このメソッドはホストへの接続のために ssh を使用します。パスワード
かパスフレーズを入力する必要があります。
su
このメソッドは他のホストへまったくアクセスしません。そのかわり、今いる
ホスト上で他のユーザーになることができます。これは、root としてファイル
を編集したいが、リモートホストはリモートからの root のログインを許可して
いない場合に役に立ちます。このような場合、一般ユーザーでのリモートホスト
への接続に telnet、rsh あるいは ssh を使う
ことができます。それから、root になるために su ホップを使います。
su は一連のシークエンス中の最後のホップである必要はありません。
必要であればホップ中のどこででも使うことができます。
su ホップと一緒にユーザーとホスト両方を指定しなければなりません。
しかしながら、ホスト名は無視されユーザー名だけが使用されます。
sudo
これは su ホップに似ています。違うユーザーになるために
su でなく sudo を使用する点が異なります。
ssh を用いてポートフォワードをしたい場合や、標準的でないポートを
使用しなければならない場合があるかもしれません。そのような場合には、
ホスト名ごとに異なるポート番号を指定した記述を ~/.ssh/config に
書き込むことで実現できます。しかしながら、multi-hop メソッドを使えば
それは Tramp の枠内で実現することもできます。例えば:
(add-to-list 'tramp-multi-connection-function-alist
'("sshf" tramp-multi-connect-rlogin "ssh %h -l %u -p 4400%n"))
とすれば、 sshf ホップを用いて、標準的なポートの変わりに 4400 番
ポートへ繋ぐことができます。
普段よく使う適切な転送メソッドを選択するには、変数 tramp-default-method
を設定しなければなりません。この変数には TRAMP ファイルパスにメソッドが
指定されなかった時に使用されるデフォルトのメソッドを設定します。
例えば:
(setq tramp-default-method "scp")
一般的には、インライン転送メソッドよりは外部転送メソッドを選ぶべきです。 外部転送メソッドはインラインより高性能です。しかし、外部転送メソッドは、 パスワード入力なしでログインできないリモートマシンがたくさんある場合は 役に立ちません。
See Inline methods. See External transfer methods. See Multi-hop Methods.
転送メソッドの選択をする時に他に考慮すべき事は、それらを使う環境と、 特にインターネット上で使う場合あなたの選択したメソッドのセキュリティ との関係です。
rsh と telnet メソッドは、リモートマシンにログイン
する時に、パスワードをプレインテキストで送信します。ファイル転送も同じ
方法でおこなうので、他もマシンからファイルの内容を簡単に読むことができます。
インターネットからアクセス可能なリモートシステムに接続する必要がある場合、
接続に ssh ベースのメソッドを使用することを真剣に考えるべきです。
このメソッドは、高いレベルのセキュリティを提供し、誰かがパスワードを入手
したり、編集しているファイルの内容を読んだりすることを困難にします。
事前に定義されたメソッドだけでは不十分な場合に、それを変更するための
tramp-methods という変数があります。
変更が必要になった時のために、この変数の Lisp ドキュメントについて述べて おきます。ドキュメントは C-h v tramp-methods <RET> で参照する ことができます。
TRAMP はリモートホスト上のいくつかのプログラム、ls、
test、find そして cat に依存しています。
これらのツールにくわえ、コネクションメソッドのためにいくつかのツールが 必要です。詳細は Inline methods と External transfer methods を参照してください。
いくつかの他のツール、perl (あるいは perl5) と
grep が存在すればそれらも使用されます。これは、性能と
リモートファイルアクセスの正確さの向上のためです。
TRAMP はリモートマシンに接続した時に、使用可能プログラムを検索します。 変数 tramp-remote-path は、リモートマシン上で検索されるディレクトリ を制御します。
デフォルトで多くのマシンにとって適切なパスが設定されています。しかし ながら、ローカル(あるいはリモート)システムの管理者が、必要なツールを へんぴなディレクトリにインストールしているかもしれません。
このような場合でも TRAMP を使う事ができます。単に、必要なディレクトリ
をリモートパスに追加するコードを .emacs に書くだけです。これで
接続時に TRAMP により、追加したディレクトリが検索されプログラムが
発見されます。
リモートサーチパスにディレクトリを追加するためには、以下のような
コードを使ってください:
(require 'tramp) ; TRAMP を最初にロードして
; おかなればならない
; perl は "/usr/local/perl" にあります
(add-to-list 'tramp-remote-path "/usr/local/perl")
この問題を追求するために、いくつかの戦略が考えられます。一つは、TRAMP がすべての可能な状況に対応できるようにすることです。これは消耗戦です。 何故なら 全ての 状況を扱うことは不可能だからです。別の手として、 TRAMP の期待通りに振る舞うように、あなたにリモートホストの設定をして いただくということも出来ます。しかしこれは不便かもしれません。何故なら TRAMP を使い始めるより先に、シェルの設定に多くの労力を割く必要がある のですから。
そのことから、このパッケージではそれらを組み合わせた方法をとります。
いくつかのありふれた設定については理解しようとしてくれて、あなたには
本当に特異な設定だけを避けるように求めます。例えば、リモートホスト上で
あるプログラムを見つけるためには、ディレクトリの一覧を調べます。
そしてまた、ファイルが存在するかをどうか調べる方法というのも明らかでは
ないので、いくつかの異なる可能性を試してくれます。
(あるホストとシェルにおいては、test -e コマンドがその役目を果たす。
別のホスト、シェルに対してはシェルの組み込みコマンドは働かないが、
/usr/bin/test -e や /bin/test -e ならうまく働く。
そしてさらに別のホストでは ls -d がその方法として働く。)
以下では、TRAMP が取り扱ってくれない、つまりあなたが正しく設定する必要 のあるいくつかの事柄について述べます。
shell-prompt-pattern
リモートホストにログインした後、TRAMP がリモートシェルに命令を送れる
ようになる前に、リモートシェルのセットアップが終了するのを待つ必要があり
ます。シェルプロンプトを認識する為に、変数 shell-prompt-pattern
をリモートホストのシェルプロンプトを認識出来るように設定しておく必要が
あります。
tset とその他の質問
シェルの起動スクリプトから tset プログラムを呼び出し、
シェルの端末の種類を尋ねるようにしている場合があります。たぶん
シェルによってはその他の質問を起動時にしてくる場合もあるでしょう。
TRAMP はこれらの質問に答える方法を知りません。
(将来のバージョンでこれらの質問に TRAMP が答えられるようにする
ことが計画されていますが、期待しないでください。)
したがってあなたは、シェルが TRAMP から呼び出されたときに何の質問も
しないように面倒を見なければなりません。そのためには、環境変数
TERM を調べて下さい。それは接続時に dumb に設定されます。
変数 tramp-terminal-type によりこの dumb の値を変更する
ことができます。
TRAMP をインストールすると、TRAMP は完全に透過的に動作します。 ログイン可能なリモートマシン上のファイルに、あたかもローカルファイル のようにアクセスすることができます。
TRAMP では、formalized シンタックスを使いファイルを指定します。これは、
EFS と ange-ftp パッケージのシンタックスに似ています。
リモートマシン<マシン>上のファイル<パス>にアクセスするためには、
ファイル名 /[<マシン>]<パス>を指定してください。(角括弧は
ファイル名の一部です。)これで、<マシン>に接続し、デフォルトメソッド
を使用しファイルが転送されます。See Default Method.
TRAMP のファイル名の例をいくつかお見せしましょう:
/[melancholia].emacs
melancholia 上のホームディレクトリにある .emacsを
編集します。
/[melancholia.danann.net].emacs
/./melancholia:~/.emacs
~ は、ローカルの場合と
同様に、リモートマシン上のホームディレクトリに展開されます。
/[melancholia]~daniel/.emacs
melancholia 上のユーザー daniel のホームディレクトリ
にあるファイル .emacs を編集します。~<ユーザー> 構文は
リモートマシン上のユーザーのホームディレクトリに展開されます。
/[melancholia]/etc/squid.conf
melancholia 上のファイル /etc/squid.conf を編集
します。
違う名前を使うように指定しない限り、TRAMP は現在のローカルなユーザ名 をログインのためのリモートユーザー名として使います。もし、違うユーザーで ログインする必要がある場合は、ファイル名の一部としてユーザー名を指定する ことができます。
指定したユーザーでリモートマシンにログインする必要がある場合、
/[<ユーザー>@<マシン>]/パス/ファイル というシンタックスを
使用してください。つまり、ユーザー daniel として melancholia
に接続しホームディレクトリの .emacs を編集する場合、
/[daniel@melancholia].emacs を指定すればよいのです。
CCC: The second @file was r@...: - was there a missing initial
slash? I've added the initial slash. Also you might want to include a
remark about the trailing colon: without a method, it's
/./user@host: (one colon), but with a method it's
/./@meth:user@host: (two colons).
ファイル名の一部として、他のファイル転送メソッド(see Default Method)
を指定することもできます。これは、最初の /[ を、
/[<メソッド>/ でおきかえることで可能になります。(最後のスラッシュ
に注意！) ユーザー、マシン、ファイルの指定は今までと同じです。
マシン melancholia に daniel として接続し、ファイル転送に
su メソッドを使い、ホームディレクトリの .emacs を編集する
ためには、ファイル名 /[su/daniel@melancholia].emacs を指定して
ください。
マルチホップファイル名のシンタックスは、当然のことながら、他の TRAMP のファイル名と若干異なります。以下に、マルチホップファイル名の例をあげます:
/[multi/rsh:out@gate/telnet:kai@real.host]/path/to.file
これは非常に重要なので、ひとつひとつ説明しましょう。ファイル名は
スラッシュと角括弧で区切られた 3 つのパーツで構成されています。
最初のパート /[multi はメソッドの指定です。二番目のパートは
rsh:out@gate/telnet:kai@real.host でホップを指定します。
(そうです、二番目のパートはもっと多くのスラッシュを含むこともあります。
これがこのファイル名が二つ以上のコロンを含む理由です。)最後のパートは
/path/to.file で、リモートホスト上のファイル名を指定します。
最初と最後のパートは明白でしょう。Multi-hop Methodsに指定可能 なメソッドの一覧があります。
二番目のパートは、再びコンポーネントに分割されます。これはホップと
よばれます。上記のファイル名には、二つのホップ、
rsh:out@gate と telnet:kai@real.host が含まれています。
それぞれのホップは、再び(3つの)コンポーネント、 ホップメソッド、ユーザー名、ホスト名に分割されます。 二番目、三番目のコンポーネントの意味は明白です。ホップメソッドは、 このホップでどのようなプログラムを使うかを意味しています。
最初のホップ rsh:out@gate は、ホスト gate にユーザー
out としてログインするために rsh を使うという意味です。
二番目のホップ telnet:kai@real.host は、このホストからホスト
real.host にユーザー kaiでログインするために telnet
を使うという意味です。
See Multi-hop Methods. ここにホップメソッドの一覧があります。 変数 tramp-multi-connection-function-alist には、選択可能なホップ メソッドのリストとそれらをどのように実行するかという情報が含まれています。 あなたが作ったメソッドをこの変数に追加してください。
TRAMP は dired 上でも透過的に動作します。この強力なファイル管理 ツールを使い、インターネットを経由しアクセス可能なすべてのマシン上の ファイルを管理できます。
TRAMP ではリモートマシン上のファイル名の補完も可能です。しかし、 現段階ではユーザー名とマシン名の補完はできません。
ファイル名の補完にはリモートマシンからファイルの一覧を取得する必要が あるので、時々、非常に時間がかかる事があります。TRAMP には、ディレ クトリ一覧の結果をキャッシュする仕組みがまだないので、二度目のファイル 名補完の時も性能は変わりません。
ディレクトリツリーをブラウズしたい場合は、今のところファイル名の補完 より dired を使うほうが良いでしょう。dired は自身でキャッシュの仕組を もっているので、ファイル一覧を一度しか取得しません。
TRAMP のバグや問題は、開発チームによってアクティブに解決されています。 仕様に関するリクエストや提案も歓迎します。
TRAMP メーリングリストは、TRAMP の情報を入手したり、問題の解決や、 一般的な議論、そしてこのパッケージに関係する話題へのアドバイスに最適 の場所です。
メーリングリストは tramp-devel@lists.sourceforge.net です。 このアドレスにメッセージをを送るとすべての講読者に届きます。 これは講読のリクエストを送信するためのアドレスでは ありません。
メーリングリストを講読するためのヘルプを入手するには、サブジェクトに
help と書いたメールを管理用のアドレス
tramp-devel-request@lists.sourceforge.net に送信してください。
TRAMP のバグ報告をする場合には、M-x tramp-bug を実行してください。 これは、あなたのシステムの詳細や TRAMP のバージョン情報を含むバッファ を自動的に生成します。
バグ報告を提出する時には、問題を再現する手順、リモートマシンの設定、 もし存在するのであれば特殊な条件を、しつこいぐらい詳細に記述してく ださい。もし可能なら、簡単な再現手順も記述してください。
もし、問題を再現するための簡単なテストケースがわかれば、それをバグ 報告に含めてください。これにより、開発チームがバグを突き止め、修正 するのが容易になります。
TRAMP は ftp://ls6-ftp.cs.uni-dortmund.de/pub/src/emacs/tramp.tar.gz にあります。また、SourceForge プロジェクトページが http://sourceforge.net/projects/tramp にあります。
このパッケージは、Emacs 20 と Emacs 21 上で動作します。XEmacs 20 上では
問題があります。tramp.el のコメントを参照してください。Emacs 19
で試した人がいるのかどうかは知りません。
このパッケージは Unix 上で動作するように設計されています。そしてリモート 側も Unix 風のシステムであることを期待しています。しかし、NT Emacs 上で 動作させることに成功した人が何人かいるようです。
以下の URL には、Tramp を NT で使うための情報があります; Joe Stoy には情報の提供に対して深く感謝します: ftp://ftp.comlab.ox.ac.uk/tmp/Joe.Stoy/
上記はもっぱら古いバージョンの ssh へのパッチがおいてあります; Tom Roche の Web page にも説明があります: http://www4.ncsu.edu/~tlroche/plinkTramp.html
??? XEmacs の情報は正しいのでしょうか?
??? 誰か、NT Emacs 上で動かすための情報を教えてください。たぶん、ssh
関係の問題があるのではないかと思います。
すべての古いバージョンの TRAMP が XEmacs を正しくサポートしているわけで はありません。まず最初に、最新の TRAMP がインストールされているかどうか を確認してください。
もし最新のバージョンなら、EFS ハンドラーが実行されるための条件を
正確に調べてください。もし可能なら、ブレークポイントを efs-ftp-path
に設定して、バグ報告と一緒にスタックトレースを送ってください。これらの情報
があると、開発者が何が間違っているのかを発見することが容易になります。
リモートマシンにログインした時に、ls の出力が色付きになって
いませんか? もし、そうなら、それが原因です。
ls は、端末エミュレーターが色を変更するための ANSI
エスケープシークエンスを出力します。しかしながら、このエスケープ
シークエンスは TRAMP を混乱させます。
リモートマシン上の .bashrc、.profile あるいは同じような
設定ファイルに、--color=yes または --color=auto
が追加された設定の alias があるはずです。
この alias を削除し、新しくログインした時の ls の出力が
色付きで表示され ない ことを確認してください。もし、これでも
ファイル名の補完が正常に動作しない場合は、TRAMP 開発者にバグ報告
をしてください。
TRAMP はいくつかのオペレーションで globbing を使用します。(globbing とは、`*.c' のようなワイルドカード展開のためにシェルを使うことです) これは、たくさんのファイルが存在するディレクトリでは長いコマンドライン を作ります。いくつかのシェルでは長いコマンドラインをけずりとったり、 あるいは globbing 自身を処理できません。
リモートホスト側に巨大なディレクトリがある場合は、
ls -d * ..?* > /dev/null のようなコマンドを実行し、ハングするか
どうかを確認してください。注意する必要があるのは、最初に正しいシェル、
/bin/sh、ksh あるいは bash、つまり tilde の
展開をサポートするシェルから試すべきだという事です。
TRAMP は、リモートシステムが Unix 風のシステムである事を前提にして います。また、ローカルシステムも Unix 風のシステムのほうが望ましいで しょう。しかし、すこし修正すれば、TRAMP は NT 上でも動作するはずです。
以下のコードを、~/.emacs に追加してください。これで、リモート
ホストに対する読み書きの後に、Emacs が beep 音をならしてくれます。
(defadvice tramp-handle-write-region (after tramp-write-beep-advice activate) " make tramp beep after writing a file." (interactive) (beep)) (defadvice tramp-handle-do-copy-or-rename-file (after tramp-copy-beep-advice activate) " make tramp beep after copying a file." (interactive) (beep)) (defadvice tramp-handle-insert-file-contents (after tramp-copy-beep-advice activate) " make tramp beep after copying a file." " make tramp beep after copying a file." (interactive) (beep))
~/.sh_history というファイルが肥大し続けて
います。これは何ですか?
TRAMP はティルダ展開の為に、しばしばリモートホストで ksh を
起動します。たぶん ksh はデフォルトで履歴を保存します。TRAMP
は履歴の保存を停止しようと試みますが、あなたが手助けをする必要がある
かもしれません。例えば、あなたの .kshrc にこれを入れてください:
if [ -f $HOME/.sh_history ] ; then
/bin/rm $HOME/.sh_history
fi
if [ "${HISTFILE-unset}" != "unset" ] ; then
unset HISTFILE
fi
if [ "${HISTSIZE-unset}" != "unset" ] ; then
unset HISTSIZE
fi
EFS や ange-ftp と異なり、TRAMP は、リモートマシン上のシェルを実行 します。したがって、TRAMP を使いアクセスしたファイルのバージョン 管理をおこなう事ができます。
バージョン管理をおこなうバイナリが、リモートマシンにインストールされて いなければなりません。そして、tramp-remote-path で指定された ディレクトリに置かれて、アクセス可能でなければなりません。
バージョン管理システムの透過的な統合は、TRAMP のもっとも価値のある 機能のひとつです。しかし、まだ完全にはほど遠い状態です。システムの透過 性を向上させるための作業が続けられています。
VC パッケージは、ディスク上のマスターファイルの存在をもとに、指定された ファイルがバージョン管理システムの管理下にあるかどうかを判断します。 これらのファイルのテストは、標準的な TRAMP の仕組みを使いリモート マシン上で実行されます。
バージョン管理システムのコマンドの実行を横取りすることのできる VC 用の
hook は存在しません。call-process の仕組みを使い、
関数呼び出しが発生します。関数は shell-command より、若干
効率的ですが、リモートでコマンドを実行するための hook は用意されていません。
とりあえず動作させるために、関数 vc-do-command と
vc-simple-command に、TRAMP を経由しアクセスされたファイルへの
オペレーションのためのリクエストを横取することが通知されます。
リモートファイルの場合、ローカルマシンと同じ機能を提供するために、
shell-command インターフェースが、いくつかのラッパーコードと
共に使用されます。
今のところ、リモートマシン上のファイルの mtime を取得する移植性の高い
方法は存在しません。vc-workfile-unchanged-p 関数に、リモート
ファイルのために TRAMP の関数の呼び出しが通知されます。
tramp-vc-workfile-unchanged-p 関数は、作業ファイルとバージョン
管理マスタファイルの変更点を調べるために VC の diff 機能を使用します。
これを実現するためには、リモートでのシェルコマンドが実行可能でなれば なりません。この処理は、ローカルファイルで使われる mtime の取得より 重い処理です。残念ながら、移植性の高い解決方法が見つかるまでは、リモート バージョン管理のコストはこのままでしょう。
デフォルトでは、VC はリモートファイルをチェックし、リポジトリからチェック
アウトされたファイルがある場合は、チェックアウトをおこないません。この問題
を解決するために、関数 vc-checkout は TRAMP ファイルを区別し、
バージョン管理をおこなうことを可能にします。
こまかな実装の詳細、その他。
Emacs は、任意のユーザー ID の値とログイン名をマッピングするのと同様に、
現在のユーザーのログイン名をかえす関数 user-full-name を用意して
います。VC は、いくつかの状況で、ワークファイルのオーナーの uid からログ
イン名へのマップ機能を使用します。
これは、リモートシステムが異なるログインセットを持つ場合には、あきらか に正しく動作しません。したがって、uid に対応するログイン名の決定をリモート マシンにおこなわせる必要があります。
残念ながら、NIS、NIS+そして NetInfo のような、
分散管理システム を使う場合、シンプルで、信頼性があり、移植性の高い
マッピングの方法は存在しません。
ありがたい事に、uid からログイン名へのマッピングに依存する VC のコードは、
関数 vc-file-owner ひとつだけです。この関数は、ファイルのオーナー
のログイン名を文字列として返します。
ログイン名を決定するために、この関数に、リモートマシン上の ls
の出力を使用することが通知されます。uid からログイン名のマッピングを、
私よりそれらについて良く知っているはずのリモートシステムに委譲します。
VC は、どのリリースのバージョン管理システムのバイナリを使っているかを
知る必要があります。これは、VC がサポートしているすべての機能を、古い
バージョンのrcs(1)、cvs(1)、sccs(1)が提供
しているわけでは無いからです。
VC のデフォルトの実装では、最初に必要になった時に、この値を決定します。 これは、毎回、必要になった時に、プロセスを実行し、その出力をパースする オーバーヘッドをさけるためです。
いかし、リモートのバージョン管理システムの事が関係してくると、人生は それほど簡単ではありません。リモートマシンはそれぞれ、異なるバージョン のバージョン管理ツールをもっています。これが困難な間は、存在しない機能 が、リモートで使用されないことを保証する必要があります。
この問題を解決するために、現在の TRAMP は、バージョン管理ツールの バージョン番号を TRAMP バッファ毎にローカルな変数にし、新しい ファイルを開くたびにVC にこの値を決定させるという力ずくのアプローチ を採用しています。
これはあきらかに性能に影響します。ありがたいことに、VC によっておこなわれる ほとんどの処理は、実際にはリモートのバージョンを知ることを必要としません。 したがって、それほど問題になりません。
最終的には、これらの変数は TRAMP によってシステム毎に調べられ、 その結果は性能を改善するためにキャッシュされるようになるでしょう。
TRAMP のファイル名は普通のファイル名とはあきらかに異なっています。
したがって、lisp の関数 file-name-directory と
file-name-nondirectory は、TRAMP パッケージによってオーバー
ライドされています。
関数の置き換えはシンプルかつ適切な方法です。ファイル名は分解され、 リモートパスに対してオリジナルのハンドラーがよばれます。そして、 その結果をもとに TRAMP パス名が再構成されます。
これにより、TRAMP パスの情報を扱う場合も、プラットホーム固有の オリジナルハンドラーのハックは有効です。
TRAMP の設計上の理由で、符号化と復号化をおこなうプログラムは標準
入力から読み込み、標準出力に書き込む必要があります。いくつかのシステム
では、uudecode -o - で標準入力から読み込み、復号化されたファイル
を標準出力に書き込みます。他のシステムでは、uudecode -p が同じ
動作をします。しかし、いくつかのシステムの uudecode の実装では、これら
のことが全くできません。これらの uudecode の実装に、標準出力に書き込む
ために適切なパラメータを渡して呼ぶことは不可能です。
もちろん、これを回避する事は可能です。テンポラリファイル名を追加する
ために begin foo 644 行を書きかえれば、uudecode を呼ぶこと
ができます。そしてテンポラリファイルを表示し削除します。
しかし、この方法はあまりにも信頼性が低いため、いくつかのシステムでは uuencode メソッドを使用できないままにしておく事にしました。
これは、XEmacs 20 に存在しないマクロ with-timeout を使っている
からです。私は、エミュレーションのためのマクロを TRAMP に追加する
ことに、あまり乗り気ではありません。しかし、XEmacs 20 ユーザーの誰かが
積極的に実装とテストをしたいと考えているのであれば、私かメーリングリスト
に連絡してください。
ログインシェルが
exec /bin/sh を正しいコマンドとして認識せずに /bin/sh
の起動に失敗することがあるかもしれません。たぶん、あなたは Scheme シェル
scsh を使っているのでしょう...
PuTTY's pscp では
コマンドラインでパスワードを指定できます。