home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / hamradio / nosvw137.arj / ASYSTAT < prev    next >
Text File  |  1991-09-18  |  3KB  |  63 lines
  1. =======                                             NOSview [137]
  2. asystat
  3. =======
  4.  
  5. ________________________________________________________________
  6. asysyat
  7. ________________________________________________________________
  8. Display statistics on attached asynchronous communications
  9. interfaces (8250 or 16550A).  The display for each port consists
  10. of three lines.
  11.  
  12. The first line gives the port label and the configuration flags;
  13. these indicate whether the port is a 16550A chip, the trigger
  14. character if any, whether CTS flow control is enabled, whether
  15. RLSD (carrier detect) line control is enabled, and the speed in
  16. bits per second.  (Receiving the trigger character causes the
  17. driver to signal upper layer software that data is ready; it is
  18. automatically set to the appropriate frame end character for
  19. SLIP, PPP and NRS lines.)
  20.  
  21. The second line of the status display shows receiver (RX) event
  22. counts: the total number of receive interrupts, received
  23. characters, receiver overruns (lost characters) and the receiver
  24. high water mark (HWM).
  25.  
  26. The HWM is the maximum number of characters ever read from the
  27. device during a single interrupt.  This is useful for monitoring
  28. system interrupt latency margins as it shows how close the port
  29. hardware has come to overflowing due to the inability of the CPU
  30. to respond to a receiver interrupt in time.
  31.  
  32. 8250 chips have no FIFO, so the HWM cannot go higher than 2
  33. before overruns occur.  The 16550A chip, however, has a 16-byte
  34. receive FIFO which the software programs to interrupt the CPU
  35. when the FIFO is one-quarter full.
  36.  
  37. The HWM should typically be 4 or 5 when a 16550A is used; higher
  38. values indicate that the CPU has at least once been slow to
  39. respond to a receiver interrupt.
  40.  
  41. When the 16550A is used, a count of FIFO timeouts is also
  42. displayed on the RX status line.  These are generated
  43. automatically by the 16550A when three character intervals go by
  44. with more than 0 but less than 4 characters in the FIFO.  Since
  45. the characters that make up a SLIP or NRS frame are normally sent
  46. at full line speed, this count will usually be a lower bound on
  47. the number of frames received on the port, as only the last
  48. fragment of a frame generally results in a timeout (and then only
  49. when the frame is not a multiple of 4 bytes long).
  50.  
  51. Finally on the second line, the software FIFO overruns and HWM
  52. are displayed.  These indicate whether the <bufsize> parameter on
  53. the 'attach' command needs to be adjusted.
  54.  
  55. The third line shows transmit (TX) statistics, including a total
  56. count of transmit interrupts, transmitted characters, the length
  57. of the transmit queue in bytes, the number of status interrupts,
  58. and the number of THRE timeouts.  The status interrupt count will
  59. be zero unless CTS flow control or RLSD line control has been
  60. enabled.  The THRE timeout is a stopgap measure to catch lost
  61. transmit interrupts, which seem to happen when there is a lot of
  62. activity (ideally, this will be zero).
  63.