DUMPCALLS(1)   DUMPCALLS(1)

dumpcalls - ذخیره فراخوانی‌های سیستم در یک فایل.

گزینه‌ها
dumpcalls [ --help ] [ --version ] [ --extcap-interfaces ] [ --extcap-dlts ] [ --extcap-interface=<interface> ] [ --extcap-config ] [ --extcap-capture-filter=<capture filter> ] [ --capture ] [ --fifo=<path to file or pipe> ] [ --log-level=<log level> ] [ --log-file=<path to file> ] [ --include-capture-processes=<TRUE or FALSE> ] [ --include-switch-calls=<TRUE or FALSE> ]

dumpcalls یک ابزار extcap است که امکان ضبط فراخوانی‌های سیستم (system calls) را روی یک سیستم لینوکس فراهم می‌کند.

--help

چاپ آرگومان‌های برنامه. این گزینه همچنین آرگومان‌های پیکربندی را برای هر پلاگین فهرست می‌کند.

--version

چاپ نسخه برنامه.

--extcap-interfaces

فهرست کردن رابط‌های در دسترس.

--extcap-interface=<interface>

استفاده از رابط مشخص‌شده.

--extcap-dlts

فهرست کردن DLTهای رابط مشخص‌شده.

--extcap-config

فهرست کردن گزینه‌های پیکربندی رابط مشخص‌شده.

--extcap-capture-filter=<capture filter>;

فیلتر ضبط. باید یک فیلتر معتبر Sysdig / Falco باشد.

--capture

شروع ضبط از منبع تعیین‌شده توسط --plugin-source از طریق رابط مشخص‌شده و نوشتن داده‌های خام بسته در مکان تعیین‌شده توسط --fifo.

--fifo=<path to file or pipe>;

ذخیره بسته ضبط‌شده در فایل یا ارسال آن از طریق لوله (pipe).

--log-level

تنظیم سطح گزارش‌گیری (log level).

--log-file

تعیین یک فایل گزارش برای ثبت پیام‌ها علاوه بر کنسول.

--include-capture-processes

در صورت TRUE بودن، فراخوانی‌های سیستم برای فرایندهای ضبط (dumpcalls، dumpcap و Stratoshark) شامل می‌شوند. پیش‌فرض FALSE است.

--include-switch-calls

در صورت TRUE بودن، فراخوانی‌های "switch" شامل می‌شوند. پیش‌فرض FALSE است.

برای مشاهده آرگومان‌های برنامه:

dumpcalls --help

برای مشاهده نسخه برنامه:

dumpcalls --version

برای مشاهده رابط‌ها:

dumpcalls --extcap-interfaces

تنها از یک رابط (dumpcalls) پشتیبانی می‌شود.

خروجی نمونه

interface {value=dumpcalls}{display=Falco plugin}

برای مشاهده DLTهای رابط:

dumpcalls --extcap-interface=cloudtrail --extcap-dlts

خروجی نمونه

dlt {number=147}{name=cloudtrail}{display=USER0}

برای مشاهده گزینه‌های پیکربندی رابط:

dumpcalls --extcap-interface=cloudtrail --extcap-config

خروجی نمونه

arg {number=0}{call=--plugin-source}{display=Plugin source}{type=string}{tooltip=The plugin data source. This us usually a URL.}{placeholder=Enter a source URL…}{required=true}{group=Capture}
arg {number=1}{call=cloudtrail-s3downloadconcurrency}{display=s3DownloadConcurrency}{type=integer}{default=1}{tooltip=Controls the number of background goroutines used to download S3 files (Default: 1)}{group=Capture}
arg {number=2}{call=cloudtrail-sqsdelete}{display=sqsDelete}{type=boolean}{default=true}{tooltip=If true then the plugin will delete sqs messages from the queue immediately after receiving them (Default: true)}{group=Capture}
arg {number=3}{call=cloudtrail-useasync}{display=useAsync}{type=boolean}{default=true}{tooltip=If true then async extraction optimization is enabled (Default: true)}{group=Capture}

برای ضبط رویدادهای AWS CloudTrail از یک باکت S3:

dumpcalls --extcap-interface=cloudtrail --fifo=/tmp/cloudtrail.pcap --plugin-source=s3://aws-cloudtrail-logs.../CloudTrail/us-east-2/... --capture

یا:

dumpcalls --capture --extcap-interface cloudtrail --fifo ~/cloudtrail.pcap --plugin-source s3://my-cloudtrail-bucket/AWSLogs/o-abc12345/123456789012/ --cloudtrail-s3downloadconcurrency 32 --cloudtrail-s3interval 5d-2d --cloudtrail-aws-region eu-west-1

نکته

جهت اطمینان از خروج تمیز و بی‌نقص فرایند، برای توقف ضبط باید از CTRL + C استفاده شود.

stratoshark(1), strato(1), dumpcap(1), extcap(4)

dumpcalls بخشی از توزیع Stratoshark است. آخرین نسخه Stratoshark را می‌توان در نشانی زیر یافت: https://www.wireshark.org.

نسخه‌های HTML صفحات راهنمای پروژه Wireshark در این نشانی در دسترس هستند: https://www.wireshark.org/docs/man-pages.

نویسنده اصلی
Gerald Combs <gerald[AT]wireshark.org>

2026-09-03