.TH fstrm_dump 1

.SH "نام (NAME)"

fstrm_dump \- نمایش فراداده و محتوای فایل Frame Streams.

.SH "خلاصه دستور (SYNOPSIS)"

.B fstrm_dump \fIinput-file\fB [\fIoutput-file\fB]

.SH "توضیحات (DESCRIPTION)"

دستور
.B fstrm_dump
فایل
.I input-file
را باز کرده و فراداده‌های فریم‌بندی آن را در \fIstderr\fR و داده‌های فریم را در \fIstdout\fR چاپ می‌کند.
مقدار
.I input-file
می‌تواند "-" باشد تا داده‌های Frame Streams از ورودی استاندارد خوانده شوند.

داده‌های فریم به صورت یک رشته در یک خط داخل گیومه چاپ می‌شوند که در آن نویسه‌های غیرقابل‌چاپ با توالی‌های گریز هگزادسیمال همراه با پیشوند بک‌اسلش جایگزین شده‌اند. برای مثال، داده‌های فریمی که حاوی "Hello, world\\n" باشد به شکل زیر چاپ می‌شود:

	 "Hello, world\\x0a"

تنها فراداده‌های فریم‌بندی مورد انتظار در یک فایل Frame Streams عبارتند از: فریم آغازین با یک فیلد نوع محتوا (content type)، طول فریم‌های داده، و فریم پایانی. این موارد به ترتیب به شکل زیر چاپ می‌شوند:

	FSTRM_CONTROL_START

	FSTRM_CONTROL_FIELD_CONTENT_TYPE (\fIN\fR bytes)
.br
	 "\fIcontent-type\fR"

	Data frame (\fIN\fR) bytes

	FSTRM_CONTROL_STOP

اگر به
.B fstrm_dump
پارامتر دوم یعنی
.I output-file
داده شود، فریم‌های ورودی علاوه بر این در
.I output-file
نیز نوشته می‌شوند. این قابلیت عمدتاً برای آزمون رگرسیون (regression testing) کد
.I fstrm_file_writer
مفید است.

.SH "همچنین ببینید (SEE ALSO)"

.BR fstrm_capture (1),
.BR fstrm_replay (1),
.br
Frame Streams C Library \fBhttps://farsightsec.github.io/fstrm\fR