NAME

       murphi2smv - translate a Murphi model to SMV

SYNOPSIS

       murphi2smv [--output FILE | -o FILE] FILE

DESCRIPTION

       The  utility  murphi2smv  is  bundled  with the model checker Rumur and can be used to translate a Murphi
       model into the input format to the NuSMV model checker. See rumur(1) for more information about Rumur  or
       Murphi.

OPTIONS

       --help or -?
              Display usage information.

       --numeric-type [integer | word] or -n [integer | word]
              Set  the  SMV type used for ranges, scalarsets and numeric literals. This can be either integer to
              use native integers or word to  use  bit-vectors.  If  this  option  is  omitted,  one  is  chosen
              automatically based on the content of the input model.

       --output FILE or -o FILE
              Set  the  path to write the output SMV model to. If this argument is omitted, output is written to
              standard out.

       --quiet or -q
              Silence warning diagnostics.

       --verbose or -v
              Report extra debugging information.

       --version
              Display version information and exit.

NOTES

       Translation to SMV is imprecise because the  semantics  of  model  execution  in  SMV  are  significantly
       different  to  Murphi.  murphi2smv should not be expected to give you a ready-to-run SMV model. Rather it
       gives you an initial rough translation that you will need to edit to form a runnable model.

LIMITATIONS

       Murphi type declarations have no exact equivalent in SMV. These are handled by propagating and  expanding
       them inline. This is done purely syntactically, which can lead to unexpected or incorrect results if your
       input model has symbols that shadow other symbols.

       The following Murphi constructs have no equivalent in SMV and are emitted as a placeholder comment:

              • alias declarations

              • alias rules

              • alias statements

              • assume, cover, and liveness properties

              • clear statements

              • error statements

              • exists expressions

              • for loops

              • forall expressions

              • functions, procedures, and calls to these

              • if statements

              • isundefined statements

              • property statements

              • quantifiers

              • record definitions

              • simple rules

              • rulesets

              • switch statements

              • undefine statements

              • while statements

       You will need to either rephrase your input model to avoid these features or edit the generated SMV after
       generation.

       Rumur  supports  integers  up to 64-bit in width. SMV integers are only 32-bit.  There are no checks that
       the numbers or calculations in  the  input  model  fit  in  32-bit.  This  may  result  in  constants  or
       calculations in the generated SMV that overflow.

       Murphi  rule-local  declarations  and  variables  have  no equivalent in SMV. These are emitted using SMV
       syntax but will need to be moved to a valid location within the SMV output.

SEE ALSO

       rumur(1)

AUTHOR

       All   comments,   questions   and    complaints    should    be    directed    to    Matthew    Fernandez
       <matthew.fernandez@gmail.com>.

LICENSE

       This is free and unencumbered software released into the public domain.

       Anyone  is  free  to  copy,  modify,  publish, use, compile, sell, or distribute this software, either in
       source code form or as a compiled binary, for any purpose,  commercial  or  non-commercial,  and  by  any
       means.

       In  jurisdictions  that recognize copyright laws, the author or authors of this software dedicate any and
       all copyright interest in the software to the public domain. We make this dedication for the  benefit  of
       the  public at large and to the detriment of our heirs and successors. We intend this dedication to be an
       overt act of relinquishment in perpetuity of all  present  and  future  rights  to  this  software  under
       copyright law.

       THE  SOFTWARE  IS  PROVIDED  “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
       LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND  NONINFRINGEMENT.   IN
       NO  EVENT  SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
       CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR  OTHER
       DEALINGS IN THE SOFTWARE.

       For more information, please refer to <http://unlicense.org>

                                                                                                   MURPHI2SMV(1)