'\" t
.\"     Title: dumpcalls
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-09-03
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "DUMPCALLS" "1" "2026-09-03" "\ \&" "\ \&"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
dumpcalls \- ذخیره فراخوانی‌های سیستم در یک فایل.
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.B گزینه‌ها
.br
\fBdumpcalls\fP
[\~\fB\-\-help\fP\~]
[\~\fB\-\-version\fP\~]
[\~\fB\-\-extcap\-interfaces\fP\~]
[\~\fB\-\-extcap\-dlts\fP\~]
[\~\fB\-\-extcap\-interface\fP=<interface>\~]
[\~\fB\-\-extcap\-config\fP\~]
[\~\fB\-\-extcap\-capture\-filter\fP=<capture\~filter>\~]
[\~\fB\-\-capture\fP\~]
[\~\fB\-\-fifo\fP=<path\~to\~file\~or\~pipe>\~]
[\~\fB\-\-log\-level\fP=<log\~level>\~]
[\~\fB\-\-log\-file\fP=<path\~to\~file>\~]
[\~\fB\-\-include\-capture\-processes\fP=<TRUE\~or\~FALSE>\~]
[\~\fB\-\-include\-switch\-calls\fP=<TRUE\~or\~FALSE>\~]
.SH "توضیحات (DESCRIPTION)"
.sp
\fBdumpcalls\fP یک ابزار extcap است که امکان ضبط فراخوانی‌های سیستم (system calls) را روی یک سیستم لینوکس فراهم می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.sp
\-\-help
.RS 4
چاپ آرگومان‌های برنامه.
این گزینه همچنین آرگومان‌های پیکربندی را برای هر پلاگین فهرست می‌کند.
.RE
.sp
\-\-version
.RS 4
چاپ نسخه برنامه.
.RE
.sp
\-\-extcap\-interfaces
.RS 4
فهرست کردن رابط‌های در دسترس.
.RE
.sp
\-\-extcap\-interface=<interface>
.RS 4
استفاده از رابط مشخص‌شده.
.RE
.sp
\-\-extcap\-dlts
.RS 4
فهرست کردن DLTهای رابط مشخص‌شده.
.RE
.sp
\-\-extcap\-config
.RS 4
فهرست کردن گزینه‌های پیکربندی رابط مشخص‌شده.
.RE
.sp
\-\-extcap\-capture\-filter=<capture filter>
.RS 4
فیلتر ضبط.
باید یک فیلتر معتبر Sysdig / Falco باشد.
.RE
.sp
\-\-capture
.RS 4
شروع ضبط از منبع تعیین‌شده توسط \-\-plugin\-source از طریق رابط مشخص‌شده و نوشتن داده‌های خام بسته در مکان تعیین‌شده توسط \-\-fifo.
.RE
.sp
\-\-fifo=<path to file or pipe>
.RS 4
ذخیره بسته ضبط‌شده در فایل یا ارسال آن از طریق لوله (pipe).
.RE
.sp
\-\-log\-level
.RS 4
تنظیم سطح گزارش‌گیری (log level).
.RE
.sp
\-\-log\-file
.RS 4
تعیین یک فایل گزارش برای ثبت پیام‌ها علاوه بر کنسول.
.RE
.sp
\-\-include\-capture\-processes
.RS 4
در صورت TRUE بودن، فراخوانی‌های سیستم برای فرایندهای ضبط (dumpcalls، dumpcap و Stratoshark) شامل می‌شوند.
پیش‌فرض FALSE است.
.RE
.sp
\-\-include\-switch\-calls
.RS 4
در صورت TRUE بودن، فراخوانی‌های "switch" شامل می‌شوند.
پیش‌فرض FALSE است.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
برای مشاهده آرگومان‌های برنامه:
.sp
.if n .RS 4
.nf
.fam C
dumpcalls \-\-help
.fam
.fi
.if n .RE
.sp
برای مشاهده نسخه برنامه:
.sp
.if n .RS 4
.nf
.fam C
dumpcalls \-\-version
.fam
.fi
.if n .RE
.sp
برای مشاهده رابط‌ها:
.sp
.if n .RS 4
.nf
.fam C
dumpcalls \-\-extcap\-interfaces
.fam
.fi
.if n .RE
.sp
تنها از یک رابط (dumpcalls) پشتیبانی می‌شود.
.sp
.B خروجی نمونه
.br
.sp
.if n .RS 4
.nf
.fam C
interface {value=dumpcalls}{display=Falco plugin}
.fam
.fi
.if n .RE
.sp
برای مشاهده DLTهای رابط:
.sp
.if n .RS 4
.nf
.fam C
dumpcalls \-\-extcap\-interface=cloudtrail \-\-extcap\-dlts
.fam
.fi
.if n .RE
.sp
.B خروجی نمونه
.br
.sp
.if n .RS 4
.nf
.fam C
dlt {number=147}{name=cloudtrail}{display=USER0}
.fam
.fi
.if n .RE
.sp
برای مشاهده گزینه‌های پیکربندی رابط:
.sp
.if n .RS 4
.nf
.fam C
dumpcalls \-\-extcap\-interface=cloudtrail \-\-extcap\-config
.fam
.fi
.if n .RE
.sp
.B خروجی نمونه
.br
.sp
.if n .RS 4
.nf
.fam C
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}
.fam
.fi
.if n .RE
.sp
برای ضبط رویدادهای AWS CloudTrail از یک باکت S3:
.sp
.if n .RS 4
.nf
.fam C
dumpcalls \-\-extcap\-interface=cloudtrail \-\-fifo=/tmp/cloudtrail.pcap \-\-plugin\-source=s3://aws\-cloudtrail\-logs.../CloudTrail/us\-east\-2/... \-\-capture
.fam
.fi
.if n .RE
.sp
یا:
.sp
.if n .RS 4
.nf
.fam C
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
.fam
.fi
.if n .RE
.if n .sp
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
.B نکته
.ps -1
.br
.sp
جهت اطمینان از خروج تمیز و بی‌نقص فرایند، برای توقف ضبط باید از \f(CRCTRL\0+\0C\fP استفاده شود.
.sp .5v
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
stratoshark(1), strato(1), dumpcap(1), extcap(4)
.SH "نکات (NOTES)"
.sp
\fBdumpcalls\fP بخشی از توزیع \fBStratoshark\fP است.
آخرین نسخه \fBStratoshark\fP را می‌توان در نشانی زیر یافت: \c
.URL "https://www.wireshark.org" "" "."
.sp
نسخه‌های HTML صفحات راهنمای پروژه Wireshark در این نشانی در دسترس هستند: \c
.URL "https://www.wireshark.org/docs/man\-pages" "" "."
.SH "نویسندگان (AUTHORS)"
.sp
.B نویسنده اصلی
.br
Gerald Combs <gerald[AT]wireshark.org>