NICNAME/WHOIS
The original description of the NICNAME/WHOIS directory server on the SRI-NIC machine.
Harrenstien, K. and V. White, "NICNAME/WHOIS", RFC 812, DOI 10.17487/RFC0812, March 1982, <https://www.rfc-editor.org/info/rfc812>.
@misc{rfc812,
series = {Request for Comments},
number = 812,
howpublished = {RFC 812},
publisher = {RFC Editor},
doi = {10.17487/RFC0812},
url = {https://www.rfc-editor.org/info/rfc812},
author = {K. Harrenstien and V. White},
title = {{NICNAME/WHOIS}},
pagetotal = 2,
year = 1982,
month = mar,
} RFC text
Contents
Ken Harrenstien RFC-812
Vic White 1 March 1982
Network Information Center
SRI International
NICNAME/WHOIS
INTRODUCTION
The NICNAME/WHOIS Server is an NCP/TCP transaction based
query/response server, running on the SRI-NIC machine, that
provides netwide directory service to ARPANET users. It is
one of a series of ARPANET/Internet name services maintained
by the Network Information Center (NIC) at SRI International
on behalf of the Defense Communications Agency (DCA). The
server is accessible across the ARPANET from user programs
running on local hosts, and it delivers the full name, U.S.
mailing address, telephone number, and network mailbox for
ARPANET users.
This server, together with the corresponding Identification
Data Base provides online directory look-up equivalent to the
ARPANET Directory. DCA strongly encourages network hosts to
provide their users with access to this network service.
WHO SHOULD BE IN THE DATA BASE
DCA requests that each individual with a directory on an
ARPANET host, who is capable of passing traffic across the
ARPANET, be registered in the NIC Identification Data Base.
To register, send full name, middle initial, U.S. mailing
address (including mail stop and full explanation of
abbreviations and acronyms), ZIP code, telephone (including
Autovon and FTS, if available), and one network mailbox, via
electronic mail to NIC@SRI-NIC.
PROTOCOL
The NICNAME protocol is similar to the NAME/FINGER protocol
(RFC 742). To access the server:
Connect to the service host (SRI-NIC)
TCP: service port 43 decimal
NCP: ICP to socket 43 decimal, establishing two 8-bit
connections
Send a single "command line", ending with <CRLF>.
Receive information in response to the command line. The
server closes its connections as soon as the output is
finished.
NICNAME/WHOIS
EXISTING USER PROGRAMS
NICNAME has been chosen as the global name for the user
program, although some sites may choose to use the more
familiar name of "WHOIS". There are versions of NICNAME for
Tenex, Tops-20, and Unix. The Tenex and Tops-20 programs are
written in assembly language (FAIL/MACRO), and the Unix
version is written in C. They are easy to invoke, taking one
argument which is passed directly to the NICNAME server at
SRI-NIC. Normally it is best to use the NIC-supplied
programs, if possible, since the protocol will continue to
evolve. Contact NIC@SRI-NIC for copies.
COMMAND LINES AND REPLIES
A command line is normally a single name specification. The
easiest way to obtain the most recent documentation on name
specifications is to give the server a command line consisting
of "?<CRLF>" (that is, a question-mark alone as the name
specification). The response from the NICNAME server will
list all possible formats that can be used.
The responses are not currently intended to be
machine-readable; the information is meant to be passed back
directly to a human user. The following three examples will
illustrate the use of NICNAME.
Command line: ?
Response:
Please enter a name or a handle ("ident"), such as "Smith"
or "SRI-NIC". Starting with a period forces a name-only
search;
starting with exclamation point forces handle-only. Examples:
Smith [looks for name or handle SMITH ]
!SRI-NIC [looks for handle SRI-NIC only ]
.Smith, John [looks for name JOHN SMITH only ]
Adding "..." to the argument will match anything from that
point,
e.g. "ZU..." will match ZUL, ZUM, etc.
To have the ENTIRE membership list of a group or
organization,
if you are asking about a group or org, shown with the record,
use
an asterisk character "*" directly preceding the given
argument.
[CAUTION: If there are a lot of members this will take a long
time!]
You may of course use exclamation point and asterisk, or a
period
and asterisk together.
NICNAME/WHOIS
Command line: dyer
Response:
Dyer, David A. (DAD2) DDYER@USC-ISIB (213) 822-1511
Dyer, Fred S. (FSD) Dyer@RADC-MULTICS (315) 330-7275
Dyer, Mary K. (MARY) DYER@SRI-NIC (415) 859-4775
Dyer, William R. (WRD) WRDyer@RADC-MULTICS (315) 330-7791
Command line: mary
Response:
Dyer, Mary K. (MARY) DYER@SRI-NIC
SRI International
Network Information Center
Telecommunications Sciences Center
333 Ravenswood Avenue
Menlo Park, California 94025
Phone: (415) 859-4775
AI ELI5
On this page
§1A Network Directory Service
The NICNAME/WHOIS server runs on the SRI-NIC machine and gives ARPANET users a directory look-up. Together with the Identification Data Base it is equivalent to the ARPANET Directory. It delivers the full name, U.S. mailing address, telephone number and network mailbox of users, and DCA strongly encourages hosts to give their users access.
DCA asks each individual with a directory on an ARPANET host to be registered, by sending their details by electronic mail to NIC@SRI-NIC.
It is a phone book for people on the network. If you are in the book, others can find how to reach you.
§2The Protocol
The protocol is similar to NAME/FINGER (RFC 742). A client connects to the service host SRI-NIC on TCP service port 43 decimal, sends a single command line ending in <CRLF>, and receives the answer. The server closes the connection as soon as its output is finished.
NICNAME is the global name of the user program, though some sites call it WHOIS. Versions existed for Tenex, Tops-20 and Unix, and the RFC advises using the NIC-supplied programs because the protocol will continue to evolve.
You make one call, ask one question, hear the answer, and the line hangs up on its own.
§3Command Lines and Replies
A command line is normally one name specification. Sending a lone ? returns help text listing the accepted formats. A leading period forces a name-only search, a leading exclamation point forces a handle-only search, and ending with ... matches anything from that point. An asterisk before the argument asks for the entire membership list of a group or organization.
The replies are not intended to be machine-readable; they are passed straight to a human user. The RFC shows a search for dyer that lists four people, and a search for mary that shows one full record with an address and phone number.
You can type part of a name, or add a special mark to say you only want names, or only IDs. The answer is written for people to read.