home *** CD-ROM | disk | FTP | other *** search
/ IRIS Development Option 6.2 / IRIS_Development_Option_6.2_814-0478-001.iso / dist / WorkShop.idb / usr / share / catman / u_man / cat1 / cvcov.z.z / cvcov.z / cvcov
Text File  |  1996-03-14  |  38KB  |  991 lines

  1.  
  2.  
  3.  
  4. CCCCVVVVCCCCOOOOVVVV((((1111))))                                                              CCCCVVVVCCCCOOOOVVVV((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      cvcov - The WorkShop Test Coverage Tool
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ccccvvvvccccoooovvvv ----vvvveeeerrrr | _s_u_b_c_o_m_m_a_n_d ...
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      ccccvvvvccccoooovvvv invokes the command line version of the WorkShop Tester dynamic
  16.      test coverage tool.  ccccvvvvxxxxccccoooovvvv invokes the GUI version of the same tool.
  17.      All functionality is available from either program.  Some of the
  18.      graphical representations of the data will be available only from ccccvvvvxxxxccccoooovvvv....
  19.  
  20.      For more information on using ccccvvvvccccoooovvvv please refer to the
  21.      "_C_A_S_E_V_i_s_i_o_n/_W_o_r_k_S_h_o_p _T_e_s_t_e_r _U_s_e_r'_s _G_u_i_d_e."
  22.  
  23.      For installation of ccccvvvvccccoooovvvv please refer to the "_W_o_r_k_S_h_o_p _T_e_s_t_e_r _R_e_l_e_a_s_e
  24.      _N_o_t_e_s."
  25.  
  26. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  27.      ----vvvveeeerrrr
  28.  
  29.           Print the program version to stdout.
  30.  
  31.      aaaaddddddddtttteeeesssstttt _t_e_s_t__n_a_m_e _t_e_s_t__s_e_t__n_a_m_e|_t_e_s_t__g_r_o_u_p__n_a_m_e
  32.  
  33.                Add the test or test set to the specified test set.
  34.  
  35.                _t_e_s_t__n_a_m_e
  36.  
  37.                Name of test or testset to add.
  38.  
  39.                _t_e_s_t__s_e_t__n_a_m_e|_t_e_s_t__g_r_o_u_p__n_a_m_e
  40.  
  41.                Name of testset or test group which is modified.
  42.  
  43.      ccccaaaatttttttteeeesssstttt [ ----rrrr ] _t_e_s_t__n_a_m_e
  44.  
  45.                Describe the test details for test_name.
  46.  
  47.                ----rrrr
  48.  
  49.                Recursively print out details of subtests of this test.  This
  50.                is useful if the test is a test set.
  51.  
  52.                _t_e_s_t__n_a_m_e
  53.  
  54.                Name of test to describe.
  55.  
  56.      ddddeeeelllltttteeeesssstttt _t_e_s_t__n_a_m_e _t_e_s_t__s_e_t__n_a_m_e|_t_e_s_t__g_r_o_u_p__n_a_m_e
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. CCCCVVVVCCCCOOOOVVVV((((1111))))                                                              CCCCVVVVCCCCOOOOVVVV((((1111))))
  71.  
  72.  
  73.  
  74.                Delete the test or test set from the specified test set.
  75.  
  76.                _t_e_s_t__n_a_m_e
  77.  
  78.                Name of test or testset to remove.
  79.  
  80.                _t_e_s_t__s_e_t__n_a_m_e|_t_e_s_t__g_r_o_u_p__n_a_m_e
  81.  
  82.                Name of testset or test group which is modified.
  83.  
  84.      ddddiiiiffffffff [ ----aaaarrrrgggg ] [ ----eeeexxxxeeee _e_x_e__n_a_m_e ] [ ----ffffuuuunnnnccccttttiiiioooonnnnssss ] [ ----pppprrrreeeettttttttyyyy ] [ ----ssssoooorrrrtttt
  85.      function|diff ] _e_x_p_e_r_i_m_e_n_t_1 _e_x_p_e_r_i_m_e_n_t_2
  86.  
  87.                List the differences in two test experiments.
  88.  
  89.                ----aaaarrrrgggg
  90.  
  91.                Show arguments for functions.
  92.  
  93.                ----eeeexxxxeeee _e_x_e__n_a_m_e
  94.  
  95.                Specify which executable is targeted for query.  If no
  96.                executable is specified, the main program is the default.
  97.  
  98.                ----ffffuuuunnnnccccttttiiiioooonnnnssss
  99.  
  100.                Show differences for functions along with summary.
  101.  
  102.                ----pppprrrreeeettttttttyyyy
  103.  
  104.                Column aligned output.
  105.  
  106.                ----ssssoooorrrrtttt function|diff
  107.  
  108.                function sorts alphabetically by function name.  diff sorts by
  109.                differences in the counting information for all types of
  110.                coverage (TBD).
  111.  
  112.                _e_x_p_e_r_i_m_e_n_t_1 and _e_x_p_e_r_i_m_e_n_t_2
  113.  
  114.                Specify the two test experiment directories to make the
  115.                comparison.
  116.  
  117.      hhhheeeellllpppp [ _c_o_m_m_a_n_d__n_a_m_e ]
  118.  
  119.                Print help on the specified command. If the optional command
  120.                name is not specified, it prints help for all the commands.
  121.  
  122.                _c_o_m_m_a_n_d__n_a_m_e
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. CCCCVVVVCCCCOOOOVVVV((((1111))))                                                              CCCCVVVVCCCCOOOOVVVV((((1111))))
  137.  
  138.  
  139.  
  140.                Name of command which requires help.
  141.  
  142.      llllssssaaaarrrrcccc [ ----aaaarrrrgggg ] [ ----ccccaaaalllllllleeeeeeee _c_a_l_l_e_e__p_a_t_t_e_r_n ] [ ----ccccaaaalllllllleeeerrrr _c_a_l_l_e_r__p_a_t_t_e_r_n ] [
  143.      ----ccccoooonnnnttttrrrriiiibbbb ] [ ----eeeexxxxeeee _e_x_e__n_a_m_e ] [ ----pppprrrreeeettttttttyyyy ] [ ----ssssoooorrrrtttt caller|callee|count ]
  144.      _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e
  145.  
  146.                List function arcs coverage. Arcs are calls from one function
  147.                to another.
  148.  
  149.                ----aaaarrrrgggg
  150.  
  151.                Show arguments for functions.
  152.  
  153.                ----ccccaaaalllllllleeeeeeee _c_a_l_l_e_e__p_a_t_t_e_r_n
  154.  
  155.                Show the arcs with callee_pattern as callee.  Note, function
  156.                patterns are of the form: [dso|executable]:{function|*}.  For
  157.                example, "/usr/lib/libc.so.1:*" refers to all functions in the
  158.                dynamically shared object for the C library.
  159.  
  160.                ----ccccaaaalllllllleeeerrrr _c_a_l_l_e_r__p_a_t_t_e_r_n
  161.  
  162.                Show the arcs with caller_pattern as caller.  See the previous
  163.                discussion of function patterns.
  164.  
  165.                ----ccccoooonnnnttttrrrriiiibbbb
  166.  
  167.                Show the list of tests that contributed to coverage for each
  168.                arc.
  169.  
  170.                ----eeeexxxxeeee _e_x_e__n_a_m_e
  171.  
  172.                Specify which executable is targeted for query.  If no
  173.                executable is specified, the main program is the default.
  174.  
  175.                ----pppprrrreeeettttttttyyyy
  176.  
  177.                Column aligned output.
  178.  
  179.                ----ssssoooorrrrtttt caller|callee|count
  180.  
  181.                Sort the output on caller, callee or arc count.
  182.  
  183.                _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e
  184.  
  185.                Specify the test experiment directory or test directory.  If
  186.                test_name is specified, the latest (newest) test experiment in
  187.                the test directory will be used.
  188.  
  189.      llllssssbbbblllloooocccckkkk [ ----aaaaddddddddrrrr ] [ ----aaaarrrrgggg ] [ ----ccccoooonnnnttttrrrriiiibbbb ] [ ----eeeexxxxeeee _e_x_e__n_a_m_e ] [ ----ppppaaaatttt
  190.      _f_u_n_c__p_a_t_t_e_r_n ] [ ----pppprrrreeeettttttttyyyy ] [ ----ssssoooorrrrtttt function|count|file ]
  191.      _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. CCCCVVVVCCCCOOOOVVVV((((1111))))                                                              CCCCVVVVCCCCOOOOVVVV((((1111))))
  203.  
  204.  
  205.  
  206.                List basic block count information in the function. Blocks are
  207.                shown as line number sequences.
  208.  
  209.                ----aaaaddddddddrrrr
  210.  
  211.                Show basic block by PC range instead of source line number
  212.                range.
  213.  
  214.                ----aaaarrrrgggg
  215.  
  216.                Show arguments for functions.
  217.  
  218.                ----ccccoooonnnnttttrrrriiiibbbb
  219.  
  220.                Show the list of tests that contributed to coverage for each
  221.                block.
  222.  
  223.                ----eeeexxxxeeee _e_x_e__n_a_m_e
  224.  
  225.                Specify which executable is targeted for query.  If no
  226.                executable is specified, the main program is the default.
  227.  
  228.                ----ppppaaaatttt _f_u_n_c__p_a_t_t_e_r_n
  229.  
  230.                Specify function name for coverage.  See the previous
  231.                discussion of function patterns.
  232.  
  233.                ----pppprrrreeeettttttttyyyy
  234.  
  235.                Column aligned output.
  236.  
  237.                ----ssssoooorrrrtttt function|count|file
  238.  
  239.                Sort the output on function name, count or file name.
  240.  
  241.                _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e
  242.  
  243.                Specify the test experiment directory or test directory.  If
  244.                test_name is specified, the latest (newest) test experiment in
  245.                the test directory will be used.
  246.  
  247.      llllssssbbbbrrrraaaannnncccchhhh [ ----aaaaddddddddrrrr ] [ ----aaaarrrrgggg ] [ ----eeeexxxxeeee _e_x_e__n_a_m_e ] [ ----ppppaaaatttt _f_u_n_c__p_a_t_t_e_r_n ] [
  248.      ----pppprrrreeeettttttttyyyy ] [ ----ssssoooorrrrtttt function|file ] _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e
  249.  
  250.                List count information for assembly language branch
  251.                instructions.
  252.  
  253.                ----aaaaddddddddrrrr
  254.  
  255.                Show branch by PC instead of source line number.
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. CCCCVVVVCCCCOOOOVVVV((((1111))))                                                              CCCCVVVVCCCCOOOOVVVV((((1111))))
  269.  
  270.  
  271.  
  272.                ----aaaarrrrgggg
  273.  
  274.                Show arguments for functions.
  275.  
  276.                ----eeeexxxxeeee _e_x_e__n_a_m_e
  277.  
  278.                Specify which executable is targeted for query.  If no
  279.                executable is specified, the main program is the default.
  280.  
  281.                ----ppppaaaatttt _f_u_n_c__p_a_t_t_e_r_n
  282.  
  283.                Specify function name for coverage.  See the previous
  284.                discussion of function patterns.
  285.  
  286.                ----pppprrrreeeettttttttyyyy
  287.  
  288.                Column aligned output.
  289.  
  290.                ----ssssoooorrrrtttt function|file
  291.  
  292.                Sort the output on function name or file name.
  293.  
  294.                _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e
  295.  
  296.                Specify the test experiment directory or test directory.  If
  297.                test_name is specified, the latest (newest) test experiment in
  298.                the test directory will be used.
  299.  
  300.      llllssssccccaaaallllllll [ ----aaaarrrrgggg ] [ ----eeeexxxxeeee _e_x_e__n_a_m_e ] [ ----nnnnooooddddeeee _f_u_n_c__n_a_m_e ] [ ----pppprrrreeeettttttttyyyy ] [ ----rrrr ]
  301.      _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e
  302.  
  303.                List function call graph.
  304.  
  305.                ----aaaarrrrgggg
  306.  
  307.                Show arguments for functions.
  308.  
  309.                ----eeeexxxxeeee _e_x_e__n_a_m_e
  310.  
  311.                Specify which executable is targeted for query.  If no
  312.                executable is specified, the main program is the default.
  313.  
  314.                ----nnnnooooddddeeee _f_u_n_c__n_a_m_e
  315.  
  316.                Show the call graph starting from func_name subnode
  317.                recursively.
  318.  
  319.                ----pppprrrreeeettttttttyyyy
  320.  
  321.                Column aligned output.
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. CCCCVVVVCCCCOOOOVVVV((((1111))))                                                              CCCCVVVVCCCCOOOOVVVV((((1111))))
  335.  
  336.  
  337.  
  338.                ----rrrr
  339.  
  340.                Show all the subnodes of the call graph recursively.
  341.  
  342.                _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e
  343.  
  344.                Specify the test experiment directory or test directory.  If
  345.                test_name is specified, the latest (newest) test experiment in
  346.                the test directory will be used.
  347.  
  348.      llllssssffffuuuunnnn [ ----aaaarrrrgggg ] [ ----bbbbffff _f_i_l_t_e_r__t_y_p_e _b_l_o_c_k__f_i_l_t_e_r__v_a_l_u_e ] [ ----bbbblllloooocccckkkkssss ] [
  349.      ----bbbbrrrraaaannnncccchhhheeeessss ] [ ----ccccoooonnnnttttrrrriiiibbbb ] [ ----eeeexxxxeeee _e_x_e__n_a_m_e ] [ ----ffffffff _f_i_l_t_e_r__t_y_p_e
  350.      _f_u_n_c__f_i_l_t_e_r__v_a_l_u_e ] [ ----ppppaaaatttt _p_a_t_t_e_r_n ] [ ----pppprrrreeeettttttttyyyy ] [ ----rrrrffff _f_i_l_t_e_r__t_y_p_e
  351.      _b_r_a_n_c_h__f_i_l_t_e_r__v_a_l_u_e ] [ ----ssssoooorrrrtttt function|count|file ] _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e
  352.  
  353.                List function coverage.
  354.  
  355.                ----aaaarrrrgggg
  356.  
  357.                Show arguments for functions.
  358.  
  359.                ----bbbbffff _f_i_l_t_e_r__t_y_p_e _b_l_o_c_k__f_i_l_t_e_r__v_a_l_u_e
  360.  
  361.                Filter for block where block_filter_value ranges between 0 and
  362.                1.  Filter type is same as function filter_type.
  363.  
  364.                For example, list the functions whose block coverage is less
  365.                than 25 percent:
  366.  
  367.                cvcov lsfun -bf "<" .25 test_name
  368.  
  369.                ----bbbblllloooocccckkkkssss
  370.  
  371.                Show block coverage for each function.
  372.  
  373.                ----bbbbrrrraaaannnncccchhhheeeessss
  374.  
  375.                Show branch coverage for each function.
  376.  
  377.                ----ccccoooonnnnttttrrrriiiibbbb
  378.  
  379.                Show the list of tests that contributed to coverage for each
  380.                function.
  381.  
  382.                ----eeeexxxxeeee _e_x_e__n_a_m_e
  383.  
  384.                Specify which executable is targeted for query.  If no
  385.                executable is specified, the main program is the default.
  386.  
  387.                ----ffffffff _f_i_l_t_e_r__t_y_p_e _f_u_n_c__f_i_l_t_e_r__v_a_l_u_e
  388.  
  389.  
  390.  
  391.  
  392.  
  393.                                                                         PPPPaaaaggggeeee 6666
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. CCCCVVVVCCCCOOOOVVVV((((1111))))                                                              CCCCVVVVCCCCOOOOVVVV((((1111))))
  401.  
  402.  
  403.  
  404.                Filter for function, where filter type is one of the following
  405.                "<","=", ">", "!=", "<=" and ">=".  func_filter_value is the
  406.                threshold value.
  407.  
  408.                For example, list only the functions whose count = 0 and sort
  409.                the output on function name:
  410.  
  411.                cvcov lsfun -ff "=" 0 -sort function test_name
  412.  
  413.                ----ppppaaaatttt _p_a_t_t_e_r_n
  414.  
  415.                Specify individual functions by pattern.  See the previous
  416.                discussion of function patterns.
  417.  
  418.                ----pppprrrreeeettttttttyyyy
  419.  
  420.                Column aligned output.
  421.  
  422.                ----rrrrffff _f_i_l_t_e_r__t_y_p_e _b_r_a_n_c_h__f_i_l_t_e_r__v_a_l_u_e
  423.  
  424.                Filter for branch coverage where branch_filter_value ranges
  425.                between 0 and 1.  Filter type is same as function filter_type.
  426.  
  427.                For example, list the functions whose branch coverage is
  428.                greater than 75 percent.
  429.  
  430.                cvcov lsfun -rf ">" .75 test_name
  431.  
  432.                ----ssssoooorrrrtttt function|count|file
  433.  
  434.                List the functions sorted on function name, count or file name.
  435.  
  436.                _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e
  437.  
  438.                Specify the test experiment directory or test directory.  If
  439.                test_name is specified, the latest (newest) test experiment in
  440.                the test directory will be used.
  441.  
  442.      llllssssiiiinnnnssssttttrrrr [ ----eeeexxxxeeee _e_x_e__n_a_m_e ] [ ----ffffuuuunnnnccccttttiiiioooonnnnssss ] [ ----vvvv _v_e_r_s_i_o_n_n_u_m_b_e_r ] _t_e_s_t__n_a_m_e
  443.  
  444.                Display the instrumentation information for a particular test.
  445.  
  446.                ----eeeexxxxeeee _e_x_e__n_a_m_e
  447.  
  448.                Specify which executable is targeted for query.  If no
  449.                executable is specified, the main program is the default.
  450.  
  451.                ----ffffuuuunnnnccccttttiiiioooonnnnssss
  452.  
  453.                Show the functions that are included in the coverage
  454.                experiment.
  455.  
  456.  
  457.  
  458.  
  459.                                                                         PPPPaaaaggggeeee 7777
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466. CCCCVVVVCCCCOOOOVVVV((((1111))))                                                              CCCCVVVVCCCCOOOOVVVV((((1111))))
  467.  
  468.  
  469.  
  470.                ----vvvv _v_e_r_s_i_o_n_n_u_m_b_e_r
  471.  
  472.                Specify the version of the program that was instrumented.
  473.  
  474.                tttteeeesssstttt____nnnnaaaammmmeeee
  475.  
  476.                Specify the test directory.
  477.  
  478.      llllsssslllliiiinnnneeee [ ----aaaarrrrgggg ] [ ----eeeexxxxeeee _e_x_e__n_a_m_e ] [ ----ppppaaaatttt _f_u_n_c__p_a_t_t_e_r_n ] [ ----pppprrrreeeettttttttyyyy ] [
  479.      ----ssssoooorrrrtttt _f_u_n_c_t_i_o_n|_f_i_l_e ] _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e
  480.  
  481.                List the coverage for native source lines.
  482.  
  483.                ----aaaarrrrgggg
  484.  
  485.                Show arguments for functions.
  486.  
  487.                ----eeeexxxxeeee _e_x_e__n_a_m_e
  488.  
  489.                Specify which executable is targeted for query.  If no
  490.                executable is specified, the main program is the default.
  491.  
  492.                ----ppppaaaatttt _f_u_n_c__p_a_t_t_e_r_n
  493.  
  494.                Specify function name for coverage.  See the previous
  495.                discussion of function patterns.
  496.  
  497.                ----pppprrrreeeettttttttyyyy
  498.  
  499.                Column aligned output.
  500.  
  501.                ----ssssoooorrrrtttt function|file
  502.  
  503.                Sort the output on either function or file name.
  504.  
  505.                _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e
  506.  
  507.                Specify the test experiment directory or test directory.  If
  508.                test_name is specified, the latest (newest) test experiment in
  509.                the test directory will be used.
  510.  
  511.      llllssssssssoooouuuurrrrcccceeee [ ----aaaassssmmmm ] [ ----eeeexxxxeeee _e_x_e__n_a_m_e ] _f_u_n_c_t_i_o_n _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e
  512.  
  513.                Display source for function with line count (block count)
  514.                information.  0 counted lines are highlighted.
  515.  
  516.                ----aaaassssmmmm
  517.  
  518.                Show assembly level source code.
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.                                                                         PPPPaaaaggggeeee 8888
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532. CCCCVVVVCCCCOOOOVVVV((((1111))))                                                              CCCCVVVVCCCCOOOOVVVV((((1111))))
  533.  
  534.  
  535.  
  536.                ----eeeexxxxeeee _e_x_e__n_a_m_e
  537.  
  538.                Specify which executable is targeted for query.  If no
  539.                executable is specified, the main program is the default.
  540.  
  541.                _f_u_n_c_t_i_o_n
  542.  
  543.                Specify the function name to be displayed.
  544.  
  545.                _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e
  546.  
  547.                Specify the test experiment directory or test directory.  If
  548.                test_name is specified, the latest (newest) test experiment in
  549.                the test directory will be used.
  550.  
  551.      llllssssssssuuuummmm [ ----eeeexxxxeeee _e_x_e__n_a_m_e ] [ ----wwwweeeeiiiigggghhhhtttt
  552.      _f_u_n_c__f_a_c_t_o_r:_l_i_n_e__f_a_c_t_o_r:_b_r_a_n_c_h__f_a_c_t_o_r:_a_r_c__f_a_c_t_o_r:_b_l_o_c_k__f_a_c_t_o_r ]
  553.      _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e
  554.  
  555.                List the summary of overall coverage for this run. Also list
  556.                the function, line, arc, branch, and block coverage.
  557.  
  558.                ----wwwweeeeiiiigggghhhhtttt
  559.                _f_u_n_c__f_a_c_t_o_r:_l_i_n_e__f_a_c_t_o_r:_b_r_a_n_c_h__f_a_c_t_o_r:_a_r_c__f_a_c_t_o_r:_b_l_o_c_k__f_a_c_t_o_r
  560.  
  561.                Specify the weight factors for calculating overall coverage
  562.                based on individual coverages for function, line, branch, arc,
  563.                and block.  The weights should add up to 1.
  564.  
  565.                _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e
  566.  
  567.                Specify the test experiment directory or test directory.  If
  568.                test_name is specified, the latest (newest) test experiment in
  569.                the test directory will be used.
  570.  
  571.      llllsssstttteeeesssstttt [ ----rrrr ] [_t_e_s_t__n_a_m_e ...]
  572.  
  573.                List the coverage tests.
  574.  
  575.                ----rrrr
  576.  
  577.                Recursively walk the directory and list all coverage tests.
  578.  
  579.                _t_e_s_t__n_a_m_e ...
  580.  
  581.                If testname or pattern is specified, list all tests which
  582.                match.  If no testname is specified, list all tests in the
  583.                current working directory.
  584.  
  585.      llllssssttttrrrraaaacccceeee [ ----eeeexxxxeeee _e_x_e__n_a_m_e ] [ ----ppppaaaatttt _f_u_n_c__n_a_m_e ] [ ----pppprrrreeeettttttttyyyy ] [ ----ssssoooorrrrtttt
  586.      function|type ] _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e
  587.  
  588.  
  589.  
  590.  
  591.                                                                         PPPPaaaaggggeeee 9999
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598. CCCCVVVVCCCCOOOOVVVV((((1111))))                                                              CCCCVVVVCCCCOOOOVVVV((((1111))))
  599.  
  600.  
  601.  
  602.                Trace function argument coverage.
  603.  
  604.                ----eeeexxxxeeee _e_x_e__n_a_m_e
  605.  
  606.                Specify which executable is targeted for query.  If no
  607.                executable is specified, the main program is the default.
  608.  
  609.                ----ppppaaaatttt _f_u_n_c__n_a_m_e
  610.  
  611.                Function name for argument tracing.  See the previous
  612.                discussion of function patterns.
  613.  
  614.                ----pppprrrreeeettttttttyyyy
  615.  
  616.                Column aligned output.
  617.  
  618.                ----ssssoooorrrrtttt function|type
  619.  
  620.                Sort the output on either function name or argument type.
  621.  
  622.                _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e
  623.  
  624.                Specify the test directory or test directory.  If test_name is
  625.                specified, the latest (newest) test experiment in the test
  626.                directory will be used.
  627.  
  628.      mmmmkkkktttteeeesssstttt ----ccccmmmmdddd '_c_m_d__l_i_n_e' [ ----ddddeeeessss '_d_e_s_c_r_i_p_t_i_o_n' ] [ ----iiiinnnnssssttttrrrr____ddddiiiirrrr _i_n_s_t_r__d_i_r ] [
  629.      ----tttteeeessssttttnnnnaaaammmmeeee _t_e_s_t ] [ _e_x_e_1 _e_x_e_2 ... ]
  630.  
  631.                Create a test directory which contains a Test Description File.
  632.  
  633.                ----ccccmmmmdddd '_c_m_d__l_i_n_e'
  634.  
  635.                Specify the program and command line options for the program to
  636.                be tested.  This includes any redirection for stdin, stderr, or
  637.                stdout as run from the Bourne shell.  The "cmd_line" is
  638.                mandatory, even if it only includes the program name.
  639.  
  640.                ----ddddeeeessss '_d_e_s_c_r_i_p_t_i_o_n'
  641.  
  642.                Specify the test description in single quotes.
  643.  
  644.                ----iiiinnnnssssttttrrrr____ddddiiiirrrr _i_n_s_t_r__d_i_r
  645.  
  646.                Specify the instrumentation directory.  If not specified,
  647.                mktest looks for the instrumentation directory in the current
  648.                working directory.
  649.  
  650.                ----tttteeeessssttttnnnnaaaammmmeeee _t_e_s_t
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.                                                                        PPPPaaaaggggeeee 11110000
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664. CCCCVVVVCCCCOOOOVVVV((((1111))))                                                              CCCCVVVVCCCCOOOOVVVV((((1111))))
  665.  
  666.  
  667.  
  668.                Specify the testname. If not specified, mktest creates a unique
  669.                name as well as the test directory.
  670.  
  671.                _e_x_e_1 _e_x_e_2 ...
  672.  
  673.                Specify the executables to be covered for this test.  This
  674.                handles programs that cause other programs to be run (e.g.,
  675.                fork/exec).  If no executable is specified, the main program is
  676.                the default.
  677.  
  678.      mmmmkkkkttttggggrrrroooouuuupppp [ ----ddddeeeessss '_d_e_s_c_r_i_p_t_i_o_n' ] [ ----lllliiiisssstttt _l_i_s_t__f_i_l_e ] [ ----tttteeeessssttttnnnnaaaammmmeeee _t_e_s_t ]
  679.      _t_a_r_g_e_t_1 _t_a_r_g_e_t_2 ...
  680.  
  681.                Create a test group which can contain other tests or test
  682.                groups.  A test group is a collection of programs which share
  683.                some libraries or dynamically shared objects in common. The
  684.                coverage is targeted for the shared libraries.
  685.  
  686.                ----ddddeeeessss '_d_e_s_c_r_i_p_t_i_o_n'
  687.  
  688.                Specify the test set description in single quotes.
  689.  
  690.                ----lllliiiisssstttt _l_i_s_t__f_i_l_e
  691.  
  692.                Specify the file containing a list of test names to be made
  693.                part of the test set. If no -list option is specified an empty
  694.                test set will be created.
  695.  
  696.                ----tttteeeessssttttnnnnaaaammmmeeee _t_e_s_t
  697.  
  698.                Specify the test set name. If not specified, mktset creates a
  699.                unique name as well as the test directory.
  700.  
  701.                _t_a_r_g_e_t_1 _t_a_r_g_e_t_2 ...
  702.  
  703.                Specify the target libraries or dynamically shared objects.
  704.  
  705.      mmmmkkkkttttsssseeeetttt [ ----ddddeeeessss '_d_e_s_c_r_i_p_t_i_o_n' ] [ ----lllliiiisssstttt _l_i_s_t__f_i_l_e ] [ ----tttteeeessssttttnnnnaaaammmmeeee _t_e_s_t ]
  706.  
  707.                Create a test set which can contain other tests or test sets as
  708.                subtests.  Specify the test set name, otherwise command will
  709.                automatically assign a test name for the test set.
  710.  
  711.                ----ddddeeeessss '_d_e_s_c_r_i_p_t_i_o_n'
  712.  
  713.                Specify the test set description in single quotes.
  714.  
  715.                ----lllliiiisssstttt _l_i_s_t__f_i_l_e
  716.  
  717.                Specify the file containing a list of test names to be made
  718.                part of the test set. If no -list option is specified an empty
  719.                test set will be created.
  720.  
  721.  
  722.  
  723.                                                                        PPPPaaaaggggeeee 11111111
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730. CCCCVVVVCCCCOOOOVVVV((((1111))))                                                              CCCCVVVVCCCCOOOOVVVV((((1111))))
  731.  
  732.  
  733.  
  734.                ----tttteeeessssttttnnnnaaaammmmeeee _t_e_s_t
  735.  
  736.                Specify the test set name. If not specified, mktset creates a
  737.                unique name as well as the test directory.
  738.  
  739.      ooooppppttttiiiimmmmiiiizzzzeeee [ ----bbbblllloooocccckkkkssss ] [ ----bbbbrrrraaaannnncccchhhheeeessss ] [ ----ccccbbbbbbbb _f_i_l_t_e_r__t_y_p_e _b_b__f_i_l_t_e_r__v_a_l_u_e ] [
  740.      ----ccccbbbbrrrr _f_i_l_t_e_r__t_y_p_e _b_r__f_i_l_t_e_r__v_a_l_u_e ] [ ----eeeexxxxeeee _e_x_e__n_a_m_e ] [ ----ppppaaaatttt _f_u_n_c__p_a_t_t_e_r_n
  741.      ] [ ----pppprrrreeeettttttttyyyy ] [ ----ssssttttaaaatttt ] _e_x_p_e_r_i_m_e_n_t ...|_t_e_s_t__n_a_m_e ...
  742.  
  743.                Choose the minimum set of tests that give the same coverage or
  744.                meet the given coverage criteria
  745.  
  746.                ----bbbblllloooocccckkkkssss
  747.  
  748.                Show block coverage for all the selected tests
  749.  
  750.                ----bbbbrrrraaaannnncccchhhheeeessss
  751.  
  752.                Show branch coverage for all the selected tests
  753.  
  754.                ----ccccbbbbbbbb _f_i_l_t_e_r__t_y_p_e _b_b__f_i_l_t_e_r__v_a_l_u_e
  755.  
  756.                Give the basic-block coverage criteria for test selection.  The
  757.                rules are the same as the option ----bbbbffff of llllssssffffuuuunnnn command.
  758.  
  759.                ----ccccbbbbrrrr _f_i_l_t_e_r__t_y_p_e _b_r__f_i_l_t_e_r__v_a_l_u_e
  760.  
  761.                Give the branch coverage criteria for test selection.  The
  762.                rules are the same as the option ----rrrrffff of llllssssffffuuuunnnn command.
  763.  
  764.                ----eeeexxxxeeee _e_x_e__n_a_m_e
  765.  
  766.                Specify which executable is targeted for test optimization.  If
  767.                no executable is specified, the main program is the default.
  768.  
  769.                ----ppppaaaatttt _p_a_t_t_e_r_n
  770.  
  771.                Specify DSO patterns for calculation of coverage on test
  772.                selection.  See the previous discussion of function patterns.
  773.  
  774.                ----pppprrrreeeettttttttyyyy
  775.  
  776.                Column aligned output.
  777.  
  778.                ----ssssttttaaaatttt
  779.  
  780.                Print out block and branch coverage for all the selected tests.
  781.                Without this option, cumulative coverages for block and branch
  782.                are given.
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.                                                                        PPPPaaaaggggeeee 11112222
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796. CCCCVVVVCCCCOOOOVVVV((((1111))))                                                              CCCCVVVVCCCCOOOOVVVV((((1111))))
  797.  
  798.  
  799.  
  800.                _e_x_p_e_r_i_m_e_n_t ...|_t_e_s_t__n_a_m_e ...
  801.  
  802.                names of experiments or tests to optimize
  803.  
  804.      rrrrmmmmtttteeeesssstttt [ ----rrrr ] _t_e_s_t__n_a_m_e
  805.  
  806.                Remove the test with the test_name specified.
  807.  
  808.                ----rrrr
  809.  
  810.                Recursively remove all the subtests of the test testname. This
  811.                is useful for removing all the subtests of a test set.
  812.  
  813.                _t_e_s_t__n_a_m_e
  814.  
  815.                Name of test to remove.
  816.  
  817.      rrrruuuunnnniiiinnnnssssttttrrrr [ ----iiiinnnnssssttttrrrr____ddddiiiirrrr _i_n_s_t_r__d_i_r ] [ ----iiiinnnnssssttttrrrr____ffffiiiilllleeee _i_n_s_t_r__f_i_l_e ] [ ----vvvv
  818.      _v_e_r_s_i_o_n_n_u_m_b_e_r ] _e_x_e_c_u_t_a_b_l_e
  819.  
  820.                Instrument the user <executable> based on the user selectable
  821.                criteria.  The instrument file is an ASCII description of the
  822.                instrumentation criteria for the experiment. A complete
  823.                description of the instrument file can be found in the
  824.                "_W_o_r_k_S_h_o_p/_T_e_s_t_e_r _U_s_e_r'_s _G_u_i_d_e".
  825.  
  826.                ----iiiinnnnssssttttrrrr____ddddiiiirrrr _i_n_s_t_r__d_i_r
  827.  
  828.                Specify the instrumentation directory.
  829.  
  830.                ----iiiinnnnssssttttrrrr____ffffiiiilllleeee _i_n_s_t_r__f_i_l_e
  831.  
  832.                Specify the instrument file to be used to instrument
  833.                <executable>.
  834.  
  835.                ----vvvv _v_e_r_s_i_o_n_n_u_m_b_e_r
  836.  
  837.                Specify the version of the program to be instrumented.
  838.  
  839.                _e_x_e_c_u_t_a_b_l_e
  840.  
  841.                Name of program that is being instrumented.
  842.  
  843.      rrrruuuunnnntttteeeesssstttt [ ----bbbbiiiittttccccoooouuuunnnntttt ] [ ----ccccoooommmmpppprrrreeeessssssss ] [ ----ffffoooorrrrcccceeee ] [ ----kkkkeeeeeeeepppp ] [ ----nnnnooooaaaarrrrcccc ] [
  844.      ----rrrrmmmmssssuuuubbbb ] [ ----ssssuuuummmm ] [ ----vvvv _v_e_r_s_i_o_n_n_u_m_b_e_r ] _t_e_s_t__n_a_m_e
  845.  
  846.                Run a test or a test set.
  847.  
  848.                ----bbbbiiiittttccccoooouuuunnnntttt
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.                                                                        PPPPaaaaggggeeee 11113333
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862. CCCCVVVVCCCCOOOOVVVV((((1111))))                                                              CCCCVVVVCCCCOOOOVVVV((((1111))))
  863.  
  864.  
  865.  
  866.                Compress count data file to be 1-bit-per-count. This option
  867.                will decrease the data base size up to 32 times, but branch
  868.                count information will be lost.
  869.  
  870.                ----ccccoooommmmpppprrrreeeessssssss
  871.  
  872.                Compress experiment database using standard utility ccccoooommmmpppprrrreeeessssssss....
  873.  
  874.                ----ffffoooorrrrcccceeee
  875.  
  876.                Force the test to be run again even if a test experiment is
  877.                present.
  878.  
  879.                ----kkkkeeeeeeeepppp
  880.  
  881.                Retain all performance data collected in the experiment.  By
  882.                default, the performance data is not retained, because it is
  883.                not required by the coverage tool.
  884.  
  885.                ----nnnnooooaaaarrrrcccc
  886.  
  887.                Do not capture arc information in the runtest experiment.  The
  888.                arc data can potentially use of large amounts of disk space.
  889.  
  890.                ----rrrrmmmmssssuuuubbbb
  891.  
  892.                Remove results for individual subtests if this is a test set or
  893.                test group.  The overall test set or test group data is
  894.                retained.
  895.  
  896.                ----ssssuuuummmm
  897.  
  898.                Accumulate (sum over) the coverage data into the existing
  899.                experiment results.  This allows users to run and re-run the
  900.                same test and accumulate the results in one place.
  901.  
  902.                ----vvvv _v_e_r_s_i_o_n_n_u_m_b_e_r
  903.  
  904.                Specify the version of the program to be run.  If not
  905.                specified, runtest assumes the latest version of the program.
  906.  
  907.                _t_e_s_t__n_a_m_e
  908.  
  909.                Name of test to run.
  910.  
  911. FFFFIIIILLLLEEEESSSS
  912.      ////uuuussssrrrr////lllliiiibbbb////XXXX11111111////aaaapppppppp----ddddeeeeffffaaaauuuullllttttssss////CCCCvvvvxxxxccccoooovvvv
  913.      Application defaults for GUI program, cvxcov.
  914.      ////uuuussssrrrr////TTTTeeeesssstttteeeerrrr////ddddeeeeffffaaaauuuulllltttt____iiiinnnnssssttttrrrr____ffffiiiilllleeee
  915.      Default instrument file.
  916.  
  917.  
  918.  
  919.  
  920.  
  921.                                                                        PPPPaaaaggggeeee 11114444
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928. CCCCVVVVCCCCOOOOVVVV((((1111))))                                                              CCCCVVVVCCCCOOOOVVVV((((1111))))
  929.  
  930.  
  931.  
  932. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  933.      cvxcov(1), cvd(1), cvinstr(1), cvperf(1), cvxhang(1)
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.                                                                        PPPPaaaaggggeeee 11115555
  988.  
  989.  
  990.  
  991.