TOP

ASN-1Step Command-line Options

Applies to: ASN-1Step 8.2

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 © 2017 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.