NAME

       morbig - POSIX shell script parser

SYNOPSIS

       morbig [ option ]...  [ script-file ]...

DESCRIPTION

       The  morbig(1)  command  is  a  parser for shell scripts written in the POSIX shell script
       language. It parses the scripts statically, that is without executing them, and constructs
       a  concrete  syntax  tree  for  each  of  them.  The concrete syntax trees are built using
       constructors according to the shell grammar of the POSIX standard.

       As required by the  POSIX  standard,  morbig  does  alias  expansion  prior  to  syntactic
       analysis.  The  alias  and  unalias commands are executed by morbig, allowing for multiple
       arguments, but only when these commands occur at toplevel, that is not inside  a  compound
       control structure like a conditional construct or a loop construct. morbig raises an error
       if an alias or unalias command occurs inside a compound construct since  these  cannot  be
       handled statically.

       The  parser processes input files in order, and stops at the first error encountered. This
       behavior may be changed by using the --continue-after-error option.

OPTIONS

       The following command-line options are recognized:

       --skip-nosh
              Skip input files which either are ELF executables, or  which  start  with  a  magic
              string indicating a bash or perl script.

       --as format
              Write  for  each input file that has been successfully parsed a file containing the
              concrete syntax tree of the script. The format may be one of the following:

              bin    binary format. This format can be read  by  applications  using  the  morbig
                     OCaml library. This is the default.

              dot    graphic representation in the dot format.

              json   complete JSON output, including position information.

              simple simplified JSON output. Use this for human-readable output.

              none   do not serialise the concrete syntax tree.

       --from-stdin
              Read names of input files from standard input.

       --continue-after-error
              If   parsing   of   input  file  fails,  then  write  the  error  message  in  file
              file.morbigerror instead of stderr, and continue with the next input file. This may
              be  used to parse a large number of scripts without creating a new UNIX process for
              each of them, like this:

                   find . -name "*.sh" | morbig --continue-after-error --from-stdin

       --display-stats
              Print at the end the total number of treated input files,  the  number  of  skipped
              input files, and the number of rejected input files.

       --debug
              Activate debugging information.

       --version
              Show version number and exit.

       --help Display usage information.

AUTHORS

       morbig  has been written for the project CoLiS by Yann Régis-Gianas, Nicolas Jeannerod and
       Ralf Treinen.

                                                                                        MORBIG(1)