.\" Copyright (c) 1989, 1990, 1993, 1994
.\" 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.
.\"
.\" @(#)finger.1 8.3 (Berkeley) 5/5/94
.\" %FreeBSD: src/usr.bin/finger/finger.1,v 1.9.2.11 2002/07/29 18:52:52 ume Exp %
.\" $FreeBSD$
.\"
.Dd August 1, 1997
.Dt FINGER 1
.Os
.Sh 名称
.Nm finger
.Nd ユーザ情報を調べるプログラム
.Sh 書式
.Nm finger
.Op Fl 46glmpshoT
.Op Ar user ...\&
.Op Ar user@host ...\&
.Sh 解説
.Nm
ユーティリティはシステムのユーザに関する情報を表示します。
.Pp
オプションは以下の通りです:
.Bl -tag -width flag
.It Fl 4
.Nm
が IPv4 アドレスのみを使用するよう、強制します。
.It Fl 6
.Nm
が IPv6 アドレスのみを使用するよう、強制します。
.It Fl s
ユーザのログイン名、本名、端末名、端末への書き込み
状態 (書き込みが不可の場合は、端末名の前に ``*'' が付きます)、
アイドル時間、ログイン時間、また、オフィスの所在地と電話番号もしくは
リモートホスト名を表示します。
.Fl o
が指定されていた場合 (デフォルト) は、
オフィスの所在地と電話番号が表示されます。
.Fl h
が指定されていた場合は、代わりに、リモートホスト名が表示されます。
.Pp
アイドル時間の単位は、数字だけの場合は
何分か、``:'' がある場合は何時間何分か、``d'' がある場合は何日か、です。
アイドル時間が
.Dq *
の場合、ログイン時間は最後のログイン時間を示します。
ログイン時間は、6 日以内の場合は何曜日の何時何分からか、それ以上の
場合は何月何日の何時何分からかが表示されます。もし 6 ヶ月を超えて
いる場合は、何年何月何日からかが表示されます。
.Pp
アイドル時間やログイン時間がない場合と同様に、
不明なデバイスは一つのアスタリスクとして表示されます。
.Pp
.It Fl h
.Fl s
オプションと共に指定されたとき、オフィスの所在地と電話番号の代わりに
リモートホスト名を表示します。
.Pp
.It Fl o
.Fl s
オプションと共に指定されたとき、リモートホスト名の代わりに
オフィスの所在地と電話番号を表示します。
.Pp
.It Fl g
本オプションは、gecos 出力をユーザの実名のみに制限します。
.Fl h
オプション共に指定されたとき、
リモートホストの出力を制限するという副作用もあります。
.Pp
.It Fl l
ユーザのホームディレクトリ、自宅の電話番号、ログインシェル、
メールの状態、そしてユーザのホームディレクトリの
.Dq Pa .forward ,
.Dq Pa .plan ,
.Dq Pa .project ,
.Dq Pa .pubkey
の内容に加えて、
.Fl s
オプションの解説で述べた情報全てが複数行にわたる形式で出力されます。
.Pp
アイドル時間は 1 分以上 1 日以内の場合は、``hh:mm'' の形式となります。
1 日よりも大きいときには、``d day[s]hh:mm'' の形式となります。
.Pp
電話番号は、11 桁の場合には ``+N-NNN-NNN-NNNN'' と表示
されます。10 桁もしくは 7 桁の場合には、上の文字列の適切な
部分として表示されます。5 桁の場合は ``xN-NNNN''、
4 桁の場合は ``xNNNN'' と表示されます。
.Pp
デバイスの書き込み許可がない場合、デバイス名を含む
行に ``(messages off)'' という語句が追加されます。
.Fl l
オプションを指定すると、1 人のユーザにつき 1 つの項目が表示されます。
もしあるユーザが複数回ログインしている場合には、端末の情報は
その各ログインについて表示されます。
.Pp
メールの状態は、全くメールがない場合には ``No Mail.''、その人が自分の
メールボックスに届いた新着メールを全て読んでいた場合
には ``Mail last read DDD MMM ## HH:MM YYYY (TZ)''、その人あての新着
メールがあれば ``New mail received ...'' や ``Unread since ...'' の
ように表示されます。
.Pp
.It Fl p
オプションは、
.Nm
の
.Fl l
オプションが、
.Dq Pa .forward ,
.Dq Pa .plan ,
.Dq Pa .project ,
.Dq Pa .pubkey
のファイルの内容を表示するのを抑制します。
.It Fl m
ユーザの本名と
.Ar user
とが名前の比較で一致しないようにします。
.Ar user
は、たいていはログイン名なのですが、
.Fl m
オプションを指定しない限り、ユーザの本名との比較もまた行われてしまいます。
.Nm
によって比較される名前は、大文字小文字を区別しません。
.Pp
.It Fl T
最初の接続要求において、データをピギーバックしません。
このオプションは，いい加減な TCP の実装が行われている
ホストに finger を行う時に必要です。
.El
.Pp
オプションが指定されなかった場合は、
.Nm
は、対象が与えられた場合は
.Fl l
の出力形式、与えられなかった場合は
.Fl s
の出力形式をデフォルトの形式とします。
どちらの形式であったとしても、情報が有効でなかった場合には、その
フィールドは欠けているかもしれないことに注意してください。
.Pp
引数が全く指定されていない場合は、
.Nm
は、現在システムにログインしている各ユーザについての情報を表示します。
.Pp
.Nm
ユーティリティは、リモートマシン上のユーザを調べることにも利用できます。
これには、
.Ar user
として
.Dq Li user@host
もしくは
.Dq Li @host
と指定する形式を使います。デフォルトでは、前者は
.Fl l
形式の出力、後者は
.Fl s
形式の出力となります。
.Fl l
オプションは、リモートマシンに渡される唯一のオプションかも知れません。
.Pp
もし、ユーザのホームディレクトリに
.Dq Pa .nofinger
というファイルが存在した場合、
.Nm
は、そのユーザが存在していないかのように振る舞います。
.Pp
オプションの
.Xr finger.conf 5
設定ファイルを使用して、別名を指定可能です。
.Xr finger 1
は
.Xr fingerd 8
が起動しますので、
ローカルの問い合わせとネットワークの問い合わせの両方で有効です。
.Sh 環境変数
.Nm
ユーティリティは、もし設定されていれば、以下の環境変数を利用します:
.Bl -tag -width Fl
.It Ev FINGER
.Nm
に好みのオプションがあれば、この環境変数に設定しておくとよいでしょう。
.El
.Sh 関連ファイル
.Bl -tag -width /var/log/lastlog -compact
.It Pa /etc/finger.conf
別名定義のデータベース
.It Pa /var/log/lastlog
最後にログインした時間のデータベース
.El
.Sh 関連項目
.Xr chpass 1 ,
.Xr w 1 ,
.Xr who 1 ,
.Xr finger.conf 5 ,
.Xr fingerd 8
.Rs
.%A D. Zimmerman
.%T The Finger User Information Protocol
.%R RFC 1288
.%D December, 1991
.Re
.Sh 歴史
.Nm
コマンドは、
.Bx 3.0
で登場しました。
.Sh バグ
現在の FINGER プロトコルの RFC では、
サーバが接続を閉じるまでクライアントはフルに接続をオープンする必要があります。
これでは、最適な 3 パケット T/TCP 交換を妨げてしまいます。
(この仕様に依存するサーバは壊れていますが、
広いインターネットにはこのようなサーバが存在します。)
