Home | History | Annotate | Line # | Download | only in ic
lance.c revision 1.40.4.3
      1  1.40.4.3      yamt /*	$NetBSD: lance.c,v 1.40.4.3 2009/09/16 13:37:48 yamt Exp $	*/
      2       1.1  drochner 
      3       1.1  drochner /*-
      4       1.3   mycroft  * Copyright (c) 1997, 1998 The NetBSD Foundation, Inc.
      5       1.1  drochner  * All rights reserved.
      6       1.1  drochner  *
      7       1.1  drochner  * This code is derived from software contributed to The NetBSD Foundation
      8       1.3   mycroft  * by Charles M. Hannum and by Jason R. Thorpe of the Numerical Aerospace
      9       1.3   mycroft  * Simulation Facility, NASA Ames Research Center.
     10       1.1  drochner  *
     11       1.1  drochner  * Redistribution and use in source and binary forms, with or without
     12       1.1  drochner  * modification, are permitted provided that the following conditions
     13       1.1  drochner  * are met:
     14       1.1  drochner  * 1. Redistributions of source code must retain the above copyright
     15       1.1  drochner  *    notice, this list of conditions and the following disclaimer.
     16       1.1  drochner  * 2. Redistributions in binary form must reproduce the above copyright
     17       1.1  drochner  *    notice, this list of conditions and the following disclaimer in the
     18       1.1  drochner  *    documentation and/or other materials provided with the distribution.
     19       1.1  drochner  *
     20       1.1  drochner  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
     21       1.1  drochner  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
     22       1.1  drochner  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
     23       1.1  drochner  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
     24       1.1  drochner  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
     25       1.1  drochner  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
     26       1.1  drochner  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
     27       1.1  drochner  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
     28       1.1  drochner  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
     29       1.1  drochner  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
     30       1.1  drochner  * POSSIBILITY OF SUCH DAMAGE.
     31       1.1  drochner  */
     32       1.1  drochner 
     33       1.1  drochner /*-
     34       1.1  drochner  * Copyright (c) 1992, 1993
     35       1.1  drochner  *	The Regents of the University of California.  All rights reserved.
     36       1.1  drochner  *
     37       1.1  drochner  * This code is derived from software contributed to Berkeley by
     38       1.1  drochner  * Ralph Campbell and Rick Macklem.
     39       1.1  drochner  *
     40       1.1  drochner  * Redistribution and use in source and binary forms, with or without
     41       1.1  drochner  * modification, are permitted provided that the following conditions
     42       1.1  drochner  * are met:
     43       1.1  drochner  * 1. Redistributions of source code must retain the above copyright
     44       1.1  drochner  *    notice, this list of conditions and the following disclaimer.
     45       1.1  drochner  * 2. Redistributions in binary form must reproduce the above copyright
     46       1.1  drochner  *    notice, this list of conditions and the following disclaimer in the
     47       1.1  drochner  *    documentation and/or other materials provided with the distribution.
     48      1.29       agc  * 3. Neither the name of the University nor the names of its contributors
     49       1.1  drochner  *    may be used to endorse or promote products derived from this software
     50       1.1  drochner  *    without specific prior written permission.
     51       1.1  drochner  *
     52       1.1  drochner  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
     53       1.1  drochner  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
     54       1.1  drochner  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
     55       1.1  drochner  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
     56       1.1  drochner  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
     57       1.1  drochner  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
     58       1.1  drochner  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
     59       1.1  drochner  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
     60       1.1  drochner  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
     61       1.1  drochner  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
     62       1.1  drochner  * SUCH DAMAGE.
     63       1.1  drochner  *
     64       1.1  drochner  *	@(#)if_le.c	8.2 (Berkeley) 11/16/93
     65       1.1  drochner  */
     66      1.26     lukem 
     67      1.26     lukem #include <sys/cdefs.h>
     68  1.40.4.3      yamt __KERNEL_RCSID(0, "$NetBSD: lance.c,v 1.40.4.3 2009/09/16 13:37:48 yamt Exp $");
     69       1.1  drochner 
     70       1.1  drochner #include "bpfilter.h"
     71       1.1  drochner #include "rnd.h"
     72       1.1  drochner 
     73       1.1  drochner #include <sys/param.h>
     74       1.1  drochner #include <sys/systm.h>
     75      1.32     perry #include <sys/mbuf.h>
     76       1.1  drochner #include <sys/syslog.h>
     77       1.1  drochner #include <sys/socket.h>
     78       1.1  drochner #include <sys/device.h>
     79       1.1  drochner #include <sys/malloc.h>
     80       1.1  drochner #include <sys/ioctl.h>
     81       1.1  drochner #include <sys/errno.h>
     82       1.1  drochner #if NRND > 0
     83       1.1  drochner #include <sys/rnd.h>
     84       1.1  drochner #endif
     85       1.1  drochner 
     86       1.1  drochner #include <net/if.h>
     87       1.1  drochner #include <net/if_dl.h>
     88       1.1  drochner #include <net/if_ether.h>
     89       1.1  drochner #include <net/if_media.h>
     90       1.1  drochner 
     91       1.1  drochner 
     92       1.1  drochner #if NBPFILTER > 0
     93       1.1  drochner #include <net/bpf.h>
     94       1.1  drochner #include <net/bpfdesc.h>
     95       1.1  drochner #endif
     96       1.1  drochner 
     97       1.1  drochner #include <dev/ic/lancereg.h>
     98       1.1  drochner #include <dev/ic/lancevar.h>
     99       1.1  drochner 
    100      1.19       mrg #if defined(_KERNEL_OPT)
    101       1.1  drochner #include "opt_ddb.h"
    102       1.1  drochner #endif
    103       1.1  drochner 
    104       1.1  drochner #ifdef DDB
    105       1.1  drochner #define	integrate
    106       1.1  drochner #define hide
    107       1.1  drochner #else
    108      1.34     perry #define	integrate	static inline
    109       1.1  drochner #define hide		static
    110       1.1  drochner #endif
    111       1.1  drochner 
    112      1.31     perry integrate struct mbuf *lance_get(struct lance_softc *, int, int);
    113       1.1  drochner 
    114  1.40.4.3      yamt hide bool lance_shutdown(device_t, int);
    115       1.1  drochner 
    116      1.31     perry int lance_mediachange(struct ifnet *);
    117      1.31     perry void lance_mediastatus(struct ifnet *, struct ifmediareq *);
    118       1.1  drochner 
    119      1.31     perry static inline u_int16_t ether_cmp(void *, void *);
    120       1.1  drochner 
    121      1.31     perry void lance_stop(struct ifnet *, int);
    122      1.38  christos int lance_ioctl(struct ifnet *, u_long, void *);
    123      1.31     perry void lance_watchdog(struct ifnet *);
    124       1.1  drochner 
    125       1.1  drochner /*
    126       1.1  drochner  * Compare two Ether/802 addresses for equality, inlined and
    127      1.23   thorpej  * unrolled for speed.  Use this like memcmp().
    128       1.1  drochner  *
    129       1.1  drochner  * XXX: Add <machine/inlines.h> for stuff like this?
    130       1.1  drochner  * XXX: or maybe add it to libkern.h instead?
    131       1.1  drochner  *
    132       1.1  drochner  * "I'd love to have an inline assembler version of this."
    133       1.1  drochner  * XXX: Who wanted that? mycroft?  I wrote one, but this
    134       1.1  drochner  * version in C is as good as hand-coded assembly. -gwr
    135       1.1  drochner  *
    136       1.1  drochner  * Please do NOT tweak this without looking at the actual
    137       1.1  drochner  * assembly code generated before and after your tweaks!
    138       1.1  drochner  */
    139      1.40   tsutsui static inline uint16_t
    140      1.40   tsutsui ether_cmp(void *one, void *two)
    141      1.40   tsutsui {
    142      1.40   tsutsui 	uint16_t *a = (uint16_t *)one;
    143      1.40   tsutsui 	uint16_t *b = (uint16_t *)two;
    144      1.40   tsutsui 	uint16_t diff;
    145       1.1  drochner 
    146       1.1  drochner #ifdef	m68k
    147       1.1  drochner 	/*
    148       1.1  drochner 	 * The post-increment-pointer form produces the best
    149       1.1  drochner 	 * machine code for m68k.  This was carefully tuned
    150       1.1  drochner 	 * so it compiles to just 8 short (2-byte) op-codes!
    151       1.1  drochner 	 */
    152       1.1  drochner 	diff  = *a++ - *b++;
    153       1.1  drochner 	diff |= *a++ - *b++;
    154       1.1  drochner 	diff |= *a++ - *b++;
    155       1.1  drochner #else
    156       1.1  drochner 	/*
    157       1.1  drochner 	 * Most modern CPUs do better with a single expresion.
    158       1.1  drochner 	 * Note that short-cut evaluation is NOT helpful here,
    159       1.1  drochner 	 * because it just makes the code longer, not faster!
    160       1.1  drochner 	 */
    161       1.1  drochner 	diff = (a[0] - b[0]) | (a[1] - b[1]) | (a[2] - b[2]);
    162       1.1  drochner #endif
    163       1.1  drochner 
    164       1.1  drochner 	return (diff);
    165       1.1  drochner }
    166       1.1  drochner 
    167       1.1  drochner #define ETHER_CMP	ether_cmp
    168       1.1  drochner 
    169       1.1  drochner #ifdef LANCE_REVC_BUG
    170       1.1  drochner /* Make sure this is short-aligned, for ether_cmp(). */
    171      1.40   tsutsui static uint16_t bcast_enaddr[3] = { ~0, ~0, ~0 };
    172       1.1  drochner #endif
    173       1.1  drochner 
    174       1.1  drochner void
    175      1.40   tsutsui lance_config(struct lance_softc *sc)
    176       1.1  drochner {
    177      1.18  jdolecek 	int i, nbuf;
    178      1.20  jdolecek 	struct ifnet *ifp = &sc->sc_ethercom.ec_if;
    179       1.1  drochner 
    180       1.1  drochner 	/* Initialize ifnet structure. */
    181      1.40   tsutsui 	strcpy(ifp->if_xname, device_xname(sc->sc_dev));
    182       1.1  drochner 	ifp->if_softc = sc;
    183       1.1  drochner 	ifp->if_start = sc->sc_start;
    184       1.1  drochner 	ifp->if_ioctl = lance_ioctl;
    185       1.1  drochner 	ifp->if_watchdog = lance_watchdog;
    186      1.20  jdolecek 	ifp->if_init = lance_init;
    187      1.20  jdolecek 	ifp->if_stop = lance_stop;
    188       1.1  drochner 	ifp->if_flags =
    189       1.1  drochner 	    IFF_BROADCAST | IFF_SIMPLEX | IFF_NOTRAILERS | IFF_MULTICAST;
    190       1.1  drochner #ifdef LANCE_REVC_BUG
    191       1.1  drochner 	ifp->if_flags &= ~IFF_MULTICAST;
    192       1.1  drochner #endif
    193      1.17   thorpej 	IFQ_SET_READY(&ifp->if_snd);
    194       1.1  drochner 
    195       1.1  drochner 	/* Initialize ifmedia structures. */
    196       1.1  drochner 	ifmedia_init(&sc->sc_media, 0, lance_mediachange, lance_mediastatus);
    197       1.1  drochner 	if (sc->sc_supmedia != NULL) {
    198       1.1  drochner 		for (i = 0; i < sc->sc_nsupmedia; i++)
    199       1.1  drochner 			ifmedia_add(&sc->sc_media, sc->sc_supmedia[i],
    200       1.1  drochner 			   0, NULL);
    201       1.1  drochner 		ifmedia_set(&sc->sc_media, sc->sc_defaultmedia);
    202       1.1  drochner 	} else {
    203       1.1  drochner 		ifmedia_add(&sc->sc_media, IFM_ETHER|IFM_MANUAL, 0, NULL);
    204       1.1  drochner 		ifmedia_set(&sc->sc_media, IFM_ETHER|IFM_MANUAL);
    205       1.1  drochner 	}
    206       1.1  drochner 
    207       1.1  drochner 	switch (sc->sc_memsize) {
    208       1.1  drochner 	case 8192:
    209       1.1  drochner 		sc->sc_nrbuf = 4;
    210       1.1  drochner 		sc->sc_ntbuf = 1;
    211       1.1  drochner 		break;
    212       1.1  drochner 	case 16384:
    213       1.1  drochner 		sc->sc_nrbuf = 8;
    214       1.1  drochner 		sc->sc_ntbuf = 2;
    215       1.1  drochner 		break;
    216       1.1  drochner 	case 32768:
    217       1.1  drochner 		sc->sc_nrbuf = 16;
    218       1.1  drochner 		sc->sc_ntbuf = 4;
    219       1.1  drochner 		break;
    220       1.1  drochner 	case 65536:
    221       1.1  drochner 		sc->sc_nrbuf = 32;
    222       1.1  drochner 		sc->sc_ntbuf = 8;
    223       1.1  drochner 		break;
    224       1.1  drochner 	case 131072:
    225       1.1  drochner 		sc->sc_nrbuf = 64;
    226       1.1  drochner 		sc->sc_ntbuf = 16;
    227       1.4       leo 		break;
    228       1.4       leo 	case 262144:
    229       1.4       leo 		sc->sc_nrbuf = 128;
    230       1.4       leo 		sc->sc_ntbuf = 32;
    231       1.1  drochner 		break;
    232       1.1  drochner 	default:
    233      1.18  jdolecek 		/* weird memory size; cope with it */
    234      1.18  jdolecek 		nbuf = sc->sc_memsize / LEBLEN;
    235      1.18  jdolecek 		sc->sc_ntbuf = nbuf / 5;
    236      1.18  jdolecek 		sc->sc_nrbuf = nbuf - sc->sc_ntbuf;
    237       1.1  drochner 	}
    238       1.1  drochner 
    239      1.40   tsutsui 	aprint_normal(": address %s\n", ether_sprintf(sc->sc_enaddr));
    240      1.40   tsutsui 	aprint_normal_dev(sc->sc_dev,
    241      1.40   tsutsui 	    "%d receive buffers, %d transmit buffers\n",
    242      1.40   tsutsui 	    sc->sc_nrbuf, sc->sc_ntbuf);
    243      1.10    simonb 
    244      1.20  jdolecek 	/* Make sure the chip is stopped. */
    245      1.20  jdolecek 	lance_stop(ifp, 0);
    246      1.20  jdolecek 
    247      1.14    bouyer 	/* claim 802.1q capability */
    248      1.14    bouyer 	sc->sc_ethercom.ec_capabilities |= ETHERCAP_VLAN_MTU;
    249      1.10    simonb 	/* Attach the interface. */
    250      1.10    simonb 	if_attach(ifp);
    251      1.10    simonb 	ether_ifattach(ifp, sc->sc_enaddr);
    252       1.1  drochner 
    253  1.40.4.3      yamt 	if (pmf_device_register1(sc->sc_dev, NULL, NULL, lance_shutdown))
    254  1.40.4.3      yamt 		pmf_class_network_register(sc->sc_dev, ifp);
    255  1.40.4.3      yamt 	else
    256  1.40.4.3      yamt 		aprint_error_dev(sc->sc_dev,
    257  1.40.4.3      yamt 		    "couldn't establish power handler\n");
    258  1.40.4.3      yamt 
    259       1.1  drochner 	sc->sc_rbufaddr = malloc(sc->sc_nrbuf * sizeof(int), M_DEVBUF,
    260       1.1  drochner 					M_WAITOK);
    261       1.1  drochner 	sc->sc_tbufaddr = malloc(sc->sc_ntbuf * sizeof(int), M_DEVBUF,
    262       1.1  drochner 					M_WAITOK);
    263       1.1  drochner 
    264       1.1  drochner #if NRND > 0
    265      1.40   tsutsui 	rnd_attach_source(&sc->rnd_source, device_xname(sc->sc_dev),
    266       1.7  explorer 			  RND_TYPE_NET, 0);
    267       1.1  drochner #endif
    268       1.1  drochner }
    269       1.1  drochner 
    270       1.1  drochner void
    271      1.40   tsutsui lance_reset(struct lance_softc *sc)
    272       1.1  drochner {
    273       1.1  drochner 	int s;
    274       1.1  drochner 
    275       1.2   mycroft 	s = splnet();
    276      1.20  jdolecek 	lance_init(&sc->sc_ethercom.ec_if);
    277       1.1  drochner 	splx(s);
    278       1.1  drochner }
    279       1.1  drochner 
    280       1.1  drochner void
    281      1.37  christos lance_stop(struct ifnet *ifp, int disable)
    282       1.1  drochner {
    283      1.20  jdolecek 	struct lance_softc *sc = ifp->if_softc;
    284       1.1  drochner 
    285       1.1  drochner 	(*sc->sc_wrcsr)(sc, LE_CSR0, LE_C0_STOP);
    286       1.1  drochner }
    287       1.1  drochner 
    288       1.1  drochner /*
    289       1.1  drochner  * Initialization of interface; set up initialization block
    290       1.1  drochner  * and transmit/receive descriptor rings.
    291       1.1  drochner  */
    292      1.20  jdolecek int
    293      1.40   tsutsui lance_init(struct ifnet *ifp)
    294       1.1  drochner {
    295      1.20  jdolecek 	struct lance_softc *sc = ifp->if_softc;
    296      1.11  augustss 	int timo;
    297       1.1  drochner 	u_long a;
    298       1.1  drochner 
    299       1.1  drochner 	(*sc->sc_wrcsr)(sc, LE_CSR0, LE_C0_STOP);
    300       1.1  drochner 	DELAY(100);
    301       1.1  drochner 
    302       1.1  drochner 	/* Newer LANCE chips have a reset register */
    303       1.1  drochner 	if (sc->sc_hwreset)
    304       1.1  drochner 		(*sc->sc_hwreset)(sc);
    305       1.1  drochner 
    306       1.1  drochner 	/* Set the correct byte swapping mode, etc. */
    307       1.1  drochner 	(*sc->sc_wrcsr)(sc, LE_CSR3, sc->sc_conf3);
    308       1.1  drochner 
    309       1.1  drochner 	/* Set up LANCE init block. */
    310       1.1  drochner 	(*sc->sc_meminit)(sc);
    311       1.1  drochner 
    312       1.1  drochner 	/* Give LANCE the physical address of its init block. */
    313       1.1  drochner 	a = sc->sc_addr + LE_INITADDR(sc);
    314       1.1  drochner 	(*sc->sc_wrcsr)(sc, LE_CSR1, a);
    315       1.1  drochner 	(*sc->sc_wrcsr)(sc, LE_CSR2, a >> 16);
    316       1.1  drochner 
    317       1.1  drochner 	/* Try to initialize the LANCE. */
    318       1.1  drochner 	DELAY(100);
    319       1.1  drochner 	(*sc->sc_wrcsr)(sc, LE_CSR0, LE_C0_INIT);
    320       1.1  drochner 
    321       1.1  drochner 	/* Wait for initialization to finish. */
    322       1.1  drochner 	for (timo = 100000; timo; timo--)
    323       1.1  drochner 		if ((*sc->sc_rdcsr)(sc, LE_CSR0) & LE_C0_IDON)
    324       1.1  drochner 			break;
    325       1.1  drochner 
    326       1.1  drochner 	if ((*sc->sc_rdcsr)(sc, LE_CSR0) & LE_C0_IDON) {
    327       1.1  drochner 		/* Start the LANCE. */
    328      1.28        pk 		(*sc->sc_wrcsr)(sc, LE_CSR0, LE_C0_INEA | LE_C0_STRT);
    329       1.1  drochner 		ifp->if_flags |= IFF_RUNNING;
    330       1.1  drochner 		ifp->if_flags &= ~IFF_OACTIVE;
    331       1.1  drochner 		ifp->if_timer = 0;
    332       1.1  drochner 		(*sc->sc_start)(ifp);
    333       1.1  drochner 	} else
    334       1.1  drochner 		printf("%s: controller failed to initialize\n",
    335      1.40   tsutsui 			device_xname(sc->sc_dev));
    336       1.1  drochner 	if (sc->sc_hwinit)
    337       1.1  drochner 		(*sc->sc_hwinit)(sc);
    338      1.20  jdolecek 
    339      1.20  jdolecek 	return (0);
    340       1.1  drochner }
    341       1.1  drochner 
    342       1.1  drochner /*
    343       1.1  drochner  * Routine to copy from mbuf chain to transmit buffer in
    344       1.1  drochner  * network buffer memory.
    345       1.1  drochner  */
    346       1.1  drochner int
    347      1.40   tsutsui lance_put(struct lance_softc *sc, int boff, struct mbuf *m)
    348       1.1  drochner {
    349      1.11  augustss 	struct mbuf *n;
    350      1.11  augustss 	int len, tlen = 0;
    351       1.1  drochner 
    352       1.1  drochner 	for (; m; m = n) {
    353       1.1  drochner 		len = m->m_len;
    354       1.1  drochner 		if (len == 0) {
    355       1.1  drochner 			MFREE(m, n);
    356       1.1  drochner 			continue;
    357       1.1  drochner 		}
    358      1.38  christos 		(*sc->sc_copytobuf)(sc, mtod(m, void *), boff, len);
    359       1.1  drochner 		boff += len;
    360       1.1  drochner 		tlen += len;
    361       1.1  drochner 		MFREE(m, n);
    362       1.1  drochner 	}
    363       1.1  drochner 	if (tlen < LEMINSIZE) {
    364       1.1  drochner 		(*sc->sc_zerobuf)(sc, boff, LEMINSIZE - tlen);
    365       1.1  drochner 		tlen = LEMINSIZE;
    366       1.1  drochner 	}
    367       1.1  drochner 	return (tlen);
    368       1.1  drochner }
    369       1.1  drochner 
    370       1.1  drochner /*
    371       1.1  drochner  * Pull data off an interface.
    372       1.1  drochner  * Len is length of data, with local net header stripped.
    373       1.1  drochner  * We copy the data into mbufs.  When full cluster sized units are present
    374       1.1  drochner  * we copy into clusters.
    375       1.1  drochner  */
    376       1.1  drochner integrate struct mbuf *
    377      1.40   tsutsui lance_get(struct lance_softc *sc, int boff, int totlen)
    378       1.1  drochner {
    379       1.5   mycroft 	struct mbuf *m, *m0, *newm;
    380       1.1  drochner 	int len;
    381       1.1  drochner 
    382       1.5   mycroft 	MGETHDR(m0, M_DONTWAIT, MT_DATA);
    383       1.5   mycroft 	if (m0 == 0)
    384       1.1  drochner 		return (0);
    385      1.20  jdolecek 	m0->m_pkthdr.rcvif = &sc->sc_ethercom.ec_if;
    386       1.5   mycroft 	m0->m_pkthdr.len = totlen;
    387       1.1  drochner 	len = MHLEN;
    388       1.5   mycroft 	m = m0;
    389       1.1  drochner 
    390       1.1  drochner 	while (totlen > 0) {
    391       1.1  drochner 		if (totlen >= MINCLSIZE) {
    392       1.1  drochner 			MCLGET(m, M_DONTWAIT);
    393       1.5   mycroft 			if ((m->m_flags & M_EXT) == 0)
    394       1.5   mycroft 				goto bad;
    395       1.1  drochner 			len = MCLBYTES;
    396       1.1  drochner 		}
    397       1.5   mycroft 
    398       1.5   mycroft 		if (m == m0) {
    399      1.38  christos 			char *newdata = (char *)
    400       1.5   mycroft 			    ALIGN(m->m_data + sizeof(struct ether_header)) -
    401       1.5   mycroft 			    sizeof(struct ether_header);
    402       1.5   mycroft 			len -= newdata - m->m_data;
    403       1.5   mycroft 			m->m_data = newdata;
    404       1.1  drochner 		}
    405       1.5   mycroft 
    406       1.1  drochner 		m->m_len = len = min(totlen, len);
    407      1.38  christos 		(*sc->sc_copyfrombuf)(sc, mtod(m, void *), boff, len);
    408       1.1  drochner 		boff += len;
    409       1.5   mycroft 
    410       1.1  drochner 		totlen -= len;
    411       1.5   mycroft 		if (totlen > 0) {
    412       1.5   mycroft 			MGET(newm, M_DONTWAIT, MT_DATA);
    413       1.5   mycroft 			if (newm == 0)
    414       1.5   mycroft 				goto bad;
    415       1.5   mycroft 			len = MLEN;
    416       1.5   mycroft 			m = m->m_next = newm;
    417       1.5   mycroft 		}
    418       1.1  drochner 	}
    419       1.1  drochner 
    420       1.5   mycroft 	return (m0);
    421       1.5   mycroft 
    422       1.5   mycroft bad:
    423       1.5   mycroft 	m_freem(m0);
    424       1.5   mycroft 	return (0);
    425       1.1  drochner }
    426       1.1  drochner 
    427       1.1  drochner /*
    428       1.1  drochner  * Pass a packet to the higher levels.
    429       1.1  drochner  */
    430       1.1  drochner void
    431      1.40   tsutsui lance_read(struct lance_softc *sc, int boff, int len)
    432       1.1  drochner {
    433       1.1  drochner 	struct mbuf *m;
    434      1.20  jdolecek 	struct ifnet *ifp = &sc->sc_ethercom.ec_if;
    435      1.15   tsutsui 	struct ether_header *eh;
    436       1.1  drochner 
    437       1.1  drochner 	if (len <= sizeof(struct ether_header) ||
    438      1.14    bouyer 	    len > ((sc->sc_ethercom.ec_capenable & ETHERCAP_VLAN_MTU) ?
    439      1.14    bouyer 		ETHER_VLAN_ENCAP_LEN + ETHERMTU + sizeof(struct ether_header) :
    440      1.14    bouyer 		ETHERMTU + sizeof(struct ether_header))) {
    441       1.1  drochner #ifdef LEDEBUG
    442       1.1  drochner 		printf("%s: invalid packet size %d; dropping\n",
    443      1.40   tsutsui 		    device_xname(sc->sc_dev), len);
    444       1.1  drochner #endif
    445       1.1  drochner 		ifp->if_ierrors++;
    446       1.1  drochner 		return;
    447       1.1  drochner 	}
    448       1.1  drochner 
    449       1.1  drochner 	/* Pull packet off interface. */
    450       1.1  drochner 	m = lance_get(sc, boff, len);
    451       1.1  drochner 	if (m == 0) {
    452       1.1  drochner 		ifp->if_ierrors++;
    453       1.1  drochner 		return;
    454       1.1  drochner 	}
    455       1.1  drochner 
    456       1.1  drochner 	ifp->if_ipackets++;
    457       1.1  drochner 
    458      1.27    itojun 	eh = mtod(m, struct ether_header *);
    459       1.1  drochner 
    460       1.1  drochner #ifdef LANCE_REVC_BUG
    461       1.1  drochner 	/*
    462       1.1  drochner 	 * The old LANCE (Rev. C) chips have a bug which causes
    463       1.1  drochner 	 * garbage to be inserted in front of the received packet.
    464       1.1  drochner 	 * The work-around is to ignore packets with an invalid
    465       1.1  drochner 	 * destination address (garbage will usually not match).
    466       1.1  drochner 	 * Of course, this precludes multicast support...
    467       1.1  drochner 	 */
    468       1.1  drochner 	if (ETHER_CMP(eh->ether_dhost, sc->sc_enaddr) &&
    469       1.1  drochner 	    ETHER_CMP(eh->ether_dhost, bcast_enaddr)) {
    470       1.1  drochner 		m_freem(m);
    471       1.1  drochner 		return;
    472       1.1  drochner 	}
    473      1.27    itojun #endif
    474      1.27    itojun 
    475      1.27    itojun 	/*
    476      1.27    itojun 	 * Some lance device does not present IFF_SIMPLEX behavior on multicast
    477      1.27    itojun 	 * packets.  Make sure to drop it if it is from ourselves.
    478      1.27    itojun 	 */
    479      1.27    itojun 	if (!ETHER_CMP(eh->ether_shost, sc->sc_enaddr)) {
    480      1.27    itojun 		m_freem(m);
    481      1.27    itojun 		return;
    482      1.27    itojun 	}
    483      1.27    itojun 
    484      1.27    itojun #if NBPFILTER > 0
    485      1.27    itojun 	/*
    486      1.27    itojun 	 * Check if there's a BPF listener on this interface.
    487      1.27    itojun 	 * If so, hand off the raw packet to BPF.
    488      1.27    itojun 	 */
    489      1.27    itojun 	if (ifp->if_bpf)
    490      1.27    itojun 		bpf_mtap(ifp->if_bpf, m);
    491       1.1  drochner #endif
    492       1.1  drochner 
    493       1.9   thorpej 	/* Pass the packet up. */
    494       1.9   thorpej 	(*ifp->if_input)(ifp, m);
    495       1.1  drochner }
    496       1.1  drochner 
    497       1.1  drochner #undef	ifp
    498       1.1  drochner 
    499       1.1  drochner void
    500      1.40   tsutsui lance_watchdog(struct ifnet *ifp)
    501       1.1  drochner {
    502       1.1  drochner 	struct lance_softc *sc = ifp->if_softc;
    503       1.1  drochner 
    504      1.40   tsutsui 	log(LOG_ERR, "%s: device timeout\n", device_xname(sc->sc_dev));
    505       1.1  drochner 	++ifp->if_oerrors;
    506       1.1  drochner 
    507       1.1  drochner 	lance_reset(sc);
    508       1.1  drochner }
    509       1.1  drochner 
    510       1.1  drochner int
    511      1.40   tsutsui lance_mediachange(struct ifnet *ifp)
    512       1.1  drochner {
    513       1.1  drochner 	struct lance_softc *sc = ifp->if_softc;
    514       1.1  drochner 
    515       1.1  drochner 	if (sc->sc_mediachange)
    516       1.1  drochner 		return ((*sc->sc_mediachange)(sc));
    517       1.8   thorpej 	return (0);
    518       1.1  drochner }
    519       1.1  drochner 
    520       1.1  drochner void
    521      1.40   tsutsui lance_mediastatus(struct ifnet *ifp, struct ifmediareq *ifmr)
    522       1.1  drochner {
    523       1.1  drochner 	struct lance_softc *sc = ifp->if_softc;
    524       1.1  drochner 
    525       1.1  drochner 	if ((ifp->if_flags & IFF_UP) == 0)
    526       1.1  drochner 		return;
    527       1.1  drochner 
    528       1.1  drochner 	ifmr->ifm_status = IFM_AVALID;
    529       1.1  drochner 	if (sc->sc_havecarrier)
    530       1.1  drochner 		ifmr->ifm_status |= IFM_ACTIVE;
    531       1.1  drochner 
    532       1.1  drochner 	if (sc->sc_mediastatus)
    533       1.1  drochner 		(*sc->sc_mediastatus)(sc, ifmr);
    534       1.1  drochner }
    535       1.1  drochner 
    536       1.1  drochner /*
    537       1.1  drochner  * Process an ioctl request.
    538       1.1  drochner  */
    539       1.1  drochner int
    540      1.40   tsutsui lance_ioctl(struct ifnet *ifp, u_long cmd, void *data)
    541       1.1  drochner {
    542      1.11  augustss 	struct lance_softc *sc = ifp->if_softc;
    543       1.1  drochner 	struct ifreq *ifr = (struct ifreq *)data;
    544       1.1  drochner 	int s, error = 0;
    545       1.1  drochner 
    546       1.2   mycroft 	s = splnet();
    547       1.1  drochner 
    548       1.1  drochner 	switch (cmd) {
    549  1.40.4.2      yamt 	case SIOCGIFMEDIA:
    550  1.40.4.2      yamt 	case SIOCSIFMEDIA:
    551  1.40.4.2      yamt 		error = ifmedia_ioctl(ifp, ifr, &sc->sc_media, cmd);
    552       1.1  drochner 		break;
    553  1.40.4.2      yamt 	default:
    554  1.40.4.2      yamt 		if ((error = ether_ioctl(ifp, cmd, data)) != ENETRESET)
    555  1.40.4.2      yamt 			break;
    556  1.40.4.2      yamt 		error = 0;
    557  1.40.4.2      yamt 		if (cmd != SIOCADDMULTI && cmd != SIOCDELMULTI)
    558  1.40.4.2      yamt 			break;
    559  1.40.4.2      yamt 		if (ifp->if_flags & IFF_RUNNING) {
    560       1.1  drochner 			/*
    561       1.1  drochner 			 * Multicast list has changed; set the hardware filter
    562       1.1  drochner 			 * accordingly.
    563       1.1  drochner 			 */
    564  1.40.4.2      yamt 			lance_reset(sc);
    565       1.1  drochner 		}
    566       1.1  drochner 		break;
    567       1.1  drochner 
    568       1.1  drochner 	}
    569       1.1  drochner 
    570       1.1  drochner 	splx(s);
    571       1.1  drochner 	return (error);
    572       1.1  drochner }
    573       1.1  drochner 
    574  1.40.4.3      yamt hide bool
    575  1.40.4.3      yamt lance_shutdown(device_t self, int howto)
    576       1.1  drochner {
    577  1.40.4.3      yamt 	struct lance_softc *sc = device_private(self);
    578  1.40.4.3      yamt 	struct ifnet *ifp = &sc->sc_ethercom.ec_if;
    579  1.40.4.3      yamt 
    580  1.40.4.3      yamt 	lance_stop(ifp, 0);
    581       1.1  drochner 
    582  1.40.4.3      yamt 	return true;
    583       1.1  drochner }
    584       1.1  drochner 
    585       1.1  drochner /*
    586       1.1  drochner  * Set up the logical address filter.
    587       1.1  drochner  */
    588       1.1  drochner void
    589      1.40   tsutsui lance_setladrf(struct ethercom *ac, uint16_t *af)
    590       1.1  drochner {
    591       1.1  drochner 	struct ifnet *ifp = &ac->ec_if;
    592       1.1  drochner 	struct ether_multi *enm;
    593      1.40   tsutsui 	uint32_t crc;
    594       1.1  drochner 	struct ether_multistep step;
    595       1.1  drochner 
    596       1.1  drochner 	/*
    597       1.1  drochner 	 * Set up multicast address filter by passing all multicast addresses
    598       1.1  drochner 	 * through a crc generator, and then using the high order 6 bits as an
    599       1.1  drochner 	 * index into the 64 bit logical address filter.  The high order bit
    600       1.1  drochner 	 * selects the word, while the rest of the bits select the bit within
    601       1.1  drochner 	 * the word.
    602       1.1  drochner 	 */
    603       1.1  drochner 
    604       1.1  drochner 	if (ifp->if_flags & IFF_PROMISC)
    605       1.1  drochner 		goto allmulti;
    606       1.1  drochner 
    607       1.1  drochner 	af[0] = af[1] = af[2] = af[3] = 0x0000;
    608       1.1  drochner 	ETHER_FIRST_MULTI(step, ac, enm);
    609       1.1  drochner 	while (enm != NULL) {
    610       1.1  drochner 		if (ETHER_CMP(enm->enm_addrlo, enm->enm_addrhi)) {
    611       1.1  drochner 			/*
    612       1.1  drochner 			 * We must listen to a range of multicast addresses.
    613       1.1  drochner 			 * For now, just accept all multicasts, rather than
    614       1.1  drochner 			 * trying to set only those filter bits needed to match
    615       1.1  drochner 			 * the range.  (At this time, the only use of address
    616       1.1  drochner 			 * ranges is for IP multicast routing, for which the
    617       1.1  drochner 			 * range is big enough to require all bits set.)
    618       1.1  drochner 			 */
    619       1.1  drochner 			goto allmulti;
    620       1.1  drochner 		}
    621       1.1  drochner 
    622      1.12   thorpej 		crc = ether_crc32_le(enm->enm_addrlo, ETHER_ADDR_LEN);
    623      1.12   thorpej 
    624       1.1  drochner 		/* Just want the 6 most significant bits. */
    625       1.1  drochner 		crc >>= 26;
    626       1.1  drochner 
    627       1.1  drochner 		/* Set the corresponding bit in the filter. */
    628       1.1  drochner 		af[crc >> 4] |= 1 << (crc & 0xf);
    629       1.1  drochner 
    630       1.1  drochner 		ETHER_NEXT_MULTI(step, enm);
    631       1.1  drochner 	}
    632       1.1  drochner 	ifp->if_flags &= ~IFF_ALLMULTI;
    633       1.1  drochner 	return;
    634       1.1  drochner 
    635       1.1  drochner allmulti:
    636       1.1  drochner 	ifp->if_flags |= IFF_ALLMULTI;
    637       1.1  drochner 	af[0] = af[1] = af[2] = af[3] = 0xffff;
    638       1.1  drochner }
    639       1.1  drochner 
    640       1.1  drochner /*
    641       1.1  drochner  * Routines for accessing the transmit and receive buffers.
    642       1.1  drochner  * The various CPU and adapter configurations supported by this
    643       1.1  drochner  * driver require three different access methods for buffers
    644       1.1  drochner  * and descriptors:
    645       1.1  drochner  *	(1) contig (contiguous data; no padding),
    646       1.1  drochner  *	(2) gap2 (two bytes of data followed by two bytes of padding),
    647       1.1  drochner  *	(3) gap16 (16 bytes of data followed by 16 bytes of padding).
    648       1.1  drochner  */
    649       1.1  drochner 
    650       1.1  drochner /*
    651       1.1  drochner  * contig: contiguous data with no padding.
    652       1.1  drochner  *
    653       1.1  drochner  * Buffers may have any alignment.
    654       1.1  drochner  */
    655       1.1  drochner 
    656       1.1  drochner void
    657      1.40   tsutsui lance_copytobuf_contig(struct lance_softc *sc, void *from, int boff, int len)
    658       1.1  drochner {
    659      1.40   tsutsui 	uint8_t *buf = sc->sc_mem;
    660       1.1  drochner 
    661       1.1  drochner 	/*
    662      1.24   thorpej 	 * Just call memcpy() to do the work.
    663       1.1  drochner 	 */
    664      1.24   thorpej 	memcpy(buf + boff, from, len);
    665       1.1  drochner }
    666       1.1  drochner 
    667       1.1  drochner void
    668      1.40   tsutsui lance_copyfrombuf_contig(struct lance_softc *sc, void *to, int boff, int len)
    669       1.1  drochner {
    670      1.40   tsutsui 	uint8_t *buf = sc->sc_mem;
    671       1.1  drochner 
    672       1.1  drochner 	/*
    673      1.24   thorpej 	 * Just call memcpy() to do the work.
    674       1.1  drochner 	 */
    675      1.24   thorpej 	memcpy(to, buf + boff, len);
    676       1.1  drochner }
    677       1.1  drochner 
    678       1.1  drochner void
    679      1.40   tsutsui lance_zerobuf_contig(struct lance_softc *sc, int boff, int len)
    680       1.1  drochner {
    681      1.40   tsutsui 	uint8_t *buf = sc->sc_mem;
    682       1.1  drochner 
    683       1.1  drochner 	/*
    684      1.25   thorpej 	 * Just let memset() do the work
    685       1.1  drochner 	 */
    686      1.25   thorpej 	memset(buf + boff, 0, len);
    687       1.1  drochner }
    688       1.1  drochner 
    689       1.1  drochner #if 0
    690       1.1  drochner /*
    691       1.1  drochner  * Examples only; duplicate these and tweak (if necessary) in
    692       1.1  drochner  * machine-specific front-ends.
    693       1.1  drochner  */
    694       1.1  drochner 
    695       1.1  drochner /*
    696       1.1  drochner  * gap2: two bytes of data followed by two bytes of pad.
    697       1.1  drochner  *
    698       1.1  drochner  * Buffers must be 4-byte aligned.  The code doesn't worry about
    699       1.1  drochner  * doing an extra byte.
    700       1.1  drochner  */
    701       1.1  drochner 
    702       1.1  drochner void
    703      1.40   tsutsui lance_copytobuf_gap2(struct lance_softc *sc, void *fromv, int boff, int len)
    704       1.1  drochner {
    705      1.38  christos 	volatile void *buf = sc->sc_mem;
    706      1.38  christos 	void *from = fromv;
    707      1.40   tsutsui 	volatile uint16_t *bptr;
    708       1.1  drochner 
    709       1.1  drochner 	if (boff & 0x1) {
    710       1.1  drochner 		/* handle unaligned first byte */
    711      1.40   tsutsui 		bptr = ((volatile uint16_t *)buf) + (boff - 1);
    712       1.1  drochner 		*bptr = (*from++ << 8) | (*bptr & 0xff);
    713       1.1  drochner 		bptr += 2;
    714       1.1  drochner 		len--;
    715       1.1  drochner 	} else
    716      1.40   tsutsui 		bptr = ((volatile uint16_t *)buf) + boff;
    717       1.1  drochner 	while (len > 1) {
    718       1.1  drochner 		*bptr = (from[1] << 8) | (from[0] & 0xff);
    719       1.1  drochner 		bptr += 2;
    720       1.1  drochner 		from += 2;
    721       1.1  drochner 		len -= 2;
    722       1.1  drochner 	}
    723       1.1  drochner 	if (len == 1)
    724      1.40   tsutsui 		*bptr = (uint16_t)*from;
    725       1.1  drochner }
    726       1.1  drochner 
    727       1.1  drochner void
    728      1.40   tsutsui lance_copyfrombuf_gap2(struct lance_softc *sc, void *tov, int boff, int len)
    729       1.1  drochner {
    730      1.38  christos 	volatile void *buf = sc->sc_mem;
    731      1.38  christos 	void *to = tov;
    732      1.40   tsutsui 	volatile uint16_t *bptr;
    733      1.40   tsutsui 	uint16_t tmp;
    734       1.1  drochner 
    735       1.1  drochner 	if (boff & 0x1) {
    736       1.1  drochner 		/* handle unaligned first byte */
    737      1.40   tsutsui 		bptr = ((volatile uint16_t *)buf) + (boff - 1);
    738       1.1  drochner 		*to++ = (*bptr >> 8) & 0xff;
    739       1.1  drochner 		bptr += 2;
    740       1.1  drochner 		len--;
    741       1.1  drochner 	} else
    742      1.40   tsutsui 		bptr = ((volatile uint16_t *)buf) + boff;
    743       1.1  drochner 	while (len > 1) {
    744       1.1  drochner 		tmp = *bptr;
    745       1.1  drochner 		*to++ = tmp & 0xff;
    746       1.1  drochner 		*to++ = (tmp >> 8) & 0xff;
    747       1.1  drochner 		bptr += 2;
    748       1.1  drochner 		len -= 2;
    749       1.1  drochner 	}
    750       1.1  drochner 	if (len == 1)
    751       1.1  drochner 		*to = *bptr & 0xff;
    752       1.1  drochner }
    753       1.1  drochner 
    754       1.1  drochner void
    755      1.40   tsutsui lance_zerobuf_gap2(struct lance_softc *sc, int boff, int len)
    756       1.1  drochner {
    757      1.38  christos 	volatile void *buf = sc->sc_mem;
    758      1.40   tsutsui 	volatile uint16_t *bptr;
    759       1.1  drochner 
    760      1.40   tsutsui 	if ((unsigned int)boff & 0x1) {
    761      1.40   tsutsui 		bptr = ((volatile uint16_t *)buf) + (boff - 1);
    762       1.1  drochner 		*bptr &= 0xff;
    763       1.1  drochner 		bptr += 2;
    764       1.1  drochner 		len--;
    765       1.1  drochner 	} else
    766      1.40   tsutsui 		bptr = ((volatile uint16_t *)buf) + boff;
    767       1.1  drochner 	while (len > 0) {
    768       1.1  drochner 		*bptr = 0;
    769       1.1  drochner 		bptr += 2;
    770       1.1  drochner 		len -= 2;
    771       1.1  drochner 	}
    772       1.1  drochner }
    773       1.1  drochner 
    774       1.1  drochner /*
    775       1.1  drochner  * gap16: 16 bytes of data followed by 16 bytes of pad.
    776       1.1  drochner  *
    777       1.1  drochner  * Buffers must be 32-byte aligned.
    778       1.1  drochner  */
    779       1.1  drochner 
    780       1.1  drochner void
    781      1.40   tsutsui lance_copytobuf_gap16(struct lance_softc *sc, void *fromv, int boff, int len)
    782       1.1  drochner {
    783      1.40   tsutsui 	volatile uint8_t *buf = sc->sc_mem;
    784      1.38  christos 	void *from = fromv;
    785      1.40   tsutsui 	uint8_t *bptr;
    786      1.11  augustss 	int xfer;
    787       1.1  drochner 
    788       1.1  drochner 	bptr = buf + ((boff << 1) & ~0x1f);
    789       1.1  drochner 	boff &= 0xf;
    790       1.1  drochner 	xfer = min(len, 16 - boff);
    791       1.1  drochner 	while (len > 0) {
    792      1.24   thorpej 		memcpy(bptr + boff, from, xfer);
    793       1.1  drochner 		from += xfer;
    794       1.1  drochner 		bptr += 32;
    795       1.1  drochner 		boff = 0;
    796       1.1  drochner 		len -= xfer;
    797       1.1  drochner 		xfer = min(len, 16);
    798       1.1  drochner 	}
    799       1.1  drochner }
    800       1.1  drochner 
    801       1.1  drochner void
    802      1.40   tsutsui lance_copyfrombuf_gap16(struct lance_softc *sc, void *tov, int boff, int len)
    803       1.1  drochner {
    804      1.40   tsutsui 	volatile uint8_t *buf = sc->sc_mem;
    805      1.38  christos 	void *to = tov;
    806      1.40   tsutsui 	uint8_t *bptr;
    807      1.11  augustss 	int xfer;
    808       1.1  drochner 
    809       1.1  drochner 	bptr = buf + ((boff << 1) & ~0x1f);
    810       1.1  drochner 	boff &= 0xf;
    811       1.1  drochner 	xfer = min(len, 16 - boff);
    812       1.1  drochner 	while (len > 0) {
    813      1.24   thorpej 		memcpy(to, bptr + boff, xfer);
    814       1.1  drochner 		to += xfer;
    815       1.1  drochner 		bptr += 32;
    816       1.1  drochner 		boff = 0;
    817       1.1  drochner 		len -= xfer;
    818       1.1  drochner 		xfer = min(len, 16);
    819       1.1  drochner 	}
    820       1.1  drochner }
    821       1.1  drochner 
    822       1.1  drochner void
    823      1.40   tsutsui lance_zerobuf_gap16(struct lance_softc *sc, int boff, int len)
    824       1.1  drochner {
    825      1.40   tsutsui 	volatile uint8_t *buf = sc->sc_mem;
    826      1.40   tsutsui 	uint8_t *bptr;
    827      1.11  augustss 	int xfer;
    828       1.1  drochner 
    829       1.1  drochner 	bptr = buf + ((boff << 1) & ~0x1f);
    830       1.1  drochner 	boff &= 0xf;
    831       1.1  drochner 	xfer = min(len, 16 - boff);
    832       1.1  drochner 	while (len > 0) {
    833      1.25   thorpej 		memset(bptr + boff, 0, xfer);
    834       1.1  drochner 		bptr += 32;
    835       1.1  drochner 		boff = 0;
    836       1.1  drochner 		len -= xfer;
    837       1.1  drochner 		xfer = min(len, 16);
    838       1.1  drochner 	}
    839       1.1  drochner }
    840       1.1  drochner #endif /* Example only */
    841