.TH ENV "1" "July 2026" "GNU coreutils 9.11" "دستورات کاربر"
.SH "نام (NAME)"
env \- اجرای یک برنامه در یک محیط تغییریافته یا چاپ متغیرهای محیط
.SH "خلاصه دستور (SYNOPSIS)"
.B env
[\fI\,گزینه‌ها\/\fR]... [\fI\,\-\/\fR] [\fI\,نام=مقدار\/\fR]... [\fI\,دستور \/\fR[\fI\,آرگومان‌ها\/\fR]...]
.SH "توضیحات (DESCRIPTION)"
.PP
تنظیم هر \fIنام\fR به \fIمقدار\fR در محیط و اجرای \fIدستور\fR.
.PP
آرگومان‌های اجباری برای گزینه‌های طولانی، برای گزینه‌های کوتاه نیز اجباری هستند.
.TP
\fB\-a\fR, \fB\-\-argv0\fR=\fI\,ARG\/\fR
ارسال ARG به‌عنوان آرگومان صفرم دستور
.TP
\fB\-i\fR, \fB\-\-ignore\-environment\fR
شروع با یک محیط خالی
.TP
\fB\-0\fR, \fB\-\-null\fR
خاتمه دادن به هر خط خروجی با نویسه NUL به جای خط جدید (newline)
.TP
\fB\-u\fR, \fB\-\-unset\fR=\fI\,NAME\/\fR
حذف متغیر مشخص‌شده از محیط
.TP
\fB\-C\fR, \fB\-\-chdir\fR=\fI\,DIR\/\fR
تغییر دایرکتوری کاری به DIR
.TP
\fB\-S\fR, \fB\-\-split\-string\fR=\fI\,S\/\fR
پردازش و تفکیک S به آرگومان‌های مجزا؛ برای ارسال چندین آرگومان در خطوط شِبنگ (shebang) استفاده می‌شود
.TP
\fB\-\-block\-signal\fR[=\fI\,SIG\/\fR]
مسدود کردن تحویل سیگنال(های) SIG به دستور
.TP
\fB\-\-default\-signal\fR[=\fI\,SIG\/\fR]
بازنشانی نحوه مدیریت سیگنال(های) SIG به حالت پیش‌فرض
.TP
\fB\-\-ignore\-signal\fR[=\fI\,SIG\/\fR]
تنظیم نحوه مدیریت سیگنال(های) SIG برای عدم انجام هیچ عملیاتی (نادیده‌گرفتن)
.TP
\fB\-\-list\-signal\-handling\fR
فهرست کردن وضعیت مدیریت سیگنال‌های غیر پیش‌فرض در خطای استاندارد
.TP
\fB\-v\fR, \fB\-\-debug\fR
چاپ اطلاعات تفصیلی و اشکال‌زدایی برای هر مرحله از پردازش
.TP
\fB\-\-help\fR
نمایش این راهنما و خروج
.TP
\fB\-\-version\fR
نمایش اطلاعات نسخه و خروج
.PP
درج یک
.B \-
به‌تنهایی به‌معنای
.B \-i
است. اگر هیچ دستوری تعیین نشود، محیط حاصل چاپ می‌شود.
.SS "سیگنال‌ها (SIGNALS)"
مقدار
.I SIG
می‌تواند نام یک سیگنال مانند 'PIPE' یا شماره سیگنال مانند '13' باشد. در صورت مشخص نشدن
.IR SIG ،
تمامی سیگنال‌های شناخته‌شده لحاظ می‌شوند. چندین سیگنال را می‌توان با کاما از یکدیگر جدا کرد. یک آرگومان
.I SIG
خالی هیچ عملیاتی انجام نمی‌دهد (no-op).
.SS "وضعیت خروج (Exit status)"
.TP
125
در صورتی که خود دستور env با شکست مواجه شود
.TP
126
در صورتی که دستور مشخص‌شده پیدا شود اما قابل فراخوانی نباشد
.TP
127
در صورتی که دستور مشخص‌شده یافت نشود
.TP
\-
در غیر این صورت، وضعیت خروج خود دستور مشخص‌شده
.SH "مدیریت گزینه‌ها در اسکریپت (SCRIPT OPTION HANDLING)"
گزینه
.B \-S
امکان مشخص کردن چندین آرگومان را در یک اسکریپت فراهم می‌کند.
اجرای اسکریپتی با نام
.B 1.pl
که شامل خط آغازین زیر باشد:
.PP
.RS
.nf
#!/usr/bin/env \-S perl \-w \-T
\&...
.fi
.RE
.PP
دستور زیر را اجرا خواهد کرد:
.PP
.B "perl \-w \-T 1.pl"
.PP
بدون گزینه
.B '\-S'
اسکریپت احتمالاً با خطای زیر با شکست مواجه می‌شود:
.PP
.RS
.nf
/usr/bin/env: 'perl \-w \-T': No such file or directory
.fi
.RE
.PP
برای جزئیات بیشتر، مستندات کامل را ببینید.
.PP
.SH "یادداشت‌ها (NOTES)"
صفحه
\fBexec\fP(3p)
در استاندارد POSIX بیان می‌کند:
.RS
«بسیاری از برنامه‌های کاربردی موجود به اشتباه فرض می‌کنند که با سیگنال‌های خاصی که بر روی عمل پیش‌فرض تنظیم شده‌اند و/یا مسدود نشده‌اند آغاز به کار می‌کنند.... بنابراین، بهتر است بدون دلیلی مشخص، سیگنال‌ها را در حین فراخوانی exec مسدود نکرده یا نادیده نگیرید، و به‌ویژه نباید سیگنال‌ها را در سراسر فراخوانی‌های exec برنامه‌های دلخواه (که همکاری نزدیکی با یکدیگر ندارند) مسدود نمایید.»
.RE
.SH "نویسنده (AUTHOR)"
نوشته‌شده توسط Richard Mlynarik، David MacKenzie، و Assaf Gordon.
.SH "گزارش اشکالات (REPORTING BUGS)"
گزارش اشکالات به: bug\-coreutils@gnu.org
.br
صفحه اصلی GNU coreutils: <https://www.gnu.org/software/coreutils>
.br
راهنمای کلی استفاده از نرم‌افزارهای گنو: <https://www.gnu.org/gethelp>
.br
گزارش هرگونه اشکال در ترجمه به: <https://translationproject.org/team>
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 2026 Free Software Foundation, Inc.
.br
مجوز GPLv3+: گنو GPL نسخه ۳ یا بالاتر <https://gnu.org/licenses/gpl.html>.
.br
این نرم‌افزار آزاد است: شما می‌توانید آن را تغییر داده و دوباره توزیع کنید. هیچ ضمانتی وجود ندارد، تا حدی که قانون مجاز می‌داند.
.SH "همچنین ببینید (SEE ALSO)"
\fBsigaction\fP(2), \fBsigprocmask\fP(2), \fBsignal\fP(7)
.PP
.br
مستندات کامل در <https://www.gnu.org/software/coreutils/env>
.br
یا در دسترس به‌صورت محلی از طریق: info \(aq(coreutils) env invocation\(aq