FORMAT: Locally: FINGER [user] [Qualifiers] over the network: FINGER [user] @host[@host...] [Qualifiers] Finger is a SHOW USERS-like program (tells you who's logged in, etc.) that performs the following functions: o SHOW USERS-like output, showing username, location, program name, etc., of all users currently logged in. o Detailed information about a specified user including the contents of the user's "PLAN" file (if the user has one), and the status of the user's mailbox. In addition, if the user is logged in, the user's job(s) is(are) displayed. o Finger will look up the username of a person whose name you know. There are variations on this: e.g. you can find the usernames of all users with the first name of Fred. The rule Finger follows for the command "$ FINGER user" is: 1) Check if "user" is a valid Username (login ID). If it is, use it. 2) Match "user" against the list of personal names kept by the system. Output all matches. This match can be to any part of the name. Thus "Rich" will match both "Richard" and "Heinrich". /ALL /ALL List all jobs, including system jobs. Note: /ALL selects all jobs for display, whereas /FULL specifies that all information for the selected jobs be displayed. /AREA /AREA (D) /NOAREA Display the default file area for the job. /BATCH /BATCH (D) /NOBATCH List the batch jobs on the system. /BYPASS /BYPASS (D) /NOBYPASS Determines whether (NOBYPASS) or not (BYPASS) control characters such as escape sequences are filtered before output is displayed. /CPUTIME /CPUTIME (D) /NOCPUTIME Display the amount of CPU time used. Format is mm:ss (or mmmmm for times over 99.9 minutes.) /FULL /FULL Displays all information for the selected jobs. This display will overflow the screen width on most terminals. Note: /ALL selects all jobs for display, whereas /FULL specifies that all information for the selected jobs be displayed. /HELP /HELP Print this message. /IMAGENAME /IMAGENAME (D) /NOIMAGENAME Display the user's image (program) name. A $ means the user is at the DCL level. /INTERACTIVE /INTERACTIVE (D) /NOINTERACTIVE List interactive jobs. /JOB /JOB (D) /NOJOB Display the user's job number. /LOCATION /LOCATION (D) /NOLOCATION Display the location of the user's terminal for interactive jobs. /LOGINTIME /LOGINTIME (D) /NOLOGINTIME Display the time the user logged in. Format is hh:mm. /MAIL /MAIL (D) /NOMAIL Display the new mail count and unread message information. /MESSAGE /MESSAGE (D) /NOMESSAGE Display the system message of the day with the output. /NETWORK /NETWORK (D) /NONETWORK List network (DECnet) jobs. /PERSONALNAME /PERSONALNAME /NOPERSONALNAME (D) Display the user's personal name, as recorded in the system authoriz- ation file (SYSUAF). /PLAN /PLAN (D) /NOPLAN Display the user's plan file. /PPN /PPN (D) /NOPPN Display the job's Project-Programmer Number. /PRIORITY /PRIORITY /NOPRIORITY (D) Display the job's priority and run-burst values. /RUNTIMESYSTEM /RUNTIMESYSTEM /NORUNTIMESYSTEM (D) Display the job's current run-time system. /SIZE /SIZE /NOSIZE (D) Display the amount of memory in K-words used by the job, as well as the maximum memory available to the job. /STATE /STATE /NOSTATE (D) Display the job state. /SYSTEM /SYSTEM (D) /NOSYSTEM List system jobs (jobs running under PPN [1,2]). /TERMINAL /TERMINAL (D) /NOTERMINAL Display the terminal line number. /TTTYPE /TTTYPE (D) /NOTTTYPE Display the type of terminal for interactive users. /USERNAME /USERNAME (D) /NOUSERNAME Display the user's username (login ID). /VERSION /VERSION /NOVERSION (D) Display the version information for the Finger program. *User Asking for a specific user will give you a list of all the active jobs for that user, as well as plan and mail information if available. A "user" can be specified in one of several ways: o A local RSTS/E username, possibly with wildcards. For example, "FL$SMITH", "BEN*", etc. Standard wild-card conventions are ob- served i.e. "*" matches any string, "%" or "?" matches any char- acter. o A local personal name or part thereof. All matches will be out- put. o A "." (period) to finger yourself. (e.g. to check your mail.) o An ID on a foreign network host, e.g. SYSTEM@JCSVAX1 or .@SPC11B Note in the second example above that .@host will return infor- mation about a user on a remote host with the same username as yourself, handy for checking your mail on the other system. See also "HELP Finger Plan" and "HELP Finger Mail" *Network Finger can retrieve information from a remote host on the network if that host supports Finger commands. The host is specified by a hostname, preceded by an atsign, e.g. @XYZ. An alternate form for specifying a nodename is with a double colon ::. The following two commands are equivalent: FINGER @FOO FINGER FOO:: In parsing the command, Finger searches for "@" first and if it cannot find this it searches for "::". Several host names may be strung together to effect routing to other networks, e.g.: @SU-AI@CUCS20 (Routing is done right to left) If you give a host name with no username you will get a listing of all the non-operator jobs at the specified site (providing it is connected and is able to provide Finger service). You may include trailing options for the foreign host; these are not parsed locally. They are simply sent to the designated host, which may or may not know what to do with them. For example: FINGER foo@unixa -a -b -c In all cases, the rightmost host name and its atsign are removed from your command and the rest of it is sent to that host as you typed it. Intermediate hosts do the same thing, until the command has no host names left, at which point the host at which it has arrived executes the remainder of the command. *Plan If you Finger an individual user, personal information about that user will be listed if it is available. A user should put this information in a file named "FINGER.PLN" in his/her login directory. Information such as phone number, office hours, etc. may be appropriate. *Mail If you Finger an individual user, information about that user's mail messages will be listed. This consists of the number of new mail mes- messages received since last read by the user, and (if any are from you) the date, time and subject is displayed. This is useful to see if a person has read your mail yet etc. *Area If you Finger an individual user, that user's default directory spec- ifcation will be displayed. *Nodes The following nodes accessible from the SPC Academic Computer Center are in the Finger database as of March 1989. These are those believed to support Finger. If you Finger other nodes, it will try anyway for DECnet nodes, but will not try for BITnet nodes. DECnet nodes - SPC11A - SPC Academic Computer Center PDP-11/84 (research) SPC11B - SPC Academic Computer Center PDP-11/44 (CS computing) SPC11C - SPC Academic Computer Center PDP-11/44 (Non-CS " ) SPC11D - SPC Academic Computer Center PDP-11/70 (CS Unix) SPC11E - SPC Academic Computer Center PDP-11/70 (CS Unix tech) SPC11Y - SPC Academic Computer Center PDP-11/23+ (Micro router) SPC11Z - SPC Academic Computer Center PDP-11/83 (RSTS SIG) SPCVXA - SPC Academic Computer Center VAX-11/785 (VAX users) BITnet nodes - JCSVAX1 - Jersey City State College VAX 8600 (admin cluster)