|
The Command Line |
Command-line Options |
Directives |
Converting to/from CSV Format |
Frequently Asked Questions
Command-line options give you greater flexibility over the behavior of the ASN-1Step program. You can use these options on the command line or within ASN.1 Studio's graphical user interface.
Get detailed information about an option by clicking on its name.
| Option | Description |
|---|---|
| -1990 | -2015 | Specifies the ASN.1 version used in the input ASN.1 specification files. |
| -allEncode | Instructs ASN-1Step to encode all value references from the input ASN.1. |
| -allow <BadCase> | Instructs ASN-1Step to accept input syntax that deviates from the standard, as specified by the <BadCase> argument. |
| -allSampleAsn1Values | Creates sample values for all PDU types from ASN.1 input. |
| -asn1Value | Instructs ASN-1Step to produce ASN.1 value notation for an input encoded message. |
| -assignments | Instructs ASN-1Step to process type and value assignments found outside of the defined input modules. |
| -autoEncDec | Instructs ASN-1Step to continue to automatically encode/decode open types even if -noConstraint is specified. |
| -binCharacters | Specifies that BER, DER, PER Aligned or Unaligned, OER, or C-OER encoded data should be read/written to a text file containing binary characters. |
| -commandFile | Specifies the name of the text-file containing command-line options for the current invocation of ASN-1Step. |
| -concatenate | Can be used with -output and instructs ASN-1Step to preserve the content of the output file, if it exists, and add the new records to the end the output file. |
| -constraints | Instructs ASN-1Step to check constraints. |
| -csv | Instructs ASN-1Step to use Comma-Separated Value (CSV) format to encode, decode, or test PDUs. |
| -csvMaxLevel | Instructs ASN-1Step to include only those simple type values that are nested no deeper than the specified level in the CSV. |
| -csvMinLevel | Instructs ASN-1Step to include only those simple type values that are nested at the specified level or deeper in the CSV. |
| -debug | Instructs ASN-1Step to issue detailed trace data and error messages. |
| -decFlags | Offers greater control over ASN-1Step decoding. |
| -decodePdu | Instructs ASN-1Step to decode a specified PDU contained in the input ASN.1, given its encoding in a separate file. |
| -demo | Allows trial users of ASN-1Step to experience the capabilities of ASN-1Step. |
| -designerWarnings | Instructs ASN-1Step to generate extra warning messages for protocol designers writing ASN.1. |
| -dtd | Can generate multiple data type definitions (DTD) files, one for each PDU. |
| -encFlags | Offers greater control over ASN-1Step encoding. |
| -encodeValue | Instructs ASN-1Step to encode a specified value reference in the input ASN.1 or encode one or more values specified in the input text file. |
| -errorFile | Redirects ASN-1Step error, warning, and informatory messages to a text file. |
| -flags | Offers greater control over the encoding and decoding conducted by ASN-1Step. |
| -hexCharacters | Specifies that BER, DER, PER Aligned or Unaligned, OER, or C-OER encoded data should be read/written to a text file containing hexadecimal characters. |
| -help | Displays a short summary of the command-line syntax and available options of ASN-1Step. |
| -ignoreError | Instructs ASN-1Step to treat certain message numbers as warning messages instead of error messages. |
| -ignoreIncompleteItems | Instructs ASN-1Step to ignore incomplete ASN.1 definitions of types and values. |
| -ignoreRedefinedAssignments | Instructs ASN-1Step to ignore redefined ASN.1 definitions of types and values. |
| -ignoreSuppress | Instructs ASN-1Step to ignore all OSS.SUPPRESS directives. |
| -informatoryMessages | Print all informatory messages. |
| -jsonIndent | Controls the indentation size of a JSON encoding generated by ASN-1Step. |
| -listPduIdentifiers | Instructs ASN-1Step to display a table of all PDUs in the input ASN.1 that are available for decoding. |
| -messageFormat | Controls the format of the error, warning, and informatory messages that are issued. |
| -noCDRHeadersDetection | Instructs ASN-1Step to ignore CDR headers in the input BER-based encoding, i.e., ASN-1Step will not automatically detect CDR headers. |
| -noConstraints | Specifies that constraints should not be checked during encoding/decoding. |
| -noDebug | Instructs ASN-1Step to not display detailed trace data and error messages. |
| -noInformatoryMessages | Instructs ASN-1Step to not display informatory messages. |
| -noOutput | Instructs ASN-1Step to not generate output files. |
| -noPdusForContainingTypes | Instructs ASN-1Step to not generate PDUs for types with CONTAINING. |
| -noPdusForOpenTypes | Instructs ASN-1Step to not generate PDUs for any open types. |
| -noPedantic | Instructs ASN-1Step to rigorously check only the root modules. |
| -noRelaxBER | Input BER-encoded PDUs must strictly conform to BER. |
| -norelaxedMode | Cancels the options specified by -relaxedMode. |
| -noRelaxPER | Input PER-encoded PDUs must strictly conform to PER. |
| -noRelaySafe | Instructs ASN-1Step to skip unrecognized extensions while decoding an encoding. |
| -noTest | Instructs ASN-1Step to not test the encoding and decoding of all value references in the input ASN.1. |
| -noTrace | Instructs ASN-1Step to not print encoder/decoder trace information. |
| -noUniquePDU | Instructs ASN-1Step to not issue a warning message when a non-unique PDU tag is found. |
| -noVerbose | Instructs ASN-1Step to not display compilation progress messages. |
| -noWarningMessages | Instructs ASN-1Step to not display warning and informatory messages. |
| -offset | Specifies the offset in the input encoding where the first encoded record starts. |
| -output | Specifies a directory path where ASN-1Step will put its output files. |
| -pdusForContainingTypes | Instructs ASN-1Step to always treat types referenced by contents constraints as PDUs. |
| -pdusForOpenTypes | Instructs ASN-1Step to treat all open types as encodable PDUs. |
| -pedantic | Instructs ASN-1Step to thoroughly check the entire abstract syntax. |
| -printPERFlags | Provides more control over the output PER analysis conducted by ASN-1Step. |
| -recordOffset | Specifies the number of bytes to skip before decoding each record from the input encoding. |
| -relaxedMode | Specifies automatic selection of command-line options that result in relaxed compiler behavior. |
| -relaxBER | instructs ASN-1Step to silently ignore minor violations to the BER standard while decoding an encoding |
| -relaxPER | Instructs ASN-1Step to silently ignore minor violations to the PER standard while decoding an encoding. |
| -relaySafe | Instructs ASN-1Step to preserve unrecognized extensions while decoding an encoding. |
| -restrictedConstraintChecking | The OSS.NoConstrain directive will not be ignored even if -constraint is specified. |
| -root | ASN-1Step will treat all input modules as if they were root modules. |
| -sampleAsn1Value | Create a sample value for the specified PDU type from the ASN.1 input. |
| -setNestingLimit | Sets the nesting limit for decoding SET and SEQUENCE types. |
| -stringNestingLimit | Sets the nesting limit for decoding constructed strings. |
| -suppress | Instructs ASN-1Step to suppress a specific warning or informatory message. |
| -syntaxOnly | Instructs ASN-1Step to do only a syntax check on the ASN.1 input. |
| -test | ASN-1Step will test the encoding and decoding of all value references in the input ASN.1. |
| -traceFile | ASN-1Step will write all encoder/decoder trace information to a text file. |
| -truncatePrintedStrings | Long printed strings will be truncated at the position specified by the "num" parameter. |
| -uniquePDU | An error will be issued if not all PDU tags are unique. |
| -valueRefTable | ASN-1Step will display a table of all value references in the input ASN.1 available for encoding. |
| -verbose | ASN-1Step will display detailed status messages. |
| -warningMessages | All warning messages should be displayed. |
| -xsl | Allows you to generate multiple default stylesheet files; one for each PDU. |
This documentation applies to release 8.2 and later of ASN-1Step®. For earlier versions, consult the PDF manual available in your product installation.
Copyright © 2025 OSS Nokalva, Inc. All rights reserved.
No part of this publication may be reproduced, stored in a retrieval system, or transmitted in any form or by any means electronic, mechanical, photocopying, recording or otherwise, without the prior permission of OSS Nokalva, Inc.
Every distributed copy of ASN-1Step is associated with a specific license and related unique license number. That license determines, among other things, what functions of ASN-1Step are available to you.
We stand with Ukraine