.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "FISH" "1" "September 7, 2026" "4.9" "fish-shell"
.SH "نام (NAME)"
fish \- پوسته تعاملی و کاربرپسند خط فرمان
.SH "خلاصه دستور (SYNOPSIS)"
.nf
\fBfish\fP [\fIگزینه‌ها\fP] [\fIپرونده\fP [\fIآرگومان\fP \&...]]
\fBfish\fP [\fIگزینه‌ها\fP] [\fB\-c\fP \fIدستور\fP [\fIآرگومان\fP \&...]]
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
\fBfish\fP یک پوسته خط فرمان است که عمدتاً با تمرکز بر استفاده تعاملی طراحی و نوشته شده است.
این صفحه به‌طور خلاصه گزینه‌های مربوط به فراخوانی \fBfish\fP را شرح می‌دهد.
راهنمای کامل از طریق دستور \fBhelp\fP درون fish به‌صورت HTML و همچنین در صفحه راهنمای \fIfish\-doc(1)\fP در دسترس است.
آموزش گام‌به‌گام به‌صورت HTML از طریق \fBhelp tutorial\fP یا در \fIman fish\-tutorial\fP در دسترس قرار دارد.
.sp
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های زیر در دسترس هستند:
.INDENT 0.0
.TP
\fB\-c\fP یا \fB\-\-command=COMMAND\fP
دستورات مشخص‌شده را به‌جای خواندن از خط فرمان ارزیابی و اجرا می‌کند.
هرگونه آرگومان موضعی اضافی به‌عنوان \fB$argv\fP استفاده می‌شود.
.TP
\fB\-C\fP یا \fB\-\-init\-command=COMMANDS\fP
دستورات مشخص‌شده را پس از خواندن فایل‌های پیکربندی، اما پیش از اجرای دستور تعیین‌شده با \fB\-c\fP یا دریافت ورودی تعاملی، ارزیابی و اجرا می‌کند.
.TP
\fB\-d\fP یا \fB\-\-debug=DEBUG_CATEGORIES\fP
خروجی اشکال‌زدایی (دیباگ) را فعال کرده و یک الگو برای تطبیق دسته‌بندی‌های اشکال‌زدایی مشخص می‌کند.
برای جزئیات بیشتر به بخش اشکال‌زدایی در ادامه مراجعه کنید.
.TP
\fB\-o\fP یا \fB\-\-debug\-output=DEBUG_FILE\fP
مسیر فایلی را برای دریافت خروجی اشکال‌زدایی، از جمله دسته‌بندی‌ها و \fBfish_trace\fP، تعیین می‌کند.
پیش‌فرض خروجی خطای استاندارد (stderr) است.
.TP
\fB\-i\fP یا \fB\-\-interactive\fP
پوسته به‌صورت تعاملی اجرا می‌شود.
.TP
\fB\-l\fP یا \fB\-\-login\fP
طوری عمل می‌کند که گویی به‌عنوان یک پوسته ورود (login shell) فراخوانی شده است.
.TP
\fB\-N\fP یا \fB\-\-no\-config\fP
فایل‌های پیکربندی را نمی‌خواند.
.TP
\fB\-n\fP یا \fB\-\-no\-execute\fP
هیچ دستوری را اجرا نمی‌کند؛ تنها بررسی درستی نحو (syntax checking) را انجام می‌دهد.
.TP
\fB\-p\fP یا \fB\-\-profile=PROFILE_FILE\fP
هنگام خروج \fBfish\fP، اطلاعات زمان‌بندی تمام دستورات اجراشده را در فایل مشخص‌شده ذخیره می‌کند.
این زمان شامل زمان صرف‌شده برای راه‌اندازی اولیه و خواندن پیکربندی نمی‌شود.
.TP
\fB\-\-profile\-startup=PROFILE_FILE\fP
زمان‌بندی مربوط به راه‌اندازی اولیه \fBfish\fP را در فایل مشخص‌شده ذخیره می‌کند.
.TP
\fB\-P\fP یا \fB\-\-private\fP
حالت خصوصی را فعال می‌کند: \fBfish\fP به تاریخچه پیشین دسترسی نخواهد داشت و تاریخچه جدیدی را نیز ذخیره نمی‌کند.
.TP
\fB\-\-print\-rusage\-self\fP
هنگام خروج \fBfish\fP، آمار مصرف منابع سیستم را از getrusage چاپ می‌کند.
.TP
\fB\-\-print\-debug\-categories\fP
تمام دسته‌بندی‌های اشکال‌زدایی را چاپ کرده و سپس خارج می‌شود.
.TP
\fB\-v\fP یا \fB\-\-version\fP
نسخه برنامه را چاپ کرده و خارج می‌شود.
.TP
\fB\-f\fP یا \fB\-\-features=FEATURES\fP
یک یا چند نشانگر ویژگی (feature flag) که با کاما از هم جدا شده‌اند را فعال می‌کند.
.UNINDENT
.sp
وضعیت خروج (exit status) پوسته \fBfish\fP به‌طور کلی برابر با وضعیت خروج آخرین دستور پیش‌زمینه است.
.SH "اشکال‌زدایی (DEBUGGING)"
اگرچه fish پشتیبانی گسترده‌ای برای اشکال‌زدایی اسکریپت‌های fish فراهم می‌کند، امکان اشکال‌زدایی و بررسی سازوکارهای داخلی آن نیز وجود دارد.
اشکال‌زدایی را می‌توان با استفاده از گزینه \fB\-\-debug\fP فعال کرد.
به‌عنوان مثال، دستور زیر علاوه بر دسته‌بندی‌های پیش‌فرض یعنی \fIdebug\fP، \fIerror\fP، \fIwarning\fP و \fIwarning\-path\fP، اشکال‌زدایی مربوط به رویدادهای رشته‌های ورودی/خروجی پس‌زمینه (background IO thread) را فعال می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
> fish \-\-debug=iothread
.EE
.UNINDENT
.UNINDENT
.sp
دسته‌بندی‌های در دسترس با دستور \fBfish \-\-print\-debug\-categories\fP فهرست می‌شوند. گزینه \fB\-\-debug\fP فهرستی از دسته‌بندی‌ها را که با کاما از هم جدا شده‌اند می‌پذیرد و از نحو الگو (glob) پشتیبانی می‌کند.
دستور زیر اشکال‌زدایی برای \fIcomplete\fP، \fIhistory\fP، \fIhistory\-file\fP و \fIprofile\-history\fP را به همراه دسته‌بندی‌های پیش‌فرض فعال می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
> fish \-\-debug=\(aqcomplete,*history*\(aq
.EE
.UNINDENT
.UNINDENT
.sp
پیام‌های اشکال‌زدایی به‌طور پیش‌فرض در stderr چاپ می‌شوند. توجه داشته باشید در صورتی که \fBfish_trace\fP تنظیم شده باشد، ردگیری اجرای دستورات نیز به‌طور پیش‌فرض در stderr خروجی داده می‌شود. با استفاده از گزینه \fB\-\-debug\-output\fP می‌توانید این خروجی را در یک فایل ذخیره کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
> fish \-\-debug=\(aqcomplete,*history*\(aq \-\-debug\-output=/tmp/fish.log \-\-init\-command=\(aqset fish_trace on\(aq
.EE
.UNINDENT
.UNINDENT
.sp
این گزینه‌ها همچنین از طریق متغیرهای \fBFISH_DEBUG\fP و \fBFISH_DEBUG_OUTPUT\fP قابل تغییر هستند.
دسته‌بندی‌های فعال‌شده از طریق \fB\-\-debug\fP به دسته‌بندی‌های فعال‌شده توسط $FISH_DEBUG \fIاضافه\fP می‌شوند؛ بنابراین با قرار دادن پیشوند \fB\-\fP در ابتدای آن‌ها می‌توان غیرفعالشان کرد (برای نمونه، \fBreader\-*,\-ast*\fP اشکال‌زدایی reader را فعال و اشکال‌زدایی ast را غیرفعال می‌کند).
.sp
فایل مشخص‌شده در \fB\-\-debug\-output\fP نسبت به فایل تعیین‌شده در \fBFISH_DEBUG_OUTPUT\fP اولویت دارد.
.SH "مثال‌ها (EXAMPLES)"
برای اجرای ساده fish:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fish
.EE
.UNINDENT
.UNINDENT
.sp
برای اجرای یک فایل اسکریپت با fish:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fish /path/to/script.fish
.EE
.UNINDENT
.UNINDENT
.sp
برای اجرای چند دستور با fish:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fish \-c \(aqecho Hi there!\(aq
.EE
.UNINDENT
.UNINDENT
.sp
همچنین می‌توانید آرگومان‌هایی را به آن دستورات ارسال کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
> fish \-c \(aqprintf %s\en $argv\(aq \(dqfirst line\(dq \(dqsecond line\(dq
first line
second line
.EE
.UNINDENT
.UNINDENT
.sp
برای اجرای یک اسکریپت پس از اجرای یک فایل اولیه:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fish \-\-init\-cmd \(dqsource otherfile\(dq script.fish
.EE
.UNINDENT
.UNINDENT
.sp
برای پروفایل‌کردن زمان راه‌اندازی fish و پیدا کردن بخشی از پیکربندی که بیشترین زمان را می‌گیرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fish \-\-profile\-startup /tmp/start.prof \-ic exit
sort \-nk2 /tmp/start.prof
.EE
.UNINDENT
.UNINDENT
.SH "همچنین ببینید (SEE ALSO)"
.BR fish-doc (1),
.BR fish-tutorial (1),
.BR fish-faq (1),
.BR fish-for-bash-users (1),
.BR fish-terminal-compatibility (1),
.BR fish_indent (1),
.BR fish_key_reader (1)
.PP
وب‌سایت رسمی: <https://fishshell.com>
.SH "حق نشر (COPYRIGHT)"
توسعه‌دهندگان fish-shell
.\" پایان صفحه راهنما