| oggz-dump(1) | General Commands Manual | oggz-dump(1) |
نام (NAME)
oggz-dump - استخراج دامپ هگزادسیمال بسته‌های یک فایل Ogg یا بازگردانی فایل Ogg از روی چنین دامپی
خلاصه دستور (SYNOPSIS)
oggz-dump [-b | --binary ] [-x | --hexadecimal ] [-n | --new ] [-o filename | --output filename ] [-c content-type | --content-type content-type ] [-s serialno | --serialno serialno ] [-O | --hide-offset ] [-S | --hide-serialno ] [-G | --hide-granulepos ] [-P | --hide-packetno ] filename
oggz-dump [-r | --revert ] [-o filename | --output filename ] filename
oggz-dump [-h | --help ] [-v | --version ]
توضیحات (DESCRIPTION)
دستور oggz-dump یک دامپ هگزادسیمال یا باینری از بسته‌های موجود در یک فایل Ogg تولید می‌کند، یا یک فایل Ogg را از روی یک فایل هگزادسیمال oggz-dump بازسازی می‌نماید.
گزینه‌ها (OPTIONS)
دستور oggz-dump گزینه‌های زیر را می‌پذیرد:
گزینه‌های قالب دامپ (Dump format options)
- -b, --binary
- تولید یک دامپ باینری از هر بسته.
- -x, --hexadecimal
- تولید یک دامپ هگزادسیمال از هر بسته.
گزینه‌های پالایش (Filtering options)
- -n, --new
- فقط اولین بسته از هر جریان بیتی منطقی جدیدِ یافت‌شده را دامپ می‌کند؛ در فایل‌های خوش‌ساخت و استاندارد Ogg، این گزینه تنها بسته‌های ابتدای جریان (bos) را دامپ خواهد کرد.
- -c content-type, --content-type content-type
- تنها جریان‌های بیتی منطقی مربوط به یک content-type (نوع محتوا) مشخص را دامپ می‌کند. برای مشاهده فهرست کاملی از کدک‌های شناخته‌شده توسط نسخه نصب‌شده oggz، دستور oggz-known-codecs(1) را اجرا کنید.
- -s serialno, --serialno serialno
- تنها جریان بیتی منطقی با serialno (شماره سریال) مشخص‌شده را دامپ می‌کند.
- -O, --hide-offset
- فیلد آفست بایتی (byte offset) دیباچه را برای هر بسته دامپ‌شده پنهان می‌کند. این گزینه به‌ویژه هنگام استفاده همراه با oggzdiff(1) جهت مقایسه جریان‌های بیتی Ogg که فقط در ساختار صفحه تفاوت دارند، بسیار سودمند است.
- -S, --hide-serialno
- فیلد serialno (شماره سریال) دیباچه را برای هر بسته دامپ‌شده پنهان می‌کند. این گزینه به‌ویژه هنگام استفاده همراه با oggzdiff(1) جهت مقایسه جریان‌های بیتی Ogg که تنها در تخصیص شماره سریال با یکدیگر تفاوت دارند، بسیار مفید است.
- -G, --hide-granulepos
- فیلد granulepos (موقعیت گرانول) دیباچه را برای هر بسته دامپ‌شده پنهان می‌کند.
- -P, --hide-packetno
- فیلد packetno (شماره بسته) دیباچه را برای هر بسته دامپ‌شده پنهان می‌کند.
گزینه‌های حالت (Mode options)
- -r, --revert
- بازگردانی یک oggz-dump. یک جریان بیتی Ogg را مطابق آنچه در فایل ورودی oggz-dump تعیین شده است، تولید می‌کند.
- فیلدهای serialno، granulepos و packetno از دیباچه بسته‌ها در oggz-dump و همچنین نشانگرهای bos یا eos در صورت وجود، برای ساختاربندی بسته‌ها در جریان‌های بیتی منطقی به کار می‌روند. از این رو توصیه می‌شود فایل ورودی اولیه oggz-dump با هیچ‌یک از فیلترهای پنهان‌سازی تولید نشده باشد.
- هنگام تولید داده‌های بسته‌های Ogg، تنها ستون‌های داده‌های هگزادسیمال فایل ورودی oggz-dump تحلیل می‌شوند؛ نمایش نویسه‌های قابل چاپ نادیده گرفته می‌شود.
گزینه‌های متفرقه (Miscellaneous options)
- -o filename, --output filename
- نوشتن خروجی در filename مشخص‌شده به جای چاپ آن در خروجی استاندارد.
- -h, --help
- نمایش اطلاعات راهنما و نحوه استفاده و خروج.
- -v, --version
- نمایش اطلاعات نسخه و خروج.
مثال‌ها (EXAMPLES)
دامپ تمام جریان‌های بیتی در file.ogg:
تنها دامپ جریان بیتی Theora در file.ogv:
نویسنده (AUTHOR)
Conrad Parker November 17, 2003;
حق نشر (COPYRIGHT)
Copyright © 2003 CSIRO Australia
همچنین ببینید (SEE ALSO)
oggz-diff(1), hogg(1) xxd(1), hexdump(1)