Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
fstrm_dump(1)		     General Commands Manual		   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 exam-
     ple, 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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=fstrm_dump&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help