.\"	$OpenBSD: tip.1,v 1.19 2001/09/23 06:15:30 pvalchev Exp $
.\"	$NetBSD: tip.1,v 1.7 1994/12/08 09:31:05 jtc Exp $
.\"
.\" Copyright (c) 1980, 1990, 1993
.\"	The Regents of the University of California.  All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\"    must display the following acknowledgement:
.\"	This product includes software developed by the University of
.\"	California, Berkeley and its contributors.
.\" 4. Neither the name of the University nor the names of its contributors
.\"    may be used to endorse or promote products derived from this software
.\"    without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\"	@(#)tip.1	8.4 (Berkeley) 4/18/94
.\" %FreeBSD: src/usr.bin/tip/tip/tip.1,v 1.22 2003/09/06 18:36:51 hmp Exp %
.\" $FreeBSD$
.\"
.Dd September 9, 2001
.Dt TIP 1
.Os
.Sh 名称
.Nm tip ,
.Nm cu
.Nd リモートシステムとの接続を行なう
.Sh 書式
.Nm
.Op Fl nv
.Op Fl Ar speed
.Op Ar system-name
.Nm cu
.Op Fl ehot
.Op Fl a Ar acu
.Op Fl l Ar line
.Op Fl s Ar speed
.Op Fl Ar #
.Op Ar phone-number
.Sh 解説
.Nm
および
.Nm cu
のユーティリティは、他のマシンとの間に全二重のコネクションを確立し、
リモートマシンへ直接ログインしてみせます。
言うまでもないことですが、コネクションを張りたいマシンに対しては、
ログインアカウント (かそれに相当するもの) がなければなりません。
好まれるインタフェースは
.Nm
です。
.Nm cu
インタフェースは、
.At v7
の
.Dq call Ux
コマンドから離れられない方々のために含まれています。
本マニュアルページは
.Nm
のみを記述します。
.Pp
以下のオプションが使用可能です:
.Bl -tag -width ".Fl s Ar speed"
.It Fl a Ar acu
acu を設定します。
.It Fl l Ar line
.Nm cu
では、使用する回線を指定します。
.Pa tty00
や
.Pa /dev/tty00
のどちらの形式も許されます。
.It Fl n
エスケープ無し (チルダの無効化)。
.It Fl s Ar speed
.Nm cu
では、接続速度を設定します。
デフォルトは 9600 です。
.It Fl v
冗長モードを設定します。
.El
.Pp
.Ar speed
が指定された場合、使用されるシステム記述で指定されたボーレートに優先します。
.Pp
.Ar speed
も
.Ar system-name
も指定されない場合、
.Ar system-name
は
.Ev HOST
環境変数の値に設定されます。
.Pp
.Ar speed
が指定されたものの
.Ar system-name
が指定されない場合、
.Dq Li tip
に
.Ar speed
を追加した値に
.Ar system-name
を設定します。
例えば
.Nm Fl 1200
は
.Ar system-name
を
.Dq Li tip1200
に設定します。
.Pp
入力された文字は通常は直接リモートマシンに転送されます
(それは同様にエコーされます)。
行頭にチルダ文字
.Pq Ql ~
が入力された場合には、これはエスケープ文字として
働きます; 以下の組み合わせが認識されます:
.Bl -tag -width indent
.It Xo
.Ic ~^D
または
.Ic ~.
.Xc
コネクションを切断し、プログラムを終了します
(リモートマシンにはログインしたままでいることもできます)。
.It Ic ~c Op Ar name
ローカルのカレントディレクトリを
.Ar name
で指定したものに変更します
(引数が指定されない場合には、ホームディレクトリに移動します)。
.It Ic ~!
シェルを起動します (シェルを終了すると、
.Nm
に戻ります)。
.It Ic ~>
ローカルマシンのファイルをリモートマシンにコピーします。
.Nm
ユーティリティは、ローカルファイル名の入力プロンプトを出します。
.It Ic ~<
リモートシステムのファイルをローカルマシンに転送します。
.Nm
ユーティリティは、まず転送されるファイル名の入力プロンプトを出し、
それからリモートマシンで実行するコマンドのプロンプトを出します。
.It Ic ~p Ar from Op Ar to
リモートの
.Ux
ホストにファイルを送ります。put コマンドは
.Nm
が
.Dq from
ファイルを送っている間、リモートの
.Ux
システム上で
.Dq Nm cat Li \&> Ar to
コマンドを実行します。
.Dq to
ファイル名が指定されない場合には、
このファイル名には
.Dq from
ファイル名を使用します。
このコマンドは、実際には
.Ic ~>
コマンドを
.Ux
システムに特定して実装したバージョンです。
.It Ic ~t Ar from Op Ar to
リモートの
.Ux
ホストからファイルを受信します。put コマンドと同じく、
.Ar to
ファイル名
が指定されない場合には、このファイル名は
.Ar from
ファイル名と同じになります。
リモートホストでは
.Nm
にファイル転送を行なうために
.Dq Nm cat Ar from ; Nm echo Li ^A
を実行します。
.It Ic ~|
リモートコマンドからの出力を、ローカル
.Ux
プロセスへパイプを用いてリダイレクトします。
ローカル
.Ux
システムに送られるコマンド文字列は、シェルで処理されます。
.It Ic ~$
ローカル
.Ux
プロセスからパイプを介してリモートホストへ出力します。
ローカル
.Ux
システムに送られるコマンド文字列は、シェルで処理されます。
.It Ic ~C
ローカルシステム上で
.Tn XMODEM
などの特別なプロトコルを扱うための
子プロセスを起動します。この子プロセスは特別に用意された、次のような
ファイル記述子を用いて動作します。
.Bd -literal -offset indent
0 <-> 自側 tty 入力
1 <-> 自側 tty 出力
2 <-> 自側 tty 出力
3 <-> 相手側 tty 入力
4 <-> 相手側 tty 出力
.Ed
.It Ic ~#
.Dv BREAK
信号をリモートホストに送信します。
必要な
.Fn ioctl
システムコールをサポートしていないシステムの場合には、回線速度の
変更と
.Dv DEL
文字の組み合わせでブレークをシミュレートします。
.It Ic ~s
変数をセットします (以下の記述を参照してください)。
.It Ic ~v
すべての変数とその値 (設定されてる場合) を表示します。
.It Ic ~^Z
.Nm
を停止します
(システムがジョブコントロールをサポートしている場合にのみ使用可能です)。
.It Ic ~^Y
.Dq ローカル側の
.Nm
のみ停止します
(システムがジョブコントロールをサポートしている場合にのみ使用可能です);
.Nm
の
.Dq リモート側
すなわちリモートホストの表示出力については引続き走行します。
.It Ic ~?
チルダエスケープで使用できるコマンド一覧を表示します。
.El
.Pp
システム記述、すなわち
.Ar system-name
の動作特性を見付けるために、
.Nm
は名前が
.Ar system-name
と合致するシステム記述を検索します。
検索順序は次の通りです:
.Bl -enum -offset indent
.It
環境変数
.Ev REMOTE
が
.Ql \&/
で開始しない場合、これはシステム記述と仮定され、最初に検討されます。
.It
環境変数
.Ev REMOTE
が
.Ql \&/
で開始する場合、これは
.Xr remote 5
データベースのパスと仮定され、指定されたデータベースが検索されます。
.It
デフォルトの
.Xr remote 5
データベース
.Pa /etc/remote
が検索されます。
.El
.Pp
システム記述に関する文書は
.Xr remote 5
を参照してください。
.Pp
システム記述中で
.Va br
ケーパビリティを使用することで、
コネクションを確立するボーレートを指定可能です。
指定された値が適当でない場合には、使用されるボーレートは
コマンドラインで指定されたものになり得ます。
例えば
.Dq Li "tip -300 mds"
です。
.Pp
.Nm
がコネクションを確立すると、使用されるシステム記述の
.Va cm
ケーパビリティで指定されているコネクションメッセージを、
リモートホストに送信します。
.Pp
.Nm
に引数の入力を促されている場合 (例えば、ファイル転送の設定の間)
には、入力された行は標準の erase や kill 文字で編集することが許されています。
入力を促されている時に空行を入力したり操作を中断
した場合には、入力を促す画面から抜け出し、リモートマシンとの対話に戻ります。
.Pp
.Nm
ユーティリティは、モデムや回線の排他制御や
.Xr uucico 8
で採用されているロックプロトコルを用いることで、複数のユーザが
リモートシステムへ接続することを制限しています。
.Pp
ファイル転送時には
.Nm
は転送した行数を表示します。
.Ic ~>
や
.Ic ~<
コマンドを使用した場合には、
.Va eofread
変数や
.Va eofwrite
変数は、ファイル読み込時の end-of-file 文字の認識や、ファイル書き込み時
の end-of-file 文字の指定に用いられます (後述)。ファイル転送時のフロー制御は、
通常は tandem モードで行なわれます。リモートシステムが tandem
モードをサポートしない場合には、
.Va echocheck
が設定され、
.Nm
が相手に転送した文字のエコーを用いてリモートシステムと同期します。
.Pp
.Nm
が他システムとの接続のために電話をかける場合には、
動作を示すさまざまな表示を行ないます。
.Nm
ユーティリティは、システム記述中の
.Va at
ケーパビリティにおいて、様々な自動呼び出し機器やモデムをサポートします。
.Pp
Ventel 212+ (ventel), Hayes AT-style (hayes),
USRobotics Courier (courier), Telebit T3000 (t3000),
Racal-Vadic 831 (vadic) のサポートは、デフォルトで有効です。
.Pp
Bizcomp 1031[fw] (biz31[fw]), Bizcomp 1022[fw]
(biz22[fw]), DEC DF0[23]-AC (df0[23]), DEC DN-11 (dn11),
Racal-Vadic 3451 (v3451) のサポートは、
.Nm
を適切な定義付きで再コンパイルすることで追加可能です。
.Pp
Racal-Vadic 831 および 3451 のサポートを両方有効にすると、
それぞれ v831 および v3451 と参照されます。
どちらか一方のみサポートすると、それは vadic と参照されます。
.Ss 変数
.Nm
ユーティリティは、自己を制御するために、
変数
を取り扱います。
いくつかの変数は、一般ユーザの権限では参照のみで変更することはできません
(スーパユーザのみ、これらの変数の変更が許可されています)。変数は、
.Ic ~s
エスケープにて、参照および変更が可能です。変数設定の書式は、
.Xr vi 1
や
.Xr Mail 1
での変数設定の書式と同様です。コマンドの引数に
.Dq Li all
を指定することで、
ユーザが読み出し可能なすべての変数を表示することができます。また、ユーザは
特定の変数について、変数名の最後に
.Ql \&?
を付加することにより、
その値を表示することができます。
例えば
.Dq Li escape?
とすることで、現在のエスケープ文字を表示します。
.Pp
変数値として採用されるものは、数値、文字列、文字、もしくは論理値です。
論理変数の設定については、単に変数名を設定するだけで設定されます;
これらは、変数名の前に
.Ql \&!
文字をつけることにより偽に設定
されます。他の変数型については、変数と値の間を
.Ql =
でつなぐことで設定
できます。すべての設定について、その指定中に空白を入れてはいけません。
単独の set コマンドは、変数の値を設定するだけでなく、変数の値を知るため
にも用いられます。
変数は実行時に set コマンドを実行することで初期化されます (
ホームディレクトリの
.Pa .tiprc
ファイル中で、
.Ic ~s
プレフィックスがない場合です)。
.Fl v
オプションを指定することで、
.Nm
が初期化時に行なった設定を表示します。
確実に共通変数と思われるものについては、略号表記されます。
以下に共通変数およびその略号と、デフォルトの値の一覧を示します。
.Bl -tag -width indent
.It Va beautify
.Pq Vt 論理値
セッション確立時に受けとった表示不可の文字については無視します;
.Va be
と略号表記されます。
.It Va baudrate
.Pq Vt 数値
コネクション確立時の通信速度を指定します;
.Va ba
と略号表記されます。
.It Va dialtimeout
.Pq Vt 数値
相手先に電話をかける際に、コネクション確立までの待ち時間 (秒単位) を
指定します;
.Va dial
と略号表記されます。
.It Va echocheck
.Pq Vt 論理値
ファイル転送時のリモートホストとの同期を、
送信された最後の文字のエコーを待つことで取ります;
本変数のデフォルト値は
.Cm off
です。
.It Va eofread
.Pq Vt 文字列
.Ic ~<
コマンドを用いてファイル転送した場合に、
転送終了を示す文字群です;
.Va eofr
と略号表記されます。
.It Va eofwrite
.Pq Vt 文字列
.Ic ~>
コマンドを用いてファイル転送した場合に、
転送終了を示すために送る文字列です;
.Va eofw
と略号表記されます。
.It Va eol
.Pq Vt 文字列
行末を示す文字群です。
.Nm
ユーティリティは、
行末文字の直後に現れたエスケープ文字のみ、エスケープ文字として認識します。
.It Va escape
.Pq Vt 文字
コマンドプレフィックス (エスケープ) 文字です;
.Va es
と略号表記されます;
本変数のデフォルト値は
.Ql ~
です。
.It Va exceptions
.Pq Vt 文字列
beautification の指定で無視されない文字群を指定します;
.Va ex
と略号表記されます;
本変数のデフォルト値
.Dq Li \et\en\ef\eb
です。
.It Va force
.Pq Vt 文字
リテラルデータ送信を強制する文字です;
.Va fo
と略号表記されます;
本変数のデフォルト値は
.Ql ^P
です。
.It Va framesize
.Pq Vt 数値
ファイルを受信した場合に、ファイルシステムとの間にあるバッファに
バッファリングするデータ量 (バイト単位) です;
.Va fr
と略号表記されます。
.It Va host
.Pq Vt 文字列
接続しているホスト名です;
.Va ho
と略号表記されます。
.It Va prompt
.Pq Vt 文字
リモートホストの行末文字です;
.Va pr
と略号表記されます;
本変数のデフォルト値は
.Ql \en
です。本変数は、データ転送時の同期を取るのに
用いられます。ファイル転送時に行なう転送行のカウントは、この文字を
いくつ受けとったかということに基づきます。
.It Va raise
.Pq Vt 論理値
大文字に変換するモードです;
.Va ra
と略号表記されます;
本変数のデフォルト値は
.Cm off
です。
本モードが有効になると、すべての小文字の文字列は、リモートホストへの転送時に
.Nm
によって大文字に変更されます。
.It Va raisechar
.Pq Vt 文字
大文字へ変換するモードの切り替えを行なう入力文字です;
.Va rc
と略号表記されます;
本変数のデフォルト値は
.Ql ^A
です。
.It Va record
.Pq Vt 文字列
セッションの記録を取るファイル名です;
.Va rec
と略号表記されます;
本変数のデフォルト値は
.Pa tip.record
です。
.It Va script
.Pq Vt 論理値
セッションの記録を取るモードです;
.Va sc
と略号表記されます;
本変数のデフォルト値は
.Cm off
です。
.Va script
が
.Cm true
の場合には、
.Nm
はリモートホストから転送されたすべてのデータを
.Va record
に指定されたファイルに記録します。
.Va beautify
スイッチが有効になっている場合には、表示可能な
.Tn ASCII
文字 (文字コードに換算して 040 から 0177 までの間) についてのみ記録されます。
beautification 規則の例外を指定する
.Va exceptions
変数による設定も有効となります。
.It Va tabexpand
.Pq Vt 論理値
ファイル転送時にタブ文字を空白文字に展開するモードです;
.Va tab
と略号表記されます。
本変数のデフォルト値は
.Cm false
です。
本モードが有効になっている場合には、タブ文字は空白文字 8 つに展開されます。
.It Va verbose
.Pq Vt 論理値
冗長モードです;
.Va verb
と略号表記されます;
本変数のデフォルト値は
.Cm true
です。
冗長モードが有効になっている場合には、
.Nm
はダイヤル時にメッセージを出力したり、ファイル転送を行なっている際の
現在の転送行数を指定したりします。
.El
.Sh 環境変数
.Bl -tag -width indent
.It Ev SHELL
.Ic ~!
コマンド実行時に使用するシェルの名前です; デフォルト値は
.Pa /bin/sh
です。
.It Ev HOME
.Ic ~c
コマンド実行時に用いるホームディレクトリです。
.It Ev HOST
コマンドラインで指定が無い場合の、デフォルトの
.Va system-name
値です。
.It Ev REMOTE
システム記述であるか、
.Xr remote 5
システム記述データベースへの絶対パスです。
.It Ev PHONES
.Xr phones 5
データベースへのパスです。
.El
.Sh 関連ファイル
.Bl -tag -width ".Pa /var/spool/lock/LCK..*" -compact
.It Pa /etc/remote
グローバル
.Xr remote 5
データベース。
.It Pa /etc/phones
デフォルト
.Xr phones 5
ファイル。
.It Pa ~/.tiprc
初期化ファイル。
.It Pa tip.record
記録ファイル。
.It Pa /var/log/aculog
回線アクセス記録。
.It Pa /var/spool/lock/LCK..*
.Xr uucp 1
との回線競合を避けるための回線排他制御ファイル。
.El
.Sh 関連項目
.Xr remote 5 ,
.Xr phones 5
.Sh 歴史
.Nm
コマンドは
.Bx 4.2
から登場しました。
.Sh バグ
すべての変数が文書化されているわけではありません。文書化されていないものは
おそらく削除されるでしょう。