'\" t
.\"     Title: sshdig
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-09-03
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: Persian
.\"
.TH "SSHDIG" "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)"
sshdig \- فراهم کردن رابط‌هایی برای ضبط فراخوان‌های سیستمی از یک میزبان راه‌دور از طریق SSH با استفاده از باینری ضبط راه‌دور
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBsshdig\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\-\-remote\-host\fP=<IP\~address>\~]
[\~\fB\-\-remote\-port\fP=<TCP\~port>\~]
[\~\fB\-\-remote\-username\fP=<username>\~]
[\~\fB\-\-remote\-password\fP=<password>\~]
[\~\fB\-\-sshkey\fP=<private\~key\~path>\~]
[\~\fB\-\-sshkey\-passphrase\fP=<private\~key\~passphrase>\~]
[\~\fB\-\-proxycommand\fP=<SSH\~proxy\~command>\~]
[\~\fB\-\-remote\-capture\-command\-select\fP=<capture\~command\~selection>\~]
[\~\fB\-\-remote\-capture\-command\fP=<capture\~command>\~]
[\~\fB\-\-remote\-priv\fP=<privilege\~elevation\~command\~selection>\~]
[\~\fB\-\-remote\-priv\-user\fP=<privileged\~user\~name>\~]
[\~\fB\-\-remote\-filter\fP=<remote\~capture\~filter>\~]
[\~\fB\-\-remote\-count\fP=<number>\~]
[\~\fB\-\-remote\-modern\-bpf\fP\~]
[\~\fB\-\-remote\-io\-snaplen\fP=<snapshot\~length>\~]
.sp
\fBsshdig\fP
\fB\-\-extcap\-interfaces\fP
.sp
\fBsshdig\fP
\fB\-\-extcap\-interface\fP=<interface>
\fB\-\-extcap\-dlts\fP
.sp
\fBsshdig\fP
\fB\-\-extcap\-interface\fP=<interface>
\fB\-\-extcap\-config\fP
.sp
\fBsshdig\fP
\fB\-\-extcap\-interface\fP=<interface>
\fB\-\-fifo\fP=<path\~to\~file\~or\~pipe>
\fB\-\-capture\fP
\fB\-\-remote\-host=myremotehost\fP
\fB\-\-remote\-port=22\fP
\fB\-\-remote\-username=user\fP
\fB\-\-remote\-capture\-command=\*(Aqsysdig\~\-\-unbuffered\~\-\-write=\-\*(Aq\fP
.SH "توضیحات (DESCRIPTION)"
.sp
ابزار \fBSshdig\fP یک ابزار extcap است که امکان ضبط فراخوان‌های سیستمی (system calls) را از طریق اتصال SSH فراهم می‌کند.
شما باید مجوزهای لازم برای ضبط فراخوان‌های سیستمی در سیستم راه‌دور را داشته باشید.
.sp
این قابلیت از نظر عملکردی معادل دستورهای زیر است:
.sp
.if n .RS 4
.nf
.fam C
$ ssh remoteuser@remotehost \-p 22222 \*(Aqsysdig \-\-unbuffered \-w \-\*(Aq > FILE &
$ stratoshark FILE
.fam
.fi
.if n .RE
.sp
معمولاً sshdig به‌طور مستقیم اجرا نمی‌شود؛ در عوض می‌توان آن را از طریق رابط گرافیکی کاربر Stratoshark یا خط فرمان آن پیکربندی کرد. دستور زیر Stratoshark را اجرا کرده و ضبط را از میزبان \fBremotehost\fP آغاز می‌کند:
.sp
.if n .RS 4
.nf
.fam C
$ stratoshark \*(Aq\-oextcap.sshdig.remotehost:myserver.home.arpa\*(Aq \-i sshdig \-k
.fam
.fi
.if n .RE
.sp
رابط‌های پشتیبانی‌شده:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 1." 4.2
.\}
sshdig
.RE
.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
فیلتر ضبط. این مقدار متناظر با مقداری است که از طریق گزینه \fBtshark \-f\fP و فیلد Capture Filter در کنار فهرست رابط‌ها در رابط کاربری Stratoshark ارائه می‌شود.
.RE
.sp
\-\-capture
.RS 4
آغاز ضبط از رابط مشخص‌شده و نوشتن داده‌های خام بسته در مکانی که توسط \-\-fifo مشخص شده است.
.RE
.sp
\-\-fifo=<path to file or pipe>
.RS 4
ذخیره بسته ضبط‌شده در فایل یا ارسال آن از طریق لوله (pipe).
.RE
.sp
\-\-remote\-host=<remote host>
.RS 4
نشانی میزبان راه‌دور برای ضبط.
.RE
.sp
\-\-remote\-port=<remote port>
.RS 4
درگاه SSH میزبان راه‌دور.
.RE
.sp
\-\-remote\-username=<username>
.RS 4
نام کاربری برای احراز هویت SSH.
.RE
.sp
\-\-remote\-password=<password>
.RS 4
گذرواژه مورد استفاده (در صورتی که از ssh\-agent و کلید عمومی استفاده نشود). هشدار: گذرواژه‌ها به صورت متن ساده (plaintext) ذخیره می‌شوند و برای تمام کاربران این سیستم قابل مشاهده هستند. توصیه می‌شود از فایل‌های کلید به همراه یک SSH agent استفاده شود.
.RE
.sp
\-\-sshkey=<SSH private key path>
.RS 4
مسیر کلید خصوصی برای احراز هویت. نکته: تنها قالب جفت کلید/مقدار OPENSSH پشتیبانی می‌شود.
.RE
.sp
\-\-sshkey\-passphrase=<SSH private key passphrase>
.RS 4
عبارت عبور کلید خصوصی برای احراز هویت.
.RE
.sp
\-\-proxycommand=<proxy command>
.RS 4
دستوری که به عنوان پراکسی برای اتصال SSH استفاده می‌شود.
.RE
.sp
\-\-remote\-capture\-command\-select=<capture command\-selection>
.RS 4
دستوری که باید در سیستم راه‌دور اجرا شود. این مقدار یا \fBsysdig\fP برای دستور ضبط راه‌دور با استفاده از sysdig است، یا \fBother\fP، که در آن دستور ضبط راه‌دور باید با گزینه \fB\-\-remote\-capture\-command\fP ارائه شود.
.RE
.sp
\-\-remote\-capture\-command=<capture command>
.RS 4
یک دستور سفارشی ضبط راه‌دور که جریان راه‌دوری را تولید می‌کند که در Stratoshark نشان داده می‌شود. این دستور باید قادر به تولید یک جریان .scap باشد که در STDOUT نوشته می‌شود.
.RE
.sp
\-\-remote\-priv=<privilege elevation command selection>
.RS 4
دستوری که برای ارتقای سطح دسترسی جهت ضبط در میزبان راه‌دور استفاده می‌شود. یکی از مقادیر none، sudo یا doas.
.RE
.sp
\-\-remote\-priv\-user=<privileged user name>
.RS 4
اگر دستوری که برای ارتقای سطح دسترسی جهت ضبط در میزبان راه‌دور به کار می‌رود نیاز به نام کاربری داشته باشد، می‌توان آن را در اینجا مشخص کرد.
.RE
.sp
\-\-remote\-filter=<capture filter>
.RS 4
فیلتر ضبط راه‌دور. این فیلتر به برنامه ضبط راه‌دور ارسال می‌شود و باید با قواعد دستوری (syntax) آن مطابقت داشته باشد.
.RE
.sp
\-\-remote\-count=<number>
.RS 4
تعداد رویدادها برای ضبط.
.RE
.sp
\-\-remote\-modern\-bpf
.RS 4
ضبط با استفاده از کاوشگر eBPF به جای ماژول هسته.
.RE
.sp
\-\-remote\-io\-snaplen=<snapshot length>
.RS 4
تعداد بایت‌ها برای ضبط در هر رویداد ورودی/خروجی (I/O).
.RE.SH "مثال‌ها (EXAMPLES)"
.sp
برای مشاهده آرگومان‌های برنامه:
.sp
.if n .RS 4
.nf
.fam C
sshdig \-\-help
.fam
.fi
.if n .RE
.sp
برای مشاهده نسخه برنامه:
.sp
.if n .RS 4
.nf
.fam C
sshdig \-\-version
.fam
.fi
.if n .RE
.sp
برای مشاهده رابط‌ها:
.sp
.if n .RS 4
.nf
.fam C
sshdig \-\-extcap\-interfaces
.fam
.fi
.if n .RE
.sp
تنها یک رابط (sshdig) پشتیبانی می‌شود.
.sp
.B خروجی نمونه
.br
.sp
.if n .RS 4
.nf
.fam C
interface {value=sshdig}{display=SSH remote syscall capture}
.fam
.fi
.if n .RE
.sp
برای مشاهده DLTهای رابط:
.sp
.if n .RS 4
.nf
.fam C
sshdig \-\-extcap\-interface=sshdig \-\-extcap\-dlts
.fam
.fi
.if n .RE
.sp
.B خروجی نمونه
.br
.sp
.if n .RS 4
.nf
.fam C
dlt {number=147}{name=sshdig}{display=Remote capture dependent DLT}
.fam
.fi
.if n .RE
.sp
برای مشاهده گزینه‌های پیکربندی رابط:
.sp
.if n .RS 4
.nf
.fam C
sshdig \-\-extcap\-interface=sshdig \-\-extcap\-config
.fam
.fi
.if n .RE
.sp
.B خروجی نمونه
.br
.sp
.if n .RS 4
.nf
.fam C
arg {number=0}{call=\-\-remote\-host}{display=Remote SSH server address}{type=string}{tooltip=The remote SSH host. It can be both an IP address or a hostname}{required=true}{group=Server}
arg {number=1}{call=\-\-remote\-port}{display=Remote SSH server port}{type=unsigned}{default=22}{tooltip=The remote SSH host port (1\-65535)}{range=1,65535}{group=Server}
arg {number=2}{call=\-\-remote\-username}{display=Remote SSH server username}{type=string}{tooltip=The remote SSH username. If not provided, the current user will be used}{group=Authentication}
arg {number=3}{call=\-\-remote\-password}{display=Remote SSH server password}{type=password}{tooltip=The SSH password, used when other methods (SSH agent or key files) are unavailable.}{group=Authentication}
arg {number=4}{call=\-\-sshkey}{display=Path to SSH private key}{type=fileselect}{tooltip=The path on the local filesystem of the private SSH key (OpenSSH format)}{mustexist=true}{group=Authentication}
arg {number=5}{call=\-\-sshkey\-passphrase}{display=SSH key passphrase}{type=password}{tooltip=Passphrase to unlock the SSH private key}{group=Authentication}
arg {number=6}{call=\-\-proxycommand}{display=ProxyCommand}{type=string}{tooltip=The command to use as proxy for the SSH connection}{group=Authentication}
arg {number=7}{call=\-\-ssh\-sha1}{display=Support SHA\-1 keys (deprecated)}{type=boolflag}{tooltip=Support keys and key exchange algorithms using SHA\-1 (deprecated)}{group=Authentication}
arg {number=8}{call=\-\-remote\-capture\-command\-select}{display=Remote capture command selection}{type=radio}{tooltip=The remote capture command to build a command line for}{group=Capture}
value {arg=8}{value=sysdig}{display=sysdig}
value {arg=8}{value=other}{display=Other:}
arg {number=9}{call=\-\-remote\-capture\-command}{display=Remote capture command}{type=string}{tooltip=The remote command used to capture}{group=Capture}
arg {number=10}{call=\-\-remote\-priv}{display=Gain capture privilege on the remote machine}{type=radio}{tooltip=Optionally prepend the capture command with sudo or doas on the remote machine}{group=Capture}
value {arg=10}{value=none}{display=none}{default=true}
value {arg=10}{value=sudo}{display=sudo}
value {arg=10}{value=doas \-n}{display=doas}
arg {number=11}{call=\-\-remote\-priv\-user}{display=Privileged user name for sudo or doas}{type=string}{tooltip=User name of privileged user to execute the capture command on the remote machine}{group=Capture}
{group=Capture}
arg {number=12}{call=\-\-remote\-count}{display=Packets to capture}{type=unsigned}{default=0}{tooltip=The number of remote packets to capture. (Default: inf)}{group=Capture}
arg {number=13}{call=\-\-log\-level}{display=Set the log level}{type=selector}{tooltip=Set the log level}{required=false}{group=Debug}
value {arg=13}{value=message}{display=Message}{default=true}
value {arg=13}{value=info}{display=Info}
value {arg=13}{value=debug}{display=Debug}
value {arg=13}{value=noisy}{display=Noisy}
arg {number=14}{call=\-\-log\-file}{display=Use a file for logging}{type=fileselect}{tooltip=Set a file where log messages are written}{required=false}{group=Debug}
.fam
.fi
.if n .RE
.sp
برای ضبط:
.sp
.if n .RS 4
.nf
.fam C
sshdig \-\-extcap\-interface=sshdig \-\-fifo=/tmp/ssh.scap \-\-capture \-\-remote\-host 192.168.1.10
\-\-remote\-username user
.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
.sp
فایل باینری sshdig را می‌توان برای پشتیبانی از چندین نمونه تغییر نام داد. برای مثال اگر بخواهیم sshdig دو بار در Stratoshark نمایش داده شود (مثلاً برای مدیریت چندین نمایه)، می‌توانیم sshdig را به sshdig\-host1 و sshdig\-host2 کپی کنیم. هر فایل باینری نام رابطی یکسان با نام فایل اجرایی را نشان خواهد داد. فایل‌های اجرایی که «sshdig» نباشند، در توضیحات منبع ضبط به‌عنوان «custom version» نمایش داده خواهند شد..SH "همچنین ببینید (SEE ALSO)"
.sp
stratoshark(1), strato(1), dumpcap(1), extcap(4)
.SH "نکات (NOTES)"
.sp
\fBSshdig\fP بخشی از توزیع \fBStratoshark\fP است. آخرین نسخه از \fBStratoshark\fP را می‌توان در این نشانی یافت:\c
.URL "https://www.wireshark.org" "" "."
.sp
نسخه‌های HTML صفحات راهنمای پروژهٔ Stratoshark در این نشانی در دسترس هستند:\c
.URL "https://www.wireshark.org/docs/man\-pages" "" "."
.SH "نویسندگان (AUTHORS)"
.sp
.B نویسنده اصلی
.br
Dario Lombardo <lomato[AT]gmail.com>