manpagez: man pages & more
man fstrm_dump(1)
Home | html | info | man
fstrm_dump(1)                                                    fstrm_dump(1)




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)

fstrm 0.4.0 - Generated Fri Jan 25 20:25:03 CST 2019
© manpagez.com 2000-2025
Individual documents may contain additional copyright information.