NAME

murphi2murphi - preprocessor for Murphi models

SYNOPSIS

murphi2murphi options [--output FILE] [FILE]

DESCRIPTION

Murphi2Murphi is a utility bundled with the Rumur model checker. It can be used for various source-to-source transformations of Murphi models. It supports options for "desugaring" Rumur-specific constructs into equivalent, more widely supported Murphi constructs. It is also useful for reducing the number of different constructs that appear in a Murphi model, to simplify the job of downstream model-consuming tools.

All transformations are off by default. I.e. Murphi2Murphi will simply reproduce the source model unmodified. Transformations can be selectively enabled using the options described below. Each transformation option below has an inverse no-prefixed option (e.g. --no-explicit-semicolons for --explicit-semicolons) for disabling that transformation. Whichever occurs last, the enabling option for a transformation or the disabling option for a transformation, will take precedence.

See rumur(1) for more information about Rumur or Murphi.

OPTIONS

--decompose-complex-comparisons

Rumur supports comparing values of complex type (records and arrays) with each other using the = and != operators. Other Murphi tools typically only support the comparison of values of simple type (booleans, ranges, enums, scalarsets). This option breaks comparisons of complex typed values into element-wise comparisons of their members, for compatibility with other tools.

--explicit-semicolons

Rumur allows semi-colons to be omitted in some places within a Murphi model. E.g. the semi-colon following a rule definition is optional. This option adds semi-colons where they have been omitted, to aid other Murphi tools that may require them.

--output FILE or -o FILE

Set path to write the resulting model to. Without this option, the model is written to stdout.

--remove-liveness

Remove any liveness properties from the model. These are not supported by other Murphi tools.

--switch-to-if

Transform switch statements into if-then-else statements. This can be useful for downstream tools that then only need to handle if-then-else statements, and not also switch statements.

--to-ascii

Turn extended unicode operators into their ASCII equivalents. This makes models that use these extended characters compatible with other Murphi tools.

--version

Display version information and exit.

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.