home *** CD-ROM | disk | FTP | other *** search
/ The Hacker's Encyclopedia 1998 / hackers_encyclopedia.iso / hacking / systems / dts.txt < prev    next >
Encoding:
Text File  |  2003-06-11  |  14.1 KB  |  574 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                DTS/DTR TEST PROGRAMS
  17.  
  18.  
  19.  
  20. dts and dtr  are  the  DECnet-DOS  transmitter  and    receiver  test
  21. programs.
  22.  
  23.  
  24.  
  25. 1.  Types Of Tests
  26.  
  27. There are four basic tests provided by dts and dtr:
  28.  
  29.       o  Connect test
  30.  
  31.       o  Data test
  32.  
  33.       o  Disconnect test
  34.  
  35.       o  Interrupt test
  36.  
  37. Each test is divided into a set of subtests.  The tests  and  subtests
  38. are described in the following sections.
  39.  
  40. 1.1  Connect Tests
  41.  
  42. Connect tests verify the ability of the network  software  to  process
  43. connect,  connect accept, and connect reject requests with and without
  44. optional user data.  Connect tests that the user can perform are:
  45.  
  46.       o  Connect reject without user data
  47.  
  48.       o  Connect accept without user data
  49.  
  50.       o  Connect reject with 16 bytes of standard user data
  51.  
  52.  
  53.  
  54.  
  55.  
  56.                  1
  57.  
  58.       o  Connect accept with 16 bytes of standard user data
  59.  
  60.       o  Connect reject with received user data used  as  reject  user
  61.          data
  62.  
  63.       o  Connect accept with received user data used  as  accept  user
  64.          data
  65.  
  66.  
  67. 1.2  Data Tests
  68.  
  69. Data tests provide a full range of test  capabilities  from  the  very
  70. simple  data  sink  operation  through  data integrity checking.  Data
  71. tests the user can perform are:
  72.  
  73.       o  Sink test.  dtr ignores all data received.   No  sequence  or
  74.          content validation is performed.
  75.  
  76.       o  Sequence test.  Data  messages  transmitted  by  dts  to  dtr
  77.          include  a  4-byte sequence number.  If a message is received
  78.      out of sequence, dtr aborts the logical link and the test.
  79.  
  80.       o  Pattern test.    Data messages transmitted to dtr have  both  a
  81.          sequence  number  and a standard data pattern.  If either the
  82.          sequence number or the  received  data  does  not  match  the
  83.      expected data, dtr aborts the logical link and the test.
  84.  
  85.       o  Echo test.  Data messages received  by  dtr  are  transmitted
  86.      back  to dts.    There is sequence and data validity checking
  87.      done by dts but not by dtr.
  88.  
  89.  
  90. 1.3  Disconnect Tests
  91.  
  92. Disconnect tests are designed to determine whether dts can detect  the
  93. difference  between disconnect and abort sequences generated by dtr as
  94. well as receive the proper optional user data.  Disconnect tests  that
  95. can be performed by the user are:
  96.  
  97.       o  Disconnect without data
  98.  
  99.       o  Abort without user data
  100.  
  101.       o  Disconnect with 16 bytes of standard user data
  102.  
  103.       o  Abort with 16 bytes of standard user data
  104.  
  105.       o  Disconnect with received connect user data used as disconnect
  106.          user data
  107.  
  108.  
  109.  
  110.  
  111.  
  112.                  2
  113.  
  114.       o  Abort with received connect user data used as abort user data
  115.  
  116.  
  117. 1.4  Interrupt Tests
  118.  
  119. Interrupt tests provide a full range of test  capabilities  from  very
  120. simple   data   sink   operations  through  data  integrity  checking.
  121. Interrupt tests that the user can perform are:
  122.  
  123.       o  Sink test.  dtr ignores  all  interrupt  data    received.   No
  124.          sequence or content validation is performed.
  125.  
  126.       o  Sequence test.  Interrupt messages transmitted by dts to  dtr
  127.          contain  a  4-byte sequence number.  If a message is received
  128.      out of sequence, dtr aborts the logical link and the test.
  129.  
  130.       o  Pattern test.    Interrupt messages  transmitted  to  dtr  have
  131.          both  a  sequence  number  and  a  standard data pattern.  If
  132.          either the  sequence  number  or  the  data  pattern  is  not
  133.      received  with the expected data, dtr aborts the logical link
  134.          and the test.
  135.  
  136.       o  Echo  test.   Interrupt  messages   received    by   dtr   are
  137.      transmitted  back  to    dts.   There  is  sequence and data
  138.      validity checking done by dts but not by dtr.
  139.  
  140.  
  141.  
  142.  
  143. 2.  Operational Characteristics
  144.  
  145. dtr functions as a slave to dts and must be installed  at  the    remote
  146. node.    dts  initiates    each test by issuing a connect request to dtr.
  147. Parameter information pertinent to  the  type  of  test  requested  is
  148. passed by dts to dtr in the optional data of the connect request.  The
  149. dts user interface enables the user to issue commands with options  to
  150. customize  the  test  to  be  performed.   Parameters are available to
  151. regulate test duration, buffer level, and the type of data used.
  152.  
  153. The dts command syntax allows for two types of buffer  level  options:
  154. squeue    and  rqueue.  The squeue option is used by dts only and rqueue
  155. is used by dtr only.  The  squeue  parameter  specifies  the  transmit
  156. buffer    level  for dts.  This level is the number of transmit requests
  157. that dts attempts to keep outstanding to the network during the  test.
  158. In  an    echo  test,  the  squeue  parameter also specifies the receive
  159. buffering level for dts.  The rqueue parameter specifies  the  receive
  160. buffer level for dtr.
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.                  3
  169.  
  170. 3.  Running dts/dtr
  171.  
  172. Be sure that the line is in the on state.  Then  enter    the  following
  173. command:
  174.  
  175. % dts<RET>
  176.  
  177. The system will respond with the following message and prompt:
  178.  
  179. DTS Version n.n.n initiated on day month date hh:mm:ss year
  180.  
  181. DTS>
  182.  
  183. You can now begin to enter commands to    dts  (see  command  format  in
  184. Section 4.).  When you wish to end testing, type exit in response to
  185. the dts prompt.  dts will print a termination message on  your    screen
  186. when it exits and your DOS prompt will reappear.
  187.  
  188.  
  189.  
  190. 4.  dts Command Syntax
  191.  
  192. The basic syntax for dts commands is shown below (refer to the Preface
  193. to  review  graphic  conventions  used  in command descriptions).  The
  194. default values for a qualifier remain  in  effect  until  a  different
  195. value  is specified.  The specified value then becomes the new default
  196. for all following tests until that value is changed.
  197.  
  198.  
  199. SYNTAX
  200.  
  201.    DTS>test[qualifiers][test-specific-qualifiers]
  202.  
  203.    where
  204.  
  205.    test         Specifies the type of test, where test must be one
  206.                     of the following:
  207.  
  208.             connect          Connect test
  209.             disconnect          Disconnect test
  210.             data          Data test
  211.             interrupt          Interrupt test
  212.  
  213.    qualifiers        Specifies any number  of  the  following  optional
  214.                     qualifiers.    Once  specified,  these  qualifiers
  215.                     remain in effect for all  applicable  tests  until
  216.             you  change them or exit from dts.    Each qualifier
  217.                     must be preceded by a slash (/).
  218.  
  219.             /nodename=node-id Identifies the node (by name or
  220.                       address) on which dtr is to run
  221.                       (default = "REMOTE").  dtr
  222.  
  223.  
  224.                  4
  225.  
  226.                       must run on a remote node's
  227.                                       default nonprivileged account
  228.                                       because you cannot specify
  229.                                       access control information with
  230.                                       this qualifier.
  231.  
  232.             /print or          Tells dts whether or not to
  233.             /noprint          print (log) test results.
  234.                     (default)
  235.  
  236.             /nostatistics or  Tells dts whether or not to
  237.             /statistics       print statistics on data and
  238.                     (default)         interrupt tests.
  239.  
  240.             /display or       Tells dts whether or not to
  241.             /nodisplay          print the data and interrupt
  242.             (default)          messages transmitted to dtr.
  243.  
  244.             /speed=number     Specifies the test line speed in
  245.                                       bits per second (default = 0).
  246.                       dts uses this data for reporting
  247.                                       statistics.
  248.  
  249.    test-specific-   Specifies any number of test-specific qualifiers,
  250.    qualifiers        as     defined   in     the    following    sections.
  251.                     Test-specific qualifiers apply to the current test
  252.                     only.
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.                  5
  281.  
  282. 4.1  Connect Test
  283.  
  284. SYNTAX
  285.  
  286.    connect[qualifiers][test-specific-qualifiers]
  287.  
  288.    where test-specific-qualifiers can be any of the following:
  289.  
  290.    /type=subtest    Specifies the type of test, where subtest can be:
  291.  
  292.             accept     Connect accept test (default)
  293.             reject     Connect reject test
  294.  
  295.    /return=type or  Specifies the type of data returned by dtr, where
  296.    /noreturn        type can be:
  297.    (default)        
  298.             standard     Standard user data
  299.             received     Received user data
  300.  
  301.             /noreturn causes  no  optional  user  data    to  be
  302.                     returned.
  303.  
  304. EXAMPLE:
  305.  
  306.    DTS>connect/nodename=pete/return=received
  307.  
  308.    This command invokes a connect accept test (by default) with remote
  309.    node  Pete.     dtr  is  to  return received user data as part of the
  310.    test.
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.                  6
  337.  
  338. 4.2  Disconnect Test
  339.  
  340. SYNTAX
  341.  
  342.    disconnect[qualifiers][test-specific-qualifiers]
  343.  
  344.    where test-specific-qualifiers can be any of the following:
  345.  
  346.    /type=subtest    Specifies the type of test, where subtest can be:
  347.  
  348.             synchronous  Synchronous disconnect test
  349.             abort     Disconnect abort test (default)
  350.  
  351.    /return=type or  Specifies the type of data returned by dtr, where
  352.    /noreturn        type can be:
  353.    (default)        
  354.             standard     Standard user data
  355.             received     Received user data
  356.  
  357.             /noreturn causes  no  optional  user  data    to  be
  358.                     returned.
  359.  
  360. EXAMPLE:
  361.  
  362.    DTS>disconnect/nodename=paris/type=synchronous
  363.  
  364.    This command invokes a synchronous disconnect test with remote node
  365.    Paris.  dtr will not return any optional user data.
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.                  7
  393.  
  394. 4.3  Data Test
  395.  
  396. SYNTAX
  397.  
  398.    data[qualifiers][test-specific-qualifiers]
  399.  
  400.    where test-specific-qualifiers can be any of the following:
  401.  
  402.    /type=subtest    Specifies the type of test, where subtest can be:
  403.  
  404.             sink     Sink test (default)
  405.             seq      Sequence test
  406.             pat      Pattern test
  407.             echo     Echo test
  408.  
  409.    /size=number     Specifies data  message  length  in  bytes,  where
  410.             number  is    a  value  in  the  range  of n to 2048
  411.             (default = 128).  n is 0 for sink and echo    tests,
  412.                     4 for a sequence test, and 5 for a pattern test.
  413.  
  414.    /test-duration   Specifies duration of  the    test  in  one  of  the
  415.                     following formats:
  416.  
  417.             /seconds=number (range: 1 to 60)
  418.             /minutes=number (range: 1 to 60)
  419.             /hours=number (range: 1 to 24)
  420.  
  421.             The default is /seconds=15.
  422.  
  423.    /flow=type or    Specifies type of flow control (if any), where
  424.    /noflow        type can be:
  425.    (default)
  426.             segment     Segment flow control
  427.             message     Message flow control
  428.                  (default -- if /flow is specified)
  429.  
  430.             If dtr is running on DECnet-DOS,  it  must  use
  431.                     the system default.
  432.  
  433.    /rqueue=number   Specifies number of pending receives  for  dtr  to
  434.             maintain,  where  number is a value in the range 1
  435.             (default)  to  16.      If   dtr   is   running   on
  436.                     DECnet-DOS, it must use the system default.
  437.  
  438.    /squeue=number   Specifies number of pending transmissions for  dts
  439.             to    maintain, where number is a value in the range
  440.             1  (default)  to  16.   If    dts  is   running   on
  441.                     DECnet-DOS, it must use the system default.
  442.  
  443.    /nak=number or   Specifies the number of segments between NAKs.  If
  444.    /nonak (default) dtr is running on DECnet-DOS, it must  use  the
  445.                     system default.
  446.  
  447.  
  448.                  8
  449.  
  450.    /back=number or  Specifies the number of segments before back
  451.    /noback        pressuring.  If dtr is running on DECnet-DOS,
  452.    (default)        it must use the system default.
  453.  
  454. EXAMPLE:
  455.  
  456.    DTS>data/size=512/seconds=30
  457.     DTS --I-- Test started at 11:23:30
  458.     DTS --I-- Test finished at 11:24:00
  459.  
  460.    Test parameters:
  461.      Target node name      "jones"
  462.      Test duration (sec)  30
  463.      Message size (bytes) 512
  464.  
  465.    Summary statistics:
  466.      Total messages SENT  48
  467.      Total bytes SENT      24576
  468.      Messages per second  1.60
  469.      Bytes per second      819.20
  470.      Line thruput (baud)  6553
  471.  
  472.    This command invokes the  data  test  with  the  sink  subtest  (by
  473.    default).  dts sends messages to dtr on node Jones (by default from
  474.    a previous command).   The  message  size  is  512  bytes  and  the
  475.    duration of the test is 30 seconds.
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.                  9
  505.  
  506. 4.4  Interrupt Test
  507.  
  508. SYNTAX
  509.  
  510.    interrupt[qualifiers][test-specific-qualifiers]
  511.  
  512.    where test-specific-qualifiers can be any of the following:
  513.  
  514.    /type=subtest    Specifies the type of test, where subtest can be:
  515.  
  516.             sink     Sink test (default)
  517.             seq      Sequence test
  518.             pat      Pattern test
  519.             echo     Echo test
  520.  
  521.    /size=number     Specifies data  message  length  in  bytes,  where
  522.             number  is    a  value  in  the  range  of  n  to 16
  523.             (default).    n is 0 for sink and echo tests, 4  for
  524.                     a sequence test, and 5 for a pattern test.
  525.  
  526.    /test-duration   Specifies duration of  the    test  in  one  of  the
  527.                     following formats:
  528.  
  529.             /seconds=number (range: 1 to 60)
  530.             /minutes=number (range: 1 to 60)
  531.             /hours=number (range: 1 to 24)
  532.  
  533.             The default is /seconds=15.
  534.  
  535.    /rqueue=number   Specifies number of pending receives  for  dtr  to
  536.             maintain,  where  number is a value in the range 1
  537.             (default)  to  16.      If   dtr   is   running   on
  538.                     DECnet-DOS, it must use the system default.
  539.  
  540.    /squeue=number   Specifies number of pending transmissions for  dts
  541.             to    maintain, where number is a value in the range
  542.             1  (default)  to  16.   If    dts  is   running   on
  543.                     DECnet-DOS, it must use the system default.
  544.  
  545. EXAMPLE:
  546.  
  547.    DTS>interrupt/nodename=dallas/print/type=pat/test=30
  548.  
  549.     DTS --I-- Test started at 17::44::10
  550.     DTS --I-- Test finished at 17::44::40
  551.  
  552.    Test parameters:
  553.      Target node name      "dallas"
  554.      Test duration (sec)  30
  555.      Message size (bytes) 16
  556.  
  557.  
  558.  
  559.  
  560.  
  561.                  10
  562.  
  563. Summary statistics:
  564.      Total messages SENT  2734
  565.      Total bytes SENT      43744
  566.      Messages per second  91.1
  567.      Bytes per second      1458
  568.      Line thruput (baud)  11665
  569.  
  570.    This command invokes the interrupt test with the  pattern  subtest.
  571.    dts    sends  interrupt  messages  to    dtr  on node Dallas where test
  572.    information is to be printed.  The default is used for message size
  573.    and the duration of the test is 30 seconds.
  574.