NAME

hyp − hyperchannel table translation

SYNOPSIS

hyp [-f input file] [-h hostname]

DESCRIPTION

Hyp takes an input file describing a hyperchannel network layout, and produces a routing map for a specific host.  It is intended to be used as a filter in front of hyroute.  It is only useful if there is some non-linear topology associated with the network.  It allows maintenance of one table, where multiple hyroute tables are needed in a given network. 

The −f option allows you to read from a specific file.  If no input file is specified, hyp looks for Hy.net then hy.net.  Specifying a dash (−) for the input file directs hyp to read from the standard input. 

By default, hyp will generate the routing map for the local host.  The −h option allows you to produce a routing table for a host other than the local host.  Hyp produces a map suitable for input to hyroute on the standard output, and a list of errors it found on the standard error. 

FILE FORMAT

The input file is composed of two parts − a list of hosts and their addresses and a description of the network topology. 

The list of hosts is a arranged as follows:

hosts
hostname0xaddress

where hostname is the name of a host attached to the network, and address is a four hexadecimal digit address that the IP layer is listening on.  The token hosts can be followed by up to 256 destinations, which is the current limit on how many the kernel can address. 

The network topology is described as follows:

net
trunk   #[,#[,#[,#]]]   [hostname  ...]

There can be any number of net constructs, each of which specifies a group of hosts connected to a particular trunk.  In each net, there can be from one to four trunk(s), listing the physical trunks to which these hosts are attached.  Each trunk is numbered either 0, 1, 2, or 3. 

The input file may also contain shell style comments. 

The following is an example Hy.net file. 

# A bunch of remote workstations and some VAXen.
net
trunk 3,2 navier3-hy amelia-hy wilbur-hy rhodan-hy
 # A bunch of local workstations
net
trunk 3,2 navier2-hy godzilla-hy
 # Some VAXen (short trunks)
net
trunk 3,2 navier0-hy navier1-hy fred-hy orville-hy
 # Everybody is on these two trunks
net
trunk 1,0 navier3-hy amelia-hy wilbur-hy rhodan-hy
  navier2-hy godzilla-hy
  navier0-hy navier1-hy fred-hy orville-hy
 hosts
# The Cray 2
navier-hy0xc415
navier1-hy0xc200
navier2-hy0x1100
navier3-hy0x2100
# IRIS Workstations
godzilla-hy0x2203
rhodan-hy0x2602
# VAXen
fred-hy0x1200
orville-hy0x1201
amelia-hy0x2400
wilbur-hy0x2401

FILES

[Hh]y.netnetwork topology description

SEE ALSO

hyroute(1M)

Version 3.6  —  December 20, 1987