share/man/man4/man4.vax/hy.4

   1 .\"     $NetBSD: hy.4,v 1.10 2002/02/13 08:18:07 ross Exp $
   2 .\"
   3 .\" Copyright (c) 1983, 1991, 1993
   4 .\"     The Regents of the University of California.  All rights reserved.
   5 .\"
   6 .\" Redistribution and use in source and binary forms, with or without
   7 .\" modification, are permitted provided that the following conditions
   8 .\" are met:
   9 .\" 1. Redistributions of source code must retain the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer.
  11 .\" 2. Redistributions in binary form must reproduce the above copyright
  12 .\"    notice, this list of conditions and the following disclaimer in the
  13 .\"    documentation and/or other materials provided with the distribution.
  14 .\" 3. Neither the name of the University nor the names of its contributors
  15 .\"    may be used to endorse or promote products derived from this software
  16 .\"    without specific prior written permission.
  17 .\"
  18 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  19 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  20 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  21 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  22 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  23 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  24 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  25 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  26 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  27 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  28 .\" SUCH DAMAGE.
  29 .\"
  30 .\"     from: @(#)hy.4  8.1 (Berkeley) 6/5/93
  31 .\"
  32 .Dd June 5, 1993
  33 .Dt HY 4 vax
  34 .Os
  35 .Sh NAME
  36 .Nm hy
  37 .Nd Network Systems Hyperchannel interface
  38 .Sh SYNOPSIS
  39 .Cd "hy0 at uba0 csr 0172410 vector hyint"
  40 .Sh DESCRIPTION
  41 NOTE: This driver has not been ported from
  42 .Bx 4.4
  43 yet.
  44 .Pp
  45 The
  46 .Nm hy
  47 interface provides access to a Network
  48 Systems Corporation Hyperchannel Adapter.
  49 .Pp
  50 The network to which the interface is attached
  51 is specified at boot time with an
  52 .Dv SIOCSIFADDR
  53 .Xr ioctl 2 .
  54 The host's address is discovered by reading the adapter status
  55 register.  The interface will not transmit or receive
  56 packets until the network number is known.
  57 .Sh DIAGNOSTICS
  58 .Bl -diag
  59 .It "hy%d: unit number 0x%x port %d type %x microcode level 0x%x."
  60 Identifies the device during autoconfiguration.
  61 .Pp
  62 .It hy%d: can't handle af%d.
  63 The interface was handed
  64 a message with addresses formatted in an unsuitable address
  65 family; the packet was dropped.
  66 .Pp
  67 .It hy%d: can't initialize.
  68 The interface was unable to allocate
  69 .Tn UNIBUS
  70 resources. This
  71 is usually due to having too many network devices on an 11/750
  72 where there are only 3 buffered data paths.
  73 .Pp
  74 .It hy%d: NEX - Non Existent Memory.
  75 Non existent memory error returned from hardware.
  76 .Pp
  77 .It hy%d:  BAR overflow.
  78 Bus address register
  79 overflow error returned from hardware.
  80 .Pp
  81 .It hy%d: Power Off bit set, trying to reset.
  82 Adapter has lost power, driver will reset the bit
  83 and see if power is still out in the adapter.
  84 .Pp
  85 .It hy%d: Power Off Error, network shutdown.
  86 Power was really off in the adapter, network
  87 connections are dropped.
  88 Software does not shut down the network unless
  89 power has been off for a while.
  90 .Pp
  91 .It hy%d: RECVD MP \*[Gt] MPSIZE (%d).
  92 A message proper was received that is too big.
  93 Probable a driver bug.
  94 Shouldn't happen.
  95 .Pp
  96 .It "hy%d: xmit error \- len \*[Gt] hy_olen [%d \*[Gt] %d]."
  97 Probable driver error.
  98 Shouldn't happen.
  99 .Pp
 100 .It hy%d: DRIVER BUG \- INVALID STATE %d.
 101 The driver state machine reached a non-existent state.
 102 Definite driver bug.
 103 .Pp
 104 .It hy%d: watchdog timer expired.
 105 A command in the adapter has taken too long to complete.
 106 Driver will abort and retry the command.
 107 .Pp
 108 .It hy%d: adapter power restored.
 109 Software was able to reset the power off bit,
 110 indicating that the power has been restored.
 111 .El
 112 .Sh SEE ALSO
 113 .Xr inet 4 ,
 114 .Xr netintro 4
 115 .Sh HISTORY
 116 The
 117 .Nm
 118 interface appeared in
 119 .Bx 4.2 .
 120 .Sh BUGS
 121 If the adapter does not respond to the status command
 122 issued during autoconfigure, the adapter is assumed down.
 123 A reboot is required to recognize it.
 124 .Pp
 125 The adapter power fail interrupt seems to occur
 126 sporadically when power has, in fact, not failed.
 127 The driver will believe that power has failed
 128 only if it can not reset the power fail latch after
 129 a
 130 .Dq reasonable
 131 time interval.
 132 These seem to appear about 2-4 times a day on some machines.
 133 There seems to be no correlation with adapter
 134 rev level, number of ports used etc. and whether a
 135 machine will get these
 136 .Dq bogus powerfails .
 137 They don't seem to cause any real problems so they have
 138 been ignored.