JUGHEAD(1)

NAME
jughead - is related to archie and veronica not only from the comic book archie, but the fact that veronica and jughead are tied directly to gopher and the fact jughead is an acronym for:

Jonzy's Universal Gopher Hierarchy Excavation And Display

SYNOPSIS
jughead [-dhHiIoOv] [-b dataFile] [-s selStr] host [-p port#] [-x hostNot2search port#] [- | hosts...]

jughead -B [dv] dataFile >

jughead -S [dv] indexFile [-l log]

DESCRIPTION
jughead is used to excavate through gopher menus, display the hierarchy of the encountered menus, acquire the name of the hosts accessed via a given server, build search tables, or run as a search engine waiting to do boolean searches on menu titles. The purpose of this program is to give a linear view of a gopher hierarchy, or allow users to search through menu titles for a given gopher server or group of gopher servers. Gopher was developed at the University of Minnesota.

-B builds an index table for quick access to the data found in "dataFile". By default this table is dumped to stdout, but should be directed to the file index file for use with the -S option.

-b creates a data file called "dataFile" for use with the -B option.

-d is for debugging mode which prints out diagnostic information concerning jughead.

-H prints the host and port accessed from "host".

-h prints the host accessed from "host".

-i prints host and port information for directories only.

-I prints host and port information for all entries.

-l says to log the search information to a log file. This option is only valid with the -S option.

-o only prints entries from hosts in "hosts".

-O same as "-o" except traverses the entire tree.

-p tells jughead to use "port" as the port number. The default port is gopher port 70.

-S runs jughead as a server listening out a port for a string containing words to search on. This include boolean operators "AND", "OR", and "NOT".

-s allows the use of sending a selector string "selStr", by default this is the empty string.

-v prints the version of jughead and terminates.

-x informs jughead to not search the menus of "hostNot2search" out port "port#".

host is the the hostname of the machine with the gopher server.

- flag means get the "hosts" from stdin. The hosts to search through need to be separated by any white space, and when you are finished entering the hosts enter EOF, ^D to quit.

hosts is a list of hosts to have their menu structure printed out or searched. If no "hosts" is specifed "host" will be the only host searched. If you specify any host in "hosts" and want "host" to be searched also, you must specify "host" as one of the "hosts".

EXAMPLES
1. To get a list of all items from the server "gopher.server" enter:

  jughead gopher.server

2. To get a list of all items stored on server "this.server" but actualy served from "gopher.server" enter:

  jughead -O gopher.server this.server

3. To get a list of all items stored on server "this.server" that are stored at the top level of "gopher.server" enter:

  jughead -o gopher.server this.server

4. To get a list of all the items, as well as the hostname and port in which the items reside, from all machines in the ".server" domain, whose links are actualy stored on "gopher.server" enter:

  jughead -I gopher.server .server

5. To get a list of items in the directory "directory", with a selector string "1/directory" stored and served from "gopher.server", and have the results placed in the file "result.file" enter:

  jughead "1/directory" gopher.server > result.file

6. To get a list of all hosts and the appropriate port which are accessed from the server "gopher.server" enter:

  jughead -h gopher.server

7. To build tables for any server in the ".edu" domain and not search through m.edu out port 2001, and then have jughead run as a server and log all search requests to the file data.log enter:

  jughead -Ob data gopher.server -x m.edu 2001 .edu
  jughead -B data > data.index
  jughead -S data.index -l data.log

FILES
/tmp/jughead.tmp which is used as a temporary file to expedite the transaction with the host to whom we are communicating with.

BUGS
No known bugs, but this is the first version of jughead. Please send any bug reports, complaints, or suggestions to:

jonzy@cc.utah.edu