table of contents
- trixie-backports 4.32.4-1~bpo13+1
- testing 4.32.4-1
- unstable 4.32.4-1
| XARGS(1) | General Commands Manual | XARGS(1) |
الاسم¶
xargs - بناء وتنفيذ سطور الأوامر من الدخل القياسي
موجز¶
xargs [خيار ...] [أمر] [معامل-أولي ...]
الوصف¶
تُوثق صفحة الدليل هذه نسخة GNU من xargs. يقرأ xargs العناصر من الدخل القياسي، بفواصل الفراغات (التي يمكن حمايتها بعلامات اقتباس مزدوجة أو مفردة أو مائلة خلفية) أو سطور جديدة، ويُنفذ الـ command (الـ echo هو المبدئي) مرة واحدة أو أكثر مع أي initial-arguments متبوعة بالعناصر المقروءة من الدخل القياسي. تُتجاهل السطور الفارغة في الدخل القياسي.
يُبنى سطر الأوامر للـ command حتى يصل إلى الحد الذي يُحدده النظام (ما لم تُستخدم الخيارات -n و -L). سيُستدعى الـ command المحدد بالعدد اللازم من المرات لاستنفاد قائمة عناصر الدخل. وبوجه عام، سيكون عدد استدعاءات الـ command أقل بكثير من عدد عناصر الدخل. سيكون لهذا عادة فوائد كبيرة في الأداء. يمكن تنفيذ بعض الأوامر بالتوازي بشكل مفيد أيضًا؛ انظر الخيار -P.
نظرًا لأن أسماء ملفات Unix قد تحتوي على فراغات وسطور جديدة، فإن هذا السلوك المبدئي غالبًا ما يكون إشكاليًا؛ إذ تُعالج أسماء الملفات التي تحتوي على فراغات و/أو سطور جديدة بشكل غير صحيح بواسطة xargs. في هذه الحالات، من الأفضل استخدام الخيار -0، الذي يمنع مثل هذه المشاكل. عند استخدام هذا الخيار، ستحتاج إلى التأكد من أن البرنامج الذي يُنتج دخل xargs يستخدم أيضًا محرف عدم (null) كفاصل. إذا كان ذلك البرنامج هو GNU find على سبيل المثال، فإن الخيار -print0 يفعل ذلك نيابة عنك.
إذا انتهى أي استدعاء للأمر بحالة 255، سيتوقف xargs فورًا دون قراءة أي دخل إضافي. ويُصدر إشعار خطأ على الخطأ القياسي عند حدوث ذلك.
الخيارات¶
- -0
-
- --null
- تُنهى عناصر الدخل بمحرف عدم بدلًا من الفراغات، ولا تكون علامات الاقتباس والمائلة الخلفية خاصة (يُؤخذ كل محرف حرفيًا). يُعطل سلسلة نهاية الملف، التي تُعامل مثل أي معامل آخر. مفيد عندما تحتوي عناصر الدخل على فراغات أو علامات اقتباس أو مائلات خلفية. يُنتج الخيار -print0 في GNU find (ومن إصدار POSIX 8، معيار IEEE Std 1003.1 لعام 2024) دخلًا مناسبًا لهذا الوضع.
- -a ملف
-
- --arg-file=ملف
- اقرأ العناصر من file بدلًا من الدخل القياسي. إذا استخدمت هذا الخيار، يبقى الدخل القياسي دون تغيير عند تشغيل الأوامر. بخلاف ذلك، يُعاد توجيه الدخل القياسي من /dev/null.
- --delimiter=محدد
-
- -d محدد
- تُنهى عناصر الدخل بالمحرف المحدد. قد يكون الفاصل المحدد محرفًا واحدًا، أو محرف هروب بنمط C مثل \n، أو رمز هروب ثماني أو ست عشري. تُفهم أكواد الهروب الثمانية والست عشرية كما في أمر printf. المحارف متعددة البايتات غير مدعومة. عند معالجة الدخل، لا تكون علامات الاقتباس والمائلة الخلفية خاصة؛ إذ يُؤخذ كل محرف في الدخل حرفيًا. يُعطل الخيار -d أي سلسلة نهاية ملف، وتُعامل كأي معامل آخر. يمكنك استخدام هذا الخيار عندما يتكون الدخل من عناصر مفصولة بسطور جديدة ببساطة، رغم أنه من الأفضل دائمًا تصميم برنامجك لاستخدام --null حيثما أمكن ذلك.
- -E سلسلة_نهاية_الملف
- اضبط سلسلة نهاية الملف على eof-str. إذا ظهرت سلسلة نهاية الملف كسطر دخل، سيُتجاهل ما تبقى من الدخل. إذا لم يُستخدم -E ولا -e، فلن تُستخدم أي سلسلة نهاية ملف. قد تحتوي التطبيقات الأخرى لـ xargs على سلسلة نهاية ملف منطقية مبدئية، لذا إذا كنت تريد التأكد بطريقة قابلة للنقل من عدم استخدام أي سلسلة نهاية ملف منطقية، فاستخدم -E "" لتعطيل سلسلة نهاية الملف المنطقية. انظر أيضًا مطابقة المعايير.
- -e[سلسلة_نهاية_الملف]
-
- --eof[=سلسلة_نهاية_الملف]
- هذا الخيار مرادف للخيار -E. استخدم -E بدلًا منه، لأنه ما زال متوافقًا مع POSIX بينما أُزيل الخيار -e من معيار POSIX (إصدار IEEE Std 1003.1 لعام 2004).
- -I سلسلة_الاستبدال
- استبدل حالات ظهور replace-str في المعاملات الأولية بالأسماء المقروءة من الدخل القياسي. كما أن الفراغات غير المقتبسة لا تنهي عناصر الدخل؛ وبدلًا من ذلك يكون الفاصل هو محرف السطر الجديد. يتضمن -x و “-L 1”.
- -i[سلسلة_الاستبدال]
-
- --replace[=سلسلة_الاستبدال]
- هذا الخيار مرادف لـ -Ireplace-str إذا حُددت replace-str. إذا غاب معامل replace-str، يكون التأثير مماثلًا لـ “-I{}”. أُزيل الخيار -i من معيار POSIX (إصدار IEEE Std 1003.1 لعام 2004). استخدم -I بدلًا منه.
- -L أقصى_سطور
- استخدم max-lines من سطور الدخل غير الفارغة كحد أقصى لكل سطر أوامر. تؤدي الفراغات اللاحقة إلى استمرار سطر الدخل منطقيًا في سطر الدخل التالي. يتضمن -x.
- -l[أقصى_سطور]
-
- --max-lines[=أقصى_سطور]
- مرادف للخيار -L. وبخلاف -L، فإن معامل max-lines اختياري. إذا لم يُحدد max-lines، فإنه يُفترض واحدًا. الخيار -l مهجور لأن معيار POSIX يحدد -L بدلًا منه.
- -n أقصى_معاملات
-
- --max-args=أقصى_معاملات
- استخدم max-args من المعاملات كحد أقصى لكل سطر أوامر. سيُستخدم عدد أقل من max-args إذا جرى تجاوز الحجم (انظر الخيار -s)، ما لم يُعطَ الخيار -x، وفي هذه الحالة سيخرج xargs.
- -P أقصى_عمليات
-
- --max-procs=أقصى_عمليات
- شغل ما يصل إلى max-procs من العمليات في وقت واحد؛ المبدئي هو 1. إذا كان max-procs هو 0، فسيقوم xargs بتشغيل أكبر عدد ممكن من العمليات في وقت واحد. استخدم الخيار -n أو الخيار -L مع -P؛ وإلا فمن المرجح تنفيذ exec واحد فقط. أثناء تشغيل xargs، يمكنك إرسال إشارة SIGUSR1 لعمليته لزيادة عدد الأوامر التي تعمل بالتزامن، أو SIGUSR2 لتقليل العدد. لا يمكنك زيادته فوق الحد الذي يحدده التنفيذ (الذي يظهر باستخدام --show-limits). لا يمكنك تقليله إلى أقل من 1. لا ينهي xargs أوامره أبدًا؛ فعندما يُطلب منه التقليل، فإنه ينتظر ببساطة انتهاء أكثر من أمر موجود قبل بدء أمر آخر. ينتظر xargs دائمًا خروج جميع العمليات الوليدة قبل أن يخرج هو نفسه (لكن انظر BUGS).
- إذا لم تستخدم الخيار -P، فلن يتعامل xargs مع إشارتي SIGUSR1 و SIGUSR2، مما يعني أنهما ستنهيان البرنامج (ما لم تكن قد حُجبت في العملية الأب قبل بدء xargs).
- يرجى ملاحظة أن الأمر متروك للعمليات المستدعاة لإدارة الوصول المتوازي إلى الموارد المشتركة بشكل صحيح. على سبيل المثال، إذا حاولت أكثر من عملية منها الطباعة على الخرج القياسي، فسيُنتج الخرج بترتيب غير محدد (ومن المرجح جدًا أن يختلط) ما لم تتعاون العمليات بطريقة ما لمنع ذلك. استخدام نوع من مخطط القفل هو إحدى الطرق لمنع مثل هذه المشاكل. بشكل عام، سيساعد استخدام مخطط القفل في ضمان الخرج الصحيح ولكنه سيقلل من الأداء. إذا كنت لا ترغب في تحمل فرق الأداء، فقم ببساطة بترتيب كل عملية لإنتاج ملف خرج منفصل (أو استخدام موارد منفصلة بطريقة أخرى).
- -o
-
- --open-tty
- أعد فتح الدخل القياسي كـ /dev/tty في العملية الوليدة قبل تنفيذ الأمر. هذا مفيد إذا كنت تريد أن يقوم xargs بتشغيل تطبيق تفاعلي.
- -p
-
- --interactive
- اسأل المستخدم عما إذا كان سيتم تشغيل كل سطر أوامر واقرأ سطرًا من الطرفية. لا تشغل سطر الأوامر إلا إذا بدأت الاستجابة بـ `y' أو `Y'. يتضمن -t.
- --process-slot-var=اسم
- اضبط متغير البيئة name على قيمة فريدة في كل عملية وليدة جارية. تُعاد استخدام القيم بمجرد خروج العمليات الوليدة. يمكن استخدام هذا في مخطط توزيع حمل بدائي، على سبيل المثال.
- -r
-
- --no-run-if-empty
- إذا لم يحتوِ الدخل القياسي على أي محارف غير فارغة، فلا تُشغل الأمر. عادةً، يُشغل الأمر مرة واحدة حتى لو لم يكن هناك دخل.
- -s أقصى_محارف
-
- --max-chars=أقصى_محارف
- استخدم على الأكثر max-chars من الرموز في كل سطر أمر، بما في ذلك الأمر والوسائط الأولية والمحارف الصفرية النهائية في نهاية سلاسل الوسائط. أكبر قيمة مسموح بها تعتمد على النظام، وتُحسب على أنها الحد الأقصى لطول الوسائط الخاص بالدالة exec، مطروحًا منه حجم متغيرات البيئة، ومطروحًا منه 2048 بايت كـ "هامش أمان". إذا كانت هذه القيمة أكبر من 128 كيلوبايت، تُستخدم 128 كيلوبايت كقيمة مبدئية؛ وبخلاف ذلك، تكون القيمة المبدئية هي الحد الأقصى. الكيلوبايت الواحد (1 KiB) يساوي 1024 بايت. يتكيف xargs آليًا مع القيود الأكثر صرامة.
- --show-limits
- اعرض الحدود على طول سطر الأوامر التي يفرضها نظام التشغيل، واختيار xargs لحجم المخزن المؤقت والخيار -s. مرر الدخل من /dev/null (وربما حدد --no-run-if-empty) إذا كنت لا تريد أن يفعل xargs أي شيء.
- -t
-
- --verbose
- اطبع سطر الأوامر على خرج الخطأ القياسي قبل تنفيذه.
- -x
-
- --exit
- اخرج إذا جرى تجاوز الحجم (انظر الخيار -s).
- --
- افصل قائمة الخيارات. تُعامل المعاملات اللاحقة، إن وجدت، كأطراف تشغيل حتى لو بدأت بـ “-”. على سبيل المثال، “xargs -- --help” يُشغل الأمر --help (الموجود في PATH) بدلًا من طباعة نص الاستخدام، و “xargs -- --mycommand” يُشغل الأمر --mycommand بدلًا من رفضه كخيار غير معروف.
- --help
- اطبع ملخصًا لخيارات xargs واخرج.
- --version
- اطبع رقم إصدار xargs واخرج.
الخيارات --max-lines (-L، -l)، و --replace (-I، -i) و --max-args (-n) متنافية تبادليًا. إذا حُدد بعضها في نفس الوقت، فسيستخدم xargs عمومًا الخيار المحدد آخِرًا في سطر الأوامر، أي أنه سيعيد تعيين قيمة الخيار المتعارض (المعطى سابقًا) إلى قيمته المبدئية. بالإضافة إلى ذلك، سيصدر xargs إشعار تحذير تشخيصي على الخطأ القياسي. الاستثناء من هذه القاعدة هو أن قيمة max-args الخاصة “1” (كما في “-n1”) يُتجاهل بعد الخيار --replace وأسمائه المستعارة -I و -i، لأنها لا تتعارض فعليًا.
أمثلة¶
find /tmp -name core -type f -print | xargs /bin/rm -f
ابحث عن الملفات المسماة core في أو تحت الدليل /tmp واحذفها. لاحظ أن هذا سيعمل بشكل غير صحيح إذا كان هناك أي أسماء ملفات تحتوي على سطور جديدة أو مسافات.
find /tmp -name core -type f -print0 | xargs -0 /bin/rm -f
ابحث عن الملفات المسماة core في أو تحت الدليل /tmp واحذفها، مع معالجة أسماء الملفات بطريقة تضمن التعامل الصحيح مع أسماء الملفات أو الأدلة التي تحتوي على مسافات أو سطور جديدة.
find /tmp -depth -name core -type f -delete
ابحث عن الملفات المسماة core في أو تحت الدليل /tmp واحذفها، ولكن بكفاءة أكبر من المثال السابق (لأننا نتجنب الحاجة إلى استخدام fork(2) و exec(2) لإطلاق rm ولا نحتاج لعملية xargs إضافية).
cut -d: -f1 < /etc/passwd | sort | xargs echoيُنشئ قائمة مدمجة بجميع المستخدمين على النظام.
حالة الخروج¶
يخرج xargs بالحالات التالية:
- 0
- إذا نجح (وانتهت أي أوامر شُغلت بواسطة xargs، إن وجدت، بشكل طبيعي بحالة خروج 0).
- 123
- إذا انتهى أي استدعاء للأمر بحالة غير 0 أو 255 (مع مراعاة ما ورد أدناه).
- 124
- إذا انتهى الأمر بحالة 255
- 125
- إذا قُتل الأمر بإشارة
- 126
- إذا تعذر تشغيل الأمر
- 127
- إذا لم يُعثر على الأمر
- 1
- في حال وقوع خطأ آخر.
من الممكن أن تنتهي الإصدارات المستقبلية من xargs بحالة في النطاق 1–125 عندما يفشل الأمر الذي أطلقته بطريقة محددة غير مدرجة أعلاه. ومع ذلك، سيمتثل xargs لمعيار POSIX. يوضح قسم مطابقة المعايير قواعد POSIX المتعلقة بحالة خروج xargs.
تُشغل الأوامر التي ينفذها xargs مباشرةً (باستخدام execvp(2)) بدلاً من استدعائها عبر الصدفة. لا يستخدم xargs عرف الصدفة (128 + الإشارة) للإبلاغ عن قتل العملية بواسطة إشارة.
المطابقة للمعايير¶
يصف هذا القسم العلاقة بين GNU xargs والمعايير التي يمتثل لها. وتُذكر بعض الاعتبارات المتعلقة بنقل البرمجيات.
الخيارات¶
الخيارات المحددة في IEEE Std 1003.1 لعام 2024 هي -E و -I و -L و -n و -p و -r و -s و -t و -x و -0.
- -E
- منذ findutils 4.2.9 (2004)، لا يحتوي GNU xargs على سلسلة نهاية ملف منطقية مبدئية. قد لا ينطبق هذا على التطبيقات الأخرى، لذا يجب عليك استخدام -E "" للتأكد.
- -e
- أُزيل من POSIX في IEEE Std 1003.1 لعام 2004. ما زال GNU xargs يدعم هذا، ولكن يجب عليك استخدام -E بدلاً منه.
- -i
- أُزيل من POSIX في IEEE Std 1003.1 لعام 2004. ما زال GNU xargs يدعم هذا، ولكن يجب عليك استخدام -I بدلاً منه.
- -l
- أُزيل من POSIX في IEEE Std 1003.1 لعام 2004. ما زال GNU xargs يدعم هذا، ولكن يجب عليك استخدام -L بدلاً منه.
- -o
- امتداد لمعيار POSIX لتحقيق توافق أفضل مع BSD. غير موجود في POSIX.
- -p
- امتداد لـ GNU منذ ما قبل عام 1994. أُضيف إلى POSIX في IEEE Std 1003.1 لعام 2004.
- -r
- امتداد لـ GNU منذ ما قبل عام 1994. أُضيف إلى POSIX في IEEE Std 1003.1 لعام 2024.
- -0
- امتداد لـ GNU منذ ما قبل عام 1994. أُضيف إلى POSIX في IEEE Std 1003.1 لعام 2024.
حدود استدعاء النظام EXEC¶
يسمح معيار POSIX للتنفيذات بأن يكون لها حد على حجم المعاملات لدوال exec. يمكن أن يكون هذا الحد منخفضًا حتى 4096 بايت بما في ذلك حجم البيئة. لكي تكون النصوص البرمجية محمولة، يجب ألا تعتمد على قيمة أكبر. ومع ذلك، لا أعرف أي تنفيذ يكون حده الفعلي بهذا الصغر. يمكن استخدام الخيار --show-limits لاكتشاف الحدود الفعلية السارية على النظام الحالي.
متطلبات حالة الخروج في POSIX¶
يحدد معيار POSIX أن أنواعًا معينة من المشاكل يجب أن تؤدي إلى قيم إرجاع محددة لـ xargs. يلخص الجدول أدناه كيفية ارتباط هذه المتطلبات بالقيم المدرجة في قسم حالة الخروج.
| متطلب POSIX | سلوك GNU xargs | ||
| الحالة | حالة الخروج | حالة الخروج | التفاصيل |
| الأداة غير موجودة | 127 | 127 | فشل execvp(2) بقيمة errno تساوي ENOENT |
| تعذر استدعاء الأداة | 126 | 126 | فشل execvp(2) بأي خطأ آخر |
| أي حالة أخرى غير ناجحة | 1 - 125 | 125 | قُتلت الأداة بإشارة قاتلة |
| 124 | انتهت الأداة بحالة 255 | ||
| 123 | انتهت الأداة بحالة غير 0 أو 255 | ||
| 2 - 122 | قد يُستخدم في المستقبل | ||
| 1 | أي نوع آخر من الأخطاء (مثل خطأ الاستخدام) | ||
| اكتمل بنجاح | 0 | 0 | |
علل المطابقة¶
| أُدخلت | أُصلحت | الوصف |
| 4.5.10 (2011) | 4.10.0 (2024) | ينبغي أن تكون SIGUSR1 إشارة قاتلة مبدئيًا، لكن SIGUSR1 لم تكن لتقتل xargs حتى لو لم يكن الخيار -P قيد الاستخدام. |
التاريخ¶
اخترع Herb Gellis برنامج xargs في مختبرات Bell. انظر دليل Texinfo لـ findutils، فصل “Finding Files”، لمزيد من المعلومات.
العلل¶
الأمن¶
من غير الممكن استخدام xargs بشكل آمن، حيث ستكون هناك دائمًا فجوة زمنية بين إنتاج قائمة ملفات الدخل واستخدامها في الأوامر التي يصدرها xargs. إذا كان لمستخدمين آخرين وصول إلى النظام، فيمكنهم التلاعب بـ نظام ملفات خلال هذه النافذة الزمنية لإجبار إجراءات الأوامر التي يشغلها xargs على الانطباق على ملفات لم تكن تقصدها. لمناقشة أكثر تفصيلًا لهذه المشكلة والمشاكل ذات الصلة، يرجى الرجوع إلى فصل “Security Considerations” في وثائق findutils Texinfo. يمكن غالبًا استخدام الخيار -execdir لـ find كبديل أكثر أمانًا.
حدود التطبيق¶
عند استخدام الخيار -I، يُخزن كل سطر يُقرأ من الدخل مؤقتًا داخليًا. هذا يعني أن هناك حدًا أقصى لطول سطر الدخل الذي سيقبله xargs عند استخدامه مع الخيار -I. للالتفاف على هذا القيد، يمكنك استخدام الخيار -s لزيادة مساحة المخزن المؤقت التي يستخدمها xargs، ويمكنك أيضًا استخدام استدعاء إضافي لـ xargs لضمان عدم حدوث سطور طويلة جدًا. على سبيل المثال:
somecommand | xargs -s 50000 echo | xargs -I "{}" -s 100000 rm "{}"
هنا، ليس للاستدعاء الأول لـ xargs حد لطول سطر الدخل لأنه لا يستخدم الخيار -i. بينما يوجد للاستدعاء الثاني لـ xargs مثل هذا الحد، لكننا تأكدنا من أنه لن يواجه أبدًا سطرًا أطول مما يمكنه التعامل معه. هذا ليس حلًا مثاليًا. بدلًا من ذلك، يجب ألا يفرض الخيار -i حدًا لطول السطر، وهذا هو سبب ظهور هذا النقاش في قسم BUGS. لا تحدث المشكلة مع مخرجات find(1) لأنها تُصدر اسم ملف واحد فقط لكل سطر.
التبليغ عن الأخطاء¶
مساعدة GNU
findutils عبر
الإنترنت:
<https://www.gnu.org/software/findutils/#get-help>
أبلغ عن أي
أخطاء
ترجمة إلى
<https://translationproject.org/team/>
أبلغ عن أي مشكلة أخرى عبر النموذج الموجود في متعقب علل GNU Savannah:
تُناقش الموضوعات العامة حول حزمة GNU findutils في القائمة البريدية bug-findutils:حقوق النسخ¶
حقوق
النشر © 1990–2026
مؤسسة
البرمجيات
الحرة،
المحدودة.
رخصة GPLv3+: رخصة
جنو
العمومية
الإصدار 3 أو
أحدث <https://gnu.org/licenses/gpl.html>.
هذا برنامج
حر: أنت حر في
تغييره
وإعادة
توزيعه. لا
يوجد أي
ضمان، إلى
المدى الذي
يسمح به
القانون.
انظر أيضًا¶
find(1), kill(1), locate(1), updatedb(1), fork(2), execvp(3), locatedb(5), signal(7)
الوثائق
الكاملة
<https://www.gnu.org/software/findutils/xargs>
أو متاحة
محليًا عبر:
info xargs
ترجمة¶
تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>
هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.
إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.
| 3 يونيو 2024 | findutils |