NAME

       fstrm_dump - Display metadata and contents of Frame Streams file.

SYNOPSIS

       fstrm_dump input-file [output-file]

DESCRIPTION

       fstrm_dump  opens  input-file  and prints its framing metadata to stderr and frame data to
       stdout.  The input-file may be "-" to read Frame Streams data from standard input.

       Frame data is printed as  a  single  line  quoted  string  with  non-printable  characters
       replaced  by  backslash-prefixed  hex  escape  sequences.  For example, a frame containing
       "Hello, world\n" would have its data printed as:

             "Hello, world\x0a"

       The only framing metadata expected in a Frame Streams file are  the  start  frame  with  a
       content  type  field,  the  data  frame  lengths,  and  the stop frame. These are printed,
       respectively, as:

            FSTRM_CONTROL_START

            FSTRM_CONTROL_FIELD_CONTENT_TYPE (N bytes)
             "content-type"

            Data frame (N) bytes

            FSTRM_CONTROL_STOP

       If fstrm_dump is given the second output-file parameter,  input  frames  are  additionally
       written   to   output-file.    This  is  mainly  useful  for  regression  testing  of  the
       fstrm_file_writer code.

SEE ALSO

       fstrm_capture(1), fstrm_replay(1),
       Frame Streams C Library https://farsightsec.github.io/fstrm

                                                                                    fstrm_dump(1)