aboutsummaryrefslogblamecommitdiffstats
path: root/lib/asn1/doc/src/notes.xml
blob: a00fc3de36f9e1635251bb861d0322f33874a539 (plain) (tree)
1
2
3
4
5
6
7
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
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481





                                        
                                        







                                                                         
 



                                                                            
 











                                                                          



























































                                                                         





































                                                                     

































































                                                                     
















                                                                    




















                                                                   















                                                             


































































                                                                        




























                                                                        




































































                                                                         

























                                                                     


















































                                                                     


















                                                                  























                                                               





































                                                                         
























                                                                     











































                                                                     


















                                                                    







































































































                                                                                          
































                                                                                                          
                                                                                  








































































































































































































































































































































































































































































































































































































































































































                                                                                                       
<?xml version="1.0" encoding="latin1" ?>
<!DOCTYPE chapter SYSTEM "chapter.dtd">

<chapter>
  <header>
    <copyright>
      <year>2004</year><year>2013</year>
      <holder>Ericsson AB. All Rights Reserved.</holder>
    </copyright>
    <legalnotice>
      The contents of this file are subject to the Erlang Public License,
      Version 1.1, (the "License"); you may not use this file except in
      compliance with the License. You should have received a copy of the
      Erlang Public License along with this software. If not, it can be
      retrieved online at http://www.erlang.org/.

      Software distributed under the License is distributed on an "AS IS"
      basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See
      the License for the specific language governing rights and limitations
      under the License.

    </legalnotice>

    <title>asn1 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 asn1 application.</p>


<section><title>Asn1 2.0.4</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    The default value for a <c>BIT STRING</c> would not
	    always be recognized, causing the encoding to be
	    incorrect for the DER/PER/UPER encodings.</p>
          <p>
	    Own Id: OTP-11319</p>
        </item>
        <item>
          <p>
	    The <c>asn1</c> application would fail to build if the
	    <c>.erlang</c> file printed something to standard output.</p>
          <p>
	    Own Id: OTP-11360</p>
        </item>
        <item>
	    <p>An union of integer ranges in an INTEGER constraint
	    could sometimes be interpreted as the intersection of the
	    range.</p>
          <p>
	    Own Id: OTP-11411 Aux Id: seq12443 </p>
        </item>
        <item>
          <p>
	    Extensible, multiple single value constraints (such as
	    <c>INTEGER (1|17, ...)</c>) would be incorrectly encoded.</p>
          <p>
	    Own Id: OTP-11415</p>
        </item>
        <item>
          <p>
	    The ASN.1 compiler would fail to compile a constraint
	    with values given for for the extension part (such as
	    <c>INTEGER (1..10, ..., 11..20)</c>).</p>
          <p>
	    Own Id: OTP-11504</p>
        </item>
      </list>
    </section>


    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
	    The new option '<c>no_ok_wrapper</c>' generates
	    M:encode/2 and M:decode/2 functions that don't wrap the
	    return value in an {ok,...} tuple.</p>
          <p>
	    Own Id: OTP-11314</p>
        </item>
      </list>
    </section>

</section>

<section><title>Asn1 2.0.3</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    Open types greater than 16383 bytes will now be correctly
	    encoded and decoded.</p>
          <p>
	    Own Id: OTP-11262 Aux Id: seq12386, OTP-11223 </p>
        </item>
      </list>
    </section>


    <section><title>Improvements and New Features</title>
      <list>
        <item>
	    <p>For the PER and UPER formats, code generation
	    especially for encoding has been improved.</p>
	    <p>When encoding BIT STRINGs, values longer than the
	    maximum size for the BIT STRING type would be truncated
	    silently - they now cause an exception.</p>
	    <p>Open types greater than 16383 bytes will now be
	    correctly encoded and decoded.</p>
	    <p>IMPORTANT NOTE: For ASN.1 specifications that depend
	    on each other, such as the S1AP-* specifications, it is
	    important to recompile all specifications (compiling some
	    with this version of the compiler and some with an older
	    version will not work).</p>
          <p>
	    Own Id: OTP-11300</p>
        </item>
      </list>
    </section>

</section>

<section><title>Asn1 2.0.2</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    Fix some Makefile rules that didn't support silent rules.
	    Thanks to Anthony Ramine.</p>
          <p>
	    Own Id: OTP-11111</p>
        </item>
        <item>
	    <p>PER/UPER: A semi-constrained INTEGER with a non-zero
	    lower bound would be incorrectly decoded. This bug was
	    introduced in R16.</p>
	    <p>PER/UPER: Given <c>INTEGER (10..MAX, ...)</c>,
	    attempting to decode any integer below 10 would cause the
	    encoder to enter an infinite loop.</p>
	    <p>PER/UPER: For a type with an extensible SIZE
	    constraint, sizes outside of the root range were
	    incorrectly encoded.</p>
	    <p>Given a constraint such as <c>(SIZE (5, ...))</c>,
	    encoding a size less than 5 would fail (PER/UPER).
	    Similarly, for BER decoding would fail.</p>
	    <p>PER: The encoder did not align a known multiplier
	    string (such as IA5String) of length 16 bits (exactly) to
	    an octet boundary.</p>
	    <p>In rare circumstances, DEFAULT values for the UPER
	    backend could be wrongly encoded.</p>
          <p>
	    Own Id: OTP-11134</p>
        </item>
        <item>
	    <p>UPER: The compiler would crash when compiling an
	    ENUMERATED having more than 63 extended values.</p>
	    <p>PER/UPER: A SEQUENCE with more 64 extended values
	    could not be decoded.</p>
          <p>
	    Own Id: OTP-11153</p>
        </item>
        <item>
          <p>
	    When decoding a SEQUENCE defined inline inside a an
	    extension addition group, the record named generated by
	    the decoding code would not match the name in the
	    generated .hrl file.</p>
          <p>
	    Own Id: OTP-11154 Aux Id: seq12339 </p>
        </item>
      </list>
    </section>


    <section><title>Improvements and New Features</title>
      <list>
        <item>
	    <p> Postscript files no longer needed for the generation
	    of PDF files have been removed. </p>
          <p>
	    Own Id: OTP-11016</p>
        </item>
      </list>
    </section>

</section>

<section><title>Asn1 2.0.1.2</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    When an object set is an actual parameter, the extension
	    marker for the object set could get lost (which would
	    cause the decoding of unknown values to fail).</p>
          <p>
	    Own Id: OTP-10995 Aux Id: seq12290 </p>
        </item>
      </list>
    </section>

</section>

<section><title>Asn1 2.0.1.1</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
	    <p>The generated decoder for the 'per' and 'uper'
	    backends did not correctly decode ENUMERATEDs with a
	    single value.</p>
	    <p>The generated encoder for the 'per' and 'uper'
	    backends generated an empty binary for a top-level type
	    that did not need to be encoded (such as an ENUMERATED
	    with a single value). The correct result should be a
	    binary containing a 0 byte.</p>
          <p>
	    Own Id: OTP-10916 Aux Id: seq12270 </p>
        </item>
      </list>
    </section>

</section>

<section><title>Asn1 2.0.1</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    Fixed broken table constraints within a SET OF or
	    SEQUENCE OF for the BER backend.</p>
          <p>
	    Own Id: OTP-10853 Aux Id: seq12245 </p>
        </item>
      </list>
    </section>

</section>

<section><title>Asn1 2.0</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    Encoding SEQUENCEs with multiple extension addition
	    groups with optional values could fail (depending both on
	    the specification and whether all values were provided).</p>
          <p>
	    Own Id: OTP-10664</p>
        </item>
      </list>
    </section>


    <section><title>Improvements and New Features</title>
      <list>
        <item>
	    <p>The options for the ASN.1 compiler has been
	    drastically simplified. The backend is chosen by using
	    <c>ber</c>, <c>per</c>, or <c>uper</c>. The options
	    <c>optimize</c>, <c>nif</c>, and <c>driver</c> are no
	    longer needed. The old options will still work, but will
	    issue a warning.</p>
	    <p>Another change is that generated <c>encode/2</c>
	    function will always return a binary (some backends used
	    to return an iolist).</p>
          <p>
	    *** POTENTIAL INCOMPATIBILITY ***</p>
          <p>
	    Own Id: OTP-10410 Aux Id: kunagi-254 [165] </p>
        </item>
        <item>
          <p>
	    The ASN.1 compiler generates faster decode functions for
	    PER and UPER. Some minor improvements have also been made
	    for PER/UPER encoding, and to the BER backend.</p>
          <p>
	    Own Id: OTP-10519 Aux Id: kunagi-322 [233] </p>
        </item>
        <item>
	    <p>The ASN.1 compiler will now always include necessary
	    run-time functions in the generated Erlang modules
	    (except for <c>asn1rt_nif</c> which is still neeeded). If
	    the option '<c>inline</c>' is used the ASN.1 compiler
	    will generate a warning. But if
	    '<c>{inline,OutputFile}</c>' is use, the ASN.1 compiler
	    will refuse to compile the file. (Use a <c>.set.asn</c>
	    file if you need to remove the output file.)</p>
	    <p>The '<c>BIT STRING</c>' type will now be decoded as
	    Erlang bitstrings by default. Use the new
	    <c>legacy_bit_string</c> option to encode as lists of
	    ones and zeroes. (The <c>compact_bit_string</c> option
	    still works as before.)</p>
	    <p>Open types are now always returned as binaries (when
	    there is no information allowing them to be decoded).</p>
          <p>
	    *** POTENTIAL INCOMPATIBILITY ***</p>
          <p>
	    Own Id: OTP-10588 Aux Id: kunagi-341 [252] </p>
        </item>
      </list>
    </section>

</section>

<section><title>Asn1 1.8.1</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    ASN.1 decoders generated with the options <c>-bber_bin
	    +optimize +nif</c> would decode open types with a size
	    larger than 511 incorrectly. That bug could cause
	    decoding by <c>public_key</c> to fail. The bug was in the
	    NIF library <c>asn1_erl_nif.so</c>; therefore there is no
	    need re-compile ASN.1 specifications that had the
	    problem.</p>
          <p>
	    Own Id: OTP-10805 Aux Id: seq12244 </p>
        </item>
        <item>
          <p>
	    Encoding SEQUENCEs with multiple extension addition
	    groups with optional values could fail (depending both on
	    the specification and whether all values were provided).</p>
          <p>
	    Own Id: OTP-10811 Aux Id: OTP-10664 </p>
        </item>
      </list>
    </section>

</section>

<section><title>Asn1 1.8</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    Encoding and decoding of integer ranges can now be done
	    with an upper bound larger than the previous limit of
	    16^10. The new upper bound in per encoding and decodings
	    for constrained whole numbers is 2^2040 (close to 16^508)</p>
          <p>
	    Own Id: OTP-10128</p>
        </item>
        <item>
          <p>
	    Per encoding/decoding now works correctly for single
	    value subtyping of an integer type where a subtype is a
	    predefined value. Previously a predefined value could
	    cause a non-valid range-check in the generated Erlang
	    code for per encoding/decoding due to a bug in the
	    constraint checking.</p>
          <p>
	    Own Id: OTP-10139</p>
        </item>
        <item>
          <p>
	    Fix typo error in selected decode function (Thanks to
	    Artem Teslenko)</p>
          <p>
	    Own Id: OTP-10152</p>
        </item>
        <item>
          <p>
	    Better error indication when detecting unexpected tags
	    during decoding of BER encoded data.</p>
          <p>
	    Own Id: OTP-10186</p>
        </item>
        <item>
          <p>
	    asn1rt_check: Fix transform_to_EXTERNAL1990 for binary
	    input (Thanks to Harald Welte)</p>
          <p>
	    Own Id: OTP-10233</p>
        </item>
      </list>
    </section>


    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
	    Add support for multiple ExtensionAdditionGroups</p>
          <p>
	    Own Id: OTP-10058</p>
        </item>
        <item>
          <p>
	    Add support for extensible enumeration types in n2n
	    generated functions.</p>
          <p>
	    Own Id: OTP-10144</p>
        </item>
      </list>
    </section>

</section>

<section><title>Asn1 1.7</title>

    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
	    Some ASN.1 INTEGER type and SEQUENCE constructor variants
	    previously not handled by the ASN.1 compiler are now
	    correctly handled</p>
          <p>
	    Own Id: OTP-9688</p>
        </item>
        <item>
          <p>
	    An INTEGER with a value constraint where unions are used
	    e.g. X1 ::= INTEGER (1..4 | 6 | 8 | 10 | 20) is not
	    handled correctly. For PER the value is encoded in wrong
	    number of bits.</p>
          <p>
	    Own Id: OTP-9946</p>
        </item>
      </list>
    </section>

</section>

<section><title>Asn1 1.6.19</title>

    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
	    The linked-in driver used for ber decode and per encode
	    has been replaced with nifs. To enable the usage of nifs
	    pass the nif option to erlc or asn1rt:compile when
	    compiling. If you previously used the linked-in driver,
	    you have to recompile your ASN1 modules with the current
	    version of asn1 application as the linked-in driver
	    modules have been removed.</p>
          <p>
	    *** POTENTIAL INCOMPATIBILITY ***</p>
          <p>
	    Own Id: OTP-9419</p>
        </item>
        <item>
          <p>
	    A few of the heavy calculations which are done for
	    encoding and decoding operations when dealing with
	    SEQUENCE OF and DEFAULT in runtime have been moved to be
	    done in compile time instead.</p>
          <p>
	    Own Id: OTP-9440</p>
        </item>
        <item>
          <p>
	    When compiling an ASN.1 ber module with the +nif option,
	    the module will use a new nif for ber encoding,
	    increasing performance by about 5%.</p>
          <p>
	    Own Id: OTP-9441</p>
        </item>
        <item>
          <p>
	    Tuple funs (a two-element tuple with a module name and a
	    function) are now officially deprecated and will be
	    removed in R16. Use '<c>fun M:F/A</c>' instead. To make
	    you aware that your system uses tuple funs, the very
	    first time a tuple fun is applied, a warning will be sent
	    to the error logger.</p>
          <p>
	    Own Id: OTP-9649</p>
        </item>
      </list>
    </section>

</section>

<section><title>Asn1 1.6.18</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    Implement or fix -Werror option</p>
          <p>
	    If -Werror is enabled and there are warnings no output
	    file is written. Also make sure that error/warning
	    reporting is consistent. (Thanks to Tuncer Ayaz)</p>
          <p>
	    Own Id: OTP-9536</p>
        </item>
      </list>
    </section>

</section>

<section><title>Asn1 1.6.17</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    Test cases which started failing when timer:tc was
	    changed to not catch are corrected.</p>
          <p>
	    Own Id: OTP-9286</p>
        </item>
        <item>
          <p>
	    The bounds checking in the asn1_erl_driver when the
	    length value of a TLV is a Long Definite Length is
	    corrected. Thanks to Vance Shipley.</p>
          <p>
	    Own Id: OTP-9303</p>
        </item>
      </list>
    </section>

</section>

<section><title>Asn1 1.6.16</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    asn1ct: Make formatting of errors and warnings consistent</p>
          <p>
	    Consistently format warning and error reports. Warning
	    and error options from erlc now also work in asnc1ct.
	    (thanks to Tuncer Ayaz)</p>
          <p>
	    Own Id: OTP-9062</p>
        </item>
        <item>
          <p>
	    Shut off some dialyzer warnings</p>
          <p>
	    Own Id: OTP-9063</p>
        </item>
      </list>
    </section>


    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
	    Crash in asn1ct_check, componentrelation_leadingattr
	    fixed. (Thanks to Stephane Pamelard for finding the bug)</p>
          <p>
	    Own Id: OTP-9092</p>
        </item>
      </list>
    </section>

</section>

<section><title>Asn1 1.6.15</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    The encoding of ExtensionAdditionGroup (for PER and UPER)
	    is corrected.</p>
          <p>
	    Own Id: OTP-8866 Aux Id: OTP-8797, SEQ-11557 </p>
        </item>
        <item>
          <p>
	    A race condition when several processes in parallel start
	    to do encode/decode using the driver could cause an error
	    log regarding crashing port owner process. This race is
	    now eliminated.</p>
          <p>
	    Own Id: OTP-8948 Aux Id: seq11733 </p>
        </item>
      </list>
    </section>

</section>

<section><title>Asn1 1.6.14.1</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    Extension Addition Groups are now supported by the parser
	    and in all backends.</p>
          <p>
	    Own Id: OTP-8598 Aux Id: seq-11557 </p>
        </item>
        <item>
          <p>
	    Extension Addition Groups are now supported in nested
	    types within a SEQUENCE and CHOICE as well (missed that
	    in previous fix)</p>
          <p>
	    Own Id: OTP-8797 Aux Id: seq-11557 </p>
        </item>
      </list>
    </section>


    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
	    Bug in UNALIGNED PER regarding encoding and decoding of
	    constrained numbers with a valuerange > 1024. (Thanks to
	    Vincent de Phily)</p>
          <p>
	    Own Id: OTP-8779</p>
        </item>
        <item>
          <p>
	    Minor corrections in the User Guide.</p>
          <p>
	    Own Id: OTP-8829</p>
        </item>
      </list>
    </section>

</section>

<section><title>Asn1 1.6.14</title>

    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
	    By default, the ASN.1 compiler is now silent in the
	    absence of warnings or errors. The new '<c>verbose</c>'
	    option or the '<c>-v</c>' option for <c>erlc</c> can be
	    given to show extra information (for instance, about the
	    files that are generated). (Thanks to Tuncer Ayaz.)</p>
          <p>
	    Own Id: OTP-8565</p>
        </item>
      </list>
    </section>

</section>

<section><title>Asn1 1.6.13</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    Harmless buffer overflow by one byte in asn1 and
	    ram_file_drv.</p>
          <p>
	    Own Id: OTP-8451</p>
        </item>
      </list>
    </section>


    <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>
	    Add support for prefixing macro names generated by the
	    compiler</p>
          <p>
	    This is useful when multiple protocols that contains
	    macros with identical names are included in a single
	    module.</p>
          <p>
	    Add the missing <c>record_name_prefix</c> compiler option
	    to the documentation.</p>
          <p>
	    Own Id: OTP-8453</p>
        </item>
        <item>
          <p>
	    Cleanups suggested by tidier and modernization of types
	    and specs.</p>
          <p>
	    Own Id: OTP-8455</p>
        </item>
        <item>
          <p>
	    Support for <c>EXTENSIBILITY IMPLIED</c> and <c>SET/SEQ
	    OF NamedType</c> is added.</p>
          <p>
	    Own Id: OTP-8463</p>
        </item>
      </list>
    </section>

</section>

<section><title>Asn1 1.6.12</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-8256</p>
        </item>
      </list>
    </section>

</section>


<section><title>Asn1 1.6.11</title>

    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
            A new option <c>{n2n,TypeName}</c> can be used to
	    enable generation of conversion functions from name to number 
	    and vice versa for selected ENUMERATION types. 
	    The option can be repeated many times in order to specify several 
	    types in the same file.<br/>
	    If the <c>TypeName</c> specified does not exists or is not an 
	    ENUMERATION type, the compilation will be terminated with an 
	    error code.<br/>
	    Below follows an example on how to use the option from the command line with <c>erlc</c>:<br/>
	    <c>erlc -bper+"{n2n,'CauseMisc'}" +"{n2n,'CausePcl'}" MyModyle.asn</c>
	  </p>
          <p>
            Own Id: OTP-8136 Aux Id: seq11347 </p>
        </item>
        <item>
          <p>
            Range checks added for BIT STRING with fixed SIZE
            constraint.</p>
          <p>
            Own Id: OTP-7972 Aux Id: seq11280 </p>
        </item>
        <item>
          <p>
            Now support multiple-line comments in asn1-specs as
            specified in ASN1 X.680 (07/2002), section 11.6.4</p>
          <p>
            Own Id: OTP-8043</p>
        </item>
        <item>
          <p>
            Now parses and adds abstract syntax for PATTERN subtype
            constraint. No other action is taken on this type of
            constraint.</p>
          <p>
            Own Id: OTP-8046</p>
        </item>
        <item>
          <p>
            The ASN1 subtype constraint <c>CONTAINING Type</c>,
            <c>CONTAINING Type ENCODED BY Value</c> and <c>ENCODED BY
            Value</c> now is parsed. Abstract syntax is added but no
            further action in generated code is taken.</p>
          <p>
            Own Id: OTP-8047</p>
        </item>
      </list>
    </section>

</section>

<section><title>Asn1 1.6.10</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
            A faulty receive case that catch-ed all messages in the
            initialization of the driver has been removed, the
            initialization has been restructured.</p>
          <p>
            Own Id: OTP-7954 Aux Id: seq11220 </p>
        </item>
      </list>
    </section>


    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
            The anonymous part of the decode that splits the ASN1 TLV
            into Tag Value tuples has been optimized.</p>
          <p>
            Own Id: OTP-7953</p>
        </item>
      </list>
    </section>

</section>

<section><title>Asn1 1.6.9</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
            Error that caused crash when drivers were loaded is now
            corrected. Parallel driver for asn1 now enabled.</p>
          <p>
            Own Id: OTP-7904 Aux Id: seq11220 </p>
        </item>
      </list>
    </section>


    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
            Optimized code for ENUMERATION type in encoder/decoder.</p>
          <p>
            Own Id: OTP-7909</p>
        </item>
      </list>
    </section>

</section>

<section><title>Asn1 1.6.8.1</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
            Removed parallel-driver functionality due to failure
            when loading the driver.</p>
          <p>
            Own Id: OTP-7900 Aux Id: seq11220 </p>
        </item>
      </list>
    </section>


    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
            Generated code now uses guards that is not obsolete, e.g.
            <c>is_integer/1</c> instead of <c>integer/1</c>.</p>
          <p>
            Own Id: OTP-7910</p>
        </item>
      </list>
    </section>

</section>

 
<section><title>Asn1 1.6.8</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
            A BIT STRING with a size constraint that has a single
            value and an extension as in <c> BIT STRING (SIZE
            (16,...))</c> was erroneous encoded/decoded. This is now
            corrected and follows X.691 Section 15.6.</p>
          <p>
            Own Id: OTP-7876 Aux Id: seq11220 </p>
        </item>
      </list>
    </section>

</section>
 <section><title>Asn1 1.6.7</title>

    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
            Now asn1 starts multiple drivers to enable simultaneous
            encode/decode in different processes for the
            asn1-backends using linked-in driver.</p>
          <p>
            Own Id: OTP-7801</p>
        </item>
      </list>
    </section>

</section>

<section><title>Asn1 1.6.6</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
	    Decode of an open_type when the value was empty tagged
	    type encoded with indefinite length failed. This is now
	    corrected.</p>
          <p>
	    Own Id: OTP-7759 Aux Id: seq11166 </p>
        </item>
        <item>
          <p>
	    Encode of BIT STRING with size of exact length, on
	    compact_bit_string format in UNALIGNED PER failed when
	    value had the right size, i.e. no padding needed.</p>
          <p>
	    Own Id: OTP-7763 Aux Id: seq11182 </p>
        </item>
      </list>
    </section>

</section>

<section><title>Asn1 1.6.5</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
            For a BIT STRING with SIZE constraint higher than 255
            compiled with <c>[per_bin,optimize,
            compact_bit_string]</c> an improper io-list was created
            and sent to the c-driver for complete encoding. This
            error has been resolved.</p>
          <p>
            Own Id: OTP-7734 Aux Id: seq11170 </p>
        </item>
      </list>
    </section>

</section>

<section><title>Asn1 1.6.4</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
            A a SEQUENCE OF with a type that is a CHOICE with
            ellipses occurred falsely a compile error. The error
            causing that is now removed.</p>
          <p>
            Own Id: OTP-7708 Aux Id: seq11136 </p>
        </item>
      </list>
    </section>

</section>
 
<section><title>Asn1 1.6.3</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
            constrained number with a value-range greater than 512 now
            has the proper interpretation of the values that causes
            shift to the next number of units (bits), According to
            limit condition <c>2^m &lt; "range" =&lt; 2^(m + 1)</c> then the
            number of bits are m + 1.</p>
          <p>
            Own Id: OTP-7681 Aux Id: seq11114 </p>
        </item>
      </list>
    </section>


    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
            Can now handle default values of simple types that is
            provided on its own format, i.e. not just as
            asn1_DEFAULT.</p>
          <p>
            Own Id: OTP-7678 Aux Id: seq11114 </p>
        </item>
      </list>
    </section>

</section>

<section><title>Asn1 1.6.2</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
            comparison of two value definitions failed due to new
            module name field in valuedef record. It is now
            corrected.</p>
          <p>
            Own Id: OTP-7608</p>
        </item>
      </list>
    </section>

</section>
 
<section><title>Asn1 1.6.1</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
            Bug regarding propagation of parameters of parameterized
            type fixed.</p>
          <p>
            Own Id: OTP-7174 Aux Id: seq10864 </p>
        </item>
        <item>
          <p>
            A bug, related to instantiation of a parameterized type
            with a type definition in the parameter-list, has been
            removed. The definition of the parameter type was in
            another module than the instance definition causing
            limited module info.</p>
          <p>
            Own Id: OTP-7299 Aux Id: seq10864 </p>
        </item>
        <item>
          <p>
            Removed hard-coded name that may cause name collision.</p>
          <p>
            Own Id: OTP-7322 Aux Id: seq10864 </p>
        </item>
        <item>
          <p>
            Object set of a class with id with properties UNIQUE
            OPTIONAL and the id field is lacking in the object is for
            now treated as a object without a unique identifier, i.e.
            no table is generated for this object.</p>
          <p>
            Own Id: OTP-7332 Aux Id: seq10864 </p>
        </item>
        <item>
          <p>
            Compiler crashed when failed to handle a OID as
            ValueFromObject.</p>
          <p>
            Own Id: OTP-7476 Aux Id: seq10999 </p>
        </item>
        <item>
          <p>
            A corrupted encoding may cause a loop when a buffer of at
            least two bytes of zero matches tag and length of a SET
            component. This behavior occurred only with decoder
            generated with <c>ber</c> or <c>ber_bin</c> options. Now a
            control breaks the loop.</p>
          <p>
            Own Id: OTP-7533</p>
        </item>
        <item>
          <p>
            Encode of BIT STRING longer than 255 bits with a
            <c>SIZE(integer())</c> constraint caused a crash when
            spec was compiled with <c>per_bin, optimize</c> options.</p>
          <p>
            Own Id: OTP-7602 Aux Id: seq11079 </p>
        </item>
      </list>
    </section>


    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
            Now supports REAL type of base 2 and 10</p>
          <p>
            Own Id: OTP-7166 Aux Id: seq10864 </p>
        </item>
        <item>
          <p>
            By the asn1 compiler option <c>{record_name_prefix
            Name}</c> a prefix is chosen to the name of the record
            generated in the .hrl and used in the generated .erl
            files.</p>
          <p>
            Own Id: OTP-7204 Aux Id: seq10853 </p>
        </item>
        <item>
          <p>
            The TypeFromObject production now covered</p>
          <p>
            Own Id: OTP-7295 Aux Id: seq10468 </p>
        </item>
        <item>
          <p>
            Extended support for ObjectSetFromObjects. Production
            occurred as a part of the RootElementSetSpec of the
            ObjectSetSpec. Added also support for Exclusion of
            Element in ObjectSetSpec.</p>
          <p>
            Own Id: OTP-7306 Aux Id: seq10864 </p>
        </item>
        <item>
          <p>
            Now implements RELATIVE-OID</p>
          <p>
            Own Id: OTP-7334 Aux Id: seq10864 </p>
        </item>
      </list>
    </section>

</section>

<section><title>Asn1 1.6</title>
 
    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
            Now is ordering, according to the canonical order, of
            components in a SET added. Canonical order is described
            in X.691 9.2 and X.680 8.6</p>
          <p>
            Own Id: OTP-7375 Aux Id: unaligned PER </p>
        </item>
        <item>
          <p>
            The precedence rules for extended constraints have been
            misinterpreted. The rule says for instance that if there
            are more than one constraint on a type that have
            extension-mark, only the last of the extension-marks would
            be kept. This affects the encoding of PER and is now
            corrected.</p>
          <p>
            Own Id: OTP-7400 Aux Id: OTP-7335 </p>
        </item>
        <item>
          <p>
            A constrained number with a single-value constraint that
            is extensible was falsely encoded/decoded in
            aligned/unaligned PER. This is now corrected.</p>
          <p>
            Own Id: OTP-7403</p>
        </item>
      </list>
    </section>
 
 
    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
            The ASN.1 compiler has got a new backend supporting PER
            UNALIGNED. Previously it was only support for PER
            ALIGNED.</p>
          <p>
            Own Id: OTP-7335</p>
        </item>
        <item>
          <p>
            Now the asn1-compiler handles unions and intersections of
            PermittedAlphabet constraints.</p>
          <p>
            Own Id: OTP-7374 Aux Id: unaligned PER </p>
        </item>
	<item>
          <p>
            With the undocumented option <c>no_final_padding</c> the
            whole encoded message is not padded to a border of a
            byte. Thus the returned encoded message is a
            <c>bitstring</c>.</p>
          <p>
            Own Id: OTP-7407</p>
        </item>
      </list>
    </section>
 
</section>

<section><title>Asn1 1.5.2</title>
 
    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
            When duplicates of object fields were removed only one
            table access function for each unique identifier value
            was generated. This can occur when several object sets
            are merged by use of ObjectSetFromObjects.</p>
          <p>
            Own Id: OTP-7263 Aux Id: seq10864 </p>
        </item>
        <item>
          <p>
            DER: For some complex types and components with reference
            to type in several steps the default value check function
            was not generated. This is now fixed.</p>
          <p>
            Own Id: OTP-7268 Aux Id: seq10684 </p>
        </item>
        <item>
          <p>
            Now is the tag in a tagged type as parameter propagated
            to the instance.</p>
          <p>
            Own Id: OTP-7273 Aux Id: seq10864 </p>
        </item>
      </list>
    </section>
 
 
    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
            Added type T61String that is similar to TeletexString</p>
          <p>
            Own Id: OTP-7264 Aux Id: seq10864 </p>
        </item>
      </list>
    </section>
 
</section>


<section><title>Asn1 1.5.1</title>
 
    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
            A bug related to renaming of types has been fixed.This
            occurred using the .set.asn functionality.</p>
          <p>
            Own Id: OTP-7149 Aux Id: seq10853 </p>
        </item>
        <item>
          <p>
            syntax error in ASN1 value now correctly shown</p>
          <p>
            Own Id: OTP-7154 Aux Id: seq10864 </p>
        </item>
        <item>
          <p>
            Now a COMPONENTS OF construct in a parameterized type
            is expanded correctly</p>
          <p>
            Own Id: OTP-7155 Aux Id: seq10864 </p>
        </item>
        <item>
          <p>
            Now the asn1-compiler also handles empty SEQUENCE DEFAULT
            values as <c>{}</c>.</p>
          <p>
            Own Id: OTP-7169 Aux Id: seq10864 </p>
        </item>
        <item>
          <p>
            Now SelectionType gets the tag of the selected type.</p>
          <p>
            Own Id: OTP-7171 Aux Id: seq10864 </p>
        </item>
        <item>
          <p>
            Correction of generated code for decode of an open type
            in a SEQUECNE OF/ SET OF</p>
          <p>
            Own Id: OTP-7193 Aux Id: seq10875 </p>
        </item>
      </list>
    </section>

    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
            Misc improvements and bug corrections regarding default
            values.</p>
          <p>
            Own Id: OTP-7199 Aux Id: seq10864 </p>
        </item>
      </list>
    </section>
 

 
</section>
                                                                                
<section><title>Asn1 1.5</title>

    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
            Now generating records in .hrl file for instances of
            parameterized SEQUENCE or SET.</p>
          <p>
            Own Id: OTP-6835</p>
        </item>
        <item>
          <p>
            Optimization using bitstr in encode/decode functions. Active with
            <c>[per_bin, optimize]</c> options.</p>
          <p>
            *** POTENTIAL INCOMPATIBILITY ***</p>
          <p>
            Own Id: OTP-6882</p>
        </item>
      </list>
    </section>

</section>

<section><title>Asn1 1.4.6</title>

    <section><title>Fixed Bugs and Malfunctions</title>
      <list>
        <item>
          <p>
            Parsing and encoding/decoding of type constrained with
            SIZE with extension is now recovered.</p>
          <p>
            Own Id: OTP-6763</p>
        </item>
        <item>
          <p>
            <c>inline</c> failed because trying to use a removed
            module.</p>
          <p>
            Own Id: OTP-6769</p>
        </item>
        <item>
          <p>
            Fixed problem with a reference to a type from an object.
            The failure was caused bye change of type name when using
            <c>inline</c> option.</p>
          <p>
            Own Id: OTP-6770</p>
        </item>
        <item>
          <p>
            Handling of decode pattern for exclusive decode was false
            in the case when an un-decoded component had more than one
            following elements that should be decoded.</p>
          <p>
            Own Id: OTP-6786</p>
        </item>
      </list>
    </section>


    <section><title>Improvements and New Features</title>
      <list>
        <item>
          <p>
            Now the asn1-compiler supports two root lists in SEQUENCE
            and SET according to alternative three in
            ComponentTypeLists (X.680 07/2002 section 24.1), i.e.
            with an extension list between two ellipses.</p>
          <p>
            Own Id: OTP-5067 Aux Id: seq8452 </p>
        </item>
      </list>
    </section>

</section>

  <section>
    <title>Asn1 1.4.5</title>

    <section>
      <title>Fixed Bugs and Malfunctions</title>
      <list type="bulleted">
        <item>
          <p>Merging modules by <c>inline</c> earlier disabled the
            driver (used in modules generated with
            [optimized]/[optimized,driver] options). Now this is
            repaired.</p>
          <p>Own Id: OTP-6601</p>
        </item>
        <item>
          <p>Checking phase now aware of which module an INSTANCE OF
            is declared in.</p>
          <p>Own Id: OTP-6702</p>
        </item>
      </list>
    </section>

    <section>
      <title>Improvements and New Features</title>
      <list type="bulleted">
        <item>
          <p>The compiler now handle all forms of ObjectSetSpec
            according to ITU-T recommendation X.681 (ISO/IEC
            8824-2:2002).</p>
          <p>Own Id: OTP-6698</p>
        </item>
        <item>
          <p>Enhanced support of referencing object sets by
            ObjectSetFromObjects.</p>
          <p>Own Id: OTP-6707</p>
        </item>
        <item>
          <p>Support for parameterized object in an object set.</p>
          <p>Own Id: OTP-6717</p>
        </item>
      </list>
    </section>

    <!-- p>There are also release notes for <url href="notes_history.html">older versions</url>.</p -->
  </section>
</chapter>