The following table shows a summary of the command line options that have meaning when Python code generation is selected:
| Option | Argument | Description |
|---|---|---|
| -allow-ambig-tags | This option suppresses the check that is done for ambiguous tags within a SEQUENCE or SET type within a specification. Special code is generated for the decoder that assigns values to ambiguous elements within a SET in much the same way as would be done if the elements were declared to be in a SEQUENCE. | |
| -asnstd |
x680 |
This option selects the version of ASN.1 syntax to be parsed. ‘x680’ (the default) refers to modern ASN.1 as specified in the ITU-T X.680-X.690 series of standards. Refer to the section called “ASN.1 Standard Revisions” for more information. |
| -attrs | <items> |
This option only has meaning when generating an XML schema definitions (XSD) file using the -xsd option. It instructs the compiler to generate non-native attributes for certain ASN.1-only items that cannot be expressed in XSD. The items are specified as a comma-delimited list. Valid values for items are tags, enum, and ext. <items> is an optional parameter. If it is not specified, it is assumed that application information should be produced for all three item classes: ASN.1 tags, ASN.1 enumerations, and extended elements. |
| -ber | None | Generate functions that implement the Basic Encoding Rules (BER) as specified in the ASN.1 standards. |
| -compare | None | Generate a Python equality comparison method (__eq__) in each generated class. |
| -config | <filename> | This option is used to specify the name of a file containing configuration information for the source file being parsed. A full discussion of the contents of a configuration file is provided in the Compiler Configuration File section. |
| -copy | None | Generate copy_value methods in all non-trivial classes to produce cloned deep-copy of an object instance. |
| -depends | None | Generate Python source files that contain only the productions in the main file being compiled and items those productions depend on from IMPORT files. |
| -der | None | Generate functions that implement the Distinguished Encoding Rules (DER) as specified in the ASN.1 standards. |
| -genbuild | [<filename>] | This option is used to generate a build script for invoking the compiler with the set of command-line options given in the command. If no file name is specified, the file will be named build.bat on Windows or build.sh on Linux/Mac. |
|
-genPrint |
None | Generate print methods to print object contents. For Python, this includes an __str__ method to get a string representation of the object as well as a print_value to print the string representation to stdout. |
|
-genTest |
None |
Generate test to populate a PDU object with random test data. This code will be embedded in the body of a generated writer program; thus the option only results in code being generated if -writer is also specified. |
| -I | <directory> | This option is used to specify a directory that the compiler will search for ASN.1 source files for IMPORT items. Multiple –I qualifiers can be used to specify multiple directories to search. |
| -json or -jer | None | Generate encode/decode functions that implement the Javascript Object Notation (JSON) Encoding Rules (JER) as specified in the X.697 ASN.1 standard. (Note: -jer+ is no longer supported. Similar functionality is now standard JER.) |
| -lax | None | Suppress generation of code to check constraints. |
| -list | None | Generate listing. This will dump the source code to the standard output device as it is parsed. This can be useful for finding parse errors. |
| -nodecode | None | Suppress generation of decode functions. |
| -noencode | None | Suppresses generation of encode functions. |
| -noIndefLen | None | Omit indefinite length tests in generated BER decode functions. These tests result in the generation of a fair amount of code. If you know that your application only uses definite length encoding, this option can result in a smaller code base size. Note that by definition it is enabled for DER code generations since these encoding rules do not use indefinite lengths. |
| -noOpenExt | None | Suppress the generation of open extension elements in constructs that contain extensibility markers. The purpose of the element is to collect any unknown items in a message. If an application does not care about these unknown items, it can use this option to reduce the size of the generated code and increase performance. |
| -noUniqueNames | None |
Turn off the capability to automatically generate unique names to resolve name collisions in the generated code. Name collisions can occur, for example, if two modules are being compiled that contain a production with the same name. A unique name is generated by prepending the module name to one of the productions to form a name of the form <module>_<name>. Note that name collisions can also be manually resolved by using the typePrefix, enumPrefix, and valuePrefix configuration items (see the Compiler Configuration File section for more details) |
| -o | <directory> | Specify the name of a directory to which all of the generated files will be written. |
| -pdu | <typeName> |
Designate given type name to be a Protocol Definition Unit (PDU) type. By default, PDU types are determined to be types that are not referenced by any other types within a module. This option allows that behavior to be overridden. Note that for Python, the only effect this has is to cause this type to be used in generated reader/writer programs. |
| -reader | None | Generate a sample reader program to decode data. |
| -shortnames | None | Change the names generated by compiler for embedded types in constructed types. |
| -tables | None | Generate additional code for the handling of table constraints as defined in the X.682 standard. |
| -warnings | None | Output information on compiler generated warnings. |
| -writer | None | Generate a sample writer program to encode data. |