Arguments to GNU Finger

The basic argument to Finger is a user@host pair. The user portion is the name of the user about whom you would like information. The host is a machine that the user has an account on. When invoked in this manner, GNU Finger displays the list of hosts that this user is currently logged in on, or, if the user is not logged in, the last time and location that he or she was. host may be expressed as any valid Internet address (i.e. dot-notation, host.domain, etc).

If host is non-existent, the local host is assumed. If user is blank or unspecified, it is assumed that you want information about all users.

The content and format of the output of GNU finger depends on what is being fingered:

User

Displays login information about user. If `--info' or `--l' is also specified, finger will display the full name, home directory, shell, mail forwarding, and `.plan' and/or `.project' file. This is what the output will look like:

bash$ finger --info [email protected]
[apple-gunkies.gnu.ai.mit.edu]

Jan Brittenson (bson)
Home: /home/fsf/bson
Shell: /usr/local/bin/bash
Mail forwarded to [email protected].
No mail.
  User     Real Name         What    Idle  TTY  Host      Console Location
bson     Jan Brittenson     fgrep          *p0 apple-gu (nutrimat.gnu.ai.)
bson     Jan Brittenson              1:57  *sb nutrimat 

Plan:
	To hack GNU Finger

The following is output, in the order listed, when asking for long information (`-l' or `--info') about a particular user:

• Real and login names.
• Home directory.
• Login shell.
• Mail forwarding.
• Whether the user has any unread mail, and if so, when it was last read.
• Current login information, in the same format as produced by a short finger (see below for an explanation). If the user isn't currently logged on, then the last login time and remote host (if known) is reported.
• A `~/.plan' file. If the file isn't readable by everyone, then a message is printed to this effect.
• A `~/.projects' file. This file, like `~/.plan', should be readable by everyone.

bash$ finger [email protected]
[apple-gunkies.gnu.ai.mit.edu]
  User     Real Name         What    Idle  TTY  Host      Console Location
bson     Jan Brittenson     fgrep          *p0 apple-gu (nutrimat.gnu.ai.)
bson     Jan Brittenson              1:57  *sb nutrimat 

Here is an explanation of what each column contains in the short example:

User

The user login name.

Real Name

The real name of the user.

What

The current or last program run by the user, depending on the system in use. On System V Release 4, for instance, the current program is shown, but on BSD it will be the last terminated program.

Idle

The time the user has been idle, as hours:minutes, or the first 7 characters of a string such as "14 days".

TTY

The significant portion of the user's terminal connection. Exactly what portion this is is system dependent. For example, on System V Release 4, it might be `*40' for `/dev/pty/40', while on BSD it might be `*p0' for `/dev/ttyp0'. If preceded by an asterisk ("*"), then the user allows anyone to send messages to this particular terminal.

Host

The host the user is logged onto.

Console Location

Where the user's console is located. If logged in over the network, then this will be the most significant portion of the remote host name if known. A host name is always parenthesized.

In the general short output (i.e. not for a particular host), GNU Finger lists the least idle login for a particular user on each host. A single user often has several logins, since on some systems each window opened creates its own login record. In addition to the least idle login, the console login is also always listed, regardless of how long it has been idle. To list all login records for a particular, host, use the special target `.local'. For example, while the following may be part of the general short finger listing for the host `mole.gnu.ai.mit.edu':

brendan  Brendan Kehoe               5:09  *p8 mole     (lisa.cygnus.com)
info     InfoMaster                 12:12  *p4 mole     (hal)
law      Jeffrey A. Law              3:52  *p7 mole     (128.110.4.17:0.0)
rms      Richard Stallman   sendmai  1:34  *p1 mole     (unix:0.0)
rms      Richard Stallman           6 days *co mole

The last line is the console. The following might be listed by the command `finger [email protected]':

[mole.gnu.ai.mit.edu]
  User     Real Name         What    Idle  TTY  Host      Console Location
brendan  Brendan Kehoe               5:18  *p8 mole     (lisa.cygnus.com)
info     InfoMaster                 12:22  *p4 mole     (hal)
law      Jeffrey A. Law              4:01  *p7 mole     (128.110.4.17:0.0)
rms      Richard Stallman   sendmai  1:44  *p1 mole     (unix:0.0)
rms      Richard Stallman           23:08  *p0 mole     (unix:0.0)
rms      Richard Stallman           1 day, *p2 mole     (unix:0.0)
rms      Richard Stallman           6 days *co mole

Mailing List or Alias

Expands the mailing list or alias and displays the recipients. You always have to use `--info' or (or `-l') when fingering a mailing list or mail alias, otherwise mail aliases won't be looked up due to the extra processing involved. This is what the output will look like:

% finger --info [email protected]
postmaster is an alias for the following:
    Roland McGrath <roland>,
    <[email protected]>,
    Noah Friedman <friedman>,
    Michael I Bushnell <mib>

User-defined Target

Allows the remote host to display specific information, such as price lists, literature, or weather forecasts. For example:

% finger [email protected]

This is the FSF GNU Project. For more information, please contact
"postmaster". For information about guest accounts, please contact
"request".

Go to the first, previous, next, last section, table of contents.