RFC 812 UNKNOWN DIRECTORY · APPLICATIONS · HISTORY

NICNAME/WHOIS

The original description of the NICNAME/WHOIS directory server on the SRI-NIC machine.

On rfc-editor.org ↗
PUBLISHED
March 1982
AUTHORS
K. Harrenstien, V. White
STREAM
Legacy
OBSOLETED BY
RFC 954 — WHOIS, RFC 3912 — WHOIS
TCP SERVICE PORT
43 decimal
SERVICE HOST
SRI-NIC
COMMAND LINE ENDS WITH
CRLF
HELP COMMAND
?
DOI
10.17487/RFC0812

RFC text

Contents
Original text · RFC Editor View on rfc-editor.org ↗
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
PROBLEMARPANET users needed an online way to look up the full name, address, telephone number and network mailbox of other users.
MECHANISMA client connects to port 43 on SRI-NIC, sends one command line ending in a carriage return and line feed, reads the reply, and the server then closes the connection.
WHY IT FADEDThe replies are meant for human readers, not machines. The RFC was replaced by RFC 954 and RFC 3912.

§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.

§4References