نام (NAME)

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

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

fstrm_dump input-file [output-file]

توضیحات (DESCRIPTION)

دستور fstrm_dump فایل input-file را باز کرده و فراداده‌های فریم‌بندی آن را در stderr و داده‌های فریم را در stdout چاپ می‌کند. مقدار input-file می‌تواند "-" باشد تا داده‌های Frame Streams از ورودی استاندارد خوانده شوند.

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

"Hello, world\x0a"

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

FSTRM_CONTROL_START

FSTRM_CONTROL_FIELD_CONTENT_TYPE (N bytes)
"content-type"

Data frame (N) bytes

FSTRM_CONTROL_STOP

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

همچنین ببینید (SEE ALSO)

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