|
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 | -2021 | Specifies the ASN.1 version used in the input ASN.1 specification files. |
| -allCsvMax | Specifies the maximum number of all CSVs to create for a top-level PDU type value that may include multiple components for multiple SET OF and SEQUENCE OF type values for which extra CSVs are created. |
| -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 or a specified value reference in the input ASN.1. |
| -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 COER 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 or -putFiles and instructs ASN-1Step to preserve the content of the output file(s), if existing, and add the new records to the end of the output file(s). |
| -constraints | Instructs ASN-1Step to check constraints. |
| -csv | Instructs ASN-1Step to use Comma-Separated Value (CSV) format to encode, decode, or test PDUs. |
| -csvEmptyOctStrIfFails | Instructs the CSV encoder to include empty values in CSVs for backward compatibility with previous versions of ASN-1Step. |
| -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. |
| -csvSkipEmpty | Instructs the CSV encoder to skip CSVs that include only column separators and spaces; that is, CSVs with empty values for all nested simple types. |
| -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 all or up to the specified maximum number of messages of a specified PDU contained in the input ASN.1, given its encoding in a separate file. Optionally, it will skip the specified number of messages before decoding starts. |
| -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 in value notation format that are included in the specified text file or in all .txt files from the specified location. |
| -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. |
| -generateMessages | Instructs ASN-1Step to generate up to the specified maximum number of PDU messages using a PDU id or a type name in multiple files (with -putFiles) or in a single file (with -output). By default, files with unique messages are created, unless the third parameter is 0. |
| -getFiles | Specifies the location and the filename extension, which corresponds to the encoding rules used, of the input encoding files to be used for decoding. Optional 'flags' specifies the file format: 'hex' or 'bin' for text files with binary encodings, CSV flags separated by ',' for CSV file. |
| -hexCharacters | Specifies that BER, DER, PER Aligned or Unaligned, OER, or COER 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. |
| -noRandomLimits | Instructs ASN-1Step to use a default set of values for different ASN.1 type properties for all types within the specified PDU except those marked with the OSS.GenRandomValues or OSS.GenOrderedValues directives in value generation with the -generateMessages option. |
| -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. |
| -noSortSetChoice | Instructs ASN-1Step to skip PER-based and canonical encoding rules, which require sorting of SET and CHOICE components, from a set of all encoding rules implied by default. |
| -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 the prefix for the output file name to store encoded, possibly concatenated, messages or the location for generated XSL/DTD 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. |
| -putFiles | Specifies the location, an optional file name prefix, and an optional starting file number suffix for multiple output encoding files. |
| -randomLimits | Specifies a range of values for different ASN.1 type properties to be used in random value generation with the -generateMessages option. |
| -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. |
| -seed | Specifies a custom seed to be used in the random value generator with the -generateMessages option. |
| -setNestingLimit | Sets the nesting limit for decoding SET and SEQUENCE types. |
| -sortSetChoice | Instructs ASN-1Step to sort SET and CHOICE components according to PER-based and canonical encoding rules even when those rules are not explicitly specified. |
| -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 10.5 and later of ASN-1Step®.
Copyright © 2024 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