home *** CD-ROM | disk | FTP | other *** search
/ Unix System Administration Handbook 1997 October / usah_oct97.iso / rfc / 700s / rfc742.txt < prev    next >
Text File  |  1992-10-14  |  12KB  |  413 lines
  1.  
  2. NWG/RFC# 742                                  KLH 30-Dec-77 08:31  42758
  3. Network Working Group                                     K. Harrenstien
  4. Request for Comments: 742                                         SRI-KL
  5. NIC: 42758                                              30 December 1977
  6.  
  7.  
  8.  
  9.                               NAME/FINGER
  10.  
  11.  
  12.  
  13.  
  14. Introduction
  15.  
  16.    This note describes the Name/Finger protocol.  This is a simple
  17.    protocol which provides an interface to the Name and Finger programs
  18.    at several network sites.  These programs return a friendly,
  19.    human-oriented status report on either the system at the moment or a
  20.    particular person in depth.  Currently only the SAIL (SU-AI), SRI
  21.    (SRI-(KA/KL)), and ITS (MIT-(AI/ML/MC/DMS)) sites support this
  22.    protocol, but there are other systems with similar programs that
  23.    could easily be made servers; there is no required format and the
  24.    protocol consists mostly of specifying a single "command line".
  25.  
  26. To use via the network:
  27.  
  28.    ICP to socket 117 (octal, 79. decimal) and establish two 8-bit
  29.    connections.
  30.  
  31.    Send a single "command line", ending with <CRLF>.
  32.  
  33.    Receive information which will vary depending on the above line and
  34.    the particular system.  The server closes its connections as soon as
  35.    this output is finished.
  36.  
  37. The command line:
  38.  
  39.    Systems may differ in their interpretations of this line.  However,
  40.    the basic scheme is straightforward:  if the line is null (i.e. just
  41.    a <CRLF> is sent) then the server should return a "default" report
  42.    which lists all people using the system at that moment.  If on the
  43.    other hand a user name is specified (e.g. FOO<CRLF>) then the
  44.    response should concern only that particular user, whether logged in
  45.    or not.
  46.  
  47.    Both ITS and SAIL sites allow several names to be included on the
  48.    line, separated by commas; but the syntax for some servers can be
  49.    slightly more elaborate.  For example, if "/W" (called the "Whois
  50.    switch") also appears on the line given to an ITS server, much fuller
  51.    descriptions are returned.  The complete documentation may be found
  52.    at any time in the files ".INFO.;NAME ORDER" on MIT-AI,
  53.    "FINGER.LES[UP,DOC]" on SU-AI, and "<DOCUMENTATION>FINGER.DOC" on
  54.  
  55.  
  56.  
  57.  
  58.  
  59.                                                                 [Page 1]
  60.  
  61. NWG/RFC# 742                                  KLH 30-Dec-77 08:31  42758
  62. Name/Finger
  63.  
  64.  
  65.  
  66.    SRI-KL, all freely accessible by FTP (with the exception of SRI-KL,
  67.    where TOPS-20 requires the "anonymous" login convention).
  68.  
  69.    Allowable "names" in the command line should of course include "user
  70.    names" or "login names" as defined by the system, but it is also
  71.    reasonable to understand last names or even full names as well.  If a
  72.    name is ambiguous, all possible derivations should be returned in
  73.    some fashion; SAIL will simply list the possible names and no more,
  74.    whereas an ITS server will furnish the full standard information for
  75.    each possibility.
  76.  
  77. Response to null command line - "default" listing:
  78.  
  79.    This is a request for a list of all online users, much like a TOPS-10
  80.    or TENEX "systat".  To fulfill the basic intent of the Name/Finger
  81.    programs, the returned list should include at least the full names of
  82.    each user and the physical locations of their terminals insofar as
  83.    they can be determined.  Including the job name and idle time (number
  84.    of minutes since last typein, or since last job activity) is also
  85.    reasonable and useful.  The appendix has examples which demonstrate
  86.    how this information can be formatted.
  87.  
  88. Response to non-null command line - "name" listing:
  89.  
  90.    For in-depth status of a specified user, there are two main cases.
  91.    If the user is logged in, a line or two is returned in the same
  92.    format as that for the "default" listing, but showing only that user.
  93.    If not logged in, things become more interesting.  Furnishing the
  94.    full name and time of last logout is the expected thing to do, but
  95.    there is also a "plan" feature, wherein a user may leave a short
  96.    message that will be included in the response to such requests.  This
  97.    is easily implemented by (for example) having the program look for a
  98.    specially named text file on the user's directory or some common
  99.    area.  See the examples for typical "plans".
  100.  
  101. Implementation miscellany:
  102.  
  103.    Anyone wishing to implement such a server is encouraged to get in
  104.    touch with the maintainers of NAME by sending a message to BUG-NAME @
  105.    MIT-AI;  apart from offering advice and help, a list of all sites
  106.    with such servers is kept there.  It is also suggested that any
  107.    existing programs performing similar functions locally (i.e. not as
  108.    net servers) be extended to allow specification of other sites, or
  109.    names at other sites.  For example, on ITS systems one can say
  110.    ":NAME<cr>" for a local default listing, or ":NAME @SAIL<cr>" for
  111.    SAIL's default listing, or ":NAME Foo@MC<cr>" to ask MIT-MC about
  112.    Foo's status, etc.
  113.  
  114.  
  115.  
  116.  
  117.  
  118.                                                                 [Page 2]
  119.  
  120. NWG/RFC# 742                                  KLH 30-Dec-77 08:31  42758
  121. Name/Finger
  122.  
  123.  
  124.  
  125.    It should be noted that connecting directly to the server from a TIP
  126.    or an equally narrow-minded TELNET-protocol user program can result
  127.    in meaningless attempts at option negotiation being sent to the
  128.    server, which will foul up the command line interpretation unless the
  129.    server knows enough to filter out IAC's and perhaps even respond
  130.    negatively (IAC WON'T) to all option commands received.  This is a
  131.    convenience but is not at all required, since normally the user side
  132.    is just an extended NAME/FINGER type program.
  133.  
  134. And finally a little background:
  135.  
  136.    The FINGER program at SAIL, written by Les Earnest, was the
  137.    inspiration for the NAME program on ITS.  Earl Killian at MIT and
  138.    Brian Harvey at SAIL were jointly responsible for implementing the
  139.    protocol just described, and Greg Hinchliffe has recently brought up
  140.    a similar server for SRI-KA and SRI-KL.
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.                                                                 [Page 3]
  178.  
  179. NWG/RFC# 742                                  KLH 30-Dec-77 08:31  42758
  180. Appendix - Examples
  181.  
  182.  
  183.  
  184.                                 EXAMPLES
  185.  
  186.  
  187.  
  188. Note: it is possible for some lines of the actual output to exceed 80
  189. chars in length.  The handling of such lines is of course dependant on
  190. the particular user program; in these examples, lines have been
  191. truncated to 72 chars for greater clarity.
  192.  
  193.                 Three examples with a null command line:
  194.  
  195. Site: MIT-AI
  196. Command line:
  197.  
  198. -User-   --Full name--          Jobnam Idle TTY -Console location-
  199. XGP    O Xerox Graphics Printer XGPSPL      T24 Datapoint Near XGP (9TH)
  200. FFM    U Steven J. Kudlak       HACTRN      T41 Net site CMU-10A
  201. KLH    + Ken Harrenstien        F           T42 Net site SRI-KL
  202. ___013 -  Not Logged In         HACTRN 1:26.T43 DSSR UNIX x3-6048 (MIT-*
  203. CWH    U Carl W. Hoffman        E         4.T50 919 Very Small Data Bas*
  204. CARL   A Carl Hewitt            HACTRN 5:03.T52 813 Hewitt x5873
  205. APD    M Alexander Doohovskoy   XGP    1:52.T54 912 9th Floor Lounge x6*
  206. JJK    T James Koschella        E           T55 824 Hollerbach, Levin, *
  207. KEN    L Kenneth Kahn           E           T56 925 Moon (Tycho under) *
  208.  
  209.  
  210. Site: SAIL
  211. Command line:
  212.  
  213.      Person          Job Jobnam Idle    Terminal
  214. DAN Dan Sleator       46 MACLSP      DM-3         150/1200 modem 415 49*
  215. DEK Don Knuth          3 E        3. tv-55  205   Library
  216.                       20 PI       2  TV-55  205   Library
  217. ES  Gene Salamin      44 SD MC       TV-40  223a  Farmwald
  218. JJ  Jerrold Ginsparg  11 TELNET      DM-0         150/1200 modem 415 49*
  219. JMC John McCarthy      1 FINGER    . detached
  220.                       12 E        2. IML-15       McCarthy's house
  221. KRD Randy Davis       42 AID      7  TV-52  203   Allen
  222. LES Les Earnest       23 TEMPS    2. DM-1         150/1200 modem 415 49*
  223. ME  Martin Frost      17 E        3  tv-46  220   Filman, Frost
  224.                       31 E           TV-46  220   Filman, Frost
  225. PAM Paul Martin        9 E           TV-106 251C  King, Levy, Martin
  226. ROD Rod Brooks        37 MACLSP   3  TV-117 250C
  227. RWG Bill Gosper       30 SD MC       TV-34  230e  Robinson
  228.                                      TV-67  213   Kant, McCune, Steinbe*
  229. RWW Richard Weyhrauch 39 E           TV-42  214   Weyhrauch
  230. SYS system files       6 FINGER      PTY122       job 5 Arpanet site AI*
  231.  
  232.  
  233.  
  234.  
  235.  
  236.                                                                 [Page 4]
  237.  
  238. NWG/RFC# 742                                  KLH 30-Dec-77 08:31  42758
  239. Appendix - Examples
  240.  
  241.  
  242.  
  243.  
  244.  
  245. Site: SRI-KL
  246. Command line:
  247.  
  248. Thursday, 15-Dec-77 01:21:24-PST  System up  3 Days, 22:20:52  28 Jobs
  249. Drum   0%  Load avs 0.26 0.23 0.31   14 Act, 10 Idle,  8 Det
  250.  
  251. User    Personal Name     Job Subsys 15m%  TTY  Room   Console Location
  252. BLEAN   Bob Blean          37 EXEC    0.0   41  K2007  Blean
  253. KLH     Ken Harrenstien    83 TELNET  1.6   12  J2023  Spaceport
  254. KREMERS Jan Kremers        48 TECO    0.0  121  Dialup 326-7005 (300 Ba*
  255. MAINT   Digital Equipment  54 SNDMSG  0.5   43  K2035  Melling
  256. MCCLURG Jim McClurg        40 EXEC    0.0   26  PKT
  257. MMCM    Michael McMahon    31 EXEC    1.5  122  Dialup 326-7006 (300 Ba*
  258. MOORE   J Moore            52 TV      0.2  124  Dialup 326-7008 (300 Ba*
  259. PATTIS  Richard Pattis     19 LISP    0.8   11  ARC
  260. PETERSO Norman Peterson    33 EXEC   25:12 234         (RAND-TIP)
  261. STONE   Duane Stone        34 TELNET 3:51  240         (RADC-TIP)
  262.                            27 EXEC   7:11  232         (SRI-KL)
  263. TORRES  Israel Torres      64 BSYS    0.0   76  K2079  TI by tape drives
  264.                            68 EXEC   1:15  104  K2029  Operators' Office
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.                                                                 [Page 5]
  296.  
  297. NWG/RFC# 742                                  KLH 30-Dec-77 08:31  42758
  298. Appendix - Examples
  299.  
  300.  
  301.  
  302.                      Examples with names specified:
  303.  
  304.  
  305.  
  306. Site: MIT-AI
  307. Command line: klh
  308.  
  309. KLH    + Ken Harrenstien        Last logout 10/16/77 13:02:11  No plan.
  310.  
  311.  
  312. Site: MIT-MC
  313. Command line: cbf
  314.  
  315. CBF    M Charles Frankston      Not logged in.  Plan:
  316.   I'll be visiting another planet til about December 15.  If anyone
  317.   wants to get a hold of me transmit on some fundamental wavelength
  318.   (like the radius of the hydrogen atom).
  319.  
  320.  
  321. Site: MIT-MC
  322. Command line: smith
  323.  
  324. BRIAN  A Brian C. Smith         Last logout 11/24/77 08:02:24  No plan.
  325. DBS    T David B. Smith         Last logout 12/03/77 11:24:01  No plan.
  326. BPS    T Byron Paul Smith       Not logged in.  No plan.
  327. GRS    U Gary R. Smith          Last logout 12/12/77 18:43:19  No plan.
  328. JOS    S Julius Orion III Smith Last logout 11/29/77 06:18:18  No plan.
  329. $PETE  M PETER G. SMITH,        Not logged in.  No plan.
  330. IAN    L Ian C. Smith           Not logged in.  No plan.
  331. AJS    D Arnold J. Smith        Last logout 12/09/77 14:31:11  No plan.
  332.  
  333.  
  334. Site: SU-AI
  335. Command line: smith
  336.  
  337. "SMITH" is ambiguous:
  338. RS  Bob Smith
  339. DAV Dave Smith
  340. JOS Julius Smith
  341. LCS Leland Smith
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.                                                                 [Page 6]
  355.  
  356. NWG/RFC# 742                                  KLH 30-Dec-77 08:31  42758
  357. Appendix - Examples
  358.  
  359.  
  360.  
  361. Site: SU-AI
  362. Command line: jbr
  363.  
  364.      Person          Job Jobnam Idle Line  Room   Location
  365. JBR Jeff Rubin        16 COPY    27. TV-43  222   Rubin
  366.                                      TV-104 233   hand-eye table
  367.  
  368.  
  369. Site: SU-AI
  370. Command line: bh
  371.  
  372.      Person               Last logout
  373. BH  Brian Harvey      22:49 on 14 Dec 1977.  Plan:
  374.     ^O08-Oct-77  2156   BH  ^Y12257 (1-Jul-78)
  375. Weekdays during the day I'm usually unreachable; I'm either at S.F.
  376. State or at Benjamin Franklin JHS in San Francisco, but neither place
  377. is recommended for leaving messages.  Evenings and weekends I'm
  378. generally home (55) 751-1762 unless I'm at SAIL.  I log in daily from
  379. home.
  380.  
  381.  
  382. Site: SRI-KL
  383. Command line: greg
  384.  
  385. GREG (Greg Hinchliffe) is on the system:
  386.  
  387. Job Subsys  # Siz  Runtime    1m%  15m%  TTY  Room   Console Location
  388. 62  EXEC    1   0  0:00:10.6        0.8  235         (SUMEX-AIM)
  389.  
  390. Last login: Mon 12-Dec-77, 15:05, from SUMEX-AIM (Host #56.)
  391. GREG has no new mail, last read on Mon 12-Dec-77 15:10
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.                                                                 [Page 7]