'\" t
.\"     Title: pipesz
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-05-18
.\"    Manual: أوامر المستخدم
.\"    Source: util-linux 2.42.1
.\"  Language: English
.\"
.TH "PIPESZ" "1" "2026-05-18" "util\-linux 2.42.1" "أوامر المستخدم"
.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 "الاسم"
pipesz \- اضبط أو افحص أحجام مخبئية الأنابيب و FIFO
.SH "موجز"
.sp
\fBpipesz\fP [خيارات] [\fB\-\-set\fP \fIالحجم\fP] [\-\-] [\fIالأمر\fP [\fIالمعطى\fP.\|.\|.]]
.sp
\fBpipesz\fP [خيارات] \fB\-\-get\fP
.SH "الوصف"
.sp
تحافظ الأنابيب و FIFOs على خبيئة داخلية تُستخدم لنقل البيانات بين طرف القراءة وطرف الكتابة. في بعض الحالات، قد لا يكون الحجم المبدئي لهذه الخبيئة الداخلية مناسباً. يوفر هذا البرنامج تسهيلات لضبط وفحص حجم هذه الخبيئات.
.sp
تضبط عملية \fB\-\-set\fP أحجام خبيئة الأنابيب. في حال تحديدها، يجب أن تُحدد بـ \fIحجم\fP صريح. خلاف ذلك، يُفهم الخيار ضمناً ويُقرأ الحجم من الملف \fB/proc/sys/fs/pipe\-max\-size\fP. قد تضبط النواة \fIالحجم\fP كما هو موضح في \fBfcntl\fP(2). لرؤية أحجام الخبيئة الفعلية التي ضُبطت، استخدم خيار \fB\-\-verbose\fP. وإذا لم يُحدد \fB\-\-file\fP ولا \fB\-\-fd\fP، فإن \fB\-\-set\fP يعمل على المخرج القياسي.
.sp
تسمح عملية \fB\-\-set\fP بـ \fIأمر\fP اختياري للتنفيذ بعد ضبط أحجام خبيئة الأنبوب. يُنفذ هذا الأمر مع الأنابيب المعدلة.
.sp
تخرج عملية \fB\-\-get\fP البيانات بتنسيق جدولي. العمود الأول هو اسم الأنبوب كما مُرر إلى \fBpipesz\fP. تُسمى واصفات الملفات كـ "fd \fIرقم\fP". العمود الثاني هو الحجم، بالبايت، لخبيئة الأنبوب الداخلية. العمود الثالث هو عدد البايتات غير المقروءة حالياً في الأنبوب. تُفصل الأعمدة بواسطة علامات جدولة (\*(Aq\(rst\*(Aq، ASCII 09h). إذا حُدد \fB\-\-verbose\fP، يُخرج ترويسة وصفية أيضاً. إذا لم يُحدد لا \fB\-\-file\fP ولا \fB\-\-fd\fP، فإن \fB\-\-get\fP يعمل على المدخل القياسي.
.sp
ما لم يُحدد خيار \fB\-\-check\fP، فإن \fBpipesz\fP لا يخرج إذا واجه خطأً أثناء معالجة ملف أو واصف ملف. يتيح ذلك استخدام \fBpipesz\fP بشكل عام دون خوف من تعطيل تنفيذ سلاسل الأوامر (pipelines) في حال تغيّر نوع ملفات معينة لاحقاً. ولتقليل التعطيل، يمنع خيار \fB\-\-quiet\fP إصدار التحذيرات في هذه الحالات.
.sp
تفرض النواة حدوداً على مقدار مساحة خبيئة الأنبوب التي يمكن للعمليات غير المتميزة استخدامها، ومع ذلك انظر \fBBUGS\fP أدناه. ستتوقف النواة أيضاً عن تقليص خبيئة الأنبوب إذا كان ذلك سيؤدي إلى فقدان البيانات المخزنة مؤقتاً. انظر \fBpipe\fP(7) لمزيد من التفاصيل.
.sp
يدعم \fBpipesz\fP تحديد خيارات قصيرة متعددة على التوالي، بأسلوب \fBgetopt\fP(3) المعتاد. يُفسر أول وسيط ليس خياراً على أنه \fIأمر\fP. إذا كان \fIأمر\fP قد يبدأ بـ \*(Aq\-\*(Aq، استخدم \*(Aq\-\-\*(Aq لفصله عن وسائط \fBpipesz\fP. في سكربتات الصدفة (shell)، من الممارسات الجيدة استخدام \*(Aq\-\-\*(Aq عند توسيع المعاملات. لا يقرأ \fBpipesz\fP نفسه من المدخل القياسي ولا يكتب إلى المخرج القياسي إلا إذا حُدد \fB\-\-get\fP أو \fB\-\-help\fP أو \fB\-\-version\fP.
.SH "الخيارات"
.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 \fIالحجم\fP
.RS 4
ضبط حجم خبيئات الأنابيب، بالبايت. يمكن إلحاق هذا الخيار بـ \fBK\fP أو \fBM\fP أو \fBG\fP أو \fBKiB\fP أو \fBMiB\fP أو \fBGiB\fP للإشارة إلى مضاعفات 1024. تُدعم القيم الكسرية في هذه الحالة. كما تُدعم لواحق إضافية ولكن من غير المرجح أن تكون مفيدة. وإذا لم يُحدد هذا الخيار، تُستخدم قيمة مبدئية كما هو موضح أعلاه. وفي حال تكرار هذا الخيار عدة مرات، يصدر تحذير ويُستخدم آخر \fIحجم\fP محدد فقط. كسلوك خاص، إذا لم يُحدد \fB\-\-file\fP ولا \fB\-\-fd\fP، يُعدل المخرج القياسي. ويُعد تحديد هذا الخيار مع \fB\-\-get\fP خطأً.
.RE
.sp
\fB\-f\fP، \fB\-\-file\fP \fIمسار\fP
.RS 4
ضبط حجم خبيئة FIFO أو الأنبوب عند \fIمسار\fP، نسبةً إلى دليل العمل الحالي. يمكنك تحديد هذا الخيار عدة مرات للتأثير على ملفات مختلفة، ويمكنك القيام بذلك مع \fB\-\-fd\fP. عموماً، يُستخدم هذا الخيار مع FIFOs، ولكنه سيعمل أيضاً على الأنابيب المجهولة مثل تلك الموجودة في \fB/proc/PID/fd\fP. لا تُحفظ التغييرات في حجم خبيئة FIFOs عبر عمليات إعادة تشغيل النظام.
.RE
.sp
\fB\-n\fP، \fB\-\-fd\fP \fIالرقم\fP
.RS 4
ضبط حجم الخبيئة للأنبوب أو FIFO المقابل لواصف الملف \fIالرقم\fP. يمكن تحديد هذا الخيار عدة مرات للتأثير على واصفات ملفات مختلفة، ويمكن القيام بذلك بالاشتراك مع \fB\-\-file\fP. تتوفر خيارات مختصرة للحالات الشائعة: fd 0 (المدخل القياسي)، و fd 1 (المخرج القياسي)، و fd 2 (الخطأ القياسي). وينبغي أن تكون هذه كافية في معظم الحالات.
.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
الخروج، دون تنفيذ \fIأمر\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 "أمثلة"
.sp
\fBpipesz\fP \fBdd\fP if=\fIملف\fP bs=1M | .\|.\|.
.RS 4
يُشغل \fBdd\fP(1) مع أنبوب مخرج قياسي موسّع، مما يسمح له بتجنب تبديلات السياق عند توجيه كتل كبيرة عبر الأنابيب.
.RE
.sp
\fBpipesz\fP \-s1M \-cf \fI/run/my\-service.fifo\fP
.RS 4
يضبط حجم مخبئية الأنبوب لـ FIFO الخاص بالخدمة على 1,048,576 بايت. وإذا تعذر ضبط حجم المخبئية، يخرج \fBpipesz\fP مع خطأ.
.RE
.sp
\fBecho\fP hello | \fBpipesz\fP \-g
.RS 4
يطبع حجم الأنبوب المستخدم من قبل الصدفة لتمرير الدخل إلى \fBpipesz\fP. وبما أن \fBpipesz\fP لا يقرأ الدخل القياسي، فقد يبلغ أيضاً عن 6 بايتات غير مقروءة في الأنبوب، اعتماداً على التوقيتات النسبية.
.RE
.sp
\fBfind\fP /proc/\fIPID\fP/fd \-exec \fBpipesz\fP \-gqf \*(Aq{}\*(Aq \*(Aq;\*(Aq
.RS 4
يطبع حجم وعدد البايتات غير المقروءة لجميع الأنابيب المستخدمة من قبل \fIمعرّف\-العملية\fP. إذا كانت بعض الأنابيب ممتلئة بشكل روتيني، فقد يتمكن \fBpipesz\fP من تخفيف عنق زجاجة المعالجة.
.RE
.SH "ملاحظات"
.sp
يدعم لينكس ضبط حجم مخازن الأنابيب المؤقتة (pipe buffers) منذ النواة 2.6.35. قدّم هذا الإصدار أيضًا \fB/proc/sys/fs/pipe\-max\-size\fP.
.sp
يستخدم هذا البرنامج \fBfcntl\fP(2) \fBF_GETPIPE_SZ\fP/\fBF_SETPIPE_SZ\fP لجلب وضبط أحجام مخازن الأنابيب المؤقتة.
.sp
يستخدم هذا البرنامج \fBioctl\fP(2) \fBFIONREAD\fP للإبلاغ عن كمية البيانات غير المقروءة في الأنابيب. إذا فشل هذا لسبب ما، يُبلغ عن كمية البيانات غير المقروءة بأنها 0.
.SH "العلل"
.sp
قبل لينكس 4.9، أثرت بعض العيوب البرمجية في كيفية فرض حدود موارد معينة عند ضبط أحجام مخازن الأنابيب المؤقتة. راجع \fBpipe\fP(7) لمزيد من التفاصيل.
.SH "المؤلفين"
.sp
.MTO "nwsharp\(atlive.com" "Nathan Sharp" ""
.SH "انظر أيضاً"
.sp
\fBpipe\fP(7)
.SH "التبليغ عن الأخطاء"
.sp
لتقارير العِلل، استخدم \c
.URL "https://github.com/util\-linux/util\-linux/issues" "مُتتبع المشكلات" "."
.SH "التوفر"
.sp
الأمر \fBpipesz\fP جزء من حزمة util\-linux التي يمكن تنزيلها من \c
.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "أرشيف نواة لينكس" "."