NAME

gfsmencode - Encode weights and/or label-pairs of (weighted) finite state machines

SYNOPSIS

gfsmencode [OPTIONS] BINFILE KEYFILE

 Arguments:
    BINFILE  Stored binary gfsm file to be encoded
    KEYFILE  Binary gfsm representing encoding key

 Options
    -h       --help            Print help and exit.
    -V       --version         Print version and exit.
    -d       --decode          Decode an encoded automaton (default: encode)
    -c       --costs           Encode/decode costs (weights); encodes as unweighted automaton.
    -l       --labels          Encode/decode labels (pairs); encodes as acceptor.
    -r       --reuse-key       Re-use existing KEYFILE in encoding mode.
    -u       --update-key      Update an existing KEYFILE in encoding mode.
    -zLEVEL  --compress=LEVEL  Specify compression level of output file.
    -FFILE   --output=FILE     Specifiy output file (default=stdout).

DESCRIPTION

Encode weights and/or label-pairs of (weighted) finite state machines

ARGUMENTS

BINFILE

Stored binary gfsm file to be encoded

If unspecified, standard input will be read

KEYFILE

Binary gfsm representing encoding key

If unspecified, standard input will be read in decoding mode and standard output will be written to in encoding mode.

OPTIONS

--help , -h

Print help and exit.

Default: '0'

--version , -V

Print version and exit.

Default: '0'

--decode , -d

Decode an encoded automaton (default: encode)

Default: '0'

If unspecified, argument automaton will be encoded.

--costs , -c

Encode/decode costs (weights); encodes as unweighted automaton.

Default: '0'

--labels , -l

Encode/decode labels (pairs); encodes as acceptor.

Default: '0'

--reuse-key , -r

Re-use existing KEYFILE in encoding mode.

Default: '0'

Normally, an existing KEYFSM will be ignored and overwritten in encoding mode. Specifying this option causes an existing KEYFSM file to be loaded and used for encoding, but not overwritten by default (unless --update-key (-u) is specified as well).

--update-key , -u

Update an existing KEYFILE in encoding mode.

Default: '0'

Causes an existing KEYFILE to be updated in encoding mode. Implies --reuse-key (-r).

--compress=LEVEL , -zLEVEL

Specify compression level of output file.

Default: '-1'

Specify zlib compression level of output file. -1 (default) indicates the default compression level, 0 (zero) indicates no zlib compression at all, and 9 indicates the best possible compression.

--output=FILE , -FFILE

Specifiy output file (default=stdout).

Default: '-'

ADDENDA

About this Document

Documentation file auto-generated by optgen.perl version 0.07 using Getopt::Gen version 0.13. Translation was initiated as:

   optgen.perl -l --no-handle-rcfile --nocfile --nohfile --notimestamp -F gfsmencode gfsmencode.gog

BUGS AND LIMITATIONS

Not be 100% compatibile with AT&T fsmencode, particularly regarding handling of encoded final weights. gfsmencode's final-weight encoding is intended to be more robust than the AT&T variant.

ACKNOWLEDGEMENTS

Perl by Larry Wall.

Getopt::Gen by Bryan Jurish.

AUTHOR

Bryan Jurish <moocow.bovine@gmail.com>

SEE ALSO

the gfsmutils manpage