PupToolDoc.tioga
Last edited by Neil Gunther, March 5, 1985 4:51:05 pm PST
PUPTOOL
CEDAR 5.2 — FOR INTERNAL XEROX USE ONLY
PupTool
A simple network interrogation program
Neil Gunther
© Copyright 1985 Xerox Corporation. All rights reserved.
Not to be confused with PupWatch, PupTool is the modern derivative of an ancient hack by Hal Murray. It is capable of determining; the host processor type and identification number; host or remote processor name or address; echoing to a remote processor; and producing a network routing table.
Keywords: Echo, Network, ProcessorID, Pup, Routing
XEROX  Xerox Corporation
   Palo Alto Research Center
   3333 Coyote Hill Road
   Palo Alto, California 94304

For Internal Xerox Use Only
Usage
Name or Address:
PupTool is mainly menu driven, the only other input needed being a name or address string. This is provided by clicking the button marked "Name or Address" and typing in the required string. There is a window below this button in which error messages are printed.

Echoing: 
The menu item "EchoOn" causes Echo-Me Pups to be sent to the given host. Most servers respond to such Pups by sending back a copy of the Pup data to its source in an I-Am-Echo Pup. Echo-Me Pups are sent in lengths ranging from the minimum to the maximum allowed and containing a distinctive data pattern. Each Echo-Me Pup causes a character to be printed in the Puptool text window. The character "!" indicates a successful echo, while the character "#" means that the returning Pup was out of sequence (i.e. late). The character "~" says that the data field of the I-Am-Echo did not match that of the Echo-Me, while the character "x" indicates that a non Echo-Me Pup arrived (the contents of this Pup will be displayed in the error window). Finally, if no Pup arrives within the timeout period of 2 seconds the character "?" will be printed.

Clicking "EchoOff" stops the echo test and prints a summary of the various Pups sent and received.
Processor ID:
This menu item will produce an octal representation of the host processor number.
Routing Table:
Clicking this menu item will produce a routing table to hosts on remote nets from the local net. Each entry in the table has the form:

Remote net # | local gateway used for that net | number of gateways on route
  
Get Name or Address:
Clicking the menu item "GetName" or "GetAddress" will cause the string in the Name or Address field to be converted to an internet name or address. Typical name strings which might be given are "ivy", "ivy+echo", "parc-nets3+cabernet+mail", "clover+12" etc. Typical address strings are "3##" (net 3), "3#121#", "3#121#234" etc.