xref: /netbsd-src/share/man/man4/man4.amiga/bah.4 (revision 3b01aba77a7a698587faaae455bbfe740923c1f5)
1.\"	$NetBSD: bah.4,v 1.10 1999/12/15 23:44:51 abs Exp $
2.\"
3.\" Copyright (c) 1995, 1997 The NetBSD Foundation, Inc.
4.\" All rights reserved.
5.\"
6.\" This code is derived from software contributed to The NetBSD Foundation
7.\" by Ignatios Souvatzis.
8.\"
9.\" Redistribution and use in source and binary forms, with or without
10.\" modification, are permitted provided that the following conditions
11.\" are met:
12.\" 1. Redistributions of source code must retain the above copyright
13.\"    notice, this list of conditions and the following disclaimer.
14.\" 2. Redistributions in binary form must reproduce the above copyright
15.\"    notice, this list of conditions and the following disclaimer in the
16.\"    documentation and/or other materials provided with the distribution.
17.\" 3. All advertising materials mentioning features or use of this software
18.\"    must display the following acknowledgement:
19.\"        This product includes software developed by the NetBSD
20.\"        Foundation, Inc. and its contributors.
21.\" 4. Neither the name of The NetBSD Foundation nor the names of its
22.\"    contributors may be used to endorse or promote products derived
23.\"    from this software without specific prior written permission.
24.\"
25.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
26.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
27.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
28.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
29.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
30.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
31.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
32.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
33.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
34.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
35.\" POSSIBILITY OF SUCH DAMAGE.
36.\"
37.\" The following requests are required for all man pages.
38.Dd May 31, 1995
39.Os
40.Dt BAH 4 amiga
41.Sh NAME
42.Nm bah
43.Nd ARCnet network driver for SMC COM90C26 based boards
44.Sh SYNOPSIS
45.Cd "bah* at zbus0"
46.Sh DESCRIPTION
47The
48.Nm
49interface provides access to the 2.5 Mb/s ARCnet network via the
50.Tn SMC
51COM90C26 + COM90C32
52ARCnet chip set.
53.Pp
54Each of the host's network addresses
55is specified at boot time with an
56.Dv SIOCSIFADDR
57.Xr ioctl .
58The interface MTU is 507 for protocols that do not use link level fragmentation
59and 60480 bytes for the others. The routing layer may specify additional
60limits.
61.br
62Currently supported protocols are IPv4(+ARP), and IPv6.
63.Sh IP version 4 considerations
64When the NOARP flag is set on the
65.Nm
66interface,
67it does not employ the address resolution protocol described in
68.Xr arp 4
69to dynamically map between Internet and Ethernet addresses on the local
70network. Instead, it uses the least significant 8 bits of the IP address
71as hardware address, as described in
72.Xr RFC 1051
73and
74.Xr RFC 1201 .
75.Pp
76With the IFF_LINK0 flag cleared, IP and ARP encoding is done according to the
77deprecated, but popular among Amiga users, RFC 1051 encoding (that
78is, with simple header, packet type 240 / 241), and the MTU is 507.
79.Pp
80With the IFF_LINK0 flag set, IP/ARP/RARP encoding is done according to RFC 1201
81(that is, with Packet Header Definition Standard header and packet type
82212/213). The MTU is normally 1500.
83.Pp
84When switching between the two modes, do a
85.Cd ifconfig interfacename down up
86to switch the mtu.
87.Pp
88When the IFF_LINK2 flag is set, ARP packets are sent with the protocol type
89encoded as it would be in the  ARCnet header, and decoded to the right protocol
90encoding on reception. According to "assigned numbers", this is wrong, but
91some legacy software (namely, AmiTCP 3.0beta) shows this bug.
92.Pp
93.Sh HARDWARE
94The
95.Nm
96interface supports the following Zorro II expansion cards:
97.Bl -tag -width "AMERISTAR" -offset indent
98.It Em A2060
99Commodore's ARCnet card, manufacturer\ 514, product\ 9
100.It Em AMERISTAR
101Ameristar's ARCnet card, manufacturer\ 1053, product\ 9
102.El
103.Sh SEE ALSO
104.Xr arp 4 ,
105.Xr ifconfig 8 ,
106.Xr inet 4 ,
107.Xr intro 4 ,
108.Xr RFC1051
109,
110.Xr RFC1201
111,
112.Xr RFC2497
113.br
114ARCnet Packet Header Definition Standard, Novell Inc., 1989
115.Sh STANDARDS
116RFC 1051 / RFC1201 with ARP, or without, using direct mapping of lower 8 IP
117address bits instead.
118.Sh HISTORY
119The
120.Tn Amiga
121.Nm
122interface first appeared in
123.Nx 1.1 .
124ARP support was added in
125.Nx 1.3 .
126.Sh AUTHOR
127Ignatios Souvatzis
128