From 4bfd864f10b68b71482b35c818559068ef8d5797 Mon Sep 17 00:00:00 2001 From: Thomas Voss Date: Wed, 27 Nov 2024 20:54:24 +0100 Subject: doc: Add RFC documents --- doc/rfc/rfc742.txt | 413 +++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 413 insertions(+) create mode 100644 doc/rfc/rfc742.txt (limited to 'doc/rfc/rfc742.txt') diff --git a/doc/rfc/rfc742.txt b/doc/rfc/rfc742.txt new file mode 100644 index 0000000..3c4438f --- /dev/null +++ b/doc/rfc/rfc742.txt @@ -0,0 +1,413 @@ + +NWG/RFC# 742 KLH 30-Dec-77 08:31 42758 +Network Working Group K. Harrenstien +Request for Comments: 742 SRI-KL +NIC: 42758 30 December 1977 + + + + NAME/FINGER + + + + +Introduction + + This note describes the Name/Finger protocol. This is a simple + protocol which provides an interface to the Name and Finger programs + at several network sites. These programs return a friendly, + human-oriented status report on either the system at the moment or a + particular person in depth. Currently only the SAIL (SU-AI), SRI + (SRI-(KA/KL)), and ITS (MIT-(AI/ML/MC/DMS)) sites support this + protocol, but there are other systems with similar programs that + could easily be made servers; there is no required format and the + protocol consists mostly of specifying a single "command line". + +To use via the network: + + ICP to socket 117 (octal, 79. decimal) and establish two 8-bit + connections. + + Send a single "command line", ending with . + + Receive information which will vary depending on the above line and + the particular system. The server closes its connections as soon as + this output is finished. + +The command line: + + Systems may differ in their interpretations of this line. However, + the basic scheme is straightforward: if the line is null (i.e. just + a is sent) then the server should return a "default" report + which lists all people using the system at that moment. If on the + other hand a user name is specified (e.g. FOO) then the + response should concern only that particular user, whether logged in + or not. + + Both ITS and SAIL sites allow several names to be included on the + line, separated by commas; but the syntax for some servers can be + slightly more elaborate. For example, if "/W" (called the "Whois + switch") also appears on the line given to an ITS server, much fuller + descriptions are returned. The complete documentation may be found + at any time in the files ".INFO.;NAME ORDER" on MIT-AI, + "FINGER.LES[UP,DOC]" on SU-AI, and "FINGER.DOC" on + + + + + + [Page 1] + +NWG/RFC# 742 KLH 30-Dec-77 08:31 42758 +Name/Finger + + + + SRI-KL, all freely accessible by FTP (with the exception of SRI-KL, + where TOPS-20 requires the "anonymous" login convention). + + Allowable "names" in the command line should of course include "user + names" or "login names" as defined by the system, but it is also + reasonable to understand last names or even full names as well. If a + name is ambiguous, all possible derivations should be returned in + some fashion; SAIL will simply list the possible names and no more, + whereas an ITS server will furnish the full standard information for + each possibility. + +Response to null command line - "default" listing: + + This is a request for a list of all online users, much like a TOPS-10 + or TENEX "systat". To fulfill the basic intent of the Name/Finger + programs, the returned list should include at least the full names of + each user and the physical locations of their terminals insofar as + they can be determined. Including the job name and idle time (number + of minutes since last typein, or since last job activity) is also + reasonable and useful. The appendix has examples which demonstrate + how this information can be formatted. + +Response to non-null command line - "name" listing: + + For in-depth status of a specified user, there are two main cases. + If the user is logged in, a line or two is returned in the same + format as that for the "default" listing, but showing only that user. + If not logged in, things become more interesting. Furnishing the + full name and time of last logout is the expected thing to do, but + there is also a "plan" feature, wherein a user may leave a short + message that will be included in the response to such requests. This + is easily implemented by (for example) having the program look for a + specially named text file on the user's directory or some common + area. See the examples for typical "plans". + +Implementation miscellany: + + Anyone wishing to implement such a server is encouraged to get in + touch with the maintainers of NAME by sending a message to BUG-NAME @ + MIT-AI; apart from offering advice and help, a list of all sites + with such servers is kept there. It is also suggested that any + existing programs performing similar functions locally (i.e. not as + net servers) be extended to allow specification of other sites, or + names at other sites. For example, on ITS systems one can say + ":NAME" for a local default listing, or ":NAME @SAIL" for + SAIL's default listing, or ":NAME Foo@MC" to ask MIT-MC about + Foo's status, etc. + + + + + + [Page 2] + +NWG/RFC# 742 KLH 30-Dec-77 08:31 42758 +Name/Finger + + + + It should be noted that connecting directly to the server from a TIP + or an equally narrow-minded TELNET-protocol user program can result + in meaningless attempts at option negotiation being sent to the + server, which will foul up the command line interpretation unless the + server knows enough to filter out IAC's and perhaps even respond + negatively (IAC WON'T) to all option commands received. This is a + convenience but is not at all required, since normally the user side + is just an extended NAME/FINGER type program. + +And finally a little background: + + The FINGER program at SAIL, written by Les Earnest, was the + inspiration for the NAME program on ITS. Earl Killian at MIT and + Brian Harvey at SAIL were jointly responsible for implementing the + protocol just described, and Greg Hinchliffe has recently brought up + a similar server for SRI-KA and SRI-KL. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + [Page 3] + +NWG/RFC# 742 KLH 30-Dec-77 08:31 42758 +Appendix - Examples + + + + EXAMPLES + + + +Note: it is possible for some lines of the actual output to exceed 80 +chars in length. The handling of such lines is of course dependant on +the particular user program; in these examples, lines have been +truncated to 72 chars for greater clarity. + + Three examples with a null command line: + +Site: MIT-AI +Command line: + +-User- --Full name-- Jobnam Idle TTY -Console location- +XGP O Xerox Graphics Printer XGPSPL T24 Datapoint Near XGP (9TH) +FFM U Steven J. Kudlak HACTRN T41 Net site CMU-10A +KLH + Ken Harrenstien F T42 Net site SRI-KL +___013 - Not Logged In HACTRN 1:26.T43 DSSR UNIX x3-6048 (MIT-* +CWH U Carl W. Hoffman E 4.T50 919 Very Small Data Bas* +CARL A Carl Hewitt HACTRN 5:03.T52 813 Hewitt x5873 +APD M Alexander Doohovskoy XGP 1:52.T54 912 9th Floor Lounge x6* +JJK T James Koschella E T55 824 Hollerbach, Levin, * +KEN L Kenneth Kahn E T56 925 Moon (Tycho under) * + + +Site: SAIL +Command line: + + Person Job Jobnam Idle Terminal +DAN Dan Sleator 46 MACLSP DM-3 150/1200 modem 415 49* +DEK Don Knuth 3 E 3. tv-55 205 Library + 20 PI 2 TV-55 205 Library +ES Gene Salamin 44 SD MC TV-40 223a Farmwald +JJ Jerrold Ginsparg 11 TELNET DM-0 150/1200 modem 415 49* +JMC John McCarthy 1 FINGER . detached + 12 E 2. IML-15 McCarthy's house +KRD Randy Davis 42 AID 7 TV-52 203 Allen +LES Les Earnest 23 TEMPS 2. DM-1 150/1200 modem 415 49* +ME Martin Frost 17 E 3 tv-46 220 Filman, Frost + 31 E TV-46 220 Filman, Frost +PAM Paul Martin 9 E TV-106 251C King, Levy, Martin +ROD Rod Brooks 37 MACLSP 3 TV-117 250C +RWG Bill Gosper 30 SD MC TV-34 230e Robinson + TV-67 213 Kant, McCune, Steinbe* +RWW Richard Weyhrauch 39 E TV-42 214 Weyhrauch +SYS system files 6 FINGER PTY122 job 5 Arpanet site AI* + + + + + + [Page 4] + +NWG/RFC# 742 KLH 30-Dec-77 08:31 42758 +Appendix - Examples + + + + + +Site: SRI-KL +Command line: + +Thursday, 15-Dec-77 01:21:24-PST System up 3 Days, 22:20:52 28 Jobs +Drum 0% Load avs 0.26 0.23 0.31 14 Act, 10 Idle, 8 Det + +User Personal Name Job Subsys 15m% TTY Room Console Location +BLEAN Bob Blean 37 EXEC 0.0 41 K2007 Blean +KLH Ken Harrenstien 83 TELNET 1.6 12 J2023 Spaceport +KREMERS Jan Kremers 48 TECO 0.0 121 Dialup 326-7005 (300 Ba* +MAINT Digital Equipment 54 SNDMSG 0.5 43 K2035 Melling +MCCLURG Jim McClurg 40 EXEC 0.0 26 PKT +MMCM Michael McMahon 31 EXEC 1.5 122 Dialup 326-7006 (300 Ba* +MOORE J Moore 52 TV 0.2 124 Dialup 326-7008 (300 Ba* +PATTIS Richard Pattis 19 LISP 0.8 11 ARC +PETERSO Norman Peterson 33 EXEC 25:12 234 (RAND-TIP) +STONE Duane Stone 34 TELNET 3:51 240 (RADC-TIP) + 27 EXEC 7:11 232 (SRI-KL) +TORRES Israel Torres 64 BSYS 0.0 76 K2079 TI by tape drives + 68 EXEC 1:15 104 K2029 Operators' Office + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + [Page 5] + +NWG/RFC# 742 KLH 30-Dec-77 08:31 42758 +Appendix - Examples + + + + Examples with names specified: + + + +Site: MIT-AI +Command line: klh + +KLH + Ken Harrenstien Last logout 10/16/77 13:02:11 No plan. + + +Site: MIT-MC +Command line: cbf + +CBF M Charles Frankston Not logged in. Plan: + I'll be visiting another planet til about December 15. If anyone + wants to get a hold of me transmit on some fundamental wavelength + (like the radius of the hydrogen atom). + + +Site: MIT-MC +Command line: smith + +BRIAN A Brian C. Smith Last logout 11/24/77 08:02:24 No plan. +DBS T David B. Smith Last logout 12/03/77 11:24:01 No plan. +BPS T Byron Paul Smith Not logged in. No plan. +GRS U Gary R. Smith Last logout 12/12/77 18:43:19 No plan. +JOS S Julius Orion III Smith Last logout 11/29/77 06:18:18 No plan. +$PETE M PETER G. SMITH, Not logged in. No plan. +IAN L Ian C. Smith Not logged in. No plan. +AJS D Arnold J. Smith Last logout 12/09/77 14:31:11 No plan. + + +Site: SU-AI +Command line: smith + +"SMITH" is ambiguous: +RS Bob Smith +DAV Dave Smith +JOS Julius Smith +LCS Leland Smith + + + + + + + + + + + + + [Page 6] + +NWG/RFC# 742 KLH 30-Dec-77 08:31 42758 +Appendix - Examples + + + +Site: SU-AI +Command line: jbr + + Person Job Jobnam Idle Line Room Location +JBR Jeff Rubin 16 COPY 27. TV-43 222 Rubin + TV-104 233 hand-eye table + + +Site: SU-AI +Command line: bh + + Person Last logout +BH Brian Harvey 22:49 on 14 Dec 1977. Plan: + ^O08-Oct-77 2156 BH ^Y12257 (1-Jul-78) +Weekdays during the day I'm usually unreachable; I'm either at S.F. +State or at Benjamin Franklin JHS in San Francisco, but neither place +is recommended for leaving messages. Evenings and weekends I'm +generally home (55) 751-1762 unless I'm at SAIL. I log in daily from +home. + + +Site: SRI-KL +Command line: greg + +GREG (Greg Hinchliffe) is on the system: + +Job Subsys # Siz Runtime 1m% 15m% TTY Room Console Location +62 EXEC 1 0 0:00:10.6 0.8 235 (SUMEX-AIM) + +Last login: Mon 12-Dec-77, 15:05, from SUMEX-AIM (Host #56.) +GREG has no new mail, last read on Mon 12-Dec-77 15:10 + + + + + + + + + + + + + + + + + + + + + + [Page 7] \ No newline at end of file -- cgit v1.2.3