xref: /netbsd-src/external/cddl/dtracetoolkit/dist/Docs/Examples/py_calltime_example.txt (revision c29d51755812ace2e87aeefdb06cb2b4dac7087a)
1The following are examples of py_calltime.d.
2
3This script traces the elapsed time of Python functions and prints a report.
4Here it traces the example program, Code/Python/func_abc.py
5
6# py_calltime.d
7Tracing... Hit Ctrl-C to end.
8^C
9
10Count,
11   FILE                 TYPE       NAME                                COUNT
12   UserDict.py          func       ?                                       1
13   UserDict.py          func       DictMixin                               1
14   UserDict.py          func       IterableUserDict                        1
15   UserDict.py          func       UserDict                                1
16   UserDict.py          func       __init__                                1
17   __init__.py          func       ?                                       1
18   __init__.py          func       CodecRegistryError                      1
19   __init__.py          func       normalize_encoding                      1
20   __init__.py          func       search_function                         1
21   aliases.py           func       ?                                       1
22   ascii.py             func       ?                                       1
23   ascii.py             func       Codec                                   1
24   ascii.py             func       StreamConverter                         1
25   ascii.py             func       StreamReader                            1
26   ascii.py             func       StreamWriter                            1
27   ascii.py             func       getregentry                             1
28   codecs.py            func       ?                                       1
29   codecs.py            func       Codec                                   1
30   codecs.py            func       StreamReader                            1
31   codecs.py            func       StreamReaderWriter                      1
32   codecs.py            func       StreamRecoder                           1
33   codecs.py            func       StreamWriter                            1
34   copy_reg.py          func       ?                                       1
35   func_abc.py          func       ?                                       1
36   func_abc.py          func       func_a                                  1
37   func_abc.py          func       func_b                                  1
38   func_abc.py          func       func_c                                  1
39   linecache.py         func       ?                                       1
40   os.py                func       ?                                       1
41   os.py                func       _Environ                                1
42   os.py                func       __init__                                1
43   os.py                func       _get_exports_list                       1
44   posixpath.py         func       ?                                       1
45   posixpath.py         func       basename                                1
46   posixpath.py         func       dirname                                 1
47   site.py              func       ?                                       1
48   site.py              func       _Helper                                 1
49   site.py              func       _Printer                                1
50   site.py              func       _init_pathinfo                          1
51   site.py              func       abs__file__                             1
52   site.py              func       addsitepackages                         1
53   site.py              func       aliasmbcs                               1
54   site.py              func       execsitecustomize                       1
55   site.py              func       main                                    1
56   site.py              func       removeduppaths                          1
57   site.py              func       setcopyright                            1
58   site.py              func       setencoding                             1
59   site.py              func       sethelper                               1
60   site.py              func       setquit                                 1
61   stat.py              func       ?                                       1
62   types.py             func       ?                                       1
63   types.py             func       _C                                      1
64   warnings.py          func       ?                                       1
65   warnings.py          func       _OptionError                            1
66   warnings.py          func       _processoptions                         1
67   posixpath.py         func       exists                                  2
68   posixpath.py         func       split                                   2
69   site.py              func       addsitedir                              2
70   warnings.py          func       simplefilter                            2
71   copy_reg.py          func       constructor                             3
72   copy_reg.py          func       pickle                                  3
73   site.py              func       __init__                                3
74   site.py              func       addpackage                              3
75   stat.py              func       S_IFMT                                  6
76   stat.py              func       S_ISDIR                                 6
77   posixpath.py         func       isdir                                   8
78   os.py                func       _exists                                10
79   <string>             func       ?                                      11
80   posixpath.py         func       normcase                               14
81   site.py              func       makepath                               14
82   posixpath.py         func       join                                   20
83   posixpath.py         func       abspath                                22
84   posixpath.py         func       isabs                                  22
85   posixpath.py         func       normpath                               22
86   -                    total      -                                     230
87
88Exclusive function elapsed times (us),
89   FILE                 TYPE       NAME                                TOTAL
90   ascii.py             func       StreamWriter                            2
91   ascii.py             func       StreamReader                            2
92   site.py              func       setencoding                             2
93   UserDict.py          func       IterableUserDict                        2
94   __init__.py          func       CodecRegistryError                      2
95   ascii.py             func       getregentry                             2
96   site.py              func       aliasmbcs                               2
97   warnings.py          func       _OptionError                            3
98   types.py             func       _C                                      3
99   site.py              func       sethelper                               3
100   warnings.py          func       _processoptions                         3
101   ascii.py             func       StreamConverter                         3
102   ascii.py             func       Codec                                   3
103   site.py              func       _Helper                                 3
104   site.py              func       setquit                                 4
105   codecs.py            func       StreamWriter                            4
106   UserDict.py          func       __init__                                4
107   site.py              func       _Printer                                4
108   codecs.py            func       Codec                                   4
109   os.py                func       _Environ                                4
110   codecs.py            func       StreamRecoder                           5
111   codecs.py            func       StreamReaderWriter                      6
112   codecs.py            func       StreamReader                            6
113   copy_reg.py          func       constructor                             7
114   __init__.py          func       normalize_encoding                      9
115   site.py              func       __init__                               10
116   warnings.py          func       simplefilter                           11
117   linecache.py         func       ?                                      11
118   posixpath.py         func       split                                  13
119   stat.py              func       ?                                      14
120   stat.py              func       S_IFMT                                 14
121   posixpath.py         func       dirname                                16
122   posixpath.py         func       basename                               24
123   os.py                func       __init__                               26
124   posixpath.py         func       normcase                               29
125   UserDict.py          func       UserDict                               32
126   posixpath.py         func       exists                                 37
127   aliases.py           func       ?                                      46
128   <string>             func       ?                                      56
129   copy_reg.py          func       pickle                                 59
130   UserDict.py          func       ?                                      84
131   site.py              func       addsitepackages                        85
132   posixpath.py         func       isabs                                  87
133   site.py              func       setcopyright                           94
134   stat.py              func       S_ISDIR                                98
135   posixpath.py         func       join                                  105
136   types.py             func       ?                                     106
137   site.py              func       removeduppaths                        115
138   ascii.py             func       ?                                     122
139   os.py                func       _get_exports_list                     136
140   site.py              func       _init_pathinfo                        155
141   site.py              func       abs__file__                           158
142   codecs.py            func       ?                                     182
143   UserDict.py          func       DictMixin                             184
144   __init__.py          func       search_function                       205
145   site.py              func       main                                  218
146   posixpath.py         func       normpath                              231
147   copy_reg.py          func       ?                                     239
148   posixpath.py         func       isdir                                 285
149   site.py              func       addpackage                            419
150   site.py              func       addsitedir                            473
151   warnings.py          func       ?                                     500
152   posixpath.py         func       ?                                     546
153   site.py              func       execsitecustomize                     558
154   site.py              func       makepath                              608
155   posixpath.py         func       abspath                               646
156   os.py                func       _exists                               925
157   __init__.py          func       ?                                    1289
158   os.py                func       ?                                    1473
159   site.py              func       ?                                    1510
160   func_abc.py          func       ?                                    1517
161   func_abc.py          func       func_c                            1000071
162   func_abc.py          func       func_a                            1005706
163   func_abc.py          func       func_b                            1010158
164   -                    total      -                                 3029815
165
166Inclusive function elapsed times (us),
167   FILE                 TYPE       NAME                                TOTAL
168   ascii.py             func       StreamWriter                            2
169   ascii.py             func       StreamReader                            2
170   site.py              func       setencoding                             2
171   UserDict.py          func       IterableUserDict                        2
172   __init__.py          func       CodecRegistryError                      2
173   ascii.py             func       getregentry                             2
174   site.py              func       aliasmbcs                               2
175   warnings.py          func       _OptionError                            3
176   types.py             func       _C                                      3
177   site.py              func       sethelper                               3
178   warnings.py          func       _processoptions                         3
179   ascii.py             func       StreamConverter                         3
180   ascii.py             func       Codec                                   3
181   site.py              func       _Helper                                 3
182   site.py              func       setquit                                 4
183   codecs.py            func       StreamWriter                            4
184   UserDict.py          func       __init__                                4
185   site.py              func       _Printer                                4
186   codecs.py            func       Codec                                   4
187   os.py                func       _Environ                                4
188   codecs.py            func       StreamRecoder                           5
189   codecs.py            func       StreamReaderWriter                      6
190   codecs.py            func       StreamReader                            6
191   copy_reg.py          func       constructor                             7
192   __init__.py          func       normalize_encoding                      9
193   site.py              func       __init__                               10
194   warnings.py          func       simplefilter                           11
195   linecache.py         func       ?                                      11
196   posixpath.py         func       split                                  13
197   stat.py              func       ?                                      14
198   stat.py              func       S_IFMT                                 14
199   posixpath.py         func       dirname                                22
200   posixpath.py         func       normcase                               29
201   os.py                func       __init__                               31
202   posixpath.py         func       basename                               31
203   UserDict.py          func       UserDict                               32
204   posixpath.py         func       exists                                 37
205   aliases.py           func       ?                                      46
206   copy_reg.py          func       pickle                                 66
207   posixpath.py         func       isabs                                  87
208   posixpath.py         func       join                                  105
209   types.py             func       ?                                     109
210   stat.py              func       S_ISDIR                               113
211   site.py              func       setcopyright                          132
212   ascii.py             func       ?                                     133
213   os.py                func       _get_exports_list                     136
214   UserDict.py          func       DictMixin                             184
215   codecs.py            func       ?                                     210
216   posixpath.py         func       normpath                              231
217   UserDict.py          func       ?                                     303
218   __init__.py          func       search_function                       350
219   copy_reg.py          func       ?                                     377
220   posixpath.py         func       isdir                                 399
221   warnings.py          func       ?                                     530
222   site.py              func       abs__file__                           540
223   site.py              func       execsitecustomize                     558
224   posixpath.py         func       ?                                     560
225   site.py              func       removeduppaths                        565
226   site.py              func       _init_pathinfo                        899
227   os.py                func       _exists                               953
228   posixpath.py         func       abspath                               966
229   site.py              func       makepath                             1296
230   __init__.py          func       ?                                    1548
231   <string>             func       ?                                    1808
232   site.py              func       addsitepackages                      2471
233   site.py              func       addpackage                           2475
234   os.py                func       ?                                    3879
235   site.py              func       addsitedir                           4026
236   site.py              func       main                                 4532
237   site.py              func       ?                                    9930
238   func_abc.py          func       func_c                            1000071
239   func_abc.py          func       func_b                            2010230
240   func_abc.py          func       func_a                            3015936
241   func_abc.py          func       ?                                 3017454
242
243Counts shows us how many times each different function was called, and how
244many functions were called in total.
245
246The exclusive function elapsed times show the time that each function spent
247processing code - while not in other functions.
248
249The inclusive function elapsed times show the time that each function spent
250processing code, including the time spent in other calls.
251
252These elapsed times are the absolute time from when the function began to
253when it completed - which includes off-CPU time due to other system events
254such as I/O, scheduling, interrupts, etc.
255
256