.\" -*- nroff -*-
.TH STAP-JUPYTER-* 1
.SH "نام (NAME)"
stap-jupyter-install \- نصب محلی isystemtap

stap-jupyter-container \- مدیریت تصویر کانتینر isystemtap

.\" macros
.de SAMPLE

.nr oldin \\n(.i
.br
.RS
.nf
.nh
..
.de ESAMPLE
.hy
.fi
.RE
.in \\n[oldin]u

..

.SH "خلاصه دستور (SYNOPSIS)"
\fBstap-jupyter-install\fR
[\fB--remove\fR]
[\fB--container-install\fR \fIPREFIX\fR]

\fBstap-jupyter-container\fR
[\fB--repo\fR \fIREPOSITORY\fR]
[\fB--image\fR \fIIMAGE\fR]
[\fB--tag\fR \fITAG\fR]
[\fB--keyname\fR \fIKEYNAME\fR]
--{\fBrun\fR, \fBpull\fR, \fBbuild\fR, \fBpublish\fR, \fBremove\fR}

.SH "توضیحات (DESCRIPTION)"
برنامه ISystemtap یک رابط تعاملی jupyter برای نوشتن و اجرای تدریجی اسکریپت‌های Systemtap است.

برنامه \fIstap-jupyter-install\fR می‌تواند برای نصب محلی کرنل jupyter مربوط به ISystemtap، language-server و افزونه jupyter-lab در مسیر ~/.systemtap/jupyter استفاده شود. پس از نصب، این کرنل همراه با \fIjupyter-lab\fR قابل استفاده خواهد بود.

همچنین برنامه \fIstap-jupyter-container\fR می‌تواند برای اجرای ISystemtap درون یک کانتینر به کار رود و نیاز به هرگونه نصب محلی کرنل jupyter را برطرف سازد.

.SH "گزینه‌های نصب (INSTALL OPTIONS)"
گزینه‌های زیر توسط stap-jupyter-install پشتیبانی می‌شوند. هر گزینه دیگری یک پیام راهنمای کوتاه چاپ می‌کند.
.IP "\fB--remove\fR"
حذف فایل‌های محلی ISystemtap.
.IP "\fB--container-install\fR \fIPREFIX\fR"
\fB[تنها ویژه نگه‌دارنده‌ها]\fR این گزینه برای تعیین \fIPREFIX\fR دایرکتوری نصب برای \fIstap\fR به کار می‌رود. این گزینه درون فرایند ساخت کانتینر فراخوانی می‌شود و نباید در حالت‌های دیگر استفاده گردد.
.SH "گزینه‌های کانتینر (CONTAINER OPTIONS)"
گزینه‌های زیر توسط stap-jupyter-container پشتیبانی می‌شوند. هر گزینه دیگری یک پیام راهنمای کوتاه چاپ می‌کند.
.IP "\fB--repo\fR \fIREPOSITORY\fR"
تعیین مخزن مورد استفاده؛ پیش‌فرض "quay.io" است.
.IP "\fB--image\fR \fIIMAGE\fR"
تعیین نام تصویر؛ پیش‌فرض "systemtap/isystemtap" است.
.IP "\fB--tag\fR \fITAG\fR"
تعیین برچسب (tag) تصویر؛ پیش‌فرض "latest" است.
.IP "\fB--keyname\fR \fIKEYNAME\fR"
برای اینکه کانتینر بتواند \fIstap\fR را اجرا کند، باید از طریق \fIssh\fR به سیستم میزبان متصل شود. این کار به یک جفت‌کلید ssh نیاز دارد که با \fIKEYNAME\fR مشخص می‌شود و پیش‌فرض آن "id_rsa" است.

.SH "دستورهای کانتینر (CONTAINER COMMANDS)"
دستورهای زیر توسط stap-jupyter-container شناخته می‌شوند. انتخاب یکی از موارد زیر الزامی است.
.IP "\fB--run\fR"
اجرای تصویر. در صورتی که قبلاً دریافت نشده باشد، آن را pull می‌کند.
.IP "\fB--pull\fR"
تصویر را دریافت (pull) می‌کند.
.IP "\fB--build\fR"
یک نسخه محلی از تصویر می‌سازد. مخزن "localhost" خواهد بود. تصاویر \fIpodman\fR را ببینید.
.IP "\fB--remove\fR"
تصویر را حذف می‌کند.
.IP "\fB--publish\fR"
\fB[تنها ویژه نگه‌دارنده‌ها]\fR این گزینه برای انتشار تصویر ساخته‌شده به کار می‌رود. این کار نیازمند دسترسی‌های نوشتن در
.nh
https://quay.io/systemtap/isystemtap
.hy
است.

.SH "همچنین ببینید (SEE ALSO)"
.nh
.nf
.IR stap (1),
.IR podman (1)
.IR ssh (1)

.SH "گزارش باگ‌ها (BUGS)"
از پیوند Bugzilla در صفحه وب پروژه یا فهرست پستی ما استفاده کنید.
.nh
.BR http://sourceware.org/systemtap , <systemtap@sourceware.org> .
.hy