1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
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
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
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
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
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
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
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
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
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
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
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
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
|
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE chapter SYSTEM "chapter.dtd">
<chapter>
<header>
<copyright>
<year>2004</year><year>2013</year>
<holder>Ericsson AB. All Rights Reserved.</holder>
</copyright>
<legalnotice>
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
</legalnotice>
<title>Runtime_Tools Release Notes</title>
<prepared></prepared>
<docno></docno>
<date></date>
<rev></rev>
<file>notes.xml</file>
</header>
<p>This document describes the changes made to the Runtime_Tools
application.</p>
<section><title>Runtime_Tools 1.9.1</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p>
The <c>trace_file_drv</c> did not handle <c>EINTR</c>
correct which caused it to fail when the runtime system
received a signal.</p>
<p>
Own Id: OTP-12890 Aux Id: seq12885 </p>
</item>
</list>
</section>
</section>
<section><title>Runtime_Tools 1.9</title>
<section><title>Improvements and New Features</title>
<list>
<item>
<p>
Change license text from Erlang Public License to Apache
Public License v2</p>
<p>
Own Id: OTP-12845</p>
</item>
</list>
</section>
</section>
<section><title>Runtime_Tools 1.8.16</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p>
The trace process started by <c>dbg</c> would not always
terminate when <c>dbg:stop/0</c> was called.</p>
<p>
Own Id: OTP-12517</p>
</item>
</list>
</section>
</section>
<section><title>Runtime_Tools 1.8.15</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p>
Add <c>nif_version</c> to <c>erlang:system_info/1</c> in
order to get the NIF API version of the runtime system in
a way similar to <c>driver_version</c>.</p>
<p>
Own Id: OTP-12298</p>
</item>
</list>
</section>
</section>
<section><title>Runtime_Tools 1.8.14</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p>
The documentation for the return value of
dbg:{stop,stop_clear} functions are now correct (Thanks
to Luca Favatella)</p>
<p>
Own Id: OTP-11603</p>
</item>
<item>
<p>
Fix DTrace build on Illumos. (Thanks to Ryan Zezeski.)</p>
<p>
Own Id: OTP-11622</p>
</item>
<item>
<p>
Do not turn off scheduler_wall_time, as it can interfere
with other applications usage.</p>
<p>
Own Id: OTP-11693 Aux Id: seq12528 </p>
</item>
<item>
<p>
Application upgrade (appup) files are corrected for the
following applications: </p>
<p>
<c>asn1, common_test, compiler, crypto, debugger,
dialyzer, edoc, eldap, erl_docgen, et, eunit, gs, hipe,
inets, observer, odbc, os_mon, otp_mibs, parsetools,
percept, public_key, reltool, runtime_tools, ssh,
syntax_tools, test_server, tools, typer, webtool, wx,
xmerl</c></p>
<p>
A new test utility for testing appup files is added to
test_server. This is now used by most applications in
OTP.</p>
<p>
(Thanks to Tobias Schlager)</p>
<p>
Own Id: OTP-11744</p>
</item>
</list>
</section>
<section><title>Improvements and New Features</title>
<list>
<item>
<p>
Allow install path to have unicode characters.</p>
<p>
Own Id: OTP-10877</p>
</item>
<item>
<p>
The <c>erts_alloc_config</c> tool has been updated to
produce configurations that better fit todays SMP support
in the VM.</p>
<p>
Own Id: OTP-11662</p>
</item>
<item>
<p>
The <seealso
marker="kernel:app"><c>app</c></seealso>-file key
<seealso
marker="kernel:app#runtime_dependencies"><c>runtime_dependencies</c></seealso>
has been introduced.</p>
<p>
Runtime dependencies have been added to all app-files in
OTP. Note that these may not be completely correct during
OTP 17, but this is actively being worked on.</p>
<p>
The function <seealso
marker="runtime_tools:system_information#sanity_check/0"><c>system_information:sanity_check/0</c></seealso>
will verify all declared runtime dependencies in the
system when called.</p>
<p>
Own Id: OTP-11773</p>
</item>
</list>
</section>
</section>
<section><title>Runtime_Tools 1.8.13</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p>
Observer did not produce correct result when ERTS
internal memory allocators had been disabled.</p>
<p>
Own Id: OTP-11520</p>
</item>
</list>
</section>
</section>
<section><title>Runtime_Tools 1.8.12</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p>
The process trace flag 'silent' is now allowed in call to
dbg:p/2.</p>
<p>
Own Id: OTP-11222</p>
</item>
</list>
</section>
<section><title>Improvements and New Features</title>
<list>
<item>
<p>
Introduced functionality for inspection of system and
build configuration.</p>
<p>
Own Id: OTP-11196</p>
</item>
</list>
</section>
</section>
<section><title>Runtime_Tools 1.8.11</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p>
Some bugs related to calculation of CPU/scheduler
utilization in observer are corrected.</p>
<p>
Current function for a process is accepted to be
'undefined' when running hipe.</p>
<p>
Own Id: OTP-10894</p>
</item>
</list>
</section>
<section><title>Improvements and New Features</title>
<list>
<item>
<p>Erlang source files with non-ASCII characters are now
encoded in UTF-8 (instead of latin1).</p>
<p>
Own Id: OTP-11041 Aux Id: OTP-10907 </p>
</item>
</list>
</section>
</section>
<section><title>Runtime_Tools 1.8.10</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p>
Fix Table Viewer refresh crash on no more existing ets
tables (Thanks to Peti Gömori)</p>
<p>
Own Id: OTP-10635</p>
</item>
</list>
</section>
<section><title>Improvements and New Features</title>
<list>
<item>
<p>
User Guides for the dynamic tracing tools dtrace and
systemtap have been added to the documentation.</p>
<p>
Own Id: OTP-10155</p>
</item>
<item>
<p>Where necessary a comment stating encoding has been
added to Erlang files. The comment is meant to be removed
in Erlang/OTP R17B when UTF-8 becomes the default
encoding. </p>
<p>
Own Id: OTP-10630</p>
</item>
<item>
<p> Some examples overflowing the width of PDF pages have
been corrected. </p>
<p>
Own Id: OTP-10665</p>
</item>
<item>
<p>
The backend module appmon_info.erl is moved from appmon
application to runtime_tools. This allows appmon to be
run from a remote erlang node towards a target node which
does not have appmon (and its dependencies) installed, as
long as runtime_tools is installed there.</p>
<p>
Own Id: OTP-10786</p>
</item>
</list>
</section>
</section>
<section><title>Runtime_Tools 1.8.9</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p>
Change the module-level docs to give complete
step-by-step instructions for using the `dyntrace:p()`
trace function. (Thanks to Scott Lystig Fritchie)</p>
<p>
Own Id: OTP-10141</p>
</item>
<item>
<p>
Add 1024 separate USDT probes to dyntrace.erl and
dyntrace.c (Thanks to Scott Lystig Fritchie)</p>
<p>
Own Id: OTP-10143</p>
</item>
<item>
<p>
Relocate bodies of DTrace probes to the statically-linked
VM.</p>
<p>
Due to various operating systems (in both the DTrace and
SystemTap worlds) not fully supporting DTrace probes (or
SystemTap-compatibility mode probes) in shared libraries,
we relocate those probes to the statically-linked virtual
machine. This could be seen as pollution of the pristine
VM by a (yet) experimental feature. However:</p>
<p>
1. This code can be eliminated completely by the C
preprocessor. 2. Leaving the probes in the dyntrace NIF
shared library simply does not work correctly on too many
platforms. *Many* thanks to Macneil Shonle at Basho for
assisting when my RSI-injured fingers gave out. (note:
Solaris 10 and FreeBSD 9.0-RELEASE can take a long time
to compile)</p>
<p>
Own Id: OTP-10189</p>
</item>
</list>
</section>
</section>
<section><title>Runtime_Tools 1.8.8</title>
<section><title>Improvements and New Features</title>
<list>
<item>
<p>
The DTrace source patch from Scott Lystig Fritchie is
integrated in the source tree. Using an emulator with
dtrace probe is still not supported for production use,
but may be a valuable debugging tool. Configure with
--with-dynamic-trace=dtrace (or
--with-dynamic-trace=systemtap) to create a build with
dtrace probes enabled. See runtime_tools for
documentation and examples.</p>
<p>
Own Id: OTP-10017</p>
</item>
</list>
</section>
</section>
<section><title>Runtime_Tools 1.8.7</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p>
Earlier dbg:stop only did erlang:trace_delivered and did
not flush the trace file driver. Therefore there could
still be trace messages that were delivered to the driver
(guaranteed by erlang:trace_delivered) but not yet
written to the file when dbg:stop returned. Flushing is
now added on each node before the dbg process terminates.</p>
<p>
Own Id: OTP-9651</p>
</item>
<item>
<p>
File handles created by the trace_file_drv driver was
inherited to child processes. This is now corrected.</p>
<p>
Own Id: OTP-9658</p>
</item>
</list>
</section>
<section><title>Improvements and New Features</title>
<list>
<item>
<p>Erlang/OTP can now be built using parallel make if you
limit the number of jobs, for instance using '<c>make
-j6</c>' or '<c>make -j10</c>'. '<c>make -j</c>' does not
work at the moment because of some missing
dependencies.</p>
<p>
Own Id: OTP-9451</p>
</item>
<item>
<p>
Two new built-in trace pattern aliases have been added:
caller_trace (c) and caller_exception_trace (cx). See the
dbg:ltp/0 documentation for more info.</p>
<p>
Own Id: OTP-9458</p>
</item>
</list>
</section>
</section>
<section><title>Runtime_Tools 1.8.6</title>
<section><title>Improvements and New Features</title>
<list>
<item>
<p>
Two new built-in trace pattern aliases have been added:
caller_trace (c) and caller_exception_trace (cx). See the
dbg:ltp/0 documentation for more info.</p>
<p>
Own Id: OTP-9458</p>
</item>
</list>
</section>
</section>
<section><title>Runtime_Tools 1.8.5</title>
<section><title>Improvements and New Features</title>
<list>
<item>
<p>
When a big number of trace patterns are set by inviso the
Erlang VM could get unresponsive for several seconds.
This is now corrected.</p>
<p>
Own Id: OTP-9048 Aux Id: seq11480 </p>
</item>
</list>
</section>
</section>
<section><title>Runtime_Tools 1.8.4.1</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p>
Minor corrections and removal of a temporary workaround.</p>
<p>
Own Id: OTP-8755 Aux Id: seq-11628, seq-11639 </p>
</item>
<item>
<p>
Small fix in inviso_autostart_server.</p>
<p>
Own Id: OTP-8783 Aux Id: seq11628 </p>
</item>
</list>
</section>
</section>
<section><title>Runtime_Tools 1.8.4</title>
<section><title>Improvements and New Features</title>
<list>
<item>
<p>
Miscellaneous updates.</p>
<p>
Own Id: OTP-8705</p>
</item>
</list>
</section>
</section>
<section><title>Runtime_Tools 1.8.3</title>
<section><title>Improvements and New Features</title>
<list>
<item>
<p>Cross compilation improvements and other build system
improvements.</p>
<p>Most notable:</p> <list><item> Lots of cross
compilation improvements. The old cross compilation
support was more or less non-existing as well as broken.
Please, note that the cross compilation support should
still be considered as experimental. Also note that old
cross compilation configurations cannot be used without
modifications. For more information on cross compiling
Erlang/OTP see the <c>$ERL_TOP/INSTALL-CROSS.md</c> file.
</item><item> Support for staged install using <url
href="http://www.gnu.org/prep/standards/html_node/DESTDIR.html">DESTDIR</url>.
The old broken <c>INSTALL_PREFIX</c> has also been fixed.
For more information see the <c>$ERL_TOP/INSTALL.md</c>
file. </item><item> Documentation of the <c>release</c>
target of the top <c>Makefile</c>. For more information
see the <c>$ERL_TOP/INSTALL.md</c> file. </item><item>
<c>make install</c> now by default creates relative
symbolic links instead of absolute ones. For more
information see the <c>$ERL_TOP/INSTALL.md</c> file.
</item><item> <c>$ERL_TOP/configure --help=recursive</c>
now works and prints help for all applications with
<c>configure</c> scripts. </item><item> Doing <c>make
install</c>, or <c>make release</c> directly after
<c>make all</c> no longer triggers miscellaneous
rebuilds. </item><item> Existing bootstrap system is now
used when doing <c>make install</c>, or <c>make
release</c> without a preceding <c>make all</c>.
</item><item> The <c>crypto</c> and <c>ssl</c>
applications use the same runtime library path when
dynamically linking against <c>libssl.so</c> and
<c>libcrypto.so</c>. The runtime library search path has
also been extended. </item><item> The <c>configure</c>
scripts of <c>erl_interface</c> and <c>odbc</c> now
search for thread libraries and thread library quirks the
same way as <c>erts</c> do. </item><item> The
<c>configure</c> script of the <c>odbc</c> application
now also looks for odbc libraries in <c>lib64</c> and
<c>lib/64</c> directories when building on a 64-bit
system. </item><item> The <c>config.h.in</c> file in the
<c>erl_interface</c> application is now automatically
generated in instead of statically updated which reduces
the risk of <c>configure</c> tests without any effect.
</item></list>
<p>(Thanks to Henrik Riomar for suggestions and
testing)</p>
<p>(Thanks to Winston Smith for the AVR32-Linux cross
configuration and testing)</p>
<p>
*** POTENTIAL INCOMPATIBILITY ***</p>
<p>
Own Id: OTP-8323</p>
</item>
<item>
<p>
Cleanups suggested by tidier and modernization of types
and specs.</p>
<p>
Own Id: OTP-8455</p>
</item>
</list>
</section>
</section>
<section><title>Runtime_Tools 1.8.2</title>
<section><title>Improvements and New Features</title>
<list>
<item>
<p>
The documentation is now built with open source tools
(xsltproc and fop) that exists on most platforms. One
visible change is that the frames are removed.</p>
<p>
Own Id: OTP-8201</p>
</item>
</list>
</section>
</section>
<section><title>Runtime_Tools 1.8.1</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p>
<c>Makefile.in</c> has been updated to use the LDFLAGS
environment variable (if set). (Thanks to Davide
Pesavento.)</p>
<p>
Own Id: OTP-8157</p>
</item>
</list>
</section>
</section>
<section><title>Runtime_Tools 1.8</title>
<section><title>Improvements and New Features</title>
<list>
<item>
<p>
<c>etop</c> would crash if the emulator's custom
allocators had been turned off (e.g. using the
<c>+Meamin</c> option).</p>
<p>
Own Id: OTP-7519</p>
</item>
<item>
<p>The copyright notices have been updated.</p>
<p>
Own Id: OTP-7851</p>
</item>
<item>
<p>Now, dbg:p/2 accepts {X,Y,Z} process specification as
stated in the documentation. It also now accepts
"<X.Y.Z>" like from erlang:pid_to_list/1.</p>
<p>There is now a pre-saved match spec in dbg that saves
a lot of typing. Use dbg:ltp/0 to find out more...</p>
<p>
Own Id: OTP-7867</p>
</item>
</list>
</section>
</section>
<section><title>Runtime_Tools 1.7.3</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p>Fixed a timestamp problem where some events could be
sent out of order. Minor fixes to presentation of
data.</p>
<p>
Own Id: OTP-7544 Aux Id: otp-7442 </p>
</item>
</list>
</section>
</section>
<section><title>Runtime_Tools 1.7.2</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p><c>etop</c> now collects process information faster
and more reliably than before (a race condition reported
by Igor Goryachev has been eliminated).</p>
<p>Trace messages could be lost when <c>ttb:stop/0</c>
was called.</p>
<p>
Own Id: OTP-7164</p>
</item>
</list>
</section>
</section>
<section><title>Runtime_Tools 1.7.1</title>
<section><title>Improvements and New Features</title>
<list>
<item>
<p>The documentation has been updated so as to reflect
the last updates of the Erlang shell as well as the minor
modifications of the control sequence <c>p</c> of the
<c>io_lib</c> module.</p> <p>Superfluous empty lines have
been removed from code examples and from Erlang shell
examples.</p>
<p>
Own Id: OTP-6944 Aux Id: OTP-6554, OTP-6911 </p>
</item>
<item>
<p>Memory management improvements especially for the
runtime system with SMP support:</p> <list> <item> The
runtime system with SMP support can now use multiple,
thread specific instances of most memory allocators. This
improves performance since it reduces lock contention in
the memory allocators. It may however increase memory
usage for some applications. The runtime system with SMP
support will by default enable this feature on most
allocators. The amount of instances used can be
configured. </item> <item> <c>driver_alloc()</c>,
<c>driver_realloc()</c>, and <c>driver_free()</c> now use
their own erts specific memory allocator instead of the
default <c>malloc()</c> implementation on the system.
</item> <item> The default configuration of some
allocators have been changed to fit applications that use
much memory better. </item> <item> Some new
<c>erts_alloc</c> configuration parameters have been
added. </item> <item> <c>erts_alloc_config</c> has been
modified to be able to create configurations suitable for
multiple instances of allocators. </item> <item> The
returned value from <c>erlang:system_info({allocator,
Alloc})</c> has been changed. This since an allocator may
now run in multiple instances. </item> </list> <p>If you
for some reason want the memory allocators to be
configured as before, you can pass the <c>+Mea r11b</c>
command-line argument to <c>erl</c>.</p> <p>For more
information see the <c>erts_alloc(3)</c>, the
<c>erts_alloc_config(3)</c>, and the <c>erlang(3)</c>
documentation.</p>
<p>
*** POTENTIAL INCOMPATIBILITY ***</p>
<p>
Own Id: OTP-7100</p>
</item>
</list>
</section>
</section>
<section><title>Runtime_Tools 1.7</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p>
<c>dbg</c> could leave traced processes in a suspended
state if the tracer process was killed with exit reason
<c>kill</c>.</p>
<p>
<c>erlang:suspend_process/2</c> has been introduced which
accepts an option list as second argument. For more
information see the <c>erlang(3)</c> documentation.</p>
<p>
Processes suspended via
<c>erlang:suspend_process/[1,2]</c> will now be
automatically resumed if the process that called
<c>erlang:suspend_process/[1,2]</c> terminates.</p>
<p>
Processes could previously be suspended by one process
and resumed by another unless someone was tracing the
suspendee. This is <em>not</em> possible anymore. The
process resuming a process <em>has</em> to be the one
that suspended it.</p>
<p>
*** POTENTIAL INCOMPATIBILITY ***</p>
<p>
Own Id: OTP-6946</p>
</item>
</list>
</section>
<section><title>Improvements and New Features</title>
<list>
<item>
<p>
The undocumented and unsupported function
<c>dbg:tracer/1</c> has been removed. The undocumented,
unsupported, and broken function <c>dbg:i/1</c> has been
removed.</p>
<p>
Own Id: OTP-6939</p>
</item>
</list>
</section>
</section>
<section><title>Runtime_Tools 1.6.8</title>
<section><title>Fixed Bugs and Malfunctions</title>
<list>
<item>
<p>
In this release the following has been fixed and
enhanced: Autostart: It is now possible to configure
modules that shall be loaded by the autostart mechanism.
This because it is not certain that all application
systems make use of the OTP boot script to set up paths
to all Erlang modules. Runtime_tools/Inviso: A bug in the
fetch_log functionality has been fixed. Further a bug
that was (supposedly) fixed in a previous patch
concerning meta-tracer write_ti has been fixed (again) in
this patch. A bug in inviso_as_lib making remote
autostart config file updates fail has been fixed.
Inviso: inviso_tool has been given a flush API.</p>
<p>
Own Id: OTP-6918</p>
</item>
</list>
</section>
</section>
<section><title>Runtime_Tools 1.6.7</title>
<section><title>Improvements and New Features</title>
<list>
<item>
<p>
The following bugs/improvements have been done: Internal
interworking between inviso_rt and inviso_rt_meta. The
call function used by inviso_rt to call inviso_rt_meta is
now protected with a monitor. Inviso_rt_meta now includes
the timestamp of the incoming meta trace message when
calling the call-callback. (Makes it possible to add a
"better" timestamp to the ti-file.) Bug in inviso_tool
making it not remove trace patterns when terminating. Bug
in internal function h_start_session making inviso_tool
crash if there were no active nodes to start the session
on. The user-inviso_tool and inviso API-inviso control
component request/response gen_server protocols had
default time-out. Since many trace operations can be time
consuming, a longer time-out is necessary. Improved
overload protection. It is now possible to let the
overload protection renew itself (e.g after an exit from
an external overload protector). Inviso_rt_meta now fully
uses the exception_trace match spec action term. Run
Trace Case API (as in contrast to activate and deactivate
trace case APIs) in inviso_tool. Flush trace-port API
added to inviso. Get_session_data API added to
inviso_tool. Improved inviso_tool:stop making it possible
to name nodes which shall not have their trace patterns
removed when inviso_tool terminates. Bug in handling of
writing multiple ti-entries if returned from a
call/return_from call-back in inviso_rt_meta Process
trace flags are no longer explicitly removed by the
inviso_tool when it terminates. Not necessary.
Inviso_tool get_autostart_data adopted to standard
autostarter.</p>
<p>
*** INCOMPATIBILITY with Meta trace call-backs are called
with different arguments now. ***</p>
<p>
Own Id: OTP-6881</p>
</item>
</list>
</section>
</section>
<section>
<title>Runtime_Tools 1.6.6</title>
<section>
<title>Fixed Bugs and Malfunctions</title>
<list type="bulleted">
<item>
<p>A bug in inviso_rt_meta caused an ETS table containing
information on initiated (init_tpm) functions to be lost
when suspending tracing. Further an enhancement to
inviso_rt has been introduced making it possible to
activate process trace flags based on globally registered
names. It is then not an error to activate a global name
on a node where the name does not reside. The process
count in the return value will simply be set to zero
(hence exactly one node in the NodeResult part of the
return value will indicate one matching process found). A
bug was found in fetch_log API. At the same time the
fetch_log functionality was enhanced to also offer flow
control making fetcher processes send chunks of
transferred file data at a slower pace.</p>
<p>Own Id: OTP-6703</p>
</item>
</list>
</section>
<section>
<title>Improvements and New Features</title>
<list type="bulleted">
<item>
<p>Minor Makefile changes.</p>
<p>Own Id: OTP-6689 Aux Id: OTP-6742 </p>
</item>
<item>
<p>An experimental tool called <c>erts_alloc_config</c>
has been added. <c>erts_alloc_config</c> is intended to
be used to aid creation of an <c>erts_alloc</c>
configuration that is suitable for a limited number of
runtime scenarios. For more information see the
<c>erts_alloc_config(3)</c> documentation.</p>
<p>Own Id: OTP-6700</p>
</item>
</list>
</section>
</section>
<section>
<title>Runtime_Tools 1.6.5</title>
<section>
<title>Improvements and New Features</title>
<list type="bulleted">
<item>
<p>Misc improvements.</p>
<p>Own Id: OTP-6576</p>
</item>
</list>
</section>
</section>
<section>
<title>Runtime_Tools 1.6.4</title>
<section>
<title>Improvements and New Features</title>
<list type="bulleted">
<item>
<p>This application has been updated to eliminate warnings
by Dialyzer.</p>
<p>Own Id: OTP-6551</p>
</item>
</list>
</section>
</section>
<section>
<title>Runtime_Tools 1.6.3</title>
<section>
<title>Fixed Bugs and Malfunctions</title>
<list type="bulleted">
<item>
<p>This ticket includes several improvements and bugfixes to
both runtime_tools and inviso. The overload mechanism can
now also react to incoming messages. This is useful if
an external overload watch-dog is used. Some improvements
of variable bindings has been done to the default
autostart mechanism - inviso_autostart_server. Autostart
"jobs" can now be done in parallel, allowing for some
jobs to hang waiting for some parts of the traced system
to become ready before proceeding. Previously when using
named meta-match-specs (tpm_ms) ending up with zero
match-specs still kept the meta trace pattern active.
This caused zero match-specs to be equal to unlimited
meta tracing on that particular function. If the internal
database becomes empty of meta match specs, meta trace
pattern is removed for that function. Standard public
loop data in the inviso runtime meta tracer process is
now extended to a 2-tuple. The functions ctp/1 and ctpl/1
are added making it possible to remove trace patterns for
a list of functions rather than one by one.
Inviso_rt_meta will now accept a list of binaries to be
output into the trace information file, in additions to a
single binary. Further it is also possible to make own
output to the trace information file using the write_ti/1
function. An error was discovered in inviso_rt making the
inviso_rt_meta remain rather than terminate if the
inviso_rt terminated due to "running alone" (not allowed
to run without a control component). A new tool,
inviso_tool, has been added to the inviso application.</p>
<p>Own Id: OTP-6426</p>
</item>
</list>
</section>
</section>
<section>
<title>Runtime_Tools 1.6.2</title>
<section>
<title>Fixed Bugs and Malfunctions</title>
<list type="bulleted">
<item>
<p>Several minor bugs and race conditions eliminated in the
runtime_tools and observer applications.</p>
<p>Own Id: OTP-6265</p>
</item>
</list>
</section>
</section>
<section>
<title>Runtime_Tools 1.6.1</title>
<section>
<title>Improvements and New Features</title>
<list type="bulleted">
<item>
<p>There are new BIFs <c>erlang:spawn_monitor/1,3</c>,
and the new option <c>monitor</c> for
<c>spawn_opt/2,3,4,5</c>.</p>
<p>The <c>observer_backend</c> module has been updated to
handle the new BIFs.</p>
<p>Own Id: OTP-6281</p>
</item>
</list>
</section>
</section>
<section>
<title>Runtime_Tools 1.6</title>
<p>Added the runtime part of the Inviso tracer, see the new Inviso
application for more information. This also meant adding an
application callback module and an application supervisor tree
for Runtime_Tools.</p>
</section>
<section>
<title>Runtime_Tools 1.5.1.1</title>
<section>
<title>Improvements and New Features</title>
<list type="bulleted">
<item>
<p>The <c>dbg</c> manual page has been updated with information
about how to avoid deadlock when tracing.</p>
<p>Own Id: OTP-5373 Aux Id: seq9729</p>
</item>
</list>
</section>
</section>
<section>
<title>Runtime_Tools 1.5.1</title>
<section>
<title>Fixed Bugs and Malfunctions</title>
<list type="bulleted">
<item>
<p>Linked in drivers in the Crypto, and Asn1 applications
are now compiled with the <c>-D_THREAD_SAFE</c> and
<c>-D_REENTRANT</c> switches on unix when the emulator has
thread support enabled.</p>
<p>Linked in drivers on MacOSX are not compiled with the
undocumented <c>-lbundle1.o</c> switch anymore. Thanks to
Sean Hinde who sent us a patch.</p>
<p>Linked in driver in Crypto, and port programs in SSL, now
compiles on OSF1.</p>
<p>Minor <c>Makefile</c> improvements in Runtime_Tools.</p>
<p>Own Id: OTP-5346</p>
</item>
</list>
</section>
</section>
</chapter>
|