home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / internet / bootnet / ReadMe-ANT next >
Encoding:
Text File  |  1995-08-08  |  36.2 KB  |  1,256 lines

  1.  
  2. Introduction
  3.  
  4. What's New?
  5.     *configure etherX multiple
  6.     *eXtest commands
  7.     *showstat command
  8.  
  9. Downloading new drivers from the Internet
  10.     Downloading via WWW
  11.     Downloading via anonymous FTP
  12.  
  13. Configuration Commands
  14.     Default
  15.     Terse
  16.     Verbose
  17.     Single
  18.     Multiple
  19.     LiveWireTest
  20.     NoLiveWireTest
  21.     Strict
  22.     Ignore
  23.     Enable
  24.     Disable
  25.  
  26. Selftests and the *eXtest commands
  27.  
  28. A couple of obscure points
  29.  
  30. Statistics and trouble shooting
  31.  
  32. The *showstat command
  33.  
  34. Summary of *commands described
  35.  
  36. Obtaining further assistance
  37.  
  38. -----------------------------------------------------------------------------
  39.  
  40. Introduction
  41.  
  42. This release of ANT's network device drivers for its ethernet cards conform
  43. to the new DCI4 interface specification.  Additional support for PC cards has
  44. been added to the drivers, along with a separate program to collect statistic
  45. information and present it tidily.
  46.  
  47. -----------------------------------------------------------------------------
  48.  
  49. What's New?
  50.  
  51. The major enhancement of interest to PC card users is the ability to
  52. configure for multiple operation.  This is a software trick that makes one
  53. ethernet card appear to be two cards, permitting RISC OS and the PC card to
  54. connect to differently named interfaces.  Together with a network client such
  55. as OmniClient, this makes it possible to view the same network file server in
  56. both RISC OS and PC windows at the same time.  This feature is available in
  57. both the Ether3 and EtherB drivers.  See the section on configuration
  58. commands for usage details.
  59.  
  60. For easier network administration, a *command has been added that runs the
  61. selftests.  This can be used at any stage (selftests are normally only run
  62. when a network protocol first connects to an ethernet interface).  See the
  63. section on selftests for
  64.  
  65. The *showstat program collects statistics from any module that understands
  66. that ANT Statistics Protocol and presents them tidily.  Currently, all our
  67. DCI4 network drivers and the Mbuf Manager are capable of supplying statistics
  68. suitably.  We intend to increase the range of programs supporting this
  69. protocol.
  70.  
  71. -----------------------------------------------------------------------------
  72.  
  73. Downloading new drivers from the Internet
  74.  
  75. You can download the latest network device drivers from our WWW and anonymous
  76. FTP sites on the Internet.
  77.  
  78. -----------------------------------------------------------------------------
  79.  
  80. Downloading via WWW
  81.  
  82. For general information on our DCI4 drivers, you should access the URL
  83.  
  84.     http://www.ant.co.uk/dci4/
  85.  
  86. For specific downloading options, access the URL
  87.  
  88.     http://www.ant.co.uk/dci4/download.html
  89.  
  90. -----------------------------------------------------------------------------
  91.  
  92. Downloading via FTP
  93.  
  94. Important:  if your FTP client permits you to vary the transfer mode, ensure
  95. that you have selected image (binary) transfer mode before downloading new
  96. device drivers or programs.
  97.  
  98. For a traditional FTP client, the following information is relevant:
  99.  
  100.     host:       ftp.ant.co.uk
  101.     userid:     anonymous
  102.     password:   <your email address>
  103.     directory:  /pub/dci4/
  104.  
  105. When using an FTP client built into a web browser (such as ANT's Fresco), the
  106. following URL should be used:
  107.  
  108.     ftp://ftp.ant.co.uk/pub/dci4/
  109.  
  110. -----------------------------------------------------------------------------
  111.  
  112. Configuration Commands
  113.  
  114. In general, the configuration options available are the same across Ether3,
  115. EtherB and EtherP modules with the same version number.  The EtherP module
  116. does not use CMOS RAM to store its configuration options, as there is none
  117. allocated (to the parallel port) that it may safely use.  Instead, EtherP
  118. takes an argument string when being loaded that contains the necessary
  119. configuration options.  Most of the configuration options are paired
  120. together.  For example, the verbose option is paired with the terse option.
  121. The general form for configuration is:
  122.  
  123.     *Configure <driver-name> <option> [slot]
  124.  
  125. Where:
  126.  
  127. <driver-name>
  128.     is Ether3, EtherB or EtherP
  129.  
  130. <option>
  131.     is one of the options listed below
  132.  
  133. [slot]
  134.     specifies a specific expansion card slot to apply the configuration
  135.     option to.  This paramater is optional.  It is used when an Ether3 module
  136.     is controlling more than one expansion card and it is desired to update
  137.     the configuration options associated with only one of them.
  138.  
  139. By way of example, the following illustrates how to configure "verbose"
  140. operation:
  141.  
  142.  
  143. For Ether3 modules:
  144.  
  145.     *configure Ether3 verbose
  146.  
  147.  
  148. For EtherB modules:
  149.  
  150.     *configure EtherB verbose
  151.  
  152.  
  153. For EtherP modules only:
  154.  
  155. The RMload command in the startup file in the files subdirectory of the
  156. !Internet directory that loads the Ethernet module requires the options
  157. appending.  A standard startup file contains a section similar to this:
  158.  
  159. | Load driver and initialise Ethernet interface, if required
  160.  
  161. IF "<Inet$EtherIPAddr>" <> "" AND "<Inet$EtherDevice>" <> "" THEN rmload inet:drivers.<Inet$EtherDevice>
  162.  
  163. This should be changed to something similar to
  164.  
  165. | Load driver and initialise Ethernet interface, if required,
  166. | including configuration options
  167.  
  168. IF "<Inet$EtherIPAddr>" <> "" AND "<Inet$EtherDevice>" <> "" THEN rmload inet:drivers.<Inet$EtherDevice> verbose
  169.  
  170. -----------------------------------------------------------------------------
  171.  
  172. Configuration option: default
  173. Applicability       : ether3, etherb
  174.  
  175. Description:
  176. ============
  177.  
  178. Selecting this configuration option restores all configuration options to
  179. their default values.
  180.  
  181. Example:
  182. ========
  183.  
  184.     *configure ether3 default
  185.  
  186. This restores the configuration of an Ether3 card to the default values.
  187. These are equivalent to:
  188.  
  189.     *configure ether3 Enable
  190.     *configure ether3 Strict
  191.     *configure ether3 NoLiveWireTest
  192.     *configure ether3 Terse
  193.     *configure ether3 Single
  194.  
  195. Notes:
  196. ======
  197.  
  198. This restoration happens automatically if the values recorded in CMOS RAM are
  199. detected as being incorrect (say because a different type of card was
  200. previously installed in the same expansion card slot the last time the
  201. machine was used).
  202.  
  203. With EtherP, simply supply no command line arguments when the module is
  204. loaded.
  205.  
  206. -----------------------------------------------------------------------------
  207.  
  208. Configuration option: terse
  209. Paired with         : verbose
  210. Applicability       : ether3, etherb
  211.  
  212. Description:
  213. ============
  214.  
  215. 1) When performing selftests, terse operation causes printing to only
  216. occur if an error is encountered.
  217.  
  218. 2) Terse selftests perform a quicker memory test than verbose
  219. selftests.
  220.  
  221. 3) Terse operation generally omits printing a count for a statistic if
  222. the value is zero.
  223.  
  224. Example:
  225. ========
  226.  
  227.     *configure ether3 terse
  228.  
  229. This configures an Ether3 card to operate in terse mode.
  230.  
  231. Notes:
  232. ======
  233.  
  234. Terse operation is often the most convenient in normal use.
  235.  
  236. -----------------------------------------------------------------------------
  237.  
  238. Configuration option: verbose
  239. Paired with         : terse
  240. Applicability       : ether3, etherb
  241.  
  242. Description:
  243. ============
  244.  
  245. 1) When performing selftests, verbose operation always prints the test
  246. being conducted and the test result.
  247.  
  248. 2) Verbose selftests perform a more extensive memory test than terse
  249. selftests.  This adds notably to the time it takes to perform
  250. selftests, but can be a useful diagnostic aid.
  251.  
  252. 3) A verbose configuration lists all available statistics, including
  253. those that are zero.
  254.  
  255. Example:
  256. ========
  257.  
  258.     *configure ether3 verbose
  259.  
  260. This configures an Ether3 card to operate in verbose mode.
  261.  
  262. Notes:
  263. ======
  264.  
  265. See also the *showstat command.
  266.  
  267. -----------------------------------------------------------------------------
  268.  
  269. Configuration option: single
  270. Paired with         : multiple
  271. Applicability       : ether3, etherb
  272.  
  273. Description:
  274. ============
  275.  
  276. When configured for single operation, each ethernet card presents one
  277. software interface to network protocols. This is the more traditional
  278. mode of operation, as contrasted with multiple operation.
  279.  
  280. Example:
  281. ========
  282.  
  283.     *configure ether3 single
  284.  
  285. This configures an Ether3 card to operate in single mode. This causes
  286. an interface named "ea0" to be presented in software to the rest of
  287. the system.
  288.  
  289. Notes:
  290. ======
  291.  
  292. -----------------------------------------------------------------------------
  293.  
  294. Configuration option: multiple
  295. Paired with         : single
  296. Applicability       : ether3, etherb
  297.  
  298. Description:
  299. ============
  300.  
  301. When configured for multiple operation, each ethernet card presents
  302. two seperate software interfaces.  In effect, multiple operation makes
  303. one ethernet card appear as if it were actually two ethernet cards at
  304. the software level.  This can be very useful when using network
  305. clients from within the RISC OS desktop and !PC486 to examine the same
  306. file server.
  307.  
  308. Example:
  309. ========
  310.  
  311.     *configure ether3 multiple
  312.  
  313. This configures an Ether3 card to operate in multiple mode.  This
  314. causes two interfaces named "ea0" and "ea1" to be presented in
  315. software to the rest of the system.
  316.  
  317. Notes:
  318. ======
  319.  
  320. Unless you require multiple operation, we recommend you use single
  321. operation - there can be a performance overhead when operating with
  322. multiple operation.
  323.  
  324. -----------------------------------------------------------------------------
  325.  
  326. Configuration option: livewiretest
  327. Paired with         : nolivewiretest
  328. Applicability       : ether3, etherb
  329.  
  330. Description:
  331. ============
  332.  
  333. When configured for livewiretest operation, the selftests performed
  334. when an ethernet card starts up include transmitting three packets
  335. onto the network and checking their receiption.
  336.  
  337. Example:
  338. ========
  339.  
  340.     *configure ether3 livewiretest
  341.  
  342. This configures an Ether3 card to operate in livewiretest mode.
  343.  
  344. Notes:
  345. ======
  346.  
  347. -----------------------------------------------------------------------------
  348.  
  349. Configuration option: nolivewiretest
  350. Paired with         : livewiretest
  351. Applicability       : ether3, etherb
  352.  
  353. Description:
  354. ============
  355.  
  356. When configured for nolivewiretest operation, the selftests performed
  357. when an ethernet card starts up refrain from transmitting any packets
  358. onto the currently attached network.  Loopback packet tests (which are
  359. performed entirely within the ethernet card itself) are still
  360. performed.
  361.  
  362. Example:
  363. ========
  364.  
  365.     *configure ether3 nolivewiretest
  366.  
  367. This configures an Ether3 card to operate in nolivewiretest mode.
  368.  
  369. Notes:
  370. ======
  371.  
  372. There are some network configurations where livewiretests can be
  373. guaranteed to fail. Nolivewiretest operation is intended for such
  374. situations.
  375.  
  376. -----------------------------------------------------------------------------
  377.  
  378. Configuration option: strict
  379. Paired with         : ignore
  380. Applicability       : ether3, etherb
  381.  
  382. Description:
  383. ============
  384.  
  385. When configured for strict operation, all selftests performed must
  386. pass.
  387.  
  388. Example:
  389. ========
  390.  
  391.     *configure ether3 strict
  392.  
  393. This configures an Ether3 card to operate in strict mode.
  394.  
  395. Notes:
  396. ======
  397.  
  398. Strict operation is the recommended mode of operation.
  399.  
  400. -----------------------------------------------------------------------------
  401.  
  402. Configuration option: ignore
  403. Paired with         : strict
  404. Applicability       : ether3, etherb
  405.  
  406. Description:
  407. ============
  408.  
  409. When configured for ignore operation, any failures encountered during
  410. live wire tests (if performed) are ignored.  This option should be
  411. excercised with caution.
  412.  
  413. Example:
  414. ========
  415.  
  416.     *configure ether3 ignore
  417.  
  418. This configures an Ether3 card to operate in ignore mode.
  419.  
  420. Notes:
  421. ======
  422.  
  423. Ignore operation is only advised when specifically recommended by your
  424. network administrator.
  425.  
  426. -----------------------------------------------------------------------------
  427.  
  428. Configuration option: enable
  429. Paired with         : disable
  430. Applicability       : ether3, etherb
  431.  
  432. Description:
  433. ============
  434.  
  435. This option selects enable operation.  Only if an ethernet card is
  436. configured for enable operation can it be used.  Enable operation is
  437. the normal operation mode.
  438.  
  439. Example:
  440. ========
  441.  
  442.     *configure ether3 enable
  443.  
  444. This configures an Ether3 card to operate in enable mode, permitting
  445. it to be used.
  446.  
  447. Notes:
  448. ======
  449.  
  450. -----------------------------------------------------------------------------
  451.  
  452. Configuration option: disable
  453. Paired with         : enable
  454. Applicability       : ether3, etherb
  455.  
  456. Description:
  457. ============
  458.  
  459. Selecting disable operation prevents an ethernet card from being used.
  460. Disable operation is rarely required.
  461.  
  462. Example:
  463. ========
  464.  
  465.     *configure ether3 disable
  466.  
  467. This prevents an ethernet card from being used by selecting disable
  468. operation.
  469.  
  470. Notes:
  471. ======
  472.  
  473. There are times when this mode of operation is extremely useful, but
  474. they are rare.
  475.  
  476. -----------------------------------------------------------------------------
  477.  
  478. Selftests and the *eXtest commands
  479.  
  480. Diagnosing network problems can be difficult at the best of times, so
  481. anything the network drivers can do to assist is very useful.  The two major
  482. ways in which they do assist are the selftests and statistics gathering
  483. (described later).
  484.  
  485. The selftests are a collection of thorough test routines that exercise a
  486. range of features of the ethernet card.  They are invoked either from a
  487. *command or when a network protocol first connects to an ethernet interface.
  488. Some configuration options are available to alter the amount of testing
  489. performed (see the section detailing configuration commands). Whether any
  490. messages are printed for successfully passed tests is configurable. Any
  491. test that fails will always print a message.  If any selftest fails, you are
  492. strongly recommended to contact their network administrator for advice.
  493.  
  494. For example, an EtherB driver module with the following configuration options
  495. active:
  496.  
  497.     single
  498.     verbose
  499.     livewiretest
  500.     enable
  501.     strict
  502.  
  503. produces the following output on selftests:
  504.  
  505.     Locate controller  . . . . 80C04.AF Network slot
  506.     Interrupts . . . . . . . . passed
  507.     Buffer memory  . . . . . . passed
  508.     Loopback, correct CRC  . . passed
  509.     Loopback, incorrect CRC  . passed
  510.     Loopback, controller CRC . passed
  511.     Livewire, correct CRC  . . passed
  512.     Livewire, incorrect CRC  . passed
  513.     Livewire, controller CRC . passed
  514.  
  515.  
  516. The first three tests perform basic functionality tests on the Ethernet
  517. controller and the associated buffer memory.
  518.  
  519.  
  520. Locate controller  . . . .
  521. --------------------------
  522.  
  523. This tests that the Ethernet controller can be accessed and that it's
  524. internal registers are operative.  This test should never fail.
  525.  
  526.  
  527. Interrupts . . . . . . . .
  528. --------------------------
  529.  
  530. This tests basic functionality of the interrupt generation of the Ethernet
  531. controller.  This test should never fail.
  532.  
  533.  
  534. Buffer memory  . . . . . .
  535. --------------------------
  536.  
  537. This tests the buffer memory contained on the Ethernet card.  If the driver
  538. module is configured for verbose operation, then more extensive (and time
  539. consuming) tests of buffer memory are performed.  This test should never
  540. fail.
  541.  
  542. If there is insufficient RMA available for the buffers used by this test,
  543. then it cannot be performed and the test is deemed passed.  If selftesting is
  544. being reported, this test is annotated as being skipped if there is not
  545. sufficient RMA.
  546.  
  547.  
  548.  
  549. The tests that follow these three basic tests are packet transmission and
  550. receiption tests.  There are three variants of the packet test, performed
  551. first in loopback mode and then on the live network (if *Configured for
  552. "livewiretest", see below).  Loopback mode is a special mode of operation of
  553. the ethernet card for diagnostic purposes, where packets are not transmitted
  554. onto the connected network, but internally redirected back to the ethernet
  555. cards own receiver.  This permits the ethernet card to transmit a packet and
  556. check its correctness.  These tests verify the correct operation of many
  557. components of the interface.
  558.  
  559.  
  560.  
  561. Loopback, correct CRC  . .
  562. Loopback, incorrect CRC  .
  563. Loopback, controller CRC .
  564.  
  565.  
  566.  
  567. Livewire, correct CRC  . .
  568. Livewire, incorrect CRC  .
  569. Livewire, controller CRC .
  570.  
  571.  
  572. In general, if an error occurs during loopback testing, the ethernet card
  573. itself may be faulty. If loopback tests pass without error but live network
  574. tests fail, this normally indicates a problem with the network itself.
  575.  
  576.  
  577. Note: If "nolivewiretest" had been configured, the last three tests
  578. would not have been performed and the last three lines would not have been
  579. printed.
  580.  
  581. -----------------------------------------------------------------------------
  582.  
  583. A couple of obscure points
  584.  
  585. When a *eXtest command is issued, the interface being tested needs to be
  586. temporarily retracted from service, which causes network protocols using it
  587. to disconnect. When the testing is complete, the interface's existence is
  588. announced and network protocols reconnect to it.
  589.  
  590. In normal operation this actually causes two selftests to be performed.  The
  591. first in response to the *command itself and the second because, once testing
  592. is complete, the interface has been connected to by a network protocol.
  593.  
  594. If no network protocol is connected to the interface being tested, then only
  595. one selftest is performed.
  596.  
  597. When operating in multiple mode, selftests are testing the real hardware
  598. associated with an interface.
  599.  
  600. This means both interfaces associated with the hardware must be withdrawn
  601. from service whilst the tests are being performed.  If both interfaces were
  602. previously in use by network protocols, a single *ebtest command can lead to
  603. four seperate selftests being performed on the one piece of hardware! The
  604. sequence of actions actually performed is:
  605.  
  606. test first interface - eb0
  607.     withdraw eb0 from service - being test
  608.     withdraw eb1 from service - associated interface
  609.     perform first selftest - *ebtest eb0 equivalent
  610.     announce eb1 - network protocol reconnects
  611.     perform second selftest - network protocol connection
  612.     announce eb0
  613.  
  614. test second interface - eb1
  615.     withdraw eb1 from service - being test
  616.     withdraw eb0 from service - associated interface
  617.     perform third selftest - *ebtest eb1 equivalent
  618.     announce eb0 - network protocol reconnects
  619.     perform fourth selftest - network protocol connection
  620.     announce eb1
  621.  
  622. -----------------------------------------------------------------------------
  623.  
  624. Statistics and trouble shooting
  625.  
  626. Each of the ANT DCI4 device driver modules collects statistics (such as
  627. number of packets transmitted and received) during operation and supports a
  628. *command to print these accumlated interface statistics.  Additionally, the
  629. *showstat command collects statistics from those modules offering them and
  630. presents them tidily.  For an Ether3 module, use the *e3info to print
  631. interface statistics. For EtherB, use *ebinfo. For EtherP, use *epinfo.
  632.  
  633. Under normal operation, the interface statistics gathered can be ignored.
  634. However, as a network problem diagnostic tool, they can be invaluable
  635. diagnostic tool.
  636.  
  637. The most important thing to do when determing the cause of network problems
  638. is to determine at what level the error is occurring.  It might be a physical
  639. problem (network not connected, server on a physically different and
  640. unconnected network), an Internet configuration problem (incorrectly assigned
  641. IP number or network mask), a routing problem (not uncommon when initially
  642. connecting multiple networks together), etc.  Each type of fault requires a
  643. different type of remedy. Time spent examining working sections of a
  644. configuration is often better spent determining what is not working. If you
  645. suspect multiple parts of a configuration are not working, start with the
  646. lowest level and work upwards.
  647.  
  648. Two major clues can be obtained from the interface statistics.  Firstly,
  649. major packet errors have their own count - if any of these counts is
  650. non-zero, then a low level network problem exists and needs investigating and
  651. correcting.  For example, receiption of packets of CRC errors suggests the
  652. network cabling might be faulty somewhere. Large numbers of transmission
  653. collisions might be due to the network not be correctly connected.
  654.  
  655. The next major clue is the count of packets transmitted and received.  When
  656. access to a fileserver or other network facility appears unavailable, the
  657. first thing to determine is whether the server machine is contactable at all
  658. over the network.  This is typically performed with the "ping" (TCP/IP) and
  659. "netprobe" (AUN) commands.  Under normal operation, each ping/netprobe causes
  660. (at least) one packet to be transmitted and (at least) one to be received
  661. under normal operation.
  662.  
  663.  
  664. As an example of the printing of interface statistics, the following shows
  665. the results of a *ebinfo when configured for terse operation. Remember that
  666. statistics which have a count of zero only have their names printed in terse
  667. mode. This makes it easier to spot non-zero values, which are generally the
  668. more significant values to observe.
  669.  
  670.  
  671. EtherB interface statistics
  672.  
  673. eb0: 80C04.AF Network slot, slot 8, up, hardware address 00:00:A4:10:1A:9E
  674.  
  675. Interface driver    : eb (built Aug  3 1995)
  676. Interface unit      : 0
  677. Interface location  : Netcard slot
  678. Interface address   : 00:00:A4:10:1A:9E
  679. Interface controller: 80C04.AF Network slot
  680. Initialise time     : Mon Aug  7 11:25:52 1995
  681. Running time        : 17 minutes, 50 seconds.
  682. Packets sent        : 2021
  683. Packets received    : 2143
  684. Bytes sent          : 421963
  685. Bytes received      : 479185
  686. Send errors         :
  687. Receive errors      :
  688. Broadcasts sent     :
  689. Broadcasts received : 119
  690. Multicasts sent     :
  691. Multicasts received : 4
  692. Monitor sends       :
  693. Monitor receives    :
  694. Send interrupts     : 2021
  695. Receive interrupts  : 2143
  696. Delivered packets   : 2143
  697. Undelivered packets :
  698. Sends too large     :
  699. Send max collisions :
  700. Send overflows      :
  701. Sends blocked       :
  702. Receives too small  :
  703. Receives too large  :
  704. Incomplete receives :
  705. Receive CRC errors  :
  706. Lack of mbufs       :
  707. Receive overflows   :
  708.  
  709. Standard clients:
  710.  
  711. Frame = &0800, ErrLvl=00, AddrLvl=01
  712. Frame = &0806, ErrLvl=00, AddrLvl=01
  713. Frame = &8035, ErrLvl=00, AddrLvl=01
  714.  
  715. IEEE 802.3 client:
  716.  
  717. Frame = &0000, ErrLvl=00, AddrLvl=02
  718.  
  719. Log: EtherB messages can appear here
  720.  
  721.  
  722. The message log (the section prefixed by "Log:"  above) is used to record the
  723. last error delivered by the ethernet driver module.  This can be useful when
  724. an intervening layer of software translates an error to a different one.  It
  725. is initialised with a message indicating it's purpose rather than leaving it
  726. empty.
  727.  
  728. -----------------------------------------------------------------------------
  729.  
  730. The following output shows an example network fault (in this case, the
  731. network has been deliberately unplugged). Three commands are issued: *ebtest,
  732. *ebinfo and *showstat. Note the extra section marked
  733.  
  734.     Failures noted during testing:
  735.  
  736. that has appeared in the *ebinfo output. The information that is printed here
  737. when a selftest fails is often enough to let a network administrator work out
  738. what to do to get a working setup. The reason why two selftests are performed
  739. is given in the section called "A couple of obscure points".
  740.  
  741.  
  742. *ebtest
  743.  
  744. Locate controller  . . . . 80C04.AF Network slot
  745. Interrupts . . . . . . . . passed
  746. Buffer memory  . . . . . . passed
  747. Loopback, correct CRC  . . passed
  748. Loopback, incorrect CRC  . passed
  749. Loopback, controller CRC . passed
  750. Livewire, correct CRC  . . FAILED
  751. Locate controller  . . . . 80C04.AF Network slot
  752. Interrupts . . . . . . . . passed
  753. Buffer memory  . . . . . . passed
  754. Loopback, correct CRC  . . passed
  755. Loopback, incorrect CRC  . passed
  756. Loopback, controller CRC . passed
  757. Livewire, correct CRC  . . FAILED
  758. eb0 (Netcard slot) FAILED SELFTESTS
  759. Error: eb0: Interface faulty
  760. eb0: Interface faulty
  761.  
  762. *ebinfo
  763.  
  764. EtherB interface statistics
  765.  
  766. eb0: 80C04.AF Network slot, slot 8, failed selftest, hardware address 00:00:A4:10:1A:9E
  767.  
  768. Interface driver    : eb (built Aug  3 1995)
  769. Interface unit      : 0
  770. Interface location  : Netcard slot
  771. Interface address   : 00:00:A4:10:1A:9E
  772. Interface controller: 80C04.AF Network slot
  773. Initialise time     : Mon Aug  7 13:52:25 1995
  774. Running time        : Interface not active
  775. Packets sent        : 6
  776. Packets received    : 7
  777. Bytes sent          : 6160
  778. Bytes received      : 6292
  779. Send errors         : 2
  780. Receive errors      : 2
  781. Broadcasts sent     : 0
  782. Broadcasts received : 1
  783. Multicasts sent     : 0
  784. Multicasts received : 0
  785. Monitor sends       : 0
  786. Monitor receives    : 0
  787. Send interrupts     : 8
  788. Receive interrupts  : 7
  789. Delivered packets   : 7
  790. Undelivered packets : 0
  791. Sends too large     : 0
  792. Send max collisions : 2
  793. Send overflows      : 0
  794. Sends blocked       : 0
  795. Receives too small  : 0
  796. Receives too large  : 0
  797. Incomplete receives : 0
  798. Receive CRC errors  : 2
  799. Lack of mbufs       : 0
  800. Receive overflows   : 0
  801.  
  802. Failures noted during testing:
  803.  
  804. Tx hw failed tests
  805. Receive interrupt failure
  806. Rx hw failed tests
  807. Live net tests failure
  808.  
  809. Log: eb0: Interface faulty
  810.  
  811. *showstat
  812.  
  813. ANT DCI4 Statistic Gatherer 1.03 (Aug  3 1995)
  814. (C) Copyright ANT Limited 1994, 1995. All rights reserved.
  815.  
  816.  
  817. Device Driver Information Block
  818.  
  819. Name                : eb
  820. Unit                : 0
  821. Address             : 00:00:A4:10:1A:9E
  822. Module              : EtherB
  823. Location            : Netcard slot
  824. Feature flags       :
  825.                     : Multicast receiption is supported
  826.                     : Promiscuous receiption is supported
  827.                     : Interface receives its own transmissions
  828.                     : Interface can receive erroneous packets
  829.                     : Interface has a hardware address
  830.                     : Driver can alter interface's hardware address
  831.                     : Driver supplies standard statistics
  832.                     : Driver supplies extended statistics
  833. Interface type      : 10Base5/10Base2/10BaseT ethernet
  834. Link Status         : Interface bad
  835. Active Status       : Interface inactive
  836. Receive mode        : Directly addressed frames only
  837. Polarity            : Correct
  838. TX excess collisions: 2
  839. Packets transmitted : 6
  840. Bytes transmitted   : 6160
  841. General TX errors   : 2
  842. Received packets    : 7
  843. Received bytes      : 6292
  844. General RX errors   : 2
  845.  
  846.  
  847. Module 'EtherB' is a supplier titled 'EtherB device driver'
  848.  
  849. EtherB device driver: DCI4 Ethernet device driver for 16 bit EtherB cards
  850. Interface driver    : eb (built Aug  3 1995)
  851. Interface unit      : 0
  852. Interface location  : Netcard slot
  853. Interface address   : 00:00:A4:10:1A:9E
  854. Interface controller: 80C04.AF Network slot
  855. Initialise time     : Mon Aug  7 13:52:25 1995
  856. Running time        : Interface not active
  857. Packets sent        : 6
  858. Packets received    : 7
  859. Bytes sent          : 6160
  860. Bytes received      : 6292
  861. Send errors         : 2
  862. Receive errors      : 2
  863. Broadcasts sent     : 0
  864. Broadcasts received : 1
  865. Multicasts sent     : 0
  866. Multicasts received : 0
  867. Monitor sends       : 0
  868. Monitor receives    : 0
  869. Send interrupts     : 8
  870. Receive interrupts  : 7
  871. Delivered packets   : 7
  872. Undelivered packets : 0
  873. Sends too large     : 0
  874. Send max collisions : 2
  875. Send overflows      : 0
  876. Sends blocked       : 0
  877. Receives too small  : 0
  878. Receives too large  : 0
  879. Incomplete receives : 0
  880. Receive CRC errors  : 2
  881. Lack of mbufs       : 0
  882. Receive overflows   : 0
  883.  
  884.  
  885. Module 'MbufManager' is a supplier titled 'Mbuf Manager'
  886.  
  887. Mbuf Manager        : System wide memory buffer (mbuf) memory management
  888. Active sessions     : 2
  889. Sessions opened     : 4
  890. Sessions closed     : 2
  891. Memory pool size    : 102400
  892. Small block size    : 128
  893. Large block size    : 1536
  894. Mbuf exhaustions    : 0
  895. Small mbufs in use  : 3
  896. Small mbufs free    : 509
  897. Large mbufs in use  : 0
  898. Large mbufs free    : 24
  899.  
  900.  
  901. -----------------------------------------------------------------------------
  902.  
  903. The *showstat command
  904.  
  905. The *showstat command is a disc based program that produces a tidy
  906. presentation of the statistics from the network device driver modules.
  907. It does an excellent job at collecting together the information that is
  908. likely to be needed to diagnose low level network problems. Your network
  909. administrator will thank you if you have the output of *showstat to hand when
  910. reporting any network problems.
  911.  
  912. Currently, the ethernet device drivers and the mbuf manager know how to
  913. supply statistics to it.  Other ANT products are likely to support showstat
  914. in the future.  An example of the output produced looks like:
  915.  
  916.  
  917. ANT DCI4 Statistic Gatherer 1.03 (Aug  3 1995)
  918. (C) Copyright ANT Limited 1994, 1995. All rights reserved.
  919.  
  920.  
  921. Device Driver Information Block
  922.  
  923. Name                : eb
  924. Unit                : 0
  925. Address             : 00:00:A4:10:1A:9E
  926. Module              : EtherB
  927. Location            : Netcard slot
  928. Feature flags       :
  929.                     : Multicast receiption is supported
  930.                     : Promiscuous receiption is supported
  931.                     : Interface receives its own transmissions
  932.                     : Interface can receive erroneous packets
  933.                     : Interface has a hardware address
  934.                     : Driver can alter interface's hardware address
  935.                     : Driver supplies standard statistics
  936.                     : Driver supplies extended statistics
  937. Interface type      : 10Base5/10Base2/10BaseT ethernet
  938. Link Status         : Interface okay
  939. Active Status       : Interface active
  940. Receive mode        : Direct, broadcast and multicast frames
  941. Polarity            : Correct
  942. Packets transmitted : 2016
  943. Bytes transmitted   : 421649
  944. Received packets    : 2134
  945. Received bytes      : 478593
  946.  
  947.  
  948. Device Driver Information Block
  949.  
  950. Name                : eb
  951. Unit                : 1
  952. Address             : 00:00:A4:90:1A:9E
  953. Module              : EtherB
  954. Location            : Netcard slot
  955. Feature flags       :
  956.                     : Multicast receiption is supported
  957.                     : Promiscuous receiption is supported
  958.                     : Interface receives its own transmissions
  959.                     : Interface can receive erroneous packets
  960.                     : Interface has a hardware address
  961.                     : Driver can alter interface's hardware address
  962.                     : Driver supplies standard statistics
  963.                     : Driver supplies extended statistics
  964.                     : Interface is a secondary interface
  965. Interface type      : 10Base5/10Base2/10BaseT ethernet
  966. Link Status         : Interface okay
  967. Active Status       : Interface inactive
  968. Receive mode        : Direct, broadcast and multicast frames
  969. Polarity            : Correct
  970.  
  971.  
  972. Module 'EtherB' is a supplier titled 'EtherB device driver'
  973.  
  974. EtherB device driver: DCI4 Ethernet device driver for 16 bit EtherB cards
  975. Interface driver    : eb (built Aug  3 1995)
  976. Interface unit      : 0
  977. Interface location  : Netcard slot
  978. Interface address   : 00:00:A4:10:1A:9E
  979. Interface controller: 80C04.AF Network slot
  980. Initialise time     : Mon Aug  7 11:25:52 1995
  981. Running time        : 17 minutes, 10 seconds.
  982. Packets sent        : 2016
  983. Packets received    : 2136
  984. Bytes sent          : 421649
  985. Bytes received      : 478705
  986. Send errors         : 0
  987. Receive errors      : 0
  988. Broadcasts sent     : 0
  989. Broadcasts received : 116
  990. Multicasts sent     : 0
  991. Multicasts received : 4
  992. Monitor sends       : 0
  993. Monitor receives    : 0
  994. Send interrupts     : 2016
  995. Receive interrupts  : 2136
  996. Delivered packets   : 2136
  997. Undelivered packets : 0
  998. Sends too large     : 0
  999. Send max collisions : 0
  1000. Send overflows      : 0
  1001. Sends blocked       : 0
  1002. Receives too small  : 0
  1003. Receives too large  : 0
  1004. Incomplete receives : 0
  1005. Receive CRC errors  : 0
  1006. Lack of mbufs       : 0
  1007. Receive overflows   : 0
  1008.  
  1009.  
  1010. Module 'EtherB' is a supplier titled 'EtherB device driver'
  1011.  
  1012. EtherB device driver: DCI4 Ethernet device driver for 16 bit EtherB cards
  1013. Interface driver    : eb (built Aug  3 1995)
  1014. Interface unit      : 1
  1015. Interface location  : Netcard slot
  1016. Interface address   : 00:00:A4:90:1A:9E
  1017. Interface controller: 80C04.AF Network slot
  1018. Initialise time     : Mon Aug  7 11:25:52 1995
  1019. Running time        : Interface not active
  1020. Packets sent        : 0
  1021. Packets received    : 0
  1022. Bytes sent          : 0
  1023. Bytes received      : 0
  1024. Send errors         : 0
  1025. Receive errors      : 0
  1026. Broadcasts sent     : 0
  1027. Broadcasts received : 0
  1028. Multicasts sent     : 0
  1029. Multicasts received : 0
  1030. Monitor sends       : 0
  1031. Monitor receives    : 0
  1032. Send interrupts     : 0
  1033. Receive interrupts  : 0
  1034. Delivered packets   : 0
  1035. Undelivered packets : 0
  1036. Sends too large     : 0
  1037. Send max collisions : 0
  1038. Send overflows      : 0
  1039. Sends blocked       : 0
  1040. Receives too small  : 0
  1041. Receives too large  : 0
  1042. Incomplete receives : 0
  1043. Receive CRC errors  : 0
  1044. Lack of mbufs       : 0
  1045. Receive overflows   : 0
  1046.  
  1047.  
  1048. Module 'MbufManager' is a supplier titled 'Mbuf Manager'
  1049.  
  1050. Mbuf Manager        : System wide memory buffer (mbuf) memory management
  1051. Active sessions     : 3
  1052. Sessions opened     : 4
  1053. Sessions closed     : 1
  1054. Memory pool size    : 102400
  1055. Small block size    : 128
  1056. Large block size    : 1536
  1057. Mbuf exhaustions    : 0
  1058. Small mbufs in use  : 19
  1059. Small mbufs free    : 493
  1060. Large mbufs in use  : 0
  1061. Large mbufs free    : 24
  1062.  
  1063. -----------------------------------------------------------------------------
  1064.  
  1065. For reference, contrast the above *showstat output with that produced by a
  1066. *ebinfo command shortly afterwards:
  1067.  
  1068.  
  1069. EtherB interface statistics
  1070.  
  1071. eb1: 80C04.AF Network slot, slot 8, down, hardware address 00:00:A4:90:1A:9E
  1072.  
  1073. Secondary interface
  1074. Interface driver    : eb (built Aug  3 1995)
  1075. Interface unit      : 1
  1076. Interface location  : Netcard slot
  1077. Interface address   : 00:00:A4:90:1A:9E
  1078. Interface controller: 80C04.AF Network slot
  1079. Initialise time     : Mon Aug  7 11:25:52 1995
  1080. Running time        : Interface not active
  1081. Packets sent        :
  1082. Packets received    :
  1083. Bytes sent          : 0
  1084. Bytes received      : 0
  1085. Send errors         :
  1086. Receive errors      :
  1087. Broadcasts sent     :
  1088. Broadcasts received :
  1089. Multicasts sent     :
  1090. Multicasts received :
  1091. Monitor sends       :
  1092. Monitor receives    :
  1093. Send interrupts     :
  1094. Receive interrupts  :
  1095. Delivered packets   :
  1096. Undelivered packets :
  1097. Sends too large     :
  1098. Send max collisions :
  1099. Send overflows      :
  1100. Sends blocked       :
  1101. Receives too small  :
  1102. Receives too large  :
  1103. Incomplete receives :
  1104. Receive CRC errors  :
  1105. Lack of mbufs       :
  1106. Receive overflows   :
  1107.  
  1108. eb0: 80C04.AF Network slot, slot 8, up, hardware address 00:00:A4:10:1A:9E
  1109.  
  1110. Interface driver    : eb (built Aug  3 1995)
  1111. Interface unit      : 0
  1112. Interface location  : Netcard slot
  1113. Interface address   : 00:00:A4:10:1A:9E
  1114. Interface controller: 80C04.AF Network slot
  1115. Initialise time     : Mon Aug  7 11:25:52 1995
  1116. Running time        : 17 minutes, 50 seconds.
  1117. Packets sent        : 2021
  1118. Packets received    : 2143
  1119. Bytes sent          : 421963
  1120. Bytes received      : 479185
  1121. Send errors         :
  1122. Receive errors      :
  1123. Broadcasts sent     :
  1124. Broadcasts received : 119
  1125. Multicasts sent     :
  1126. Multicasts received : 4
  1127. Monitor sends       :
  1128. Monitor receives    :
  1129. Send interrupts     : 2021
  1130. Receive interrupts  : 2143
  1131. Delivered packets   : 2143
  1132. Undelivered packets :
  1133. Sends too large     :
  1134. Send max collisions :
  1135. Send overflows      :
  1136. Sends blocked       :
  1137. Receives too small  :
  1138. Receives too large  :
  1139. Incomplete receives :
  1140. Receive CRC errors  :
  1141. Lack of mbufs       :
  1142. Receive overflows   :
  1143.  
  1144. Standard clients:
  1145.  
  1146. Frame = &0800, ErrLvl=00, AddrLvl=01
  1147. Frame = &0806, ErrLvl=00, AddrLvl=01
  1148. Frame = &8035, ErrLvl=00, AddrLvl=01
  1149.  
  1150. IEEE 802.3 client:
  1151.  
  1152. Frame = &0000, ErrLvl=00, AddrLvl=02
  1153.  
  1154. Log: EtherB messages can appear here
  1155.  
  1156. -----------------------------------------------------------------------------
  1157.  
  1158. Summary of *commands described
  1159.  
  1160.  
  1161. *ebtest
  1162.     Perform selftests when using the EtherB module.
  1163.  
  1164. *e3test
  1165.     Perform selftests when using the Ether3 module.
  1166.  
  1167. *eptest
  1168.     Perform selftests when using the EtherP module.
  1169.  
  1170. *ebtest
  1171.     Display statistics when using the EtherB module.
  1172.  
  1173. *e3test
  1174.     Display statistics when using the Ether3 module.
  1175.  
  1176. *eptest
  1177.     Display statistics when using the EtherP module.
  1178.  
  1179. *showstat
  1180.     Collect and display available statistics
  1181.  
  1182. *configure etherX default
  1183.     Restore default configuration for an ethernet device driver.
  1184.  
  1185. *configure etherX terse
  1186.     Select terse operation
  1187.  
  1188. *configure etherX verbose
  1189.     Select verbose operation
  1190.  
  1191. *configure etherX single
  1192.     Each physical card presents one interface in software
  1193.  
  1194. *configure etherX multiple
  1195.     Each physical card presents two interfaces in software
  1196.  
  1197. *configure etherX livewiretest
  1198.     Configure selftests to perform packet tests on the attached network.
  1199.  
  1200. *configure etherX nolivewiretest
  1201.     Configure selftests to not perform packet tests on the attached network.
  1202.  
  1203. *configure etherX strict
  1204.     Any errors encountered during livewiretests are significant.
  1205.  
  1206. *configure etherX ignore
  1207.     Errors encountered during livewiretests are ignored.
  1208.  
  1209. *configure etherX enable
  1210.     Permit use of a network card
  1211.  
  1212. *configure etherX disable
  1213.     Prevent use of a network cards
  1214.  
  1215. -----------------------------------------------------------------------------
  1216.  
  1217. Obtaining further assistance
  1218.  
  1219.  
  1220. You can contact us by email at the following address
  1221.  
  1222.     support@ant.co.uk
  1223.  
  1224.  
  1225. You can fax your questions to
  1226.  
  1227.     +44 (0) 1223 567801
  1228.  
  1229.  
  1230. You can post enquires to
  1231.  
  1232.     ANT Limited
  1233.     PO BOX 300
  1234.     Cambridge
  1235.     CB1 2EG
  1236.  
  1237.  
  1238. You can browse support information on our WWW site
  1239.  
  1240.     http://www.ant.co.uk/
  1241.  
  1242.  
  1243. We also operate an FTP site
  1244.  
  1245.     ftp://ftp.ant.co.uk/
  1246.  
  1247.  
  1248. You can also receive assistance from the electronic news groups in the
  1249. comp.sys.acorn hierarchy.
  1250.  
  1251.  
  1252.  
  1253. -----------------------------------------------------------------------------
  1254.  
  1255. Document ends. Borris. 8th August 1995.
  1256.