home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / a_man / cat1 / strace.z / strace
Encoding:
Text File  |  1998-10-20  |  4.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ssssttttrrrraaaacccceeee((((1111MMMM))))                                                          ssssttttrrrraaaacccceeee((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _ssss_tttt_rrrr_aaaa_cccc_eeee - print STREAMS trace messages
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _ssss_tttt_rrrr_aaaa_cccc_eeee [ _m_i_d _s_i_d _l_e_v_e_l ] ...
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _ssss_tttt_rrrr_aaaa_cccc_eeee without arguments writes all STREAMS event trace messages from all
  16.      drivers and modules to its standard output.  These messages are obtained
  17.      from the STREAMS log driver (_llll_oooo_gggg(7)).  If arguments are provided they
  18.      must be in triplets of the form _m_i_d, _s_i_d, _l_e_v_e_l, where _m_i_d is a STREAMS
  19.      module ID number, _s_i_d is a sub-ID number, and _l_e_v_e_l is a tracing priority
  20.      level.  Each triplet indicates that tracing messages are to be received
  21.      from the given module/driver, sub-ID (usually indicating minor device),
  22.      and priority level equal to or less than the given level.  The token _aaaa_llll_llll
  23.      can be used for any member to indicate no restriction for that attribute.
  24.  
  25.      The format of each trace message output is:
  26.  
  27.           <_s_e_q> <_t_i_m_e> <_t_i_c_k_s> <_l_e_v_e_l> <_f_l_a_g_s> <_m_i_d> <_s_i_d> <_t_e_x_t>
  28.  
  29.  
  30.      <_s_e_q>     trace sequence number
  31.  
  32.      <_t_i_m_e>    time of message in _h_h:_m_m:_s_s
  33.  
  34.      <_t_i_c_k_s>   time of message in machine ticks since boot
  35.  
  36.      <_l_e_v_e_l>   tracing priority level
  37.  
  38.      <_f_l_a_g_s>   _EEEE : message is also in the error log
  39.                _FFFF : indicates a fatal error
  40.                _NNNN : mail was sent to the system administrator
  41.  
  42.      <_m_i_d>     module ID number of source
  43.  
  44.      <_s_i_d>     sub-ID number of source
  45.  
  46.      <_t_e_x_t>    formatted text of the trace message
  47.  
  48.      Once initiated, _ssss_tttt_rrrr_aaaa_cccc_eeee continues to execute until terminated by the user.
  49.  
  50. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  51.      Output all trace messages from the module or driver whose module ID is
  52.      41:
  53.  
  54.           _ssss_tttt_rrrr_aaaa_cccc_eeee  _4444_1111 _aaaa_llll_llll _aaaa_llll_llll
  55.  
  56.      Output those trace messages from driver/module ID 41 with sub-IDs 0, 1,
  57.      or 2:
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ssssttttrrrraaaacccceeee((((1111MMMM))))                                                          ssssttttrrrraaaacccceeee((((1111MMMM))))
  71.  
  72.  
  73.  
  74.           _ssss_tttt_rrrr_aaaa_cccc_eeee  _4444_1111 _0000 _1111  _4444_1111 _1111 _1111  _4444_1111 _2222 _0000
  75.  
  76.      Messages from sub-IDs 0 and 1 must have a tracing level less than or
  77.      equal to 1.  Those from sub-ID 2 must have a tracing level of 0.
  78.  
  79. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  80.      log(7).
  81.  
  82. NNNNOOOOTTTTEEEESSSS
  83.      Due to performance considerations, only one _ssss_tttt_rrrr_aaaa_cccc_eeee process is permitted
  84.      to open the STREAMS log driver at a time.  The log driver has a list of
  85.      the triplets specified in the command invocation, and compares each
  86.      potential trace message against this list to decide if it should be
  87.      formatted and sent up to the _ssss_tttt_rrrr_aaaa_cccc_eeee process.  Hence, long lists of
  88.      triplets have a greater impact on overall STREAMS performance.  Running
  89.      _ssss_tttt_rrrr_aaaa_cccc_eeee has the most impact on the timing of the modules and drivers
  90.      generating the trace messages that are sent to the _ssss_tttt_rrrr_aaaa_cccc_eeee process.  If
  91.      trace messages are generated faster than the _ssss_tttt_rrrr_aaaa_cccc_eeee process can handle
  92.      them, some of the messages will be lost.  This last case can be
  93.      determined by examining the sequence numbers on the trace messages
  94.      output.
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.