'\" t
.\"     Title: pipesz
.\"    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 "PIPESZ" "1" "2026-09-02" "util\-linux 2.42.3" "دستورهای کاربری"
.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)"
pipesz \- تنظیم و بررسی اندازه بافر پایپ‌ها و FIFOها
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBpipesz\fP [options] [\fB\-\-set\fP \fIsize\fP] [\-\-] [\fIcommand\fP [\fIargument\fP.\|.\|.]]
.sp
\fBpipesz\fP [options] \fB\-\-get\fP
.SH "توضیحات (DESCRIPTION)"
.sp
پایپ‌ها و FIFOها یک بافر داخلی را برای انتقال داده‌ها میان سر خواندن و سر نوشتن نگه می‌دارند. در برخی موارد، اندازه پیش‌فرض این بافر داخلی ممکن است مناسب نباشد. این برنامه امکاناتی را برای تنظیم و بررسی اندازه این بافرها فراهم می‌کند.
.sp
عملیات \fB\-\-set\fP اندازه بافر پایپ را تنظیم می‌کند. اگر این گزینه مشخص شود، باید همراه با یک \fIsize\fP صریح مشخص گردد. در غیر این صورت، این مقدار ضمنی در نظر گرفته شده و اندازه از \fB/proc/sys/fs/pipe\-max\-size\fP خوانده می‌شود. هسته ممکن است \fIsize\fP را همان‌طور که در \fBfcntl\fP(2) شرح داده شده تنظیم کند. برای مشاهده اندازه واقعی بافرهایی که تنظیم می‌شوند، از گزینهٔ \fB\-\-verbose\fP استفاده کنید. اگر نه \fB\-\-file\fP و نه \fB\-\-fd\fP مشخص نشده باشند، \fB\-\-set\fP بر روی خروجی استاندارد عمل می‌کند.
.sp
عملیات \fB\-\-set\fP امکان اجرای یک \fIcommand\fP اختیاری را پس از تنظیم اندازه بافر پایپ فراهم می‌کند. این دستور با پایپ‌های تنظیم‌شده اجرا می‌شود.
.sp
عملیات \fB\-\-get\fP داده‌ها را در قالب جدول خروجی می‌دهد. ستون نخست، نام پایپ به همان صورت داده‌شده به \fBpipesz\fP است. توصیف‌کننده‌های پرونده به صورت "fd \fIN\fP" نام‌گذاری می‌شوند. ستون دوم اندازه بافر داخلی پایپ بر حسب بایت است. ستون سوم تعداد بایت‌های خوانده‌نشده موجود در پایپ است. ستون‌ها با تب (\*(Aq\(rst\*(Aq، کد ASCII 09h) از هم جدا می‌شوند. اگر \fB\-\-verbose\fP مشخص شده باشد، یک سربرگ توضیحی نیز نمایش داده می‌شود. اگر نه \fB\-\-file\fP و نه \fB\-\-fd\fP مشخص نشده باشند، \fB\-\-get\fP بر روی ورودی استاندارد عمل می‌کند.
.sp
مگر اینکه گزینهٔ \fB\-\-check\fP مشخص شده باشد، در صورت مواجهه با خطا هنگام دستکاری یک پرونده یا توصیف‌کننده پرونده، \fBpipesz\fP خارج \fIنمی‌شود\fP. این امر امکان استفاده عمومی از \fBpipesz\fP را بدون ترس از مختل شدن اجرای خطوط لوله در صورتی که نوع برخی پرونده‌ها بعداً تغییر کند، فراهم می‌سازد. برای کمترین میزان اختلال، گزینهٔ \fB\-\-quiet\fP از صدور هشدارها در این موارد جلوگیری می‌کند.
.sp
هسته محدودیت‌هایی را برای میزان فضای بافر پایپ که فرآیندهای بدون امتیاز می‌توانند استفاده کنند اعمال می‌کند، هرچند به بخش \fBاشکالات (BUGS)\fP در زیر مراجعه کنید. هسته همچنین در صورتی که کوچک کردن بافر پایپ منجر به از دست رفتن داده‌های بافرشده شود، از انجام آن خودداری می‌کند. برای جزئیات بیشتر به \fBpipe\fP(7) مراجعه کنید.
.sp
دستور \fBpipesz\fP از مشخص کردن چندین گزینهٔ کوتاه به صورت متوالی، به شیوهٔ معمول \fBgetopt\fP(3) پشتیبانی می‌کند. اولین آرگومان غیرگزینه‌ای به عنوان \fIcommand\fP تفسیر می‌شود. اگر ممکن است \fIcommand\fP با \*(Aq\-\*(Aq شروع شود، از \*(Aq\-\-\*(Aq برای جدا کردن آن از آرگومان‌های \fBpipesz\fP استفاده کنید. در اسکریپت‌های پوسته، استفاده از \*(Aq\-\-\*(Aq در هنگام بسط پارامترها روش مناسبی است. خود \fBpipesz\fP از ورودی استاندارد نمی‌خواند و در خروجی استاندارد نمی‌نویسد، مگر اینکه \fB\-\-get\fP، \fB\-\-help\fP یا \fB\-\-version\fP مشخص شده باشند.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-g\fP, \fB\-\-get\fP
.RS 4
گزارش اندازه بافرهای پایپ در خروجی استاندارد و خروج. به عنوان یک رفتار ویژه، اگر نه \fB\-\-file\fP و نه \fB\-\-fd\fP مشخص نشده باشند، ورودی استاندارد بررسی می‌شود. مشخص کردن این گزینه همراه با \fB\-\-set\fP خطا است.
.RE
.sp
\fB\-s\fP, \fB\-\-set\fP \fIsize\fP
.RS 4
تنظیم اندازه بافرهای پایپ بر حسب بایت. این گزینه می‌تواند دارای پسوندهای \fBK\fP، \fBM\fP، \fBG\fP، \fBKiB\fP، \fBMiB\fP یا \fBGiB\fP برای نشان دادن مضارب ۱۰۲۴ باشد. مقادیر کسری در این حالت پشتیبانی می‌شوند. پسوندهای اضافی نیز پشتیبانی می‌شوند اما بعید است کاربردی باشند. اگر این گزینه مشخص نشود، یک مقدار پیش‌فرض استفاده می‌شود، همان‌طور که در بالا توضیح داده شد. اگر این گزینه چندین بار مشخص شود، هشداری صادر می‌شود و تنها آخرین \fIsize\fP مشخص‌شده اعمال خواهد شد. به عنوان یک رفتار ویژه، اگر نه \fB\-\-file\fP و نه \fB\-\-fd\fP مشخص نشده باشند، خروجی استاندارد تنظیم می‌شود. مشخص کردن این گزینه همراه با \fB\-\-get\fP خطا است.
.RE
.sp
\fB\-f\fP, \fB\-\-file\fP \fIpath\fP
.RS 4
تنظیم اندازه بافر FIFO یا پایپ در مسیر \fIpath\fP، نسبت به دایرکتوری کاری فعلی. می‌توانید این گزینه را چندین بار برای اعمال روی پرونده‌های مختلف مشخص کنید، و همچنین می‌توانید آن را همراه با \fB\-\-fd\fP به کار ببرید. به‌طور کلی، این گزینه برای FIFOها استفاده می‌شود، اما روی پایپ‌های بی‌نام مانند آن‌هایی که در \fB/proc/PID/fd\fP یافت می‌شوند نیز عمل می‌کند. تغییرات اندازه بافر FIFOها پس از راه‌اندازی مجدد سیستم حفظ نمی‌شوند.
.RE
.sp
\fB\-n\fP, \fB\-\-fd\fP \fInumber\fP
.RS 4
تنظیم اندازه بافر پایپ یا FIFO متناظر با توصیف‌کننده پرونده شمارهٔ \fInumber\fP. می‌توانید این گزینه را چندین بار برای اعمال روی توصیف‌کننده‌های پرونده مختلف مشخص کنید، و همچنین می‌توانید آن را همراه با \fB\-\-file\fP به کار ببرید. گزینه‌های کوتاه برای موارد معمول fd 0 (ورودی استاندارد / stdin)، fd 1 (خروجی استاندارد / stdout) و fd 2 (خطای استاندارد / stderr) ارائه شده‌اند که در بیشتر موارد کافی خواهند بود.
.RE
.sp
\fB\-i\fP, \fB\-\-stdin\fP
.RS 4
کوتاه‌شده برای \fB\-\-fd 0\fP.
.RE
.sp
\fB\-o\fP, \fB\-\-stdout\fP
.RS 4
کوتاه‌شده برای \fB\-\-fd 1\fP.
.RE
.sp
\fB\-e\fP, \fB\-\-stderr\fP
.RS 4
کوتاه‌شده برای \fB\-\-fd 2\fP.
.RE
.sp
\fB\-c\fP, \fB\-\-check\fP
.RS 4
خروج بدون اجرای \fIcommand\fP در صورت وقوع هرگونه خطا هنگام دستکاری یک پرونده یا توصیف‌کننده پرونده. رفتار پیش‌فرض در صورتی که این گزینه مشخص نشود، چاپ یک هشدار در خطای استاندارد و ادامه کار است.
.RE
.sp
\fB\-q\fP, \fB\-\-quiet\fP
.RS 4
عدم گزارش خطاهای غیرمهلک در خطای استاندارد. این گزینه بر خروجی عادی گزینه‌های \fB\-\-get\fP، \fB\-\-verbose\fP، \fB\-\-help\fP یا \fB\-\-version\fP تأثیری ندارد.
.RE
.sp
\fB\-v\fP, \fB\-\-verbose\fP
.RS 4
در صورت مشخص شدن همراه با \fB\-\-get\fP، دستور \fBpipesz\fP یک سربرگ توضیحی را بالای جدول نمایش می‌دهد. در غیر این صورت، در صورت مشخص شدن، \fBpipesz\fP اندازه‌های واقعی بافر تنظیم‌شده توسط هسته را در خطای استاندارد چاپ می‌کند.
.RE
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
نمایش متن راهنما و خروج.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
نمایش نسخه و خروج.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
\fBpipesz\fP \fBdd\fP if=\fIfile\fP bs=1M | .\|.\|.
.RS 4
دستور \fBdd\fP(1) را با یک پایپ خروجی استاندارد گسترش‌یافته اجرا می‌کند، که به آن اجازه می‌دهد هنگام انتقال بلوک‌های بزرگ داده از طریق پایپ، از تعویض متن (context switch) جلوگیری کند.
.RE
.sp
\fBpipesz\fP \-s1M \-cf \fI/run/my\-service.fifo\fP
.RS 4
اندازه بافر پایپ یک FIFO سرویس را به ۱٬۰۴۸٬۵۷۶ بایت تنظیم می‌کند. اگر اندازه بافر تنظیم نشود، \fBpipesz\fP با خطا خارج می‌شود.
.RE
.sp
\fBecho\fP hello | \fBpipesz\fP \-g
.RS 4
اندازه پایپ استفاده‌شده توسط پوسته برای ارسال ورودی به \fBpipesz\fP را چاپ می‌کند. از آنجا که \fBpipesz\fP ورودی استاندارد را نمی‌خواند، بسته به زمان‌بندی نسبی ممکن است ۶ بایت خوانده‌نشده را نیز در پایپ گزارش کند.
.RE
.sp
\fBfind\fP /proc/\fIPID\fP/fd \-exec \fBpipesz\fP \-gqf \*(Aq{}\*(Aq \*(Aq;\*(Aq
.RS 4
اندازه و تعداد بایت‌های خوانده‌نشده تمام پایپ‌های در حال استفاده توسط \fIPID\fP را چاپ می‌کند. اگر برخی پایپ‌ها معمولاً پر باشند، \fBpipesz\fP ممکن است بتواند گلوگاه پردازشی را کاهش دهد.
.RE
.SH "نکات (NOTES)"
.sp
لینوکس از نگارش هسته ۲.۶.۳۵ به بعد از تنظیم اندازه بافرهای پایپ پشتیبانی می‌کند. این نگارش همچنین \fB/proc/sys/fs/pipe\-max\-size\fP را معرفی کرد.
.sp
این برنامه از \fBF_GETPIPE_SZ\fP/\fBF_SETPIPE_SZ\fP در \fBfcntl\fP(2) برای دریافت و تنظیم اندازه‌های بافر پایپ استفاده می‌کند.
.sp
این برنامه از \fBFIONREAD\fP در \fBioctl\fP(2) برای گزارش مقدار داده‌های خوانده‌نشده در پایپ‌ها استفاده می‌کند. اگر بنا به دلیلی این عملیات ناموفق باشد، مقدار داده‌های خوانده‌نشده ۰ گزارش می‌شود.
.SH "اشکالات (BUGS)"
.sp
پیش از لینوکس ۴.۹، برخی اشکالات بر نحوه اعمال محدودیت‌های خاص منابع هنگام تنظیم اندازه بافر پایپ تأثیر می‌گذاشتند. برای جزئیات به \fBpipe\fP(7) مراجعه کنید.
.SH "نویسندگان (AUTHORS)"
.sp
.MTO "nwsharp\(atlive.com" "Nathan Sharp" ""
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBpipe\fP(7)
.SH "گزارش باگ‌ها (REPORTING BUGS)"
.sp
برای گزارش باگ‌ها از \c
.URL "https://github.com/util\-linux/util\-linux/issues" "ردیاب مشکلات" "."
.SH "دسترسی (AVAILABILITY)"
.sp
دستور \fBpipesz\fP بخشی از بستهٔ util\-linux است که می‌توان آن را از \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux" "بایگانی هسته لینوکس" "."