# TRAMP User Manual

Node:Top, Next:Copying, Previous:(dir), Up:(dir)

## TRAMP ユーザーマニュアル

このプロジェクトは に間借りさせて頂いています。

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/ にあります。

- Copying: TRAMP の配布条件
- Overview: TRAMP で可能な事、不可能な事

  エンドユーザー向け:

- Obtaining TRAMP: TRAMP の入手方法
- History: TRAMP の歴史
- Installation: TRAMP のインストール
- Configuration: TRAMP の設定
- Usage: TRAMP の使い方
- Bug Reports: バグや問題の報告
- Frequently Asked Questions: よくある質問とその答

  開発者向け:

- Version Control: リモートバージョンコントロールの内部動作
- Files directories and paths: ファイル名、ディレクトリ、パス名がどのように 変換され(mangled)、管理されるか
- Issues:

  --- 詳細なノードの一覧 ---

  TRAMP の設定

- Connection types: リモートマシンへの接続の種類
- Inline methods: インラインメソッド
- External transfer methods: 外部転送メソッド
- Multi-hop Methods: マルチホップを使用したリモートホストへの接続
- Default Method: デフォルトのメソッドの選択
- Customizing Methods: 非標準のメソッドを使う
- Remote Programs: リモートマシン上で TRAMP がプログラムを発見、使用する方法
- Remote shell setup:

  TRAMP の使い方

- Filename Syntax: TRAMP ファイル名のきまり
- Multi-hop filename syntax: マルチホップファイル名のきまり
- Dired: Dired とファイル名の補完

  リモートバージョンコントロールの内部動作

- Version Controlled Files: ファイルがバージョン管理されているかどうかの判断
- Remote Commands: リモートマシン上でのバージョン管理コマンドの実行
- Changed workfiles: 作業ファイルの変更の発見
- Checking out files: 作業ファイルのリポジトリからの取得
- Miscellaneous Version Control: その他バージョン管理システムに関係する事

  その他バージョン管理システムに関係する事

- Remote File Ownership: VC がワークファイルのオーナーを調べる方法
- Back-end Versions: VC が RCS のバージョンを調べる方法

  ファイル名、ディレクトリ、パス名がどのように変換され(mangled)、管理されるか

- Path deconstruction: コンポーネント中のパスの分解

Node:Copying, Next:Overview, Previous:Top, Up:Top

## TRAMP の配布条件

[訳注: 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.

Node:Overview, Next:Obtaining TRAMP, Previous:Copying, Up:Top

## TRAMP の概要

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 の起動の場合、以下のような事 がおこります。

- TRAMP は、他のホストへの接続が必要な事を認識します。それから `telnet HOST` か `rsh HOST -l USER` あるいは、その他 のリモートホストへ接続するためのツールを起動します。これらのプロセスとの コミュニケーションは Emacs のバッファを経由しておこなわれます。した がって、リモートホストからの出力はこのバッファに出力されます。
- リモートホストは、ログイン名のプロンプトを表示します(`telnet` の場合)。ログイン名は入力されたファイル名に含まれているので、TRAMP はログイン名と改行を送信します。
- リモートホストは、パスワードあるいはパスフレーズのプロンプトを表示 します(これは`rsh` の場合です。`telnet` の場合はログ イン名を送信した後に表示されます)。TRAMP はミニバッファにプロン プトを表示し、パスワードまたはパスフレーズをたずねます。

  パスワードかパスフレーズを入力すると、TRAMP はそれをリモートホスト に送信し、次に改行を送信します。

- TRAMP は、シェルプロンプトかログインに失敗した旨のメッセージを待ち ます。

  もし、TRAMP が、一定時間(たとえば一分)待っても、これらのメッセージを 発見することができなかったら、リモートシェルのプロンプトを発見できなかっ た旨のメッセージを出力し、リモートホストから送信されたメッセージを表示 します。

  もし、TRAMP が「login failed」というメッセージを発見したら、それを 表示し、ログインを中止します。これで再びログインを試みることができます。

- ログインに成功し、TRAMP がシェルプロンプトを発見したとします。ここで、 TRAMP は `/bin/sh` を起動します。これは、Bourne シェルと C シェルでは文法が異なるためです。1

  Bourne シェルが起動されたら、TRAMP は確実に動作する環境を準備するため にいくつかのコマンドを送信します。echo をオフにし、シェルプロンプトを設定 したり、その他いくつかの事をおこないます。

- さて、リモートシェルが起動されきちんと動作する状態になりました。ここで、 何がおこるはずだったか思いだしてください。リモートホスト上にどのような ファイルが存在するかを TRAMP が調べ、ファイル名を補完できるようになる ことです。

  TRAMP は `cd` と `ls` コマンド、そして時々 globbing された `echo` を実行します。これ以外に、ファイルが書き込み可能 かどうか、ディレクトリかどうか等を調べるために `test` が、しば しば使用されます。オペレーションをおこなうために、すべてのコマンドの出 力はパースされます。

- ファイル名の補完が完了し、`C-xC-f`と完全なファイル名を入力し、 `<RET>` を押したとしましょう。ファイルを編集するために、リモート ホストからローカルホストにファイルの内容を転送する時がようやくやって きました。

  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` をバッファに読み込み、一時ファイルを削除します。

- 今、あなたはバッファの内容を編集しています。しかし、幸運にも舞台裏で何が おこっているのかに気がつきません(このセクションを読むまでは、そうでしょう)。 作業が終り、バッファを保存するために `C-x C-s` を押します。
- 再び、TRAMP はファイルの内容をリモートホストにインラインか out-of-band メソッドで転送します。ここではファイルを読み時におこっている事と逆のこと がおこっています。

この説明で、TRAMP を使いファイルをオープンした時に舞台裏でおこっている 事をわかってもらえることを願っています。

Node:Obtaining TRAMP, Next:History, Previous:Overview, Up:Top

## 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

Node:History, Next:Installation, Previous:Obtaining TRAMP, Up:Top

## TRAMP の歴史

TRAMP の開発は 1998 年の 11月下旬に始まりました。その当時は、この パッケージは `rssh.el' と呼ばれていました。ファイルにアクセスするため のたったひとつのメソッドがあるだけで、`ssh` を使用しリモート ホストにログインし、`scp` でファイルの内容を転送していました。 しばらくして、名前が `rcp.el' に変わり、今は TRAMP と呼ばれています。 これに伴い、リモートシェルを起動しファイルの内容を転送する多くのメソッド が追加されました。また、VC サポートも追加されました。

もっとも最近の大きな機能追加は、2000年4月のマルチホップメソッドです。

Node:Installation, Next:Configuration, Previous:History, Up:Top

## TRAMP のインストール

TRAMP をインストールするのは比較的簡単です。すくなくとも、あなたの マシンを一から再構築するよりは。;)

真面目な話、インストール方法は非常にシンプルです。

もっとも簡単な方法は以下の通りです:

- ディレクトリ、たとえば `~/emacs/`を決めます。そのディレクトリに 移動し、tarball を展開してください。`~/emacs/tramp/` というディ レクトリができているはずです。この中には、Lisp コードのための `lisp` やドキュメントのための `texi` というサブディレクトリが含まれています。
- Lisp ディレクトリ内の全ファイルを byte-compile することもできます。Lisp ディレクトリで、以下のコマンドを実行してください:

      make EMACS=emacs all            # Emacs ユーザーの場合
      make EMACS=xemacs all           # XEmacs ユーザーの場合

- 新らしい Lisp のディレクトリと TRAMP パッケージを Emacs に認識させる ために、以下の行を `~/.emacs` に追加してください。

      (add-to-list 'load-path "~/emacs/tramp/lisp/")
      (require 'tramp)

- Info ドキュメントを読むことができるようにするためには、 `~/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 サイト.)

Node:Configuration, Next:Usage, Previous:Installation, Up:Top

## TRAMP の設定

TRAMP は(通常)インストールするだけで完全に機能します。初期状態では、 リモートホストへの接続に `rsh` と `rcp` プログラムを使用 するように設定されています。

ホストによっては、接続を確立するのに問題が起きることがあります。これは、 remote shell の振る舞いによるものです。この詳細については See Remote shell setup, を参照してください。

もし、リモートホストとの接続にこれらのコマンドを使用したくない場合は、 TRAMP のデフォルトの接続と転送メソッドを変更してください。リモート マシンに接続しファイルを転送するのに使うことのできる TRAMP のメソッド がいくつかあります (see Connection types)。

- Connection types: リモートマシンへの接続の種類
- Inline methods: インラインメソッド
- External transfer methods: 外部転送メソッド
- Multi-hop Methods: マルチホップを使用したリモートホストへの接続
- Default Method: デフォルトのメソッドの選択
- Customizing Methods: 非標準のメソッドを使う
- Remote Programs: リモートマシン上で TRAMP がプログラムを発見、使用する方法
- Remote shell setup:

Node:Connection types, Next:Inline methods, Previous:Configuration, Up:Configuration

### リモートマシンへの接続の種類

転送メソッドには二つの基本的なタイプがあり、それぞれに長所、短所が あります。両者ともに、`rsh` や `ssh`、`telnet` のようなリモートシェルにアクセスするプログラムを使用し、リモートマシン に接続します。

このコネクションは、TRAMP がローカルマシンからリモートマシンへ透過的 にアクセスするために、さまざまなオペレーションをおこなうために使われます。 ファイルをオープンした時のメソッドが異なるだけです。

リモートファイルを読み込んだり、保存する時には、二つのマシン間でファイル の内容を転送する必要があります。ファイルの内容は、マシンにログインしたの と同じコネクションか、`rcp` や `scp`、`rsync` などのリモートコピープログラムを使用した別のコネクションで転送されます。 前者は インラインメソッド、後者は 外部転送メソッドとよばれます。

外部転送メソッドの性能は、一般にインラインメソッドよりすぐれています。 インライン転送では、データの符号化、復号化をおこなう必要があるからです。

このルールの唯一の例外は、`scp` を使用する転送メソッドです。 これらのメソッドの実際のファイル転送の性能は高いのですが、転送開始時 の暗号化にかかわるネゴシエーションのオーバーヘッドがファイル転送の性能 を帳消しにします。

外部転送メソッドを使うためには、リモートコピーコマンドが対話的でない、 つまりコマンドがパスワードのためにプロンプトを出力しないことが必要です。 もし、パスワード入力なしのリモートコピーコマンドを使う事ができないので あれば、インラインメソッドを使う必要があります。

インラインメソッドの一種に、マルチホップメソッド があります。 このメソッドを使うと、いくつかのホップを使い、リモートホストへ接続 できます。これは、あなたがセキュアなネットワークの中にいて、要塞ホスト を経由して外部に接続する場合に便利です。

Node:Inline methods, Next:External transfer methods, Previous:Connection types, Up:Configuration

### インラインメソッド

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` を使用します。

Node:External transfer methods, Next:Multi-hop Methods, Previous:Inline methods, Up:Configuration

### 外部転送メソッド

外部転送メソッドは複数のチャネルを使用します。オペレーションのために リモートシェルのコネクションを使い、ファイル転送には、外部プログラム を使います。

これは、インライン転送時の、ひとつのコネクションを使った多重化転送のため の符号化、復号化のオーバーヘッドを削減します。

外部転送メソッドを使いたい場合は、ファイルをコピーするための転送ユーティ リティが、パスワード入力なしで実行できなければなりません。

つまり、`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 と一緒に動作するより標準的、あるいは非標準的 なログインシェルを起動します。

Node:Multi-hop Methods, Next:Default Method, Previous:External transfer methods, Up:Configuration

### 複数のホップを使いリモートホストに接続する

これまでに説明したメソッドでは不十分な事があります。シンプルなメソッドを 使ってリモートホストに接続できないことがあります。たとえば、セキュアな ネットワークの中にいる場合、外部に接続する前にまず要塞ホストにログイン しなければならないでしょう。もちろん、ターゲットホストは要塞ホストも要求 します。マルチホップのファイル名のフォーマットは、通常の 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 番 ポートへ繋ぐことができます。

Node:Default Method, Next:Customizing Methods, Previous:Multi-hop Methods, Up:Configuration

### デフォルトのメソッドの選択

普段よく使う適切な転送メソッドを選択するには、変数 tramp-default-method を設定しなければなりません。この変数には TRAMP ファイルパスにメソッドが 指定されなかった時に使用されるデフォルトのメソッドを設定します。 例えば:

    (setq tramp-default-method "scp")

一般的には、インライン転送メソッドよりは外部転送メソッドを選ぶべきです。 外部転送メソッドはインラインより高性能です。しかし、外部転送メソッドは、 パスワード入力なしでログインできないリモートマシンがたくさんある場合は 役に立ちません。

See Inline methods. See External transfer methods. See Multi-hop Methods.

転送メソッドの選択をする時に他に考慮すべき事は、それらを使う環境と、 特にインターネット上で使う場合あなたの選択したメソッドのセキュリティ との関係です。

`rsh` と `telnet` メソッドは、リモートマシンにログイン する時に、パスワードをプレインテキストで送信します。ファイル転送も同じ 方法でおこなうので、他もマシンからファイルの内容を簡単に読むことができます。

インターネットからアクセス可能なリモートシステムに接続する必要がある場合、 接続に `ssh` ベースのメソッドを使用することを真剣に考えるべきです。 このメソッドは、高いレベルのセキュリティを提供し、誰かがパスワードを入手 したり、編集しているファイルの内容を読んだりすることを困難にします。

Node:Customizing Methods, Next:Remote Programs, Previous:Default Method, Up:Configuration

### 非標準のメソッドを使う

事前に定義されたメソッドだけでは不十分な場合に、それを変更するための `tramp-methods` という変数があります。

変更が必要になった時のために、この変数の Lisp ドキュメントについて述べて おきます。ドキュメントは `C-h v tramp-methods <RET>` で参照する ことができます。

Node:Remote Programs, Next:Remote shell setup, Previous:Customizing Methods, Up:Configuration

### リモートマシン上で TRAMP がプログラムを発見、使用する方法

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")

Node:Remote shell setup, Previous:Remote Programs, Up:Configuration

### リモートシェルの設定のヒント

Overview の節で説明したように、TRAMP はリモートホストに接続し、 そこにあるシェルと対話します。もちろんログインする際にはシェルはその 初期化ファイルを実行します。例えばあなたの初期化ファイルがあなたのお母 さんの誕生日を入力させるようになっていたとしましょう; 当然 TRAMP はそのことを知らないので、そのホストへのログインに失敗します。

この問題を追求するために、いくつかの戦略が考えられます。一つは、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` の値を変更する ことができます。

Node:Usage, Next:Bug Reports, Previous:Configuration, Up:Top

## TRAMP の使い方

TRAMP をインストールすると、TRAMP は完全に透過的に動作します。 ログイン可能なリモートマシン上のファイルに、あたかもローカルファイル のようにアクセスすることができます。

TRAMP では、formalized シンタックスを使いファイルを指定します。これは、 `EFS` と `ange-ftp` パッケージのシンタックスに似ています。

- Filename Syntax: TRAMP ファイル名のきまり
- Multi-hop filename syntax: マルチホップファイル名のきまり
- Dired: Dired とファイル名の補完

Node:Filename Syntax, Next:Multi-hop filename syntax, Previous:Usage, Up:Usage

### TRAMP ファイル名のきまり

リモートマシン<マシン>上のファイル<パス>にアクセスするためには、 ファイル名 `/[<マシン>]<パス>`を指定してください。(角括弧は ファイル名の一部です。)これで、<マシン>に接続し、デフォルトメソッド を使用しファイルが転送されます。See Default Method.

TRAMP のファイル名の例をいくつかお見せしましょう:

`/[melancholia].emacs`
  マシン `melancholia` 上のホームディレクトリにある `.emacs`を 編集します。
`/[melancholia.danann.net].emacs`
  完全なホスト名(FQDN)を使い、上と同じファイルを編集します。
`/./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` を指定して ください。

Node:Multi-hop filename syntax, Next:Dired, Previous:Filename Syntax, Up:Usage

### マルチホップファイル名のきまり

マルチホップファイル名のシンタックスは、当然のことながら、他の 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 には、選択可能なホップ メソッドのリストとそれらをどのように実行するかという情報が含まれています。 あなたが作ったメソッドをこの変数に追加してください。

Node:Dired, Previous:Multi-hop filename syntax, Up:Usage

### Dired とファイル名の補完

TRAMP は dired 上でも透過的に動作します。この強力なファイル管理 ツールを使い、インターネットを経由しアクセス可能なすべてのマシン上の ファイルを管理できます。

TRAMP ではリモートマシン上のファイル名の補完も可能です。しかし、 現段階ではユーザー名とマシン名の補完はできません。

ファイル名の補完にはリモートマシンからファイルの一覧を取得する必要が あるので、時々、非常に時間がかかる事があります。TRAMP には、ディレ クトリ一覧の結果をキャッシュする仕組みがまだないので、二度目のファイル 名補完の時も性能は変わりません。

ディレクトリツリーをブラウズしたい場合は、今のところファイル名の補完 より dired を使うほうが良いでしょう。dired は自身でキャッシュの仕組を もっているので、ファイル一覧を一度しか取得しません。

Node:Bug Reports, Next:Frequently Asked Questions, Previous:Usage, Up:Top

## バグや問題の報告

TRAMP のバグや問題は、開発チームによってアクティブに解決されています。 仕様に関するリクエストや提案も歓迎します。

TRAMP メーリングリストは、TRAMP の情報を入手したり、問題の解決や、 一般的な議論、そしてこのパッケージに関係する話題へのアドバイスに最適 の場所です。

メーリングリストは tramp-devel@lists.sourceforge.net です。 このアドレスにメッセージをを送るとすべての講読者に届きます。 これは講読のリクエストを送信するためのアドレスでは ありません。

メーリングリストを講読するためのヘルプを入手するには、サブジェクトに `help` と書いたメールを管理用のアドレス tramp-devel-request@lists.sourceforge.net に送信してください。

TRAMP のバグ報告をする場合には、`M-x tramp-bug` を実行してください。 これは、あなたのシステムの詳細や TRAMP のバージョン情報を含むバッファ を自動的に生成します。

バグ報告を提出する時には、問題を再現する手順、リモートマシンの設定、 もし存在するのであれば特殊な条件を、しつこいぐらい詳細に記述してく ださい。もし可能なら、簡単な再現手順も記述してください。

もし、問題を再現するための簡単なテストケースがわかれば、それをバグ 報告に含めてください。これにより、開発チームがバグを突き止め、修正 するのが容易になります。

Node:Frequently Asked Questions, Next:Version Control, Previous:Bug Reports, Up:Top

## よくある質問とその答

- 最新の 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` 関係の問題があるのではないかと思います。

- XEmacs で EFS が起動されてしまいます

  すべての古いバージョンの TRAMP が XEmacs を正しくサポートしているわけで はありません。まず最初に、最新の TRAMP がインストールされているかどうか を確認してください。

  もし最新のバージョンなら、`EFS` ハンドラーが実行されるための条件を 正確に調べてください。もし可能なら、ブレークポイントを `efs-ftp-path` に設定して、バグ報告と一緒にスタックトレースを送ってください。これらの情報 があると、開発者が何が間違っているのかを発見することが容易になります。

- TRAMP を使うとファイル名の補完ができません

  リモートマシンにログインした時に、`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 はどのような種類のシステムで動作しますか

  TRAMP は、リモートシステムが Unix 風のシステムである事を前提にして います。また、ローカルシステムも Unix 風のシステムのほうが望ましいで しょう。しかし、すこし修正すれば、TRAMP は NT 上でも動作するはずです。

- TRAMP のファイル転送が完了した時に通知させるにはどうすればいいでしょうか?

  以下のコードを、`~/.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

Node:Version Control, Next:Files directories and paths, Previous:Frequently Asked Questions, Up:Top

## リモートバージョンコントロールの内部動作

EFS や ange-ftp と異なり、TRAMP は、リモートマシン上のシェルを実行 します。したがって、TRAMP を使いアクセスしたファイルのバージョン 管理をおこなう事ができます。

バージョン管理をおこなうバイナリが、リモートマシンにインストールされて いなければなりません。そして、tramp-remote-path で指定された ディレクトリに置かれて、アクセス可能でなければなりません。

バージョン管理システムの透過的な統合は、TRAMP のもっとも価値のある 機能のひとつです。しかし、まだ完全にはほど遠い状態です。システムの透過 性を向上させるための作業が続けられています。

- Version Controlled Files: ファイルがバージョン管理されているかどうかの判断
- Remote Commands: リモートマシン上でのバージョン管理コマンドの実行
- Changed workfiles: 作業ファイルの変更の発見
- Checking out files: 作業ファイルのリポジトリからの取得
- Miscellaneous Version Control: その他バージョン管理システムに関係する事

Node:Version Controlled Files, Next:Remote Commands, Previous:Version Control, Up:Version Control

### ファイルがバージョン管理されているかどうかの判断

VC パッケージは、ディスク上のマスターファイルの存在をもとに、指定された ファイルがバージョン管理システムの管理下にあるかどうかを判断します。 これらのファイルのテストは、標準的な TRAMP の仕組みを使いリモート マシン上で実行されます。

Node:Remote Commands, Next:Changed workfiles, Previous:Version Controlled Files, Up:Version Control

### リモートマシン上のバージョン管理コマンドの実行

バージョン管理システムのコマンドの実行を横取りすることのできる VC 用の hook は存在しません。`call-process` の仕組みを使い、 関数呼び出しが発生します。関数は `shell-command` より、若干 効率的ですが、リモートでコマンドを実行するための hook は用意されていません。

とりあえず動作させるために、関数 `vc-do-command` と `vc-simple-command` に、TRAMP を経由しアクセスされたファイルへの オペレーションのためのリクエストを横取することが通知されます。

リモートファイルの場合、ローカルマシンと同じ機能を提供するために、 `shell-command` インターフェースが、いくつかのラッパーコードと 共に使用されます。

Node:Changed workfiles, Next:Checking out files, Previous:Remote Commands, Up:Version Control

### 作業ファイルの変更の発見

今のところ、リモートマシン上のファイルの mtime を取得する移植性の高い 方法は存在しません。`vc-workfile-unchanged-p` 関数に、リモート ファイルのために TRAMP の関数の呼び出しが通知されます。

`tramp-vc-workfile-unchanged-p` 関数は、作業ファイルとバージョン 管理マスタファイルの変更点を調べるために VC の diff 機能を使用します。

これを実現するためには、リモートでのシェルコマンドが実行可能でなれば なりません。この処理は、ローカルファイルで使われる mtime の取得より 重い処理です。残念ながら、移植性の高い解決方法が見つかるまでは、リモート バージョン管理のコストはこのままでしょう。

Node:Checking out files, Next:Miscellaneous Version Control, Previous:Changed workfiles, Up:Version Control

### 作業ファイルのリポジトリからの取得

デフォルトでは、VC はリモートファイルをチェックし、リポジトリからチェック アウトされたファイルがある場合は、チェックアウトをおこないません。この問題 を解決するために、関数 `vc-checkout` は TRAMP ファイルを区別し、 バージョン管理をおこなうことを可能にします。

Node:Miscellaneous Version Control, Previous:Checking out files, Up:Version Control

### その他バージョン管理システムに関係する事

こまかな実装の詳細、その他。

- Remote File Ownership: VC がワークファイルのオーナーを調べる方法
- Back-end Versions: VC が RCS のバージョンを調べる方法

Node:Remote File Ownership, Next:Back-end Versions, Previous:Miscellaneous Version Control, Up:Miscellaneous Version Control

#### VC がワークファイルのオーナーを調べる方法

Emacs は、任意のユーザー ID の値とログイン名をマッピングするのと同様に、 現在のユーザーのログイン名をかえす関数 `user-full-name` を用意して います。VC は、いくつかの状況で、ワークファイルのオーナーの uid からログ イン名へのマップ機能を使用します。

これは、リモートシステムが異なるログインセットを持つ場合には、あきらか に正しく動作しません。したがって、uid に対応するログイン名の決定をリモート マシンにおこなわせる必要があります。

残念ながら、`NIS`、`NIS+`そして `NetInfo` のような、 分散管理システム を使う場合、シンプルで、信頼性があり、移植性の高い マッピングの方法は存在しません。

ありがたい事に、uid からログイン名へのマッピングに依存する VC のコードは、 関数 `vc-file-owner` ひとつだけです。この関数は、ファイルのオーナー のログイン名を文字列として返します。

ログイン名を決定するために、この関数に、リモートマシン上の `ls` の出力を使用することが通知されます。uid からログイン名のマッピングを、 私よりそれらについて良く知っているはずのリモートシステムに委譲します。

Node:Back-end Versions, Previous:Remote File Ownership, Up:Miscellaneous Version Control

#### VC が RCS のバージョンを調べる方法

VC は、どのリリースのバージョン管理システムのバイナリを使っているかを 知る必要があります。これは、VC がサポートしているすべての機能を、古い バージョンの`rcs(1)`、`cvs(1)`、`sccs(1)`が提供 しているわけでは無いからです。

VC のデフォルトの実装では、最初に必要になった時に、この値を決定します。 これは、毎回、必要になった時に、プロセスを実行し、その出力をパースする オーバーヘッドをさけるためです。

いかし、リモートのバージョン管理システムの事が関係してくると、人生は それほど簡単ではありません。リモートマシンはそれぞれ、異なるバージョン のバージョン管理ツールをもっています。これが困難な間は、存在しない機能 が、リモートで使用されないことを保証する必要があります。

この問題を解決するために、現在の TRAMP は、バージョン管理ツールの バージョン番号を TRAMP バッファ毎にローカルな変数にし、新しい ファイルを開くたびにVC にこの値を決定させるという力ずくのアプローチ を採用しています。

これはあきらかに性能に影響します。ありがたいことに、VC によっておこなわれる ほとんどの処理は、実際にはリモートのバージョンを知ることを必要としません。 したがって、それほど問題になりません。

最終的には、これらの変数は TRAMP によってシステム毎に調べられ、 その結果は性能を改善するためにキャッシュされるようになるでしょう。

Node:Files directories and paths, Next:Issues, Previous:Version Control, Up:Top

## ファイル名、ディレクトリ、パス名がどのように変換され(mangled)、管理されるか

- Path deconstruction: コンポーネント中のパスの分解

Node:Path deconstruction, Previous:Files directories and paths, Up:Files directories and paths

### コンポーネント中のパスの分解

TRAMP のファイル名は普通のファイル名とはあきらかに異なっています。 したがって、lisp の関数 `file-name-directory` と `file-name-nondirectory` は、TRAMP パッケージによってオーバー ライドされています。

関数の置き換えはシンプルかつ適切な方法です。ファイル名は分解され、 リモートパスに対してオリジナルのハンドラーがよばれます。そして、 その結果をもとに TRAMP パス名が再構成されます。

これにより、TRAMP パスの情報を扱う場合も、プラットホーム固有の オリジナルハンドラーのハックは有効です。

Node:Issues, Previous:Files directories and paths, Up:Top

## 検討課題と決定事項

- uuencode メソッドがいつも動作するわけではありません

  TRAMP の設計上の理由で、符号化と復号化をおこなうプログラムは標準 入力から読み込み、標準出力に書き込む必要があります。いくつかのシステム では、`uudecode -o -` で標準入力から読み込み、復号化されたファイル を標準出力に書き込みます。他のシステムでは、`uudecode -p` が同じ 動作をします。しかし、いくつかのシステムの uudecode の実装では、これら のことが全くできません。これらの uudecode の実装に、標準出力に書き込む ために適切なパラメータを渡して呼ぶことは不可能です。

  もちろん、これを回避する事は可能です。テンポラリファイル名を追加する ために `begin foo 644` 行を書きかえれば、`uudecode` を呼ぶこと ができます。そしてテンポラリファイルを表示し削除します。

  しかし、この方法はあまりにも信頼性が低いため、いくつかのシステムでは uuencode メソッドを使用できないままにしておく事にしました。

- TRAMP は XEmacs 20 上で動きません

  これは、XEmacs 20 に存在しないマクロ `with-timeout` を使っている からです。私は、エミュレーションのためのマクロを TRAMP に追加する ことに、あまり乗り気ではありません。しかし、XEmacs 20 ユーザーの誰かが 積極的に実装とテストをしたいと考えているのであれば、私かメーリングリスト に連絡してください。

#### Footnotes

1. ログインシェルが `exec /bin/sh` を正しいコマンドとして認識せずに `/bin/sh` の起動に失敗することがあるかもしれません。たぶん、あなたは Scheme シェル `scsh` を使っているのでしょう...

2. PuTTY's `pscp` では コマンドラインでパスワードを指定できます。