Understanding the SLAX Processor (slaxproc)

--‍check
 -c

Perform a syntax and content check on a SLAX script, reporting any errors. This mode is useful for off-box syntax checks before installing or uploading scripts to a device running Junos OS.

--‍format
 -F

Format a SLAX script, correcting indentation and spacing to the preferred style.

--‍json-‍to-‍xml

Transform JSON input into XML using the conventions defined in http://juniper.github.io/libslax/slax-manual.html#json-elements.

--‍run
 -r

Run a SLAX script. This is the default mode. The script name, input filename, and output filename can be provided using command-line options, positional arguments, or a mix of both. Input defaults to standard input, and output defaults to standard output.

--‍show-‍select

Show an XPath selection from the input document. This mode is used to extract out selections from a script for external consumption. This enables the consumer to avoid a SLAX parser but still have visibility into the contents of the script.

--show-‍variable

Show the contents of a global variable. This mode is used to extract static variable contents for external consumption. This enables the consumer of the data to avoid a SLAX parser but still have access to the static contents of global variables, such as the $arguments variable.

--‍slax-‍to-‍xslt
 -x

Convert a SLAX script into XSLT format. The script filename and output filename are provided using command-line options, positional arguments, or a mix of both.

--‍xml-‍to-‍json

Convert XML into JSON using the conventions defined in http://juniper.github.io/libslax/slax-manual.html#json-elements.

--‍xpath xpath
 -X xpath

Select data from the input document that matches the given XPath expression.

--‍xslt-‍to-‍slax
 -s

Convert an XSLT script into SLAX format. The script filename and output filename are provided using command-line options, positional arguments, or a mix of both.

--‍debug
 -d

Enable the SLAX/XSLT debugger.

--‍empty
 -E

Provide an empty document as the input data set. This is useful for scripts that do not expect or need meaningful input.

--‍expression <expr>

Convert a SLAX expression to an XPATH expression, or vice versa, depending on the presence of --slax-to-xslt or --xslt-to-slax.

--‍exslt
 -e

Enable the EXSLT library, which provides a set of standard extension functions. See http://www.exslt.org for more information.

--‍help
 -h

Display the help message and exit.

--‍html
 -H

Parse input data using the HTML parser, which differs from XML.

--‍ignore-‍arguments

Do not process any further arguments. This can be combined with #! to enable distinct styles of argument parsing.

--‍include <dir>
 -I <dir>

Add a directory to the list of directories searched when using include and import files. Alternatively, you can define the SLAXPATH environment variable to specify a colon-delimited list of directories to search.

--‍indent
 -g

Indent output. This option is identical to the behavior triggered by output-method { indent 'true'; }.

--‍input <file>
 -i <file>

Read input from the specified file.

--‍json-‍tagging

Tag JSON elements with the 'json' attribute as the input is converted to XML. This enables you to use the --format mode to transform the data back into JSON format.

--‍keep-‍text

When building a script from mini templates, do not add a template to discard normal text. By default, XSLT displays unmatched text data. This option preserves the default behavior instead of replacing it with the discard action.

--‍lib <dir>
 -L <dir>

Adds a directory to the list of directories searched when using extension libraries.

Alternatively, you can define the SLAXEXTPATH environment variable to specify a colon-delimited list of extension library locations to search.

--‍log <file>

Write log data to the given file.

--‍mini-‍template <code>
 -m <code>

Pass a simple script in through the command line. The argument is typically a template, such as a named or match template.

--‍name <file>
 -n <file>

Read the SLAX script from the specified file.

--‍no-‍json-‍types <dir>

Omit type attributes when using slaxproc mode --json-‍to-‍xml to transform JSON input into XML.

--‍no-‍randomize

Do not initialize the random number generator. This is useful if you want the script to return identical data for a series of invocations. This option is typically only used during testing.

--‍no-‍tty

Do not use tty for the SLAX debugger and other tty-related input needs.

--‍output <file>
 -o <file>

Write output to the specified file.

--‍param <name> <value>
 -a <name> <value>

Pass a parameter to the script using the name and value pair provided. All parameters are string parameters, so normal quoting rules apply.

--‍partial
 -p

Allow the input data to contain a partial SLAX script, which can be used with the ‑‑slax‑to‑xslt or -x mode to perform partial transformations.

--‍slax-‍output
 -S

Write the results using SLAX-style XML.

--‍trace <file>
 -t <file>

Write trace data to the specified file.

--‍verbose
 -v

Add verbose internal debugging output to the trace data output, including calls to the slaxLog() function.

--‍version
 -V

Show version information and exit.

--write-‍version <version>
 -w <version>

Write the specified version number to the output file when converting a script using the --xslt-‍to-‍slax or -s mode.

This option can be used to limit the conversion to only use features in certain versions of SLAX. Acceptable values are 1.0, 1.1, 1.2. If this option is not specified, the SLAX script version defaults to the latest version.