'\" t
.\"     Title: pg
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-09-02
.\"    Manual: User Commands
.\"    Source: util-linux 2.42.3
.\"  Language: Persian
.\"
.TH "PG" "1" "2026-09-02" "util\-linux 2.42.3" "User Commands"
.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)"
pg \- مرور پرونده‌های متنی به صورت صفحه‌به‌صفحه
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBpg\fP \fB\-*\fIamount\fP *\-p\fP \fIprompt\fP \fB\-cefnrs\fP +line +/pattern/ file_ .\|.\|.
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBpg\fP یک پروندهٔ متنی را هر بار به اندازهٔ یک صفحه بر روی نمایشگر نشان می‌دهد. پس از هر صفحه، یک اعلان نمایش داده می‌شود. سپس کاربر می‌تواند با فشردن کلید خط جدید صفحهٔ بعدی را مشاهده کند یا یکی از کلیدهای شرح‌داده‌شده در زیر را فشار دهد.
.sp
اگر هیچ نام پرونده‌ای در خط فرمان مشخص نشده باشد، \fBpg\fP از ورودی استاندارد می‌خواند. اگر خروجی استاندارد یک ترمینال نباشد، \fBpg\fP مانند \fBcat\fP(1) عمل می‌کند، اما اگر بیش از یک پرونده وجود داشته باشد، پیش از محتوای هر پرونده نام آن را درج می‌کند.
.sp
اگر ورودی از یک لوله دریافت شود، \fBpg\fP داده‌ها را هنگام خواندن در یک پروندهٔ میانگیر ذخیره می‌کند تا امکان پیمایش فراهم شود.
.SH "گزینه‌ها (OPTIONS)"
.sp
دستور \fBpg\fP گزینه‌های زیر را می‌پذیرد:
.sp
\fB+\fP\fInumber\fP
.RS 4
شروع از شماره خط مشخص‌شده.
.RE
.sp
\fB+/\fP\fIpattern\fP*/*
.RS 4
شروع از خطی که شامل عبارت باقاعدهٔ پایهٔ \fIpattern\fP مشخص‌شده است.
.RE
.sp
\fB\-\fP\fInumber\fP
.RS 4
تعداد خطوط در هر صفحه. به‌طور پیش‌فرض، این مقدار برابر با تعداد خطوط نمایشگر منهای یک است.
.RE
.sp
\fB\-c\fP
.RS 4
پاک‌سازی صفحه پیش از نمایش هر صفحه، در صورتی که مدخل terminfo ترمینال این قابلیت را فراهم کند.
.RE
.sp
\fB\-e\fP
.RS 4
در انتهای پرونده مکث نکرده و عبارت \fI(EOF)\fP را نمایش ندهد.
.RE
.sp
\fB\-f\fP
.RS 4
خطوط طولانی شکسته نشوند.
.RE
.sp
\fB\-n\fP
.RS 4
بدون این گزینه، دستورات باید با یک نویسهٔ خط جدید خاتمه یابند.
.sp
با این گزینه، به محض وارد کردن حرف دستور، \fBpg\fP به جلو می‌رود.
.RE
.sp
\fB\-p\fP \fIstring\fP
.RS 4
به جای اعلان عادی \fI:\fP، عبارت \fIstring\fP نمایش داده می‌شود. اگر \fIstring\fP حاوی \fB%d\fP باشد، نخستین رخداد آن با شمارهٔ صفحهٔ جاری جایگزین می‌شود.
.RE
.sp
\fB\-r\fP
.RS 4
غیرمجاز کردن گریز به پوسته (shell escape).
.RE
.sp
\fB\-s\fP
.RS 4
چاپ پیام‌ها در حالت برجسته (\fIstandout\fP)، در صورتی که مدخل terminfo ترمینال این قابلیت را فراهم کند.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
نمایش متن راهنما و خروج.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
نمایش نسخه و خروج.
.RE
.SH "دستورات (COMMANDS)"
.sp
دستورات زیر را می‌توان در خط اعلان وارد کرد. دستوراتی که در این سند پیشوند \fIi\fP دارند، یک عدد را به عنوان آرگومان (مثبت یا منفی) می‌پذیرند. اگر این آرگومان با \fB+\fP یا \fB\-\fP آغاز شود، به صورت نسبی نسبت به موقعیت جاری در پروندهٔ ورودی تفسیر می‌شود، در غیر این صورت نسبت به ابتدای پرونده در نظر گرفته می‌شود.
.sp
\fIi\fP\fB<Enter>\fP
.RS 4
نمایش صفحهٔ بعدی یا صفحهٔ مشخص‌شده.
.RE
.sp
\fIi\fP\fBd\fP یا \fB^D\fP
.RS 4
نمایش نیم‌صفحهٔ بعدی. اگر \fIi\fP داده شود، همواره به صورت نسبی نسبت به موقعیت جاری تفسیر می‌شود.
.RE
.sp
\fIi\fP\fBl\fP
.RS 4
نمایش خط بعدی یا خط مشخص‌شده.
.RE
.sp
\fIi\fP\fBf\fP
.RS 4
پرش یک صفحه به جلو. \fIi\fP باید یک عدد مثبت باشد و همواره به صورت نسبی نسبت به موقعیت جاری تفسیر می‌شود.
.RE
.sp
\fIi\fP\fBw\fP یا \fIi\fP\fBz\fP
.RS 4
مانند \fB<Enter>\fP به جز اینکه \fIi\fP به اندازهٔ جدید صفحه تبدیل می‌شود.
.RE
.sp
\fB.\fP یا \fB^L\fP
.RS 4
ترسیم مجدد صفحه نمایش.
.RE
.sp
\fB$\fP
.RS 4
رفتن به آخرین خط پروندهٔ ورودی.
.RE
.sp
\fIi\fP\fB/\fP\fIpattern\fP\fB/\fP
.RS 4
جستجو به سمت جلو تا زمانی که اولین یا \fIi\fP\-امین رخداد عبارت باقاعدهٔ پایهٔ \fIpattern\fP پیدا شود. جستجو پس از صفحهٔ جاری آغاز شده و در انتهای پرونده متوقف می‌شود. هیچ گردشی به ابتدای پرونده (wrap\-around) انجام نمی‌شود. \fIi\fP باید یک عدد مثبت باشد.
.RE
.sp
\fIi\fP\fB?\fP\fIpattern\fP\fB?\fP یا \fIi\fP\fB\fP\fIpattern\fP\fB\fP
.RS 4
جستجو به سمت عقب تا زمانی که اولین یا \fIi\fP\-امین رخداد عبارت باقاعدهٔ پایهٔ \fIpattern\fP پیدا شود. جستجو پیش از صفحهٔ جاری آغاز شده و در ابتدای پرونده متوقف می‌شود. هیچ گردشی به انتهای پرونده (wrap\-around) انجام نمی‌شود. \fIi\fP باید یک عدد مثبت باشد.
.RE
.sp
دستورات جستجو یک حرف افزوده را می‌پذیرند. اگر \fBt\fP داده شود، خط حاوی الگو در بالای صفحه نمایش داده می‌شود که حالت پیش‌فرض است. \fBm\fP میانه و \fBb\fP پایین صفحه را انتخاب می‌کند. موقعیت انتخاب‌شده در جستجوهای بعدی نیز استفاده می‌شود.
.sp
\fIi\fP\fBn\fP
.RS 4
رفتن به پروندهٔ بعدی یا \fIi\fP پرونده به جلو.
.RE
.sp
\fIi\fP\fBp\fP
.RS 4
خواندن مجدد پروندهٔ قبلی یا \fIi\fP پرونده به عقب.
.RE
.sp
\fBs\fP \fIfilename\fP
.RS 4
ذخیرهٔ پروندهٔ جاری با نام پروندهٔ مشخص‌شده در \fIfilename\fP.
.RE
.sp
\fBh\fP
.RS 4
نمایش خلاصهٔ دستورات.
.RE
.sp
\fB!\fP\fIcommand\fP
.RS 4
اجرای \fIcommand\fP با استفاده از پوسته.
.RE
.sp
\fBq\fP یا \fBQ\fP
.RS 4
خروج.
.RE
.sp
اگر در حالی که \fBpg\fP از پروندهٔ ورودی می‌خواند یا روی ترمینال می‌نویسد کاربر کلید وقفه یا خروج را فشار دهد، \fBpg\fP بلافاصله خط اعلان را نمایش خواهد داد. در تمامی شرایط دیگر، این کلیدها موجب پایان یافتن اجرای \fBpg\fP می‌شوند.
.SH "محیط (ENVIRONMENT)"
.sp
متغیرهای محیطی زیر بر رفتار \fBpg\fP تأثیر می‌گذارند:
.sp
\fBCOLUMNS\fP
.RS 4
در صورت تنظیم، تعداد ستون‌های مشخص‌شده توسط سیستم را بازنویسی (override) می‌کند.
.RE
.sp
\fBLANG\fP, \fBLC_ALL\fP, \fBLC_COLLATE\fP, \fBLC_CTYPE\fP, \fBLC_MESSAGES\fP
.RS 4
به \fBlocale\fP(7) مراجعه کنید.
.RE
.sp
\fBLINES\fP
.RS 4
در صورت تنظیم، تعداد خطوط مشخص‌شده توسط سیستم را بازنویسی (override) می‌کند.
.RE
.sp
\fBSHELL\fP
.RS 4
توسط دستور \fB!\fP استفاده می‌شود.
.RE
.sp
\fBTERM\fP
.RS 4
نوع ترمینال را تعیین می‌کند.
.RE
.SH "نکات (NOTES)"
.sp
دستور \fBpg\fP انتظار دارد که فواصل تب در ترمینال در هر هشت موقعیت تنظیم شده باشند.
.sp
پرونده‌هایی که شامل نویسه‌های NUL باشند، توسط \fBpg\fP قابل نمایش نیستند.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBcat\fP(1),
\fBmore\fP(1),
\fBsh\fP(1p),
\fBterminfo\fP(5),
\fBlocale\fP(7),
\fBregex\fP(7),
\fBterm\fP(7)
.SH "گزارش باگ‌ها (REPORTING BUGS)"
.sp
برای گزارش باگ‌ها، از \c
.URL "https://github.com/util\-linux/util\-linux/issues" "سامانه پیگیری مشکلات" "."
.SH "در دسترس بودن (AVAILABILITY)"
.sp
دستور \fBpg\fP بخشی از بستهٔ util\-linux است که می‌توان آن را از \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux" "آرشیو هسته لینوکس" "."
دریافت کرد.