SYSTEMD-ESCAPE(1)

الاسم
systemd-escape - تعمية السلاسل لاستخدامها في أسماء وحدات systemd

موجز

systemd-escape [خيارات...] [سلسلة...]

الوصف

يمكن استخدام systemd-escape لتعمية السلاسل لإدراجها في أسماء وحدات systemd. يمكن استخدام الأمر لتعمية السلاسل وإلغاء تعميتها.

يأخذ الأمر أي عدد من السلاسل في سطر الأوامر، ويعالجها فرديًا، واحدة تلو الأخرى. يخرجها مفصولة بمسافات إلى stdout.

مبدئيًا، يعمي هذا الأمر السلاسل الممررة، ما لم يمرر --unescape مما يؤدي إلى تطبيق العملية العكسية. إذا أعطي --mangle، يطبق وضع خاص من التعمية بدلاً من ذلك، يفترض أن السلسلة معمية بالفعل لكنه يعمي كل ما يبدو غير معمي بوضوح.

للتفاصيل حول خوارزميات التعمية وإلغاء التعمية، انظر القسم ذي الصلة في systemd.unit(5).

الخيارات

الخيارات التالية مفهومة:

--suffix=
    يُلحق لاحقة نوع الوحدة المحددة بالسلسلة المعمية. يأخذ أحد أنواع الوحدات المدعومة من systemd، مثل "service" أو "mount". لا يمكن استخدامه مع --template= أو --unescape أو --mangle.

    أُضيف في الإصدارة 216.

--template=
    يُدرج السلاسل المعمية في قالب اسم وحدة. يأخذ قالب اسم وحدة مثل foobar@.service. مع --unescape، يتوقع أسماء وحدات ممثلة لهذا القالب ويستخرج ويعمي فقط جزء المثيل. لا يمكن استخدامه مع --suffix= أو --instance أو --mangle.

    أُضيف في الإصدارة 216.

--path, -p
    عند تعمية أو إلغاء تعمية سلسلة، افترض أنها تشير إلى مسار نظام ملفات. يبسط هذا المسار (تزال الأحرف "/" البادئة واللاحقة والمكررة، وتزال مكونات المسار غير الفعالة "."، وبالنسبة للمسارات المطلقة، تزال المكونات البادئة ".."). بعد التبسيط، يجب ألا يحتوي المسار على "..".

    هذا مفيد بشكل خاص لتوليد سلاسل مناسبة لإلغاء التعمية مع محدد "%f" في ملفات الوحدة، انظر systemd.unit(5).

    أُضيف في الإصدارة 216.

--unescape, -u
    بدلاً من تعمية السلاسل المحددة، ألغ التعمية، مع عكس العملية. لا يمكن استخدامه مع --suffix= أو --mangle.

    أُضيف في الإصدارة 216.

--mangle, -m
    مثل --escape، لكن يعمي فقط الأحرف التي ليست معمية بوضوح بعد، وربما يُلحق آليًا لاحقة نوع وحدة مناسبة بالسلسلة. لا يمكن استخدامه مع --suffix= أو --template= أو --unescape.

    أُضيف في الإصدارة 216.

--instance
    مع --unescape، ألغ التعمية واطبع فقط جزء المثيل من قالب اسم وحدة ممثلة. ينتج خطأ لقالب غير ممثل مثل ssh@.service أو اسم غير قالب مثل ssh.service. يجب استخدامه مع --unescape ولا يمكن استخدامه مع --template.

    أُضيف في الإصدار 240.

-h، --help
    اطبع نص مساعدة قصير واخرج.

--version
    اطبع سلسلة إصدار قصيرة واخرج.

أمثلة

لتعمية سلسلة واحدة:

    $ systemd-escape 'Hallöchen, Meister'
    Hall\xc3\xb6chen\x2c\x20Meister

لإلغاء التعمية على سلسلة واحدة:

    $ systemd-escape -u 'Hall\xc3\xb6chen\x2c\x20Meister'
    Hallöchen, Meister

لتوليد وحدة الوصل لمسار:

    $ systemd-escape -p --suffix=mount "/tmp//waldi/foobar/"
    tmp-waldi-foobar.mount

لتوليد أسماء مثيل لثلاث سلاسل:

    $ systemd-escape --template=systemd-nspawn@.service 'My Container 1' 'containerb' 'container/III'
    systemd-nspawn@My\x20Container\x201.service systemd-nspawn@containerb.service systemd-nspawn@container-III.service

لاستخراج جزء المثيل لوحدة ممثلة:

    $ systemd-escape -u --instance 'systemd-nspawn@My\x20Container\x201.service'
    My Container 1

لاستخراج جزء المثيل لمثيل لقالب معين:

    $ systemd-escape -u --template=systemd-nspawn@.service 'systemd-nspawn@My\x20Container\x201.service'
    My Container 1

حالة الخروج

عند النجاح، يُعاد الرقم 0، وإلا فيُعاد رمز فشل غير صفري.

انظر أيضًا

systemd(1), systemd.unit(5), systemctl(1)

ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.