NetBSD/sys/dev/isa
dyoung de87fe677d *** Summary ***
When a link-layer address changes (e.g., ifconfig ex0 link
02🇩🇪ad:be:ef:02 active), send a gratuitous ARP and/or a Neighbor
Advertisement to update the network-/link-layer address bindings
on our LAN peers.

Refuse a change of ethernet address to the address 00:00:00:00:00:00
or to any multicast/broadcast address.  (Thanks matt@.)

Reorder ifnet ioctl operations so that driver ioctls may inherit
the functions of their "class"---ether_ioctl(), fddi_ioctl(), et
cetera---and the class ioctls may inherit from the generic ioctl,
ifioctl_common(), but both driver- and class-ioctls may override
the generic behavior.  Make network drivers share more code.

Distinguish a "factory" link-layer address from others for the
purposes of both protecting that address from deletion and computing
EUI64.

Return consistent, appropriate error codes from network drivers.

Improve readability.  KNF.

*** Details ***

In if_attach(), always initialize the interface ioctl routine,
ifnet->if_ioctl, if the driver has not already initialized it.
Delete if_ioctl == NULL tests everywhere else, because it cannot
happen.

In the ioctl routines of network interfaces, inherit common ioctl
behaviors by calling either ifioctl_common() or whichever ioctl
routine is appropriate for the class of interface---e.g., ether_ioctl()
for ethernets.

Stop (ab)using SIOCSIFADDR and start to use SIOCINITIFADDR.  In
the user->kernel interface, SIOCSIFADDR's argument was an ifreq,
but on the protocol->ifnet interface, SIOCSIFADDR's argument was
an ifaddr.  That was confusing, and it would work against me as I
make it possible for a network interface to overload most ioctls.
On the protocol->ifnet interface, replace SIOCSIFADDR with
SIOCINITIFADDR.  In ifioctl(), return EPERM if userland tries to
invoke SIOCINITIFADDR.

In ifioctl(), give the interface the first shot at handling most
interface ioctls, and give the protocol the second shot, instead
of the other way around. Finally, let compatibility code (COMPAT_OSOCK)
take a shot.

Pull device initialization out of switch statements under
SIOCINITIFADDR.  For example, pull ..._init() out of any switch
statement that looks like this:

        switch (...->sa_family) {
        case ...:
                ..._init();
                ...
                break;
        ...
        default:
                ..._init();
                ...
                break;
        }

Rewrite many if-else clauses that handle all permutations of IFF_UP
and IFF_RUNNING to use a switch statement,

        switch (x & (IFF_UP|IFF_RUNNING)) {
        case 0:
                ...
                break;
        case IFF_RUNNING:
                ...
                break;
        case IFF_UP:
                ...
                break;
        case IFF_UP|IFF_RUNNING:
                ...
                break;
        }

unifdef lots of code containing #ifdef FreeBSD, #ifdef NetBSD, and
#ifdef SIOCSIFMTU, especially in fwip(4) and in ndis(4).

In ipw(4), remove an if_set_sadl() call that is out of place.

In nfe(4), reuse the jumbo MTU logic in ether_ioctl().

Let ethernets register a callback for setting h/w state such as
promiscuous mode and the multicast filter in accord with a change
in the if_flags: ether_set_ifflags_cb() registers a callback that
returns ENETRESET if the caller should reset the ethernet by calling
if_init(), 0 on success, != 0 on failure.  Pull common code from
ex(4), gem(4), nfe(4), sip(4), tlp(4), vge(4) into ether_ioctl(),
and register if_flags callbacks for those drivers.

Return ENOTTY instead of EINVAL for inappropriate ioctls.  In
zyd(4), use ENXIO instead of ENOTTY to indicate that the device is
not any longer attached.

Add to if_set_sadl() a boolean 'factory' argument that indicates
whether a link-layer address was assigned by the factory or some
other source.  In a comment, recommend using the factory address
for generating an EUI64, and update in6_get_hw_ifid() to prefer a
factory address to any other link-layer address.

Add a routing message, RTM_LLINFO_UPD, that tells protocols to
update the binding of network-layer addresses to link-layer addresses.
Implement this message in IPv4 and IPv6 by sending a gratuitous
ARP or a neighbor advertisement, respectively.  Generate RTM_LLINFO_UPD
messages on a change of an interface's link-layer address.

In ether_ioctl(), do not let SIOCALIFADDR set a link-layer address
that is broadcast/multicast or equal to 00:00:00:00:00:00.

Make ether_ioctl() call ifioctl_common() to handle ioctls that it
does not understand.

In gif(4), initialize if_softc and use it, instead of assuming that
the gif_softc and ifp overlap.

Let ifioctl_common() handle SIOCGIFADDR.

Sprinkle rtcache_invariants(), which checks on DIAGNOSTIC kernels
that certain invariants on a struct route are satisfied.

In agr(4), rewrite agr_ioctl_filter() to be a bit more explicit
about the ioctls that we do not allow on an agr(4) member interface.

bzero -> memset.  Delete unnecessary casts to void *.  Use
sockaddr_in_init() and sockaddr_in6_init().  Compare pointers with
NULL instead of "testing truth".  Replace some instances of (type
*)0 with NULL.  Change some K&R prototypes to ANSI C, and join
lines.
2008-11-07 00:20:01 +00:00
..
ad1848_isa.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
ad1848var.h Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
addcom_isa.c use aprint_*_dev and device_xname 2008-04-08 20:08:49 +00:00
adv_isa.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
aha_isa.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
aic_isa.c use aprint_*_dev and device_xname 2008-04-08 20:08:49 +00:00
aps.c Don't forget to unmap I/O space in the error paths. 2008-04-04 09:41:40 +00:00
aria.c use aprint_*_dev and device_xname 2008-04-08 20:08:49 +00:00
ariareg.h
ast.c Pass the com softc to comintr, not the device_t. 2008-05-30 10:59:42 +00:00
atppc_isa.c device_t / softc split. From Hans Rosenfeld. 2008-04-16 09:39:01 +00:00
atppc_isadma.c device_t / softc split. From Hans Rosenfeld 2008-04-15 15:02:28 +00:00
atppc_isadma.h
attimer_isa.c Convert to new 2 clause license 2008-04-29 06:53:00 +00:00
aztech.c use aprint_*_dev and device_xname 2008-04-08 20:08:49 +00:00
bha_isa.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
boca.c use aprint_*_dev and device_xname 2008-04-08 20:08:49 +00:00
cec.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
cms.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
cmsreg.h Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
com_isa.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
com_multi.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
com_multi.h
commultiprint.c
cs89x0isa.c use aprint_*_dev and device_xname 2008-04-08 20:08:49 +00:00
cs89x0isavar.h
cs4231var.h Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
cy_isa.c split device_t/softc. Use aprint_*_dev and device_xname. 2008-03-26 17:50:32 +00:00
daic_isa.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
depca_isa.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
dpt_isa.c
ega.c
egavar.h
elink.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
elink.h Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
esp_isa.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
esp_isavar.h Split device_t/softc for MI ncr53c9x and some related devices, 2008-04-13 04:55:52 +00:00
ess_isa.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
ess.c use aprint_*_dev and device_xname 2008-04-08 20:08:49 +00:00
essreg.h
essvar.h
fd.c after the "struct disk" is finished with, it should be 2008-05-03 08:23:41 +00:00
fdc_isa.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
fdcvar.h Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
fdreg.h
fdvar.h Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
files.isa Add the finsio(4) driver. This driver supports the Hardware Monitor 2008-04-03 22:46:22 +00:00
finsio_isa.c Set the ENVSYS_FCHANGERFACT flag in voltage sensors, so that we 2008-04-22 13:33:38 +00:00
gus.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
gusreg.h Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
i82365_isa.c constify the pcmcia/cardbus method tables 2008-06-26 12:33:17 +00:00
i82365_isasubr.c use aprint_*_dev and device_xname 2008-04-08 20:08:49 +00:00
i82365_isavar.h
ics2101.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
ics2101var.h Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
if_ai.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
if_aireg.h Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
if_ate.c Split device_t/softc for MI mb86960, with misc cosmetics. 2008-04-12 06:27:01 +00:00
if_cs_isa.c use aprint_*_dev and device_xname 2008-04-08 20:08:49 +00:00
if_ec.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
if_ecreg.h
if_ef.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
if_efreg.h Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
if_eg.c *** Summary *** 2008-11-07 00:20:01 +00:00
if_egreg.h
if_el.c *** Summary *** 2008-11-07 00:20:01 +00:00
if_elreg.h
if_ep_isa.c device_t changes, pmf, minor knf. 2008-08-27 05:33:47 +00:00
if_fmv_isa.c Split device_t/softc for MI mb86960, with misc cosmetics. 2008-04-12 06:27:01 +00:00
if_hp.c *** Summary *** 2008-11-07 00:20:01 +00:00
if_ix.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
if_ixreg.h
if_iy.c *** Summary *** 2008-11-07 00:20:01 +00:00
if_lc_isa.c use aprint_*_dev and device_xname 2008-04-08 20:08:49 +00:00
if_le_isa.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
if_levar.h Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
if_ne_isa.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
if_ntwoc_isa.c use aprint_*_dev and device_xname 2008-04-08 20:08:49 +00:00
if_ntwoc_isareg.h
if_sm_isa.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
if_tr_isa.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
if_tribm_isa.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
if_trtcm_isa.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
if_tscs_isa.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
if_we_isa.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
ioat66.c use aprint_*_dev and device_xname 2008-04-08 20:08:49 +00:00
isa.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
isabusprint.c
isadma.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
isadmareg.h Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
isadmavar.h Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
isareg.h
isavar.h Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
isic_isa_avm_a1.c
isic_isa_itk_ix1.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
isic_isa_tel_s08.c
isic_isa_tel_s016.c
isic_isa_tel_s0163.c
isic_isa_usr_sti.c
isic_isa.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
isv.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
isvio.h Certain misguided people have complained, NetBSD only runs rare or 2008-04-02 01:34:36 +00:00
itesio_isa.c Also attach in the IT8726F Super I/O. 2008-04-26 19:01:53 +00:00
itesio_isavar.h Also attach in the IT8726F Super I/O. 2008-04-26 19:01:53 +00:00
joy_ess.c Split device_t/softc for joy(4) and all its attachments. Also 2008-03-26 18:27:07 +00:00
joy_isa.c Split device_t/softc for joy(4) and all its attachments. Also 2008-03-26 18:27:07 +00:00
lm_isa.c Consistent use of softc member name - fixes build breakage from previous. 2008-10-12 23:07:32 +00:00
lpt_isa.c lpt(4): register NULL pmf handler. 2008-05-31 14:07:03 +00:00
madreg.h
Makefile Certain misguided people have complained, NetBSD only runs rare or 2008-04-02 01:34:36 +00:00
mcd.c Replace device_lookup() with device_lookup_private() on getting softc 2008-06-08 12:43:51 +00:00
mcdreg.h
midi_pcppi.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
moxa_isa.c use aprint_*_dev and device_xname 2008-04-08 20:08:49 +00:00
mpu_isa.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
mpu_sb.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
mpu_ym.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
nca_isa.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
nsclpcsio_isa.c Fix fallout from previous commit. 2008-04-04 13:10:41 +00:00
opl_ess.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
opl_isa.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
opl_sb.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
opl_wss.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
opl_ym.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
pas.c Split device_t and softc for sb(4) and all its attachments. 2008-03-15 21:09:02 +00:00
pasreg.h
pcdisplay.c
pcdisplayvar.h
pckbc_isa.c Add pmf support. 2008-05-25 16:19:12 +00:00
pcppi.c Fix a softc split fallout. 2008-03-05 22:46:43 +00:00
pcppireg.h
pcppivar.h - Split device_t and softc for pcppi(4) and attimer(4) 2008-03-04 16:35:18 +00:00
radiotrack2.c
radiotrack.c use aprint_*_dev and device_xname 2008-04-08 20:08:49 +00:00
README.seagate
rtfps.c use aprint_*_dev and device_xname 2008-04-08 20:08:49 +00:00
satlink.c Replace device_lookup() with device_lookup_private() on getting softc 2008-06-08 12:43:51 +00:00
satlinkio.h Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
satlinkreg.h Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
sb_isa.c Split device_t and softc for sb(4) and all its attachments. 2008-03-15 21:09:02 +00:00
sb.c Split device_t and softc for sb(4) and all its attachments. 2008-03-15 21:09:02 +00:00
sbdsp.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
sbdspvar.h Split device_t and softc for sb(4) and all its attachments. 2008-03-15 21:09:02 +00:00
sbreg.h
sbvar.h Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
seagate.c Replace device_lookup() with device_lookup_private() on getting softc 2008-06-08 12:43:51 +00:00
sf16fmr2.c
slhci_isa.c split device/softc for USB host controllers and the usb (control) 2008-03-28 17:14:45 +00:00
smsc.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
smscvar.h Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
spkr.c Use CFATTACH_DECL_NEW and other related cosmetic changes. 2008-03-04 14:59:35 +00:00
spkrio.h
tcic2_isa.c constify the pcmcia/cardbus method tables 2008-06-26 12:33:17 +00:00
tcom.c Apply patch from Dave Huang in PR kern/39642: catch up on com(4)'s 2008-09-28 15:39:40 +00:00
toaster.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
toasterlcd.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
tsdio.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
tsdioreg.h
tsdiovar.h
ug_isa.c Don't forget to unmap I/O space in the error paths. 2008-04-04 09:30:55 +00:00
uha_isa.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
vga_isa.c Split device_t and softc for all attachments of vga(4). 2008-03-14 22:12:08 +00:00
vga_isavar.h
wdc_isa.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
wds.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
wdsreg.h
weasel_isa.c use aprint_*_dev and device_xname 2008-04-08 20:08:49 +00:00
weaselreg.h
weaselvar.h
wss_isa.c use aprint_*_dev and device_xname 2008-04-08 20:08:49 +00:00
wss.c
wssreg.h
wssvar.h
wt.c Replace device_lookup() with device_lookup_private() on getting softc 2008-06-08 12:43:51 +00:00
wtreg.h
ym.c Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00
ymvar.h Remove clause 3 and 4 from TNF licenses 2008-04-28 20:22:51 +00:00

#	$NetBSD: README.seagate,v 1.5 2005/12/11 12:22:02 christos Exp $

The hardware:

The ST01/02, and Future Domain 950 are very simple SCSI controllers. They are
not busmastering, so the processor must do all transfers a la IDE. They support
blind transfer by adding wait states (up to a certain limit). Interrupt is
generated for reconnect and parity errors (maybe also for some other events).

The card consists of one command port that writes to scsi control lines, reads
status lines, and a data port that read/writes to the 8 data lines. The address
decoding gives both data and control ports large memory areas to a single
port. This is used by the code.

The ST01/02 differs from the FD950 in memory address location and SCSI id.

Probing for the card:

A card is recognized by comparing the BIOS signature with known signatures. A
new card may not be recognized if the BIOS signature has changed. Please send
new signatures to me.

Driver function:

A scsi command is sent to scsi_cmd function. The command is either placed in
the queue or an retryable message is returned. The routine may wait for
completion of the command depending on the supplied flags. A timer is started
for every command placed in the queue. The commands are added in the order they
are received. There is a possiblity to make all REQUEST SENSE commands be
queued before all other commands, but I dont think it is a good thing (Linux
do however use this).

The card is mostly controlled by the sea_main function. It is called by
scsi_cmd, the interrupt routine, and the timeout routine. The sea_main routine
runs as long there are something to do (transfer data, issue queued commands,
and handle reconnected commands).

The data transfers may be done in two different ways: Blind and polled
transfers. They differ in the way the driver does it handshaking with the
target. During a blind transfer, the driver code blindly transfers a block
of data without checking for changed phase. During polled transfers, the
phase is checked between every character transfered. The polled transfers
are always used for status information and command transfers.

Because the card does not use DMA in any way, there is no need to handle
physical addresses. There is no problem with the isa-bus address limit of
16MB, making bounce-buffers unnecessary.

The data structures:

Every card has a sea_softc structure keeping the queues of commands waiting to
be issued, and commands currently disconnected. The type of card (Seagate or
Future Domain), data and control port addresses, scsi id, busy flags for all
possible targets, and interrupt vector for the card.

Every scsi command to be issued are stored in a sea_scb structure. It contains
a flag describing status/error of the command, current data buffer position,
and number of bytes remaining to be transfered.


PROBLEMS

I have had problems getting the ST02 boot using the boot floppies. I think it
is some problem with BIOS calls not working. It is unfortunately impossible to
disconnect the ST02 floppy controller.

I have had problem to get the driver talk to a 40 MB Seagate disk. I dont have
access to it any more, so I can't do any more checks on that.

NOTE: The ST02 creates its own description of the disk attached. This is not
the same as the disk says. This translation problem may cause problems when
sharing a disk between both DOS and BSD. It is however not impossible.