aboutsummaryrefslogtreecommitdiffstats
path: root/lib/observer/doc/src/notes.xml
blob: 4d1a9a4f55509bfd4a88f45767ef099df959bd19 (plain) (blame)
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
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE chapter SYSTEM "chapter.dtd">

<chapter>
  <header>
    <copyright>
      <year>2004</year><year>2018</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>Observer Release Notes</title>
    <prepared>otp_appnotes</prepared>
    <docno>nil</docno>
    <date>nil</date>
    <rev>nil</rev>
    <file>notes.xml</file>
  </header>
  <p>This document describes the changes made to the Observer
    application.</p>

<section><title>Observer 2.8.1</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    Improved documentation.</p>
          <p>
	    Own Id: OTP-15190</p>
        </item>
      </list>
    </section>

</section>

<section><title>Observer 2.8</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    Added possibility to garbage collect selected processes
	    and fixed a crash when the saved config file contained
	    bad data.</p>
          <p>
	    Own Id: OTP-14993 Aux Id: PR-1666 </p>
        </item>
      </list>
    </section>


    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
	    Use uri_string module instead of http_uri.</p>
          <p>
	    Own Id: OTP-14902</p>
        </item>
      </list>
    </section>

</section>

<section><title>Observer 2.7</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    etop.hrl used a relative path to include
	    observer_backend.hrl, this is now changed to use
	    include_lib instead. runtime_tools/include is added to
	    the tertiary bootstrap.</p>
          <p>
	    Own Id: OTP-14842 Aux Id: ERL-534 </p>
        </item>
        <item>
          <p>
	    If a crashdump was truncated in the attributes section
	    for a module, crashdump_viewer would crash when a module
	    view was opened from the GUI. This bug was introduced in
	    OTP-20.2 and is now corrected.</p>
          <p>
	    Own Id: OTP-14846 Aux Id: ERL-537 </p>
        </item>
        <item>
          <p>
	    Optimized ets and mnesia table view tab in observer gui,
	    listing 10000 tables was previously very slow.</p>
          <p>
	    Own Id: OTP-14856 Aux Id: ERIERL-117 </p>
        </item>
      </list>
    </section>


    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
	    When a process has many links and/or monitors, it could
	    earlier take very long time to display the process
	    information window. This is now improved by only showing
	    a few links and monitors, and then an link named
	    "more..." to expand the rest.</p>
          <p>
	    Own Id: OTP-14725</p>
        </item>
        <item>
          <p>
	    More crash dump info such as: process binary virtual heap
	    stats, full info for process causing out-of-mem during
	    GC, more port related info, and dirty scheduler info.</p>
          <p>
	    Own Id: OTP-14820</p>
        </item>
      </list>
    </section>

</section>

<section><title>Observer 2.6</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    A bug introduced in OTP-20 would make Crashdump Viewer
	    crash when trying to expand an empty binary. This is now
	    corrected.</p>
          <p>
	    Own Id: OTP-14642</p>
        </item>
        <item>
          <p>
	    If a match spec in the config file contained more than
	    one clause, observer would earlier crash when trying to
	    display it in the GUI. This is now corrected.</p>
          <p>
	    Own Id: OTP-14643 Aux Id: ERL-489 </p>
        </item>
        <item>
	    <p>Writing of crash dumps is significantly faster.</p>
	    <p>Maps are now included in crash dumps.</p>
	    <p>Constants terms would only be shown in one process,
	    while other processes referencing the same constant term
	    would show a marker for incomplete heap. </p>
          <p>
	    Own Id: OTP-14685 Aux Id: OTP-14611, OTP-14603, OTP-14595 </p>
        </item>
      </list>
    </section>


    <section><title>Improvements and New Features</title>
      <list>
        <item>
	    <p>Binaries and some other data in crash dumps are now
	    encoded in base64 (instead of in hex), which will reduce
	    the size of crash dumps.</p>
	    <p>A few bugs in the handling of sub binaries in
	    <c>crashdump_viewer</c> have been fixed.</p>
          <p>
	    Own Id: OTP-14686</p>
        </item>
        <item>
          <p>
	    In order to allow future improvements, Crashdump Viewer
	    now checks the version tag of the crashdump to see that
	    it is a known format. If the crashdump version is newer
	    than Crashdump Viewer is prepared to read, then an
	    information dialog is displayed before Crashdump Viewer
	    terminates.</p>
          <p>
	    If an incomplete process heap is discovered in a
	    crashdump, Crashdump Viewer will now display a warning
	    for this, similar to the warning displayed when a
	    crashdump is truncated. Incomplete heaps can occur if for
	    instance the literals are not included, which is the case
	    for all dumps prior to OTP-20.2.</p>
          <p>
	    Own Id: OTP-14755</p>
        </item>
      </list>
    </section>

</section>

<section><title>Observer 2.5</title>

    <section><title>Improvements and New Features</title>
      <list>
        <item>
	    <p>The following improvements are done to Crashdump
	    Viewer:</p> <list> <item>Reading of crash dumps with many
	    binaries is optimized.</item> <item>A progress bar is
	    shown when the detail view for a process is
	    opened.</item> <item>The <c>cdv</c> script now sets
	    <c>ERL_CRASH_DUMP_SECONDS=0</c> to avoid generating a new
	    crash dump from the node running the Crashdump
	    Viewer.</item> <item>A warning dialog is shown if the
	    node running the Crashdump Viewer could potentially
	    overwrite the crash dump under inspection.</item>
	    <item>Bugfix: In some situations, Crashdump Viewer could
	    not find the end of the 'Last calls' section in a crash
	    dump, and would erroneously mark the crash dump as
	    truncated. This is now corrected.</item> <item>Bugfix: In
	    some situations, process info for a specific process
	    would be marked as truncated by Crashdump Viewer, even if
	    the crash dump was truncated in the binary section - and
	    not related to the process in question. This is now
	    corrected.</item> </list>
          <p>
	    Own Id: OTP-14386</p>
        </item>
        <item>
          <p>
	    General Unicode improvements.</p>
          <p>
	    Own Id: OTP-14462</p>
        </item>
        <item>
          <p>
	    Tools are updated to show Unicode atoms correctly.</p>
          <p>
	    Own Id: OTP-14464</p>
        </item>
        <item>
          <p>
	    Add system statistics and limits to frontpage in
	    observer.</p>
          <p>
	    Own Id: OTP-14536</p>
        </item>
      </list>
    </section>

</section>

<section><title>Observer 2.4</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    <c>etop</c> had a hardcoded timeout value of 1 second
	    when waiting for data from a remote node. When this
	    expired, which could happen for instance if there were
	    very many processes on the remote node, etop would exit
	    with reason <c>connection_lost</c>. To overcome this
	    problem, the timeout is now changed to be the same as the
	    update interval, which is configurable.</p>
          <p>
	    Own Id: OTP-14393</p>
        </item>
      </list>
    </section>


    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
	    Show dirty-scheduler threads in performance monitor graph
	    and add a column with maximum allocated memory in the
	    Memory Allocators table.</p>
          <p>
	    Own Id: OTP-14137</p>
        </item>
        <item>
          <p>
	    Keep table and port selection after refresh of tables.
	    Store settings before shutdown and restore when starting
	    application.</p>
          <p>
	    Own Id: OTP-14270</p>
        </item>
        <item>
	    <p> Miscellaneous updates due to atoms containing
	    arbitrary Unicode characters. </p>
          <p>
	    Own Id: OTP-14285</p>
        </item>
        <item>
          <p>
	    When observing a node older than OTP-19.0, a pop-up will
	    be displayed when trying to access port information.
	    Earlier, observer would crash in this situation.</p>
          <p>
	    Own Id: OTP-14345 Aux Id: ERL-399 </p>
        </item>
      </list>
    </section>

</section>

<section><title>Observer 2.3.1</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    etop erroneously reported the average scheduler
	    utilization since the tool was first started instead of
	    the scheduler utilization since last update. This is now
	    corrected.</p>
          <p>
	    Own Id: OTP-14090 Aux Id: seq13232 </p>
        </item>
        <item>
          <p>
	    crashdump_viewer crashed when the 'Slogan' had more than
	    one line. This is now corrected.</p>
          <p>
	    Own Id: OTP-14093 Aux Id: ERL-318 </p>
        </item>
        <item>
          <p>
	    When clicking an HTML-link to a port before the port tab
	    has been opened for the first time, observer would crash
	    since port info is not initiated. This is now corrected.</p>
          <p>
	    Own Id: OTP-14151 Aux Id: PR-1296 </p>
        </item>
        <item>
	    <p>The dialyzer and observer applications will now use a
	    portable way to find the home directory. That means that
	    there is no longer any need to manually set the HOME
	    environment variable on Windows.</p>
          <p>
	    Own Id: OTP-14249 Aux Id: ERL-161 </p>
        </item>
      </list>
    </section>

</section>

<section><title>Observer 2.3</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    The shell script (priv/bin/cdv) and bat file
	    (priv/bin/cdv.bat) which can be used for starting
	    crashdump_viewer both started a distributed erlang node.
	    This would cause any attempt at starting a second
	    instance of the crashdump_viewer to fail. To solve this
	    problem, cdv and cdv.bat now use non-distributed nodes
	    when starting the crashdump_viewer.</p>
          <p>
	    Own Id: OTP-14010</p>
        </item>
        <item>
          <p>
	    A bug caused the number of buckets to be shown in the
	    'Objects' column, and the number of objects to be shown
	    in the 'Memory' column for ets table in crashdump_viewer.
	    This is now corrected.</p>
          <p>
	    Own Id: OTP-14064</p>
        </item>
      </list>
    </section>


    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
	    Add option <c>queue_size</c> to ttb:tracer/2. This sets
	    the maximum queue size for the IP trace driver which is
	    used when tracing to shell and/or <c>{local,File}</c>.</p>
          <p>
	    The default value for <c>queue_size</c> is specified by
	    <c>dbg</c>, and it is now changed from 50 to 200.</p>
          <p>
	    Own Id: OTP-13829 Aux Id: seq13171 </p>
        </item>
        <item>
          <p>
	    The port information page is updated to show more
	    information per port.</p>
          <p>
	    Own Id: OTP-13948 Aux Id: ERL-272 </p>
        </item>
      </list>
    </section>

</section>

<section><title>Observer 2.2.2</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    Fixed error handling in observer when mnesia tables was
	    requested and not available.</p>
          <p>
	    Own Id: OTP-13845 Aux Id: ERL-237 </p>
        </item>
      </list>
    </section>

</section>

<section><title>Observer 2.2.1</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    Fixed a crash happening when observing another node, who
	    have a different number of schedulers than the current
	    one.</p>
          <p>
	    Own Id: OTP-13702 Aux Id: ERL-171 </p>
        </item>
      </list>
    </section>

</section>

<section><title>Observer 2.2</title>

    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
	    Update observer GUI to support tracing on ports, and to
	    set matchspecs for send/receive. This required some minor
	    bugfixes in runtime_tools/dbg.</p>
          <p>
	    Own Id: OTP-13481</p>
        </item>
        <item>
          <p>
	    Update dbg and ttb to work with a tracer module as tracer
	    and tracing on ports.</p>
          <p>
	    Own Id: OTP-13500</p>
        </item>
        <item>
          <p>
	    Added possibility to change update frequency and length
	    of the graph windows.</p>
          <p>
	    Own Id: OTP-13555</p>
        </item>
        <item>
          <p>
	    Improved background coloring to work with dark themes and
	    other visual improvements.</p>
          <p>
	    Own Id: OTP-13556</p>
        </item>
        <item>
          <p>
	    Crashdump viewer now allows port info "Port controls
	    forker process..."</p>
          <p>
	    Own Id: OTP-13647</p>
        </item>
      </list>
    </section>

</section>

<section><title>Observer 2.1.2</title>

    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
	    Documentation corrections.</p>
          <p>
	    Own Id: OTP-12994</p>
        </item>
      </list>
    </section>

</section>

<section><title>Observer 2.1.1</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    Show ets owner pid in crashdump viewers popup window,
	    thanks Leo Liu.</p>
          <p>
	    Own Id: OTP-13030</p>
        </item>
        <item>
          <p>
	    Several initialisms (eg, ERTS, ETS, SMP) are used as
	    headings. They were being capitalized incorrectly.</p>
          <p>
	    Own Id: OTP-13044</p>
        </item>
        <item>
          <p>
	    Fixed a crash in crashdump viewer when dump contained a
	    truncated binary.</p>
          <p>
	    Own Id: OTP-13163</p>
        </item>
      </list>
    </section>

</section>

<section><title>Observer 2.1</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    Show run queue status in crashdump viewer.</p>
          <p>
	    Own Id: OTP-12401</p>
        </item>
        <item>
          <p>
	    Don't refresh observer table view if there was no change</p>
          <p>
	    Own Id: OTP-12819</p>
        </item>
      </list>
    </section>


    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
	    Added display of new crashdump information available in
	    crashdumps from Erlang/OTP 18.</p>
          <p>
	    Own Id: OTP-12363</p>
        </item>
        <item>
          <p>
	    Added the possibility to view sasl log entries for
	    processes.</p>
          <p>
	    Own Id: OTP-12504</p>
        </item>
        <item>
          <p>
	    Add memory allocator usage and utilization graphs.</p>
          <p>
	    Own Id: OTP-12631</p>
        </item>
      </list>
    </section>

</section>

<section><title>Observer 2.0.4</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    Fix crash when opening a process information window.</p>
          <p>
	    Own Id: OTP-12634</p>
        </item>
      </list>
    </section>

</section>

<section><title>Observer 2.0.3</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    A note saying only R15B nodes can be observed is removed
	    from the user guide.</p>
          <p>
	    Own Id: OTP-12078</p>
        </item>
      </list>
    </section>

</section>

<section><title>Observer 2.0.2</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    Fixed statusbar on Windows</p>
          <p>
	    Own Id: OTP-12162</p>
        </item>
      </list>
    </section>

</section>

<section><title>Observer 2.0.1</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    crashdump_viewer would crash if the owner of a timer was
	    specified as the process' registered name. This has been
	    corrected.</p>
          <p>
	    Own Id: OTP-11919</p>
        </item>
        <item>
          <p>
	    Fix crash and minor updates.</p>
          <p>
	    Own Id: OTP-11949</p>
        </item>
      </list>
    </section>

</section>

<section><title>Observer 2.0</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    etop trace handler now works in smp environment (Thanks
	    to Péter Gömöri)</p>
          <p>
	    Own Id: OTP-11633</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>
	    Removed gs based applications and gs based backends. The
	    <c>observer</c> application replaces the removed
	    applications.</p>
          <p>
	    *** POTENTIAL INCOMPATIBILITY ***</p>
          <p>
	    Own Id: OTP-10915</p>
        </item>
        <item>
          <p>
	    The <c>crashdump_viewer</c> is re-written using
	    <c>wx</c>. The old <c>webtool</c> interface for
	    <c>crashdump_viewer</c> does no longer exist.</p>
          <p>
	    *** POTENTIAL INCOMPATIBILITY ***</p>
          <p>
	    Own Id: OTP-11179</p>
        </item>
      </list>
    </section>

</section>

<section><title>Observer 1.3.1.2</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    The documentation for <c>ttb:tracer/2</c> incorrectly
	    stated that there was an option named '<c>overload</c>',
	    while the correct name used in the implementation is
	    '<c>overload_check</c>'.</p>
          <p>
	    Own Id: OTP-11335 Aux Id: seq12385 </p>
        </item>
        <item>
          <p>
	    Fixed typo in observer documentation. Thanks to Dave
	    Parfitt.</p>
          <p>
	    Own Id: OTP-11475</p>
        </item>
      </list>
    </section>

</section>

<section><title>Observer 1.3.1.1</title>

    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
	    The encoding of the <c>notes.xml</c> file has been
	    changed from latin1 to utf-8 to avoid future merge
	    problems.</p>
          <p>
	    Own Id: OTP-11310</p>
        </item>
      </list>
    </section>

</section>

<section><title>Observer 1.3.1</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>
	    <list> <item> The new Memory field from a crash dump is
	    now presented by crashdump viewer, both in the process
	    overview and in the process detail page. </item> <item> A
	    summary of blocks- and carriers sizes is added to the
	    allocator information page in the crashdump viewer.
	    </item> </list>
          <p>
	    Own Id: OTP-10604 Aux Id: kunagi-336 [247] </p>
        </item>
        <item>
          <p>
	    Use "open" as default browser for crashdump viewer on Mac
	    OS X. Thanks to Magnus Henoch.</p>
          <p>
	    Own Id: OTP-10929</p>
        </item>
        <item>
          <p>
	    Fix observer table viewer crash on formatting improper
	    lists. Thanks to Andrey Tsirulev</p>
          <p>
	    Own Id: OTP-10931</p>
        </item>
        <item>
	    <p> Postscript files no longer needed for the generation
	    of PDF files have been removed. </p>
          <p>
	    Own Id: OTP-11016</p>
        </item>
        <item>
          <p>
	    Add processes state view in observer. Thanks to Eric
	    Pailleau.</p>
          <p>
	    Own Id: OTP-11136</p>
        </item>
      </list>
    </section>

</section>

<section><title>Observer 1.3</title>

    <section><title>Improvements and New Features</title>
      <list>
        <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>
      </list>
    </section>

</section>

<section><title>Observer 1.2</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    The module name in the link to the detail page for each
	    loaded module was earlier not URL encoded. If the module
	    name contained e.g. a # this could cause the crashdump
	    viewer to crash when opening the link. This has been
	    corrected.</p>
          <p>
	    Own Id: OTP-10090 Aux Id: seq12068 </p>
        </item>
        <item>
          <p>
	    Escape control characters in Table Viewer</p>
          <p>
	    Similar behaviour to old tv. Objects in tables supposed
	    to be printed in a single line and it looks ugly when a
	    [...,10,...] integer list creates a new-line. Fix Table
	    Viewer search crash on new|changed|deleted rows.</p>
          <p>
	    Fix Table Viewer crash after a 'Found' -&gt; 'Not found'
	    search sequence</p>
          <p>
	    Start position was lost after a 'Found' -&gt; 'Not found'
	    search sequence leading an undefined position in the next
	    search. Thanks to Peti Gömori</p>
          <p>
	    Own Id: OTP-10218</p>
        </item>
        <item>
          <p>
	    observer: fix app file (Noticed-by: Motiejus Jakstys)</p>
          <p>
	    Add missing observer modules to observer.app.src. Thanks
	    to Tuncer Ayaz.</p>
          <p>
	    Own Id: OTP-10221</p>
        </item>
        <item>
          <p>
	    Make Table Viewer search a bit faster</p>
          <p>
	    Edit table row in a multiline text dialog. Thanks to Peti
	    Gomori.</p>
          <p>
	    Own Id: OTP-10225</p>
        </item>
      </list>
    </section>


    <section><title>Improvements and New Features</title>
      <list>
        <item>
	    <p>Allow tracing on bifs.</p> <p>Ask epmd for local
	    nodes, and remember users last input in connect.</p>
	    <p>Fix crashes when a table or process information could
	    not be retrieved.</p>
          <p>
	    Own Id: OTP-10075</p>
        </item>
      </list>
    </section>

</section>

<section><title>Observer 1.0</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    The following bugs in <c>ttb</c> have been corrected:</p>
	    <list> <item><c>ttb:tracer/2</c> would earlier crash when
	    trying to set up tracing for a diskless node to wrap
	    files, i.e. when option
	    <c>{file,{local,{wrap,Filename,Size,Count}}}</c> was
	    used.</item> <item><c>ttb:stop([fetch])</c> would
	    sometimes silently fail if multiple nodes with different
	    current working directories were traced.</item>
	    <item><c>ttb:stop([fetch])</c> would crash if the tracer
	    was started with option
	    <c>{file,{local,Filename}}</c></item> <item>A deadlock
	    would sometimes occur due to an information printout from
	    the <c>ttb_control</c> process when <c>ttb</c> was
	    stopped.</item> </list>
          <p>
	    Own Id: OTP-9431</p>
        </item>
        <item>
          <p>
	    The file trace port to which the IP trace client relays
	    all traces from diskless nodes was not flushed and closed
	    properly on ttb:stop. This has been corrected.</p>
          <p>
	    Own Id: OTP-9665</p>
        </item>
      </list>
    </section>


    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
	    A new GUI for Observer. Integrating pman, etop, appmon
	    and tv into observer with tracing facilities.</p>
          <p>
	    Own Id: OTP-4779</p>
        </item>
        <item>
          <p>
	    The following new features are added to <c>ttb</c>:</p>
	    <list> <item>A one-command trace setup is added,
	    <c>ttb:start_trace/4</c>.</item> <item>The following new
	    options are added to <c>ttb:tracer/2</c>: <list>
	    <item><em><c>shell</c></em> - Show trace messages on the
	    console in real time</item> <item><em><c>timer</c></em> -
	    Time constrained tracing</item>
	    <item><em><c>overload</c></em> - Overload
	    protection</item> <item><em><c>flush</c></em> - Flush
	    file trace port buffers with given frequency</item>
	    <item><em><c>resume</c></em> - Automatically resume
	    tracing after node restart</item> </list> </item> <item>
	    A new shortcut is added for common tracer settings
	    similar to using the <c>dbg</c> module directly,
	    <c>ttb:tracer(shell | dbg)</c>. </item> <item> Some
	    shortcuts are added for commonly used match
	    specifications in <c>ttb:tp</c> and <c>ttb:tpl</c>.
	    </item> <item> The <c>Options</c> argument to functions
	    <c>ttb:tracer</c>, <c>ttb:write_config</c>,
	    <c>ttb:stop</c> and <c>ttb:format</c> may now be one
	    single option instead of a list. </item> <item> The
	    history buffer of the last trace is now always
	    automatically dumped to the file <c>ttb_last_config</c>
	    when <c>ttb:stop</c> is called. </item> <item> The
	    following new options are added to <c>ttb:stop/1</c>:
	    <list> <item><em><c>fetch_dir</c></em> - Specify where to
	    store fetched logs</item>
	    <item><em><c>{format,FormatOpts}</c></em> - Specify
	    options to use when formatting the fetched logs</item>
	    <item><em><c>return_fetch_dir</c></em> - Indicate that
	    the return value from <c>ttb:stop/1</c> should include
	    the name of the directory where the fetched logs are
	    stored</item> </list> </item> <item> The option
	    <c>disable_sort</c> is added to <c>ttb:format/2</c>. When
	    this option is used, trace messages from different logs
	    are not merged according to timestamps, but just appended
	    one log after the other. </item> </list>
          <p>
	    Own Id: OTP-9403</p>
        </item>
        <item>
          <p>
	    The following non backwards compatible changes are done
	    in <c>ttb</c>:</p>
	    <list> <item> When setting up trace with ttb, the
	    'timestamp' trace flag will now always be set. </item>
	    <item> The 'fetch' option to ttb:stop/1 is removed since
	    it is now default behavior that trace logs are fetched
	    when stopping ttb. Fetching can be disabled with the
	    'nofetch' option to ttb:stop/1. </item> <item> The name
	    of the upload directory is changed from
	    ttb_upload-Timestamp to ttb_upload_FileName-Timestamp.
	    </item> <item> To format the output using 'et', you now
	    need to provide the option {handler,ttb:get_et_handler()}
	    instead of {handler,et}. </item> <item> When formatting a
	    trace log, the handler state was earlier reset after each
	    trace file, this is now changed so the handler state is
	    passed not only from one trace message to the next in the
	    same file, but also from one file to the next. </item>
	    </list>
          <p>
	    *** POTENTIAL INCOMPATIBILITY ***</p>
          <p>
	    Own Id: OTP-9430</p>
        </item>
      </list>
    </section>

</section>

<section><title>Observer 0.9.10</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    Do not install *.bat files on non-win32 machines (Thanks
	    to Hans Ulrich Niedermann)</p>
          <p>
	    Own Id: OTP-9515</p>
        </item>
      </list>
    </section>

</section>

<section><title>Observer 0.9.9</title>

    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
	    The time needed for loading a crashump into the crashdump
	    viewer would earlier grow exponentially with the size of
	    the crashdump file. Reading a file of 20M would take a
	    couple of minutes, and for a dump of 250M it would take
	    between 1 and 2 hours. This has been solved.</p>
          <p>
	    Earlier, all processes, timers, funs or ets-tables would
	    be loaded into the memory of the crashdump viewer node
	    before sending it on to the web server. This has been
	    changed and the pages are now sent to the web server in
	    chunks.</p>
          <p>
	    A security function in newer web browsers prevents a full
	    file path to be sent from an HTML file input field, i.e.
	    the field needed to implement the "Browse" button when
	    loading a file into the crashdump viewer. To overcome
	    this, the file input field is no longer used. Instead a
	    normal text input field is used, and the user needs to
	    manually insert the complete file path. For convenience,
	    a shell script and a batch file are added to the observer
	    application. These can be used to start the
	    crashdump_viewer and a browser and load a file - with the
	    file name given from the command line. The shell script
	    and batch file are called cdv and cdv.bat respectively,
	    and can be found in the priv dir of the observer
	    application.</p>
          <p>
	    Own Id: OTP-9051 Aux Id: seq11789 </p>
        </item>
      </list>
    </section>

</section>

<section><title>Observer 0.9.8.4</title>

    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
	    The multitrace.erl installation example file is now
	    installed in the examples directory. (Thanks to Peter
	    Lemenkov.)</p>
          <p>
	    Own Id: OTP-8857</p>
        </item>
      </list>
    </section>

</section>

<section><title>Observer 0.9.8.3</title>

    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
	    The test suite has been updated for R14A.</p>
          <p>
	    Own Id: OTP-8708</p>
        </item>
      </list>
    </section>

</section>

<section><title>Observer 0.9.8.2</title>

    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
	    Misc updates</p>
          <p>
	    Own Id: OTP-8456</p>
        </item>
      </list>
    </section>

</section>

<section><title>Observer 0.9.8.1</title>

    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
	    Major improvements of the Erlang distribution for Erlang
	    runtime systems with SMP support. Previously distribution
	    port locks were heavily contended, and all encoding and
	    decoding for a specific distribution channel had to be
	    done in sequence. Lock contention due to the distribution
	    is now negligible and both encoding and decoding of
	    Erlang messages can be done in parallel.</p>
          <p>
	    The old atom cache protocol used by the Erlang
	    distribution has been dropped since it effectively
	    prevented all parallel encoding and decoding of messages
	    passed over the same distribution channel.</p>
          <p>
	    A new atom cache protocol has been introduced which
	    isolates atom cache accesses and makes parallel encoding
	    and decoding of messages passed over the same
	    distribution channel possible. The new atom cache
	    protocol also use an atom cache size 8 times larger than
	    before. The new atom cache protocol is documented in the
	    ERTS users guide.</p>
          <p>
	    Erlang messages received via the distribution are now
	    decoded by the receiving Erlang processes without holding
	    any distribution channel specific locks. Erlang messages
	    and signals sent over the distribution are as before
	    encoded by the sending Erlang process, but now without
	    holding any distribution channel specific locks during
	    the encoding. That is, both encoding and decoding can be
	    and are done in parallel regardless of distribution
	    channel used.</p>
          <p>
	    The part that cannot be parallelized is the atom cache
	    updates. Atom cache updates are therefore now scheduled
	    on the distribution port. Since it is only one entity per
	    distribution channel doing this work there is no lock
	    contention due to the atom cache updates.</p>
          <p>
	    The new runtime system does not understand the old atom
	    cache protocol. New and old runtime systems can however
	    still communicate, but no atom cache will be used.</p>
          <p>
	    Own Id: OTP-7774</p>
        </item>
      </list>
    </section>

</section>

<section><title>Observer 0.9.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>
      </list>
    </section>

</section>

  <section>
    <title>Observer 0.9.7.4</title>

    <section>
      <title>Improvements and New Features</title>
      <list type="bulleted">
        <item>
          <p>Minor Makefile changes.</p>
          <p>Own Id: OTP-6689</p>
        </item>
        <item>
          <p>Obsolete guard tests (such as list()) have been replaced
            with the modern guard tests (such as is_list()).</p>
          <p>Own Id: OTP-6725</p>
        </item>
      </list>
    </section>
  </section>

  <section>
    <title>Observer 0.9.7.3</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>Observer 0.9.7.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>Observer 0.9.7.1</title>

    <section>
      <title>Fixed Bugs and Malfunctions</title>
      <list type="bulleted">
        <item>
          <p>Crash dump with large integers could crash the
            <c>crashdump_viewer</c>.</p>
          <p>Own Id: OTP-6301</p>
        </item>
      </list>
    </section>
  </section>

  <section>
    <title>Observer 0.9.7 (R11B)</title>

    <section>
      <title>Fixed Bugs and Malfunctions</title>
      <list type="bulleted">
        <item>
          <p>Fixed a bug in <c>etop</c> which made the Load and Memory
            information in the header incorrect -- for example the
            value shown for <c>binary</c> (memory allocated for
            binaries) was actually the number of currently running
            processes. (Thanks to Rikard Johansson.)</p>
          <p>Own Id: OTP-6075</p>
        </item>
      </list>
    </section>
  </section>

  <section>
    <title>Observer 0.9.6.2</title>

    <section>
      <title>Fixed Bugs and Malfunctions</title>
      <list type="bulleted">
        <item>
          <p>The Observer application has been recompiled because of
            a compiler bug.</p>
          <p>Own Id: OTP-5700</p>
        </item>
      </list>
    </section>
  </section>

  <section>
    <title>Observer 0.9.6.1</title>

    <section>
      <title>Fixed Bugs and Malfunctions</title>
      <list type="bulleted">
        <item>
          <p><c>crashdump_viewer</c> is faster when showing message,
            dictionary, and stack dump for large processes.</p>
          <p>Own Id: OTP-5408</p>
        </item>
      </list>
    </section>
  </section>
</chapter>