From 0b340619c90d7b55189fcb06a46ff64e594d3a97 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Bj=C3=B6rn=20Gustavsson?= Date: Sun, 6 Dec 2009 15:59:55 +0000 Subject: asn1 documentation: remove unused files --- lib/asn1/doc/src/Makefile | 4 +- lib/asn1/doc/src/note.gif | Bin 1539 -> 0 bytes lib/asn1/doc/src/notes_history.xml | 1782 ------------------------------------ lib/asn1/doc/src/part_notes.xml | 39 - lib/asn1/doc/src/warning.gif | Bin 1498 -> 0 bytes 5 files changed, 1 insertion(+), 1824 deletions(-) delete mode 100644 lib/asn1/doc/src/note.gif delete mode 100644 lib/asn1/doc/src/notes_history.xml delete mode 100644 lib/asn1/doc/src/part_notes.xml delete mode 100644 lib/asn1/doc/src/warning.gif (limited to 'lib/asn1') diff --git a/lib/asn1/doc/src/Makefile b/lib/asn1/doc/src/Makefile index be8755f0ff..d29225f6c9 100644 --- a/lib/asn1/doc/src/Makefile +++ b/lib/asn1/doc/src/Makefile @@ -51,9 +51,7 @@ XML_REF3_FILES = asn1ct.xml \ GEN_XML = \ asn1_spec.xml -XML_PART_FILES = \ - part.xml \ - part_notes.xml +XML_PART_FILES = part.xml XML_HTML_FILE = \ notes_history.xml diff --git a/lib/asn1/doc/src/note.gif b/lib/asn1/doc/src/note.gif deleted file mode 100644 index 6fffe30419..0000000000 Binary files a/lib/asn1/doc/src/note.gif and /dev/null differ diff --git a/lib/asn1/doc/src/notes_history.xml b/lib/asn1/doc/src/notes_history.xml deleted file mode 100644 index e6c423e79e..0000000000 --- a/lib/asn1/doc/src/notes_history.xml +++ /dev/null @@ -1,1782 +0,0 @@ - - - - -
- - 20062009 - Ericsson AB. All Rights Reserved. - - - 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. - - - - ASN1 Release Notes - Bertil Karlsson - - - - - 06-04-24 - - notes_history.sgml -
-

This document describes the changes made to the asn1 system - from version to version. The intention of this document is to - list all incompatibilities as well as all enhancements and - bug-fixes for every release of the asn1 application. Each release of asn1 - thus constitutes one section in this document. The title of each - section is the version number of asn1.

- - -
- Asn1 1.4.4.14 - -
- Improvements and New Features - - -

Data in info/0 in generated code is moved to attribute - asn1_info, thus vsn value remains the same if compiler - options for asn1-spec differs but the generated code is - the same.

-

Own Id: OTP-6462

- - -

Dialyzer warnings on asn1 are removed, i.e. dead code - removed.

-

Own Id: OTP-6506

- - -
-
- -
- Asn1 1.4.4.13 - -
- Improvements and New Features - - -

Now it is possible to use 'asn1config' and 'inline' - options together. It is also possible to use 'inline' on - a single file like: - asn1ct:compile("MyASN1spec.asn",[inline]).

-

Own Id: OTP-6405

- - -
-
- -
- Asn1 1.4.4.12 - -
- Improvements and New Features - - -

As a complement to the option "{inline,OutputFile}" it is - now possible to use the option "inline". Then asn1 creates - an output file with the name of the source .set file.

-

Own Id: OTP-6314

- - -
-
- -
- Asn1 1.4.4.11 - -
- Fixed Bugs and Malfunctions - - -

When compiling an asn1 source that reference a type in - another source the compiler uses the asn1db file of the - other source to resolve the reference. It also tests - whether the other source has been updated since the - asn1db file was generated. This last test was to brutal - in that it exits compilation when no source was found, - even though a asn1db file existed. Changed behavior from - a brutal exit to a warning.

-

Own Id: OTP-6143

- - -
-
- -
- Asn1 1.4.4.10 - -
- Fixed Bugs and Malfunctions - - -

asn1 encoding failed on BIT STRING with constraint - (SIZE (32..MAX)).

-

Own Id: OTP-5932

- - -

Race condition removed in server for variable names for - generated code.

-

Own Id: OTP-6111

- - -
-
- -
- Asn1 1.4.4.9 - -
- Fixed Bugs and Malfunctions - - -

Now exists a default function clause for table lookup of - a table constraint. This causes a nice error instead of a - crash. Did also remove some obsolete funs ({Mod,Fun}) in - generated code.

-

Own Id: OTP-5783

- - -

ASN1-compiler failed to derive a value out of an external - reference in some certain cases, when compiling specs so - that the spec with the reference was compiled before the - spec with the defined value.

-

Own Id: OTP-5812 Aux Id: seq10133

- - -

The documentation of how records of embedded types are - named is extended and made clearer by examples and rules. - The section "Naming of Records in .hrl Files" in the - User's Guide is added.

-

Own Id: OTP-5831 Aux Id: seq10133

- - -

The compiler failed to give right name to record/function - of a parameterized type that was referenced through - another instance of a parameterized type in another - module. The fault occurred when modules were compiled in a - certain order. Now the compiler resolves the name - correctly.

-

Own Id: OTP-5832 Aux Id: seq10133

- - -
-
- -
- Asn1 1.4.4.8 - -
- Fixed Bugs and Malfunctions - - -

The dynamic sort of SET OF values now correctly handles - values encoded in the "ber_bin, der, optimize" mode, the - value of a SET OF is a list of binaries.

-

Own Id: OTP-5687

- - -

Bad code was generated for an INTEGER with value-range. If - the value that was encoded had a lower bound with - negative value it caused a crash. This bug is now - removed.

-

Own Id: OTP-5688 Aux Id: seq10049

- - -

Compiler now handles wrong include paths by returning an - error if a referenced module is not available.

-

Own Id: OTP-5689

- - -

The bug causing a runtime error when encoding a type - defined by: BIT STRING {a(1),b(2)} with the value - [] in per_bin mode is now removed.

-

Own Id: OTP-5710 Aux Id: seq10066

- - -
- -
- Improvements and New Features - - -

Better handling of filename paths

-

Own Id: OTP-5701

- - -
-
- -
- Asn1 1.4.4.7 - -
- Fixed Bugs and Malfunctions - - -

Effective constraint for per now corrected. For - instance INTEGER (0|15..269) didn't work properly.

-

Own Id: OTP-5477 Aux Id: OTP-5511

- - -

Adjusted compiler so that functions in generated code - only are exported once.

-

Own Id: OTP-5509

- - -

Fixed the compiler failure when handling a value range - constraint with an extension mark that had the Lower - bound and/or Upper bound values as an external reference - to a defined value.

-

Own Id: OTP-5511 Aux Id: OTP-5466

- - -

Removed sorting of elements for SEQUENCE OF. It shall - only be done in SET OF.

-

Own Id: OTP-5602

- - -

Corrected code that generated code causing badarith - warning.

-

Own Id: OTP-5616

- - -
-
- -
- Asn1 1.4.4.6 - -
- Known Bugs and Problems - - -

Compiler now correctly crashes when compiling bad values. - Failed for instance on INTEGER value that was a reference - to a defined value. Also solved problem with a union - constraint on an INTEGER.

-

Own Id: OTP-5457

- - -

Additional coverage of object set syntax.

-

Own Id: OTP-5466

- - -
-
- -
- Asn1 1.4.4.5 - -
- Fixed Bugs and Malfunctions - - -

A bug due to representation of open_type values is now - fixed. It could cause problem if one used the EXTERNAL - type.

-

Own Id: OTP-5302

- - -

Due to an internal error the same code could have been - generated more than one time. This happened for the - exclusive decode functionality.

-

Own Id: OTP-5378

- - -
-
- -
- Asn1 1.4.4.4 - -
- Fixed Bugs and Malfunctions - - -

Empty objects caused problems. There was trouble when an - object set referenced imported objects that in turn - referenced imported types. Lacked support of - SelectionType in object. All these have been attended.

-

Own Id: OTP-5240

- - -
- -
- Improvements and New Features - - -

Now it is possible to inline asn1 run-time functionality - in the module generated by the asn1 compiler. Thus, it - will be only one module doing all encoding/decoding.

-

Own Id: OTP-5243

- - -
-
- -
- Asn1 1.4.4.3 - -
- Fixed errors and malfunctions - - -

A class that was referenced in two steps caused a - compiler failure. It is now corrected.

-

Own Id: OTP-5103

- - -
- -
- Improvements and new features - - -

Optionally make it possible to get the un-decoded rest along with - the return value. Compile with option undec_rest.

-

Own Id: OTP-5104

- - -
-
- -
- Asn1 1.4.4.2 - -
- Fixed errors and malfunctions - - -

An error due to unchecked referenced imported type resulted - in missing tag in some table constraint cases. This error is - now corrected. Error occurred during decode in - ber_bin optimized version.

-

Own Id: OTP-5022

- - -
-
- -
- Asn1 1.4.4.1 - -
- Fixed errors and malfunctions - - -

When a referenced value in another module in turn referenced a - defined value the compilation crashed. This is due to the new - routines for compilation, that external references are resolved - during compilation, and not by the order in which modules are - compiled. This error is now corrected.

-

Own Id: OTP-4970

- - -
-
- -
- Asn1 1.4.4 - -
- Fixed errors and malfunctions - - -

Functionality for parameterized class is added. Parsing failures on - WithSyntax spec is corrected.

-

Own Id: OTP-4893

- - -

The failure due to Parameterized Type when parameter is an object - set is corrected.

-

Own Id: OTP-4894

-

Aux Id: OTP-4893

- - -

Object Identifier values with two components and the first was a - value reference failed due to parsing conflicts. Now it is - corrected.

-

Own Id: OTP-4895

- - -

The erroneous comparison of file name and asn1 module name could - cause compilation failure. The situation for this failure is rare, - it requires that other processes modifies the compiled file during - the compilation procedure. It is now fixed.

-

Own Id: OTP-4944

-

Aux Id: seq8429

- - -

Selective decode was ignored when exclusive decode spec in asn1 - configfile was missing. Selective decode failed when the selected - type was the top type. These bugs are now removed.

-

Own Id: OTP-4953

-

Aux Id: seq8436

- - -

The test interface asn1ct:test/1,2,3 and asn1ct:value/2 failed for - open type and EXTERNAL. The bug is now removed.

-

Own Id: OTP-4955

-

Aux Id: seq8438)

- - -

Two equal functions were generated for two components referencing - the same type when they were picked by the action "parts". The bug - is now fixed.

-

Own Id: OTP-4957

-

Aux Id: seq8434

- - -
- -
- Improvements and new features - - -

INTEGER with named number list and ENUMERATED can now be sub - constrained with names from the names list.

-

Own Id: OTP-4917

- - -

Now there is support for SelectionType (X 680 section 29)

-

Own Id: OTP-4918

- - -

The compiler now resolves circular dependencies. When asn1 specs - IMPORTS from each other so that there are circular dependencies.

-

Own Id: OTP-4919

- - -

Now is the asn1 type UTF8String supported. For user instructions - see documentation.

-

Own Id: OTP-4965

- - -
-
- -
- Asn1 1.4.3.1 - -
- Fixed Bugs and Malfunctions - - -

The {internal_error,...,{ unrecognized_type,...}} - error occurring for a SET type when compiling with options - [ber_bin,optimize,der] is now corrected.

-

Own Id: OTP-4866

- - -

False encode of BIT STRING in PER (per_bin,optimize) is fixed. The error occurred when there was a type like BIT STRING (SIZE(C)) and C > 16.

-

Own Id: OTP-4869

- - -
-
- -
- Asn1 1.4.3 - -
- Fixed errors and malfunctions - - -

Functionality to handle parameterized object sets have been added.

-

Own Id: OTP-4832

- - -

Bug causing duplicated function definitions using exclusive decode is removed.

-

Own Id: OTP-4833)

- - -

The race condition when loading asn1 driver is solved.

-

Own Id: OTP-4835

- - -
- -
- Improvements and new features - - -

A specialized decode, selective decode is now available. It decodes a chosen internal sub-type of a constructed type.

-

Own Id: OTP-4856)

- - -
-
- -
- Asn1 1.4.2.2 - -
- Fixed errors and malfunctions - - -

Release of Asn1 1.4.2.1 on R7B, The functionality is the same, but - the layer between the driver and the asn1 erlang code is different.

- - -
-
- -
- Asn1 1.4.2.1 - -
- Fixed errors and malfunctions - - -

ObjectDescriptor does now work as part of a sequence, set or choice.

-

Own Id: OTP-4773

- - -

When a SEQUENCE that have extension mark was decoded inside a - SEQUENCE OF it could cause decode error due to a failure in - restbytes2. It is now corrected.

-

Own Id: OTP-4791)

- - -

Now the bug is fixed that caused the compiler crash on an untagged - optional open type.

-

Own Id: OTP-4792

- - -

The earlier exit caused by bad in-data is now fixed so it will - return an {error,Reason} tuple.

- return an {error,Reason} tuple.

-

Own Id: OTP-4797

- - -

Open type encoded with indefinite length is now correct decoded.

-

Own Id: OTP-4798

- - -

Now is absent optional open types handled correctly.

-

Own Id: OTP-4799

- - -

Now is the necessary functions available for sorting in run-time of - SET and SET OF components.

-

Own Id: OTP-4809

- - -
-
- -
- Asn1 1.4.2 - -
- Fixed errors and malfunctions - - -

When a component in a SEQUENCE is a CHOICE (or reference to a CHOICE) - and the SEQUENCE's component and one of the alternatives in the CHOICE - have identical names, an error may occur if one doesn't use the - 'optimized' versions of the compiler. In the older versions (ber, ber_bin, per, per_bin) one could optionally apply a value of a - component as {ComponentName,Value}, and the generated code - chooses the second element of the tuple. However, a value of a CHOICE - must be applied as a tuple: {AlternativeName,Value}. Thus, - in the rare case described above and if the value to the SEQUENCE's - component is not in a tuple notation the - {AlternativeName,Value} will be peeled off in the SEQUENCE - and the value fed to the CHOICE will only be the Value - part of {AlternativeName,Value}, and the encoder crashes. - The best way to avoid this is to use the optimized version of the - compiler where the unnecessary tuple notation - {ComponentName,Value} no longer is allowed. Since it isn't - possible to solve this bug in the compiler.

-

Own Id: OTP-4693

- - -
- -
- Improvements and new features - - -

Exclusive decode is enabled by a compiler option and a configuration - file. It makes it possible to leave parts of an ASN.1 encoded message - un-decoded.

-

Own Id: OTP-4744

- - -
-
- -
- Asn1 1.4.1.1 - -
- Fixed errors and malfunctions - - -

The documentation about how extensibility is handled is now corrected.

-

Own Id: OTP-4663

- - -

Function in object now calls the exported function

-

Own Id: OTP-4665

- - -

Now is tags for ObjectClassFieldType analyzed correctly.

-

Own Id: OTP-4666

- - -
-
- -
- Asn1 1.4.1 - -
- Fixed errors and malfunctions - - -

Now is the Default value for an ENUMERATED returned as the name from - the NamedList when decoding.

-

Own Id: OTP-4633

- - -

It was an internal failure when permitted alphabet constraint existed - together with for instance a size constraint. E.g. when a - referenced type is constrained by a size constraint and the defined - type in turn is constrained by a permitted alphabet constraint.

-

Own Id: OTP-4559

- - -

Record is generated in hrl file for a CHOICE with extension mark - that has an internal SEQUENCE/SET definition.

-

Own Id: OTP-4560

- - -

Now is the length of a SEQUENCE/SET OF correctly encoded/decoded (PER).

-

Own Id: OTP-4590

- - -

The problem with unordered decoded terms when a component is a - ObjectClassFieldType has been solved.

-

Own Id: OTP-4591

- - -
- -
- Improvements and new features - - -

More complex definitions with TableConstraints where the SimpleTable - and ComponentRelation are on different levels is now fully - supported.

-

Own Id: OTP-4631

- - -
-
- -
- Asn1 1.4 - -
- Fixed errors and malfunctions -
- -
- Improvements and new features - - -

Each generated .erl file have now a function info/0 that returns - information about the used compiler version and options.

-

Own Id: OTP-4373

- - -

When compiling an ASN.1 module the compiler generates an Erlang module - that is compiled by the Erlang compiler. Earlier it was not possible to - add options to the final step, the Erlang compilation. By adding any - option that is not recognized as a specific ASN.1 option it will be - passed to the final step like: erlc +debug_info Mymodule.asn or - asn1ct:compile('Mymodule',[debug_info]).

-

Own Id: OTP-4491

- - -

Earlier one couldn't multi file compile modules that had different - tagdefault, which now is possible. Equal Type/Value names in different - modules are resolved by renaming (concatenate type name and module - name): If two types with the same name T exist in module A and module B - they will get the new names TA and TB.

-

(Own Id: OTP-4492)

-

Aux Id: OTP-3983

- - -

BER: Encode/decode of data have been significantly improved. By use of - the compiler options ber_bin and optimize, - optimized code will be generated and the optimized run-time module will - be used.

-

Own Id: OTP-4493

- - -
-
- -
- Asn1 1.3.3.1 - -
- Fixed errors and malfunctions - - -

Proper length encoding and padding implemented for a BIT STRING with - NamedNumberList and size constraint as value range. This functionality - didn't work in the rare occasion when the NamedNumberList is shorter - than the lower bound of the constraint.As in this example: - TestS ::= BIT STRING {a (0),b (1)} (SIZE (3..8))

-

(Own Id: OTP-4353)

- - -

Bug in compiler, when an OBJECT IDENTIFIER value consisting of - two identifiers (Defined values or Name form identifiers) was falsely - interpreted causing a compiling error is now corrected.

-

(Own Id: OTP-4354)

- - -

Internal error in check phase that caused crash on - ObjectClassFieldType in ber_bin is corrected.

-

(Own Id: OTP-4390)

- - -

Tags for open types are handled according to x.680 30.6c, i.e. - open types shall not be tagged IMPLICIT.

-

(Own Id: OTP-4395)

-

(Aux Id: OTP-4390)

- - -
-
- -
- Asn1 1.3.3 - -
- Fixed errors and malfunctions - - -

Now gives the compiler an appropriate error report when exported - undefined types are detected.

-

(Own Id: OTP-4129)

- - -

The type ObjectDescriptor is now supported, previously the - implementation of encode/decode for this rarely used type was - incomplete.

-

(Own Id: OTP-4161)

-

(Aux Id: seq7165)

- - -

In case of per and compact_bit_string the rightmost byte were erroneous - truncated when the rightmost bits of that byte were zeros. This is now - corrected.

-

(Own Id: OTP-4200)

- - -

Bad match of return-value from decode_length in skipvalue/3 has now been - fixed.

-

(Own Id: OTP-4232)

- - -

Now is decode of ENUMERATED handled correctly, when tagged EXPLICIT.

-

(Own Id: OTP-4234)

- - -

The compiler now parses and handles the ValueFromObject construct.

-

(Own Id: OTP-4242)

- - -

Now does the compiler handle the case when the object set in simple - table and componentrelation constraints is of a CLASS without a UNIQUE - field. In this case is the octets, which is assumed to be encoded, - encoded as an open type.

-

(Own Id: OTP-4248)

-

(Aux Id: OTP-4242)

- - -

Compiler handles objects in AdditionalElementSetSpec in ObjectSetSpec, - i.e. the objects that are referred to after the ellipses in an object set.

-

(Own Id: OTP-4275)

- - -

Now are values with a component of type CHOICE encoded with indefinite - length correctly decoded.

-

(Own Id: OTP-4358)

- - -
- -
- Improvements and new features - - -

The language constructs (from the old 1988 standard) ANY - and ANY DEFINED BY are now implemented.

-

(Own Id: OTP-2741)

-

(Aux Id: seq 1188)

- - -

Now it is checked in run-time if a OBJECT IDENTIFIER value is invalid

-

(Own Id: OTP-4235)

- - -

The ASN.1 types EXTERNAL,EMBEDDED PDV and CHARACTER STRING now have full support in the compiler.

-

(Own Id: OTP-4247)

- - -

A driver in C does the final job (complete) of the PER encoding when - files are compiled with per_bin and optimize flags. - It gives significant faster encoding for PER.

-

(Own Id: OTP-4355)

- - -

Encode and decode of PER encoding has been made faster by moving - analysis done in run-time to compile-time. These optimizations are - available by compiling ASN.1 files with options per_bin and - optimize.

-

(Own Id: OTP-4381)

-

(Aux Id: OTP-4355)

- - -
-
- -
- Asn1 1.3.2 - -
- Fixed errors and malfunctions - - -

Now does the compiler check values (including referenced values), and - formats the value so it is suitable to use as input to encoding - functions.

-

(Own Id: OTP-3277)

-

(Aux Id: OTP-4103)

- - -

Unnecessary external function calls in generated code are now generated - as internal function calls.

-

(Own Id: OTP-4073)

- - -
- -
- Improvements and new features - - -

Now is Information Objects supported in BER encoding.

-

(Own Id: OTP-3980)

-

(Aux Id: OTP-3979 OTP-3978)

-

- - -

PER: A new option per_bin is now supported. When used the - generated encode/decode functions use binaries and the bit syntax to - get better performance than the old per variant which used - lists. All values input to encode and returned from decode are - compatible between per and per_bin except for - open types which are represented as binaries with per_bin and octet - lists with per. We recommend that you use per_bin instead of per from - now on, the use of binaries will be the default in coming versions and - all improvements and optimizations for PER will be concentrated to that - solution.

-

(Own Id: OTP-4094)

-

- - -

Support for DER implemented. Used by flag +der when compiling. Include - the full BER encoding plus: sorting of SET components, sorting of - encoded elements in SET OF, full check of default values in SET and - SEQUENCE. See new documentation on DER in user_guide sections 1.3.1; - 1.4.11; 1.4.12; 1.4.14; 1.4.16 and 1.10, in the reference manual for - asn1ct.

-

(Own Id: OTP-4103)

-

- - -
-
- -
- Asn1 1.3.1 - -
- Fixed errors and malfunctions - - -

Do not generate record in .hrl file for SET types

-

Own Id: OTP-4025

- - -

Fixed internal error when using BIT STRINGs with Named Number List in combination with compact_bit_string and ber_bin options.

-

Own Id: OTP-4026

-

Aux Id: OTP-3982

- - -

The atom 'com' can now be used in ENUMERATED as an EnumerationItem.

-

Own Id: OTP-4037

-

Aux Id: Seq 7036

- - -

ber: Now it is possible (again) to encode data format "{Type,Value}" in a SEQUENCE OF RequestParameter, when RequestParameter is of type ENUMERATED. The {Type,Value} - notation is not recommended for use, it is redundant and exist only for very ancient backwards compatibility reasons. The "feature" might be removed in forthcoming versions.

-

Own Id: OTP-4057

-

Aux Id: Seq 7066

- - -

A bug in the parser, that caused failure on COMPONENTS OF is now removed.

-

Own Id: OTP-4058

- - -
-
- -
- Asn1 1.3 - -
- Known problems - - -

The compiler will now check that a value referenced by name - does exist.

-

Own Id: OTP-3277

- - -

BER:Decode of a type T ::= SEQUENCE OF C fails if C is encoded with indefinite length. - This is know corrected.

-

Own Id: OTP-3811

-

Aux Id: seq5040

- - -
- -
- Fixed errors and malfunctions - - -

The new parser handles imports when one import ends with FROM, a modulename and a reference to a objectidentifier followed by imports from other modules.

-

Own Id: OTP-3463

- - -

The compiler did not check that a name mentioned as EXPORTED - actually is defined within the module. - This is now corrected.

-

Own Id: OTP-3659

- - -

Removed bug caused by use of nested indefinite length

-

Own Id: OTP-3994

- - -
- -
- Improvements and new features - - -

Now supporting most common use of parameterization according to X.683

-

(Own Id: OTP-3978)

- - -

PER: Now supporting most common use of Information Objects according to X.681. A new parser has been implemented. The error messages due to syntax errors are slightly different than previous. TableConstraint part of X.682 now also supported.

-

Own Id: OTP-3979

- - -

New compiler option added: ber_bin. The compiler generates code with new bit syntax. Run time functions uses bit syntax when feasible. Higher encoding/decoding performance in most cases. Se also comments for Asn1 1.2.9.3.

-

Own Id: OTP-3981

- - -

A more compact format of BIT STRING in Erlang is now available by use of the compiler option compact_bit_string. It is much faster when large BIT STRINGs are used.

-

Own Id: OTP-3982

- - -

Now possible to merge many ASN.1 input files to one Erlang file by use of a configuration file that lists the ASN.1 files.

-

Own Id: OTP-3983

- - -

New documentation in User's Guide in section:

-

3.1: New compile-time functions and options are described.

-

4.6: New compact format of BIT STRING is described.

-

4.8: Additional comments on character strings.

-

7: New section describing ASN.1 Information Objects.

-

8: New section describing Parameterization.

-

Reference Manual/asn1ct New compile options are described.

-

Own Id: OTP-3984

-

Aux Id: OTP-3978, OTP-3979, OTP-3981, OTP-3982, OTP-3983

- - -

Added the functionality to invoke ASN1Mod:encode (and decode).

-

Own Id: OTP-3985

- - -

Performance improvements by removing not necessary use of apply when calling asn1rt:encode. Also other general improvements.

-

Own Id: OTP-3988

- - -
-
- -
- Asn1 1.2.9.6 - -
- Known problems - - -

The compiler does not check that an exported name actually exists in the ASN.1 module.

-

Own Id: OTP-3659

- - -

The compiler does not check that a value referenced by name does exist.

-

Own Id: OTP-3277

- - -

BER: The compiler does not take the extensions into account when checking if - the tags are unique in a SEQUENCE or SET.

-

Own Id: OTP-3304

- - -
- -
- Fixed errors and malfunctions - - -

PER: Trailing zeroes in a BIT STRING declared without named bits - should not be removed in the encodings.

-

Own Id: OTP-3830

- - -
-
- -
- Asn1 1.2.9.5 - -
- Known problems -

Same as for 1.2.9.3.

-
- -
- Fixed errors and malfunctions - - -

PER: Constraints are not propagated when types are - referring to each other. Example:

- - - TBCD-STRING ::= OCTET STRING - - LAI ::= TBCD-STRING (SIZE(3)) -

The size constraint is not passed on during encode,decode - resulting in wrong encoding for PER , it is - coded with a length determinant which should not be there - when the length is fixed. For BER this does not matter because the constraints does - not affect the encodings.

-

Own Id: OTP-3713

- - -

The generated code gets wrong if there are several ENUMERATED fields in a SEQUENCE or SET, this is now corrected.

-

Own Id: OTP-3796

- - -

BER:Decode of a type T ::= SEQUENCE OF C fails if C is encoded with indefinite length. - This is know corrected.

-

Own Id: OTP-3811

- - -
-
- -
- Asn1 1.2.9.3 - -
- Known problems - - -

The compiler does not check that an exported name actually exists in the ASN.1 module.

-

Own Id: OTP-3659

- - -

The compiler does not check that a value referenced by name does exist.

-

Own Id: OTP-3277

- - -

BER: The compiler does not take the extensions into account when checking if - the tags are unique in a SEQUENCE or SET.

-

Own Id: OTP-3304

- - -
- -
- Fixed errors and malfunctions - - -

This version supports soft upgrade from versions 1.2.6 1.2.7.

- - -

In an ENUMERATED type like this:

- -\011\011T ::= ENUMERATED { blue, green} -

The symbols was encoded/decoded with the wrong values, i.e in - reverse order. This is now corrected.

-

Own Id: OTP-3700

- - -

PER: OCTET STRING with Size constrained to a single value i.e fixed size - was treated wrong during encode and decode. This is now corrected.

-

Own Id: OTP-3701

- - -
- -
- Improvements and new features - - -

There is now a new compiler option ber_bin available that can be used to - generate encode/decode functions for BER that uses the new "bit-syntax" to - make the functions more efficient. The ber_bin option is used - as an alternative to the ber and per options.

-

The encode function then produces a - possibly nested list of binaries and integer lists. The decode function does - in this case require a single binary as input instead of a list. - The modules generated with this option require that you have an R7A or later - system, otherwise they will not compile and the runtime module asn1rt_ber_bin - can not be executed.

-

The ber_bin option is not officially supported in this version (will be - in a later version) but is provided for those who want to try it. - It should be significantly faster at decode and is slightly faster at encode. - Exactly how performance differs between this binary approach and the - list approach depends highly on the type of input. - Another thing worth noting is that both approaches still have a lot of - solutions in common which can be improved a lot to gain even better - performance.

- - -
-
- -
- Asn1 1.2.9.2 - -
- Fixed errors and malfunctions - - -

BER: Encode/decode of extension components did not work properly. This is now corrected.

-

Own Id: OTP-3395

-

Aux Id:

-

PER:The encode/decode of NULL as an open type has been corrected. An open type must always have a length of at least 1 byte even if the contained - value (e.g NULL) encodes to nothing.

-

Own Id: OTP-3496

-

Aux Id:

- - -

BER:In the current implementation extension components of a SEQUENCE are required - to be present when they are specified as mandatory. This is an error, all extension - components are "optional" even if they are not specified to have the OPTIONAL or - DEFAULT property. This is now corrected.

-

Own Id: OTP-3278

- - -
- -
- Improvements and new features - - -

The ASN.1 language feature COMPONENTS OF is now implemented.

-

Own Id: OTP-2515

- - -

The encoding and decoding of ENUMERATED and - INTEGER with NamedNumbers is made more efficient and thus - faster in runtime.

-

Own Id: OTP-3464

-

Aux Id:

- - -

Added support for encode/decode of open type which is - constrained to a specific type. Previously the value of - an open type had to be a list of octets, but now the Erlang - representation of the specific type used in the constraint - is used both as input to encode and as output from decode.

-

Own Id: OTP-3569

-

Aux Id:

- - -

PER: GeneralString, GraphicalString etc. i.e all strings - that are not so called "known-multiplier character - string types" are now supported by the runtime - encode/decode functions.

-

Own Id: OTP-3573

-

Aux Id:

- - -
-
- -
- Asn1 1.2.6 - -
- Known problems - - -

The ASN.1 language feature COMPONENTS OF is not implemented.

-

Own Id: OTP-2515

- - -

The compiler does not check that a value referenced by name does exist.

-

Own Id: OTP-3277

- - -

BER:In the current implementation extension components of a SEQUENCE are required - to be present when they are specified as mandatory. This is an error, all extension - components are "optional" even if they are not specified to have the OPTIONAL or - DEFAULT property.

-

Own Id: OTP-3278

- - -

BER: The compiler does not take the extensions into account when checking if - the tags are unique in a SEQUENCE or SET.

-

Own Id: OTP-3304

- - -
- -
- Fixed errors and malfunctions - - -

This version supports soft upgrade from versions 1.1.1, 1.1.5 and 1.1.6. - Two new runtime modules asn1rt_ber_v1 and - asn1rt_per_v1 are delivered together with the old ones. This makes - it possible to continue running applications with modules generated with the - previous version of the asn1 compiler while modules generated by this version - will use the new runtime modules. Note that it is only advice-able to continue - running old generates if they are working perfectly and have no need - for the corrections made in this version of the asn1 application.

- - -

BER: SEQUENCEs encoded with indefinite length was not correctly decoded. - This in now corrected.

-

Own Id: OTP-3352

-

Aux Id: Seq 4100

- - -
-
- -
- Asn1 1.2.4 - -
- Fixed errors and malfunctions - - -

The compiler now detects multiple definitions of values and types and reports this as - an error. Previously this was detected when the generated Erlang module was compiled.

-

Own Id: OTP-3105

- - -

BER: An error regarding encoding of ENUMERATED present in asn1-1.1.1 - is corrected. The new version 1.1.2 of asn1 containing this correction is - delivered as a "patch".

-

Own Id: OTP-3169

- - -

BER: Decoding of SEQUENCE OF and SET OF with indefinite length is corrected. - The correction was first delivered in version 1.1.2.

-

Own Id: OTP-3170

- - -

BER: Encoding and decoding of ENUMERATED - with extensionmark - "..." did not work (crashed with a runtime error). This - has now been corrected. If an unknown enumerated value is - decoded (for an extensible enumerated type) - it is returned as {asn1_enum,Value} where - Value is an integer. Enumerated values in this format - are also accepted by the encoder. - ASN.1 modules containing - ENUMERATED with extensionmark should be - recompiled with the corrected - version of the compiler. The BER runtime functions are also - corrected. - Note that this correction has already been delivered as a - bugfix for R4B (OTP-2951).

-

Own Id: OTP-3202

-

Aux Id: Seq3745

- - -

BER: The primitive/constructed bit in the tag byte of an encoding - is not correct when it comes to user defined tags. - For example in

- - T ::= [2] SEQUENCE { a BOOLEAN} -

the tag 2 does not get the constructed bit set which it should. - This is now corrected.

-

Own Id: OTP-3241

- - -

The decoder can now detect if there are unexpected bytes - remaining when all components of a sequence are decoded. - The decoder will then return {error,{asn1{unexpected,Bytes}}}

-

Own Id: OTP-3270

- - -

Values of type OBJECT IDENTIFIER was sometimes returned as an Erlang list - (ASN.1 constants) and sometimes as a tuple (from the decode functions). This is now - changed so that OBJECT IDENTIFIER values always are represented as an Erlang - tuple.

-

Own Id: OTP-3280

- - -

PER:The encode/decode functions could not handle integers with - a range greater than 16#7ffffff. This limit is now removed.

-

Own Id: OTP-3287

- - -

PER: The encoding/decoding of the length for a SET OF/SEQUENCE OF - was wrong if there was a size constraint. This is now corrected.

-

Own Id: OTP-3291

- - -

PER: Encoding of a constrained INTEGER (range > 16 k) was wrong for - the value 0. This is now corrected.

-

Own Id: OTP-3306

- - -
- -
- Improvements and new features - - -

The ASN.1 module name and the filename where the ASN.1 - specification resides must match each other (has always been the - case). This is now checked by the compiler. The check requires that - the names match in a case or case insensitive way depending on the - characteristics for the current system.

-

Own Id: OTP-1843

- - -

PER: Encode/decode of an extension value (i.e not within the root set) for - ENUMERATED did not work properly. This is now corrected. - If an unknown enumerated value is - decoded (for an extensible enumerated type) - it is returned as {asn1_enum,Value} where - Value is an integer. Enumerated values in this format - are also accepted by the encoder (if the value is >= the number of known - extension values).

-

Own Id: OTP-2930

- - -

Unnecessary printouts from the compiler are removed. - The compiler version and the compiler options are now - printed to stdout.

-

Own Id: OTP-3276

- - -

In order to better suite the use of ASN.1 in embedded systems only - the modules needed in runtime are now listed in the .app file.

-

Own Id: OTP-3279

- - -

The compiler now supports extensionmarker in constraint specifications. - Example:

- -INTEGER (0..10, ...) -

In previous version this was reported as a syntax error.

-

Own Id: OTP-3281

- - -

A very limited part of ITU-T recommendation X.681 - Abstract Syntax Notation One (ASN.1): Information - object specification is now implemented. Specifically \011 - TYPE IDENTIFIER is recognized by the compiler.

-

Own Id: OTP-3325

- - -

Parameterization of ASN.1 specifications (ITU-T X.683) is now - supported to a limited extent.

-

Own Id: OTP-3326

- - -
-
- -
- Asn1 1.1.3.1 - -
- Fixed errors and malfunctions - - -

BER Encoding and decoding of ENUMERATED - with extensionmark - "..." did not work (crashed with a runtime error). This - has now been corrected. If an unknown enumerated value is - decoded (for an extensible enumerated type) - it is returned as {asn1_enum,Value} where - Value is an integer. Enumerated values in this format - are also accepted by the encoder. - ASN.1 modules containing - ENUMERATED with extensionmark should be - recompiled with the corrected - version of the compiler. The BER runtime functions are also - corrected. - Note that this correction has already been delivered as a - bug-fix for R4B (OTP-2951).

-

Own Id: OTP-3202

-

Aux Id: Seq3745

- - -
-
- -
- Asn1 1.1.1 - -
- Known problems - - -

The syntactic construct COMPONENTS OF is not - implemented.

-

Own Id: OTP-2515

- - -

ANY and ANY DEFINED BY are currently not - supported.

-

Own Id: OTP-2741

-

Aux Id: seq 1188

- - -

Multiple definitions of the same Type or Value is not detected - by the compiler. The error occurs when the generated Erlang - module is compiled.

-

Own Id: OTP-3105

- - -
-
- -
- Asn1 1.1 - -
- Known problems - - -

The primitive/constructed bit in the tag byte of an encoding - is not correct when it comes to user defined tags. - For example in

- - T ::= [2] SEQUENCE { a BOOLEAN} -

the tag 2 does not get the constructed bit set which it should. - This is now corrected.

-

Own Id: OTP-3241

- - -
- -
- Fixed errors and malfunctions - - -

The BER decoder failed to decode certain nested data types - where IMPLICIT tags where involved. - This is now corrected.

-

Own Id: OTP-2719

-

Aux Id: seq 1148

- - -

The handling of types with extension marker "..." is corrected. - Earlier each SEQUENCE and SET with an extension marker got an - extra field named asn1_EXT in the generated record. - This was a mistake and that field is now removed (concerns - both BER and BER).

-

Own Id: OTP-2724

-

Aux Id: seq 1148, OTP-2719

- - -

The decoder (both BER and PER) could not handle unnamed - bits of a BIT STRING if the type had any - named bits declared. This is now corrected and the unnamed - bits are returned as {bit,Pos} where Pos is the bit - position. The {bit,Pos} can be used as input to the - encoder too.

-

Own Id: OTP-2725

-

Aux Id: seq 1148,OTP-2719,OTP-2724

- - -

The functions asn1rt:decode and asn1ct:decode - did not always return {ok,Result} or - {error,Reason} as documented. This is now corrected.

-

Own Id: OTP-2730

-

Aux Id: seq 1158

- - -

The compiler did not accept CHOICE types as components - of a SEQUENCE or SET when - the modules tag default was IMPLICIT. - Example:

- -C ::= CHOICE { ......} -A ::= SEQUENCE { -a [1] C, -- This was not accepted -..... -

This was an error - caused by a misinterpretation of the ASN.1 standard. This - is now corrected.

-

Own Id: OTP-2731

-

Aux Id: seq 1163

- - -

When decoding a SEQUENCE A which contains an OPTIONAL component - b which is a SEQUENCE with mandatory components, the decoder - does not detect as an error that a mandatory component of b - is missing. The same error could occur also in other cases - with nested types and optional components of SEQUENCE or SET. - This is now corrected.

-

Own Id: OTP-2738

-

Aux Id: seq 1183

- - -

BER Encoding and decoding of ENUMERATED - with extensionmark - "..." did not work (crashed with a runtime error). This - has now been corrected. If an unknown enumerated value is - decoded (for an extensible enumerated type) - it is returned as {asn1_enum,Value} where - Value is an integer. Enumerated values in this format - are also accepted by the encoder. - ASN.1 modules containing - ENUMERATED with extensionmark should be - recompiled with the corrected - version of the compiler. The BER runtime functions are also - corrected.

-

Own Id: OTP-2951

-

Aux Id: Seq 1446 OTP-2929

- - -

The compiler does now accept all valid value notations - for the OBJECT IDENTIFIER type. The generated code for - those values is also corrected.

-

Own Id: OTP-3059

- - -
- -
- Improvements and new features - - -

The code generated for BER is significantly enhanced resulting - in less code and around 300% better performance in runtime - for the encoding of complex ASN.1 values. The performance of - decoding is unchanged.

-

Own Id: OTP-2806

- - -
-
- -
- Asn1 1.0.3 - -
- Fixed errors and malfunctions - - -

The asn1.app file is corrected.

-

Own Id: OTP-2640

- - -

The encoding of integers in BER did not comply with the - standard for all values. The values was not encoded - in the minimum number of octets as required. This is - now corrected in the runtime module asn1rt_ber.

-

Own Id: OTP-2666

- - -
- -
- Improvements and new features - - -

The compiler now generates explicit exports directives for - all generated - functions that should be exported (instead of -compile(export_all)). - This eliminates the warnings from the Erlang compiler when - compiling the - generated file.

-

Own Id: OTP-1845

- - -
-
- -
- R3B02 (Asn1 1.0.2) - -
- Fixed errors and malfunctions - - -

The decoding of a BER encoded SEQUENCE with optional component - of type SEQUENCE (also with optional components) could result - in an error or wrong result if the tags are equal.

-

Own Id: OTP-2226

- - -

The encoding of (PER) SEQUENCE with extensionmark was wrong. - This is now corrected.

-

Own Id: OTP-2349

- - -
-
- -
- R3A (Asn1 0.9) - -
- Fixed errors and malfunctions - - -

The asn1 compiler now detects the use of an implicit tag before CHOICE as an error (in accordance with the standard)

-

Own Id: OTP-1844

- - -

An OPTIONAL CHOICE embedded in SEQUENCE when BER coding - caused an error when generating decode code. This is now - corrected.

-

Own Id: OTP-1857

-

Aux Id: OTP-1848

- - -
-
- -
- 1 ASN1 0.8.1 -

This is the first release of the ASN1 application. This version is - released for beta-testing. Some functionality will be added until the - 1.0 version is released. See the release notes for the latest version - for the exact details about new features. A list of missing features - and restrictions can be found in the chapter below.

- -
- 1.1 Missing features and other restrictions -

- - -

The encoding rules BER and PER (aligned) is supported. PER (unaligned) IS NOT SUPPORTED.

- - -

NOT SUPPORTED types ANY and ANY DEFINED BY - (is not in the standard any more).

- - -

NOT SUPPORTED types EXTERNAL and EMBEDDED-PDV.

- - -

NOT SUPPORTED type REAL (planned to be implemented).

- - -

The code generation support for value definitions in the ASN.1 notation is very limited - (planned to be enhanced).

- - -

The support for constraints is limited to:

- - - - -

SizeConstraint SIZE(X)

- - -

SingleValue (1)

- - -

ValueRange (X..Y)

- - -

PermittedAlpabet FROM (but not for BMPString and UniversalString when generating PER).

- - -

Complex expressions in constraints is not supported (planned to be extended).

- - -

The current version of the compiler has very limited error checking:

- - -

Stops at first syntax error.

- - -

Does not stop when a reference to an undefined type is found , - but prints an error message. Compilation of the generated - Erlang module will then fail.

- - -

A whole number of other semantical controls is currently - missing. This means that the compiler will give little - or bad help to detect what's wrong with an ASN.1 - specification, but will mostly work very well when the - ASN.1 specification is correct.

- - - - -

The maximum INTEGER supported in this version is a - signed 64 bit integer. This limitation is probably quite - reasonable. (Planned to be extended).

- - -

Only AUTOMATIC TAGS supported for PER.

- - -

Only EXPLICIT and IMPLICIT TAGS supported for BER.

- - -

The compiler supports decoding of BER-data with indefinite - length but it is not possible to produce data with indefinite - length with the encoder.

- - -
-
- - diff --git a/lib/asn1/doc/src/part_notes.xml b/lib/asn1/doc/src/part_notes.xml deleted file mode 100644 index b0a6887aa5..0000000000 --- a/lib/asn1/doc/src/part_notes.xml +++ /dev/null @@ -1,39 +0,0 @@ - - - - -
- - 20042009 - Ericsson AB. All Rights Reserved. - - - 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. - - - - Asn1 Release Notes - Ingela Anderton Andin - - >2004-09-07 - - part_notes.sgml -
- -

The Asn1 application - contains modules with compile-time and run-time support for ASN.1.

-

There are also release notes for - older versions.

- - - - diff --git a/lib/asn1/doc/src/warning.gif b/lib/asn1/doc/src/warning.gif deleted file mode 100644 index 96af52360e..0000000000 Binary files a/lib/asn1/doc/src/warning.gif and /dev/null differ -- cgit v1.2.3