snap - أداة للتفاعل مع الحزم
ملخص
snap [خيارات]
الوصف
يسمح أمر snap بتثبيت الحزم وتكوينها وتحديثها وإزالتها. الحزم عبارة عن حزم تعمل عبر العديد من توزيعات Linux المختلفة، مما يتيح تقديم وتشغيل التطبيقات والأدوات بأمان.
الخيارات
خيارات التطبيق
الأوامر
abort
إلغاء تغيير معلق
يحاول أمر abort إلغاء تغيير لا تزال لديه مهام معلقة.
الاستخدام: snap [خيارات] abort [خيارات-abort]
--last حدد آخر تغيير من النوع المحدد (تثبيت، تحديث، إزالة، تجربة، تحديث تلقائي، إلخ).
تُستخدم علامة الاستفهام في نهاية النوع للإشارة إلى عدم فعل أي شيء (بدلاً من إرجاع خطأ)
إذا لم يتم العثور على أي تغيير من النوع المحدد. لاحظ أنه قد يلزم حماية علامة الاستفهام من shell.
ack
إضافة تأكيد إلى النظام
يحاول أمر ack إضافة تأكيد إلى قاعدة بيانات تأكيدات النظام.
يمكن أن يكون التأكيد أيضًا نسخة أحدث من تأكيد موجود مسبقًا سيتم استبداله.
لكي ينجح الأمر، يجب أن يكون التأكيد صالحًا، ويجب التحقق من توقيعه باستخدام مفتاح عام معروف، ويجب أن يكون التأكيد متسقًا مع متطلباته في قاعدة البيانات.
alias
إعداد اسم مستعار يدوي
يقوم أمر alias بإنشاء اسم مستعار للتطبيق المحدد.
بمجرد إعداد هذا الاسم المستعار اليدوي، يمكن استدعاء الأمر الخاص بالتطبيق ببساطة باستخدام الاسم المستعار.
الاستخدام: snap [خيارات] alias [خيارات-alias]
--no-wait
لا تنتظر حتى ينتهي التشغيل، ولكن اطبع معرف التغيير فقط.
aliases
عرض قائمة بالأسماء المستعارة في النظام
يعرض أمر aliases جميع الأسماء المستعارة المتوفرة في النظام وحالتها.
$ snap aliases <اسم_الحزمة>
يعرض فقط الأسماء المستعارة المعرفة بواسطة الحزمة المحددة.
changes
عرض قائمة بتغييرات النظام
يعرض أمر changes ملخصًا لتغييرات النظام التي تم إجراؤها مؤخرًا.
الاستخدام: snap [خيارات] changes [خيارات-changes]
--abs-time
عرض الأوقات المطلقة (بتنسيق RFC 3339). وإلا، اعرض الأوقات النسبية حتى 60 يومًا، ثم YYYY-MM-DD.
check-snapshot
التحقق من لقطة
يتحقق أمر check-snapshot من بيانات المستخدم والنظام والتكوين الخاصة بالحزم المضمنة في اللقطة المحددة.
يُجري هذا الأمر عملية التحقق من سلامة البيانات نفسها التي يتم إجراؤها عند استعادة لقطة.
افتراضيًا، يتحقق هذا الأمر من جميع البيانات الموجودة في لقطة. بدلاً من ذلك، يمكنك تحديد بيانات الحزم التي سيتم التحقق منها، أو للمستخدمين الذين سيتم التحقق منها، أو مزيج من الاثنين.
إذا كانت الحزمة مضمنة في عملية check-snapshot، فليس من الممكن حاليًا استبعاد بيانات النظام والتكوين الخاصة بها من عملية التحقق. قد يتم رفع هذا القيد في المستقبل.
الاستخدام: snap [الخيارات] check-snapshot [خيارات check-snapshot]
--no-wait
لا تنتظر حتى اكتمال العملية، ولكن اطبع فقط معرف التغيير.
--users
تحقق من بيانات المستخدمين المحددين فقط (مفصولة بفواصل) (افتراضي: جميع المستخدمين)
components
قائمة بالمكونات المتاحة والمثبتة للـ snaps المثبتة
يعرض الأمر components ملخصًا للمكونات المثبتة والمتاحة لمجموعة الـ snaps المثبتة حاليًا.
يمكن الاستعلام عن المكونات الخاصة بـ snaps المثبتة المحددة عن طريق توفير أسماء الـ snaps كمُدخلات موضعية.
connect
قم بتوصيل مكون إضافي بفتحة
يقوم الأمر connect بتوصيل مكون إضافي بفتحة. يمكن استدعاؤه بالطرق التالية:
$ snap connect <snap>:<plug> <snap>:<slot>
يقوم بتوصيل المكون الإضافي المقدم بالفتحة المحددة.
$ snap connect <snap>:<plug> <snap>
يقوم بتوصيل المكون الإضافي المحدد بالفتحة الوحيدة في snap المقدمة التي تطابق الواجهة المتصلة. إذا كان هناك أكثر من فتحة محتملة واحدة، فسيفشل الأمر.
$ snap connect <snap>:<plug>
يقوم بتوصيل المكون الإضافي المقدم بالفتحة في snap النواة التي تحمل اسمًا مطابقًا لاسم المكون الإضافي.
الاستخدام: snap [الخيارات] connect [خيارات connect]
--no-wait
لا تنتظر حتى اكتمال العملية، ولكن اطبع فقط معرف التغيير.
connections
قائمة باتصالات الواجهة
يعرض الأمر connections قائمة بالاتصالات بين المكونات الإضافية والفتحات في النظام.
ما لم يتم توفير
$ snap connections <snap>
يعرض المكونات الإضافية والفتحات المتصلة وغير المتصلة للـ snap المحدد.
الاستخدام: snap [الخيارات] connections [خيارات connections]
--all عرض المكونات الإضافية والفتحات المتصلة وغير المتصلة
create-cohort
إنشاء مفاتيح مجموعة لـ snaps
يقوم الأمر create-cohort بإنشاء مجموعة من مفاتيح المجموعة لمجموعة معينة من الـ snaps.
المجموعة هي عرض أو لقطة لـ "خريطة القناة" الخاصة بـ snap في وقت معين والتي تحدد مجموعة الإصدارات الخاصة بـ snap مع مراعاة قيود أخرى (مثل القناة أو البنية). يتم تحديد المجموعة بعد ذلك بمفتاح خاص بالـ snap يعمل عبر الأنظمة. ستستخدم عمليات التثبيت أو التحديث للـ snap باستخدام مفتاح مجموعة معين إصدارًا ثابتًا لمدة تصل إلى 90 يومًا، وبعد ذلك سيتم تحديد مجموعة جديدة من الإصدارات تحت نفس مفتاح المجموعة وسيتم بدء فترة 90 يومًا جديدة.
debug
تشغيل أوامر التصحيح
يحتوي الأمر debug على مجموعة من الأوامر الفرعية الإضافية.
يمكن إزالة أوامر التصحيح دون إشعار وقد لا تعمل على الأنظمة غير الخاصة بالتطوير.
debug api
تنفيذ استعلام خام لواجهة برمجة تطبيقات snapd
نفّذ استعلامًا خامًا لواجهة برمجة تطبيقات snapd. يمكن قراءة المدخلات المعقدة من stdin، بينما تتم طباعة المخرجات إلى stdout. انظر الأمثلة أدناه:
قائمة بجميع الـ snaps: $ snap debug api /v2/snaps
العثور على الـ snaps التي تحمل الاسم "foo": $ snap debug api '/v2/find?name=foo'
طلب تحديث snap "some-snap": $ echo '{"action": "refresh"}' | snap debug api -X POST \ -H 'Content-Type: application/json' /v2/snaps/some-snap
الاستخدام: debug api [خيارات-api]
--snap-socket
استخدم مقبس الوصول الخاص بـ Snap
-H، --header
عيّن الرأس (يمكن تكراره عدة مرات)، يتم فصل نوع الرأس وقيمته باستخدام ': '
-X، --request
طريقة HTTP المراد استخدامها (افتراضيًا GET)
--fail
فشل في حالة حدوث أخطاء في الطلب
debug confinement
اطبع وضع الاحتواء الذي يعمل عليه النظام
سيقوم الأمر confinement بطباعة وضع الاحتواء (صارم أو جزئي أو لا شيء) الذي يعمل عليه النظام.
debug connectivity
تحقق من حالة الاتصال بالشبكة
يتحقق الأمر connectivity من اتصال الشبكة الخاص بـ snapd.
debug execution
احصل على معلومات حول جوانب التنفيذ لأوامر أدوات Snap
يعرض معلومات تصحيح حول جوانب تنفيذ أدوات Snap، مثل إعادة التنفيذ، وموقع الأدوات، وما إلى ذلك.
debug execution apparmor
اعرض AppArmor
debug execution internal-tool
اعرض معلومات تنفيذ الأداة الداخلية
debug execution snap
اعرض معلومات تنفيذ Snap
debug features
احصل على القائمة الكاملة لعلامات الميزات
يعرض إخراج JSON الذي يحتوي على القائمة الكاملة لعلامات الميزات الموجودة في snapd و Snap. علامات الميزات هي مجموعة من البيانات التي تصف مسارات التعليمات البرمجية المهمة داخل snapd، بما في ذلك المهام والتغييرات والواجهات ونقاط النهاية وأوامر Snap ووظائف المساعدة الخاصة بـ ensure.
debug lsm
(داخلي) احصل على معلومات الحالة حول LSMs
(داخلي) احصل على معلومات الحالة حول LSMs
debug migrate-home
قم بترحيل دليل Snap إلى \~/Snap.
قم بترحيل دليل Snap إلى \~/Snap.
الاستخدام: debug migrate-home [خيارات-migrate-home]
--no-wait
debug paths
اطبع مسارات النظام
يطبع الأمر paths قائمة المسارات التي تم اكتشافها واستخدامها بواسطة snapd.
debug refresh-app-awareness
(داخلي) سرد تفاصيل refresh-app-awareness
(داخلي) سرد تفاصيل refresh-app-awareness
الاستخدام: debug refresh-app-awareness [خيارات-refresh-app-awareness]
--unicode <افتراضي: "auto">
debug sandbox-features
اطبع ميزات مربع الحماية المتاحة على النظام
يطبع الأمر sandbox علامات تصف ميزات مكونات مربع الحماية الفردية المستخدمة بواسطة snapd على نظام معين.
الاستخدام: debug sandbox-features [خيارات-sandbox-features]
--required
تأكد من أن الواجهة الخلفية: الميزة المحددة متاحة
debug seeding
احصل على تفاصيل الإعداد المسبق والإعداد المسبق
احصل على تفاصيل الإعداد المسبق والإعداد المسبق
الاستخدام: debug seeding [خيارات-seeding]
--unicode <افتراضي: "auto">
debug stacktraces
احصل على تتبعات المكدس لجميع عمليات snapd
احصل على تتبعات المكدس لجميع عمليات snapd.
debug state
افحص ملف حالة snapd.
افحص ملف حالة snapd، مع تجاوز واجهة برمجة تطبيقات snapd.
الاستخدام: debug state [خيارات-state]
--abs-time
اعرض الأوقات المطلقة (بتنسيق RFC 3339). وإلا، اعرض الأوقات النسبية حتى 60 يومًا، ثم YYYY-MM-DD.
--changes
سرد جميع التغييرات
--task
معرف المهمة المراد فحصها
--change
معرف التغيير المراد فحصه
--check
تحقق من تناسق التغيير
--connections
عرض جميع الاتصالات
--connection
عرض تفاصيل الاتصالات المطابقة (إما snap أو snap:plug، أو snap:slot أو snap:plug-or-slot)
--is-seeded
إخراج حالة التلقيح (صحيح أو خطأ)
--dot إخراج بتنسيق Dot (graphviz)
--no-hold
تجاهل المهام في حالة "معلقة" في الإخراج الخاص بالتغييرات
debug timings
احصل على توقيتات المهام الخاصة بالتغيير
يعرض الأمر timings تفاصيل حول الوقت الذي تستغرقه كل مهمة لتنفيذها.
الاستخدام: debug timings [timings-OPTIONS]
--last حدد آخر تغيير من النوع المحدد (تثبيت، تحديث، إزالة، تجربة، تحديث تلقائي، إلخ).
يشير رمز الاستفهام في نهاية النوع إلى عدم فعل أي شيء (بدلاً من إرجاع خطأ)
إذا لم يتم العثور على أي تغيير من النوع المحدد. لاحظ أنه قد يلزم حماية رمز الاستفهام من shell.
--ensure
اعرض التوقيتات الخاصة بالتغيير المتعلق بنشاط Ensure المحدد (واحد مما يلي: تحديث تلقائي، بدء التشغيل، تحديث الكتالوجات، تحديث التلميحات، التلقيح)
--all اعرض التوقيتات لجميع عمليات تنفيذ Ensure أو نشاط بدء التشغيل المحدد، وليس فقط الأحدث
--startup اعرض التوقيتات لبدء تشغيل النظام الفرعي المحدد (واحد مما يلي: تحميل الحالة، ifacemgr)
--verbose اعرض المزيد من المعلومات
debug validate-seed
التحقق من صحة التلقيح (seed)
التحقق من صحة التلقيح (seed) الموجود في الدليل الذي يحتوي على ملف seed.yaml.
disable
تعطيل snap في النظام
يعطل الأمر disable snap. لن تكون الملفات التنفيذية والخدمات الخاصة بـ snap متاحة، ولكن تظل جميع البيانات متاحة ويمكن إعادة تمكين snap بسهولة.
الاستخدام: snap [OPTIONS] disable [disable-OPTIONS]
--no-wait
لا تنتظر حتى انتهاء العملية، ولكن اطبع فقط معرف التغيير.
disconnect
افصل مقبسًا عن فتحة
يمكن استدعاء الأمر disconnect بالطرق التالية:
$ snap disconnect <snap>:<plug> <snap>:<slot>
يفصل المكون plug المحدد عن الفتحة slot المحددة.
$ snap disconnect <snap>:<slot or plug>
يفصل كل شيء عن المكون plug أو الفتحة slot المحدد. يمكن حذف اسم snap بالنسبة لـ snap الرئيسي (core).
عند فصل اتصال تم إعداده تلقائيًا يدويًا، يتم الاحتفاظ بحالته المفصولة بعد تحديث snap. يمكن إضافة العلامة --forget إلى الأمر disconnect لإعادة تعيين هذا السلوك، وبالتالي إعادة تمكين إعادة الاتصال التلقائي بعد تحديث snap.
الاستخدام: snap [OPTIONS] disconnect [disconnect-OPTIONS]
--no-wait
لا تنتظر حتى انتهاء العملية، ولكن اطبع فقط معرف التغيير.
--forget
انسَ الحالة المحفوظة حول الاتصال المحدد.
download
قم بتنزيل snap المحدد
يقوم الأمر download بتنزيل snap والمكونات والإقرارات الداعمة الخاصة بها إلى الدليل الحالي بامتدادات ملف .snap و .comp و .assert على التوالي.
الاستخدام: snap [OPTIONS] download [download-OPTIONS]
--channel
استخدم هذا القناة بدلاً من القناة المستقرة
--edge قم بالتثبيت من القناة التجريبية (edge)
--beta قم بالتثبيت من القناة التجريبية (beta)
--candidate قم بالتثبيت من القناة التجريبية (candidate)
--stable قم بالتثبيت من القناة المستقرة
--revision قم بتنزيل الإصدار المحدد من snap. عند تنزيل المكونات، قم بتنزيل المكونات المرتبطة بالإصدار المحدد من snap.
--basename
استخدم هذا الاسم الأساس لملفات اللقطة والمكون والتأكيد (افتراضيًا <snap>_<revision>)
--target-directory
قم بالتنزيل إلى هذا الدليل (افتراضيًا الدليل الحالي)
--only-components
قم بتنزيل المكونات المحددة فقط، وليس اللقطة
--cohort
قم بالتنزيل من المجموعة المحددة
enable
قم بتمكين لقطة في النظام
يقوم الأمر `enable` بتمكين لقطة تم تعطيلها مسبقًا.
الاستخدام: snap [OPTIONS] enable [enable-OPTIONS]
--no-wait
لا تنتظر حتى اكتمال العملية، ولكن اطبع فقط معرف التغيير.
export-snapshot
تصدير لقطة
قم بتصدير لقطة إلى اسم الملف المحدد.
find
ابحث عن حزم للتثبيت
يستعلم الأمر `find` عن المتجر للحصول على حزم متاحة.
باستخدام العلامة `--private`، والتي تتطلب أن يكون المستخدم قد قام بتسجيل الدخول إلى المتجر (راجع "snap help login")، فإنه يبحث بدلاً من ذلك عن اللقطات الخاصة التي يتمتع المستخدم بالحق في الوصول إليها كمطور، إما مباشرة أو من خلال ميزة التعاون في المتجر.
يتم الإشارة إلى ناشر تم التحقق منه بعلامة اختيار خضراء (إذا كان مدعومًا بالألوان و Unicode) بعد اسم الناشر.
الاستخدام: snap [OPTIONS] find [find-OPTIONS]
الأسماء المستعارة: search
--private
ابحث عن اللقطات الخاصة.
--narrow
ابحث فقط عن اللقطات الموجودة في قسم "مستقر".
--section [="show-all-sections-please"] <افتراضي: "no-section-specified">
قم بتقييد البحث بقسم معين.
--color <افتراضي: "auto">
استخدم القليل من الألوان لإبراز بعض الأشياء.
--unicode <افتراضي: "auto">
استخدم القليل من Unicode لتحسين سهولة القراءة.
forget
احذف لقطة
يحذف الأمر `forget` لقطة. لا يمكن التراجع عن هذه العملية.
تحتوي اللقطة على أرشيفات للبيانات الخاصة بالمستخدم والنظام والتكوين لكل لقطة مضمنة في اللقطة.
بشكل افتراضي، يحذف هذا الأمر جميع البيانات الموجودة في اللقطة. بدلاً من ذلك، يمكنك تحديد البيانات الخاصة باللقطات التي تريد حذفها.
الاستخدام: snap [OPTIONS] forget [forget-OPTIONS]
--no-wait
لا تنتظر حتى اكتمال العملية، ولكن اطبع فقط معرف التغيير.
get
اطبع خيارات التكوين
يطبع الأمر `get` خيارات التكوين للقطة المحددة.
$ snap get snap-name username
frank
إذا تم توفير أسماء خيارات متعددة، فسيتم إرجاع القيم المقابلة:
$ snap get snap-name username password
Key Value
username frank
password ...
يمكن استرداد القيم المتداخلة عبر مسار منقط:
$ snap get snap-name author.name
frank
الاستخدام: snap [OPTIONS] get [get-OPTIONS]
-t التحقق الصارم من الأنواع مع القيم الفارغة والسلاسل المقتبسة
-d إرجاع المستند دائمًا، حتى مع مفتاح واحد
-l إرجاع القائمة دائمًا، حتى مع مفتاح واحد
help
اعرض مساعدة حول أمر
يعرض الأمر `help` معلومات حول أوامر snap.
الاستخدام: snap [OPTIONS] help [help-OPTIONS]
--all اعرض ملخصًا موجزًا لجميع الأوامر
import-snapshot
استيراد لقطة
قم باستيراد مجموعة لقطات مصدرة إلى النظام. يتم استيراد اللقطة بمعرف لقطة جديد ويمكن استعادتها باستخدام الأمر `restore`.
الاستخدام: snap [الخيارات] import-snapshot [خيارات import-snapshot]
--abs-time
info
اعرض معلومات مفصلة حول اللقطات
يعرض الأمر `info` معلومات مفصلة حول اللقطات.
يمكن تحديد اللقطات بالاسم أو بالمسار؛ يتم البحث عن الأسماء في المتجر وفي اللقطات المثبتة؛ يمكن أن يشير المسار إلى ملف `.snap`، أو إلى دليل يحتوي على لقطة غير مضغوطة مناسبة لـ `snap try` (مثال على ذلك هو الدليل `prime` الذي ينتجه `snapcraft`).
الاستخدام: snap [الخيارات] info [خيارات info]
--color <افتراضي: "auto">
استخدم القليل من الألوان لتسليط الضوء على بعض الأشياء.
--unicode <افتراضي: "auto">
استخدم القليل من Unicode لتحسين سهولة القراءة.
--abs-time
اعرض الأوقات المطلقة (بتنسيق RFC 3339). وإلا، اعرض الأوقات النسبية حتى 60 يومًا، ثم YYYY-MM-DD.
--verbose
قم بتضمين المزيد من التفاصيل حول اللقطة (ملاحظات موسعة، أساس، إلخ).
install
قم بتثبيت اللقطات على النظام
يقوم الأمر `install` بتثبيت اللقطات المحددة على النظام.
لتثبيت مثيلات متعددة من نفس اللقطة، أضف شرطة سفلية ومعرفًا فريدًا (لكل مثيل) إلى اسم اللقطة.
يتم تثبيت المثيلات المتوازية مع تمرير `--unaliased` ضمنيًا لتجنب التعارضات مع عمليات التثبيت الموجودة. يمكن تغيير هذا السلوك عن طريق تمرير `--prefer`، مما سيُمكّن جميع الأسماء المستعارة للقطة المعطاة مع إعطاء الأولوية لها على الأسماء المستعارة المتعارضة للقطات الأخرى، وسيتم تعطيل الأسماء المستعارة التلقائية وإزالة الأسماء المستعارة اليدوية.
بدون خيارات إضافية، يتم تثبيت اللقطات مع تتبع القناة المستقرة، مع تقييد أمني صارم. يتم سرد جميع القنوات المتاحة للقطعة في إخراج `snap info`.
عند استخدام `--revision`، عادةً ما ستعيد عملية التحديث اللاحقة تجاوز الإصدار، مما يعيد اللقطة إلى الإصدار الحالي للقناة التي تتتبعها.
استخدم `--name` لتعيين اسم المثيل عند التثبيت من ملف اللقطة.
الاستخدام: snap [الخيارات] install [خيارات install]
--color <افتراضي: "auto">
استخدم القليل من الألوان لتسليط الضوء على بعض الأشياء.
--unicode <افتراضي: "auto">
استخدم القليل من Unicode لتحسين سهولة القراءة.
--no-wait
لا تنتظر حتى تنتهي العملية، ولكن اطبع فقط معرف التغيير.
--channel
استخدم هذه القناة بدلاً من القناة المستقرة
--edge
قم بالتثبيت من قناة edge.
--beta
قم بالتثبيت من قناة beta.
--candidate
قم بالتثبيت من قناة candidate.
--stable
قم بالتثبيت من القناة المستقرة.
--devmode
ضع اللقطة في وضع التطوير وقم بتعطيل التقييد الأمني.
--jailmode
ضع اللقطة في وضع التقييد المفروض.
--classic
ضع اللقطة في وضع classic وقم بتعطيل التقييد الأمني.
--revision
قم بتثبيت الإصدار المحدد من اللقطة.
--dangerous
قم بتثبيت ملف اللقطة المحدد حتى إذا لم تكن هناك أي توقيعات معترف بها مسبقًا له، مما يعني أنه لم يتم التحقق منه وقد يكون خطيرًا (يشير `--devmode` ضمنيًا إلى هذا).
--unaliased
قم بتثبيت اللقطة المحددة دون تمكين أسماءها المستعارة التلقائية.
--prefer
قم بتمكين جميع الأسماء المستعارة للوحدة النمطية (snap) المحددة بدلاً من الأسماء المستعارة المتضاربة للوحدات النمطية الأخرى.
--name
قم بتثبيت ملف الوحدة النمطية (snap) تحت اسم المثيل المحدد.
--cohort
قم بتثبيت الوحدة النمطية (snap) في المجموعة المحددة.
--ignore-validation
تجاهل التحقق من قبل الوحدات النمطية الأخرى التي تمنع التثبيت.
--transaction <القيمة الافتراضية: "per-snap">
استخدم معاملة لكل وحدة نمطية (snap) أو معاملة واحدة لجميع الوحدات النمطية المحددة.
--quota-group
أضف الوحدة النمطية (snap) إلى مجموعة حصص عند التثبيت.
interface
عرض تفاصيل واجهات الوحدة النمطية (snap).
يعرض الأمر `interface` تفاصيل واجهات الوحدة النمطية (snap).
إذا لم يتم توفير اسم واجهة، فسيتم عرض قائمة بأسماء الواجهات التي تحتوي على اتصال واحد على الأقل، أو قائمة بجميع الواجهات إذا تم توفير `--all`.
الاستخدام: `snap [OPTIONS] interface [interface-OPTIONS]`
--attrs
عرض سمات الواجهة.
--all
قم بتضمين الواجهات غير المستخدمة.
known
عرض التأكيدات المعروفة من النوع المحدد.
يعرض الأمر `known` التأكيدات المعروفة من النوع المحدد. إذا تم توفير أزواج `header=value` بعد نوع التأكيد، فيجب أن تحتوي التأكيدات المعروضة أيضًا على الرؤوس المحددة التي تتطابق مع القيم المقدمة.
الاستخدام: `snap [OPTIONS] known [known-OPTIONS]`
--remote
استعلم عن المتجر للحصول على التأكيد، عبر snapd إن أمكن.
--direct
استعلم عن المتجر للحصول على التأكيد، دون محاولة المرور عبر snapd.
list
عرض قائمة بالوحدات النمطية (snaps) المثبتة.
يعرض الأمر `list` ملخصًا للوحدات النمطية (snaps) المثبتة في النظام الحالي.
يشير علامة اختيار خضراء (إذا تم دعم الألوان و Unicode) بعد اسم الناشر إلى أن الناشر قد تم التحقق منه.
الاستخدام: `snap [OPTIONS] list [list-OPTIONS]`
--all
عرض جميع المراجعات.
--color <القيمة الافتراضية: "auto">
استخدم القليل من الألوان لإبراز بعض العناصر.
--unicode <القيمة الافتراضية: "auto">
استخدم القليل من Unicode لتحسين سهولة القراءة.
login
المصادقة على snapd والمتجر.
يصادق الأمر `login` المستخدم على snapd ومتجر الوحدات النمطية (snap) ويحفظ بيانات الاعتماد في ملف `~/.snap/auth.json`. سيتم بعد ذلك إجراء مزيد من الاتصالات مع snapd باستخدام بيانات الاعتماد هذه.
ليس من الضروري تسجيل الدخول للتفاعل مع snapd. ومع ذلك، يتيح القيام بذلك التفاعلات بدون استخدام `sudo`، بالإضافة إلى بعض الميزات الموجهة للمطورين كما هو مفصل في تعليمات الأوامر `find` و `install` و `refresh`.
يمكن إعداد حساب على https://login.ubuntu.com
logout
تسجيل الخروج من snapd والمتجر.
يسجل الأمر `logout` تسجيل الخروج للمستخدم الحالي من snapd والمتجر.
logs
استرداد سجلات الخدمات.
يجلب الأمر `logs` سجلات الخدمات المحددة ويعرضها بترتيب زمني.
الاستخدام: `snap [OPTIONS] logs [logs-OPTIONS]`
--abs-time
عرض الأوقات المطلقة (بتنسيق RFC 3339). وإلا، فسيتم عرض الأوقات النسبية حتى 60 يومًا، ثم YYYY-MM-DD.
-n <القيمة الافتراضية: "10">
اعرض فقط العدد المحدد من الأسطر، أو 'all'.
-f
انتظر الأسطر الجديدة واطبعها فور وصولها.
model
الحصول على النموذج النشط لهذا الجهاز.
يعرض الأمر `model` معلومات تأكيد النموذج النشط لهذا الجهاز.
افتراضيًا، يتم تضمين معلومات تعريف النموذج الأساسية فقط في الإخراج، ولكن يمكن توسيع ذلك ليشمل جميع رؤوس التأكيد غير التعريفية.
يتم تقديم الإخراج المفصل بتنسيق منظم يشبه YAML.
وبالمثل، يمكن استخدام تأكيد السلسلة النشط للإخراج بدلاً من تأكيد النموذج.
الاستخدام: snap [خيارات] نموذج [خيارات-النموذج]
--abs-time
عرض الأوقات المطلقة (بتنسيق RFC 3339). وإلا، يتم عرض الأوقات النسبية حتى 60 يومًا، ثم YYYY-MM-DD.
--color <افتراضي: "تلقائي">
استخدم القليل من الألوان لتسليط الضوء على بعض الأشياء.
--unicode <افتراضي: "تلقائي">
استخدم القليل من Unicode لتحسين سهولة القراءة.
--serial
اطبع تأكيد السلسلة بدلاً من تأكيد النموذج.
--verbose
اطبع جميع حقول التأكيد المحددة.
--assertion
اطبع التأكيد الخام.
okay
أقر بالتحذيرات
يقوم الأمر okay بالإقرار بالتحذيرات المدرجة باستخدام 'snap warnings'.
بمجرد الإقرار، لن يظهر التحذير مرة أخرى إلا إذا تكرر ومر وقت كافٍ.
pack
قم بتعبئة الدليل المحدد كسلسلة
يقوم الأمر pack بتعبئة snap-dir المحدد كسلسلة ويكتب النتيجة إلى target-dir. إذا تم حذف target-dir، فسيتم كتابة النتيجة إلى الدليل الحالي. إذا تم حذف كل من source-dir و target-dir، يقوم الأمر pack بتعبئة الدليل الحالي.
يمكن اشتقاق اسم الملف الافتراضي لسلسلة من snap.yaml الخاص بها، ولكن في بعض الحالات يكون من الأسهل أن يقوم البرنامج النصي بإدخال اسم الملف. في هذه الحالات، يمكن إعطاء --filename لتجاوز الافتراضي. إذا لم يكن هذا الاسم المطلق، فسيتم اعتباره نسبيًا لـ targetdir.
عند استخدامه مع --check-skeleton، يتحقق الأمر pack فقط مما إذا كان snap-dir يحتوي على بيانات تعريف سلسلة صالحة ويرفع خطأ بخلاف ذلك. تؤدي الأوامر المدرجة في ملف بيانات تعريف السلسلة، ولكنها تظهر مع أذونات غير صحيحة، إلى حدوث خطأ. يتم سرد الأوامر المفقودة من snap-dir في رسائل تشخيصية.
الاستخدام: snap [خيارات] pack [خيارات-التعبئة]
--check-skeleton
تحقق من بيانات تعريف snap-dir فقط
--filename
الإخراج إلى اسم الملف هذا
--compression
الضغط المراد استخدامه (على سبيل المثال، xz أو lzo)
prefer
تمكين الأسماء المستعارة من سلسلة، وتعطيل أي أسماء مستعارة متعارضة
يقوم الأمر prefer بتمكين جميع الأسماء المستعارة للسلسلة المحددة بدلاً من الأسماء المستعارة المتعارضة للسلاسل الأخرى، والتي سيتم تعطيلها (أو إزالتها، للأسماء المستعارة اليدوية).
الاستخدام: snap [خيارات] prefer [خيارات-التفضيل]
--no-wait
لا تنتظر حتى تنتهي العملية ولكن اطبع معرف التغيير فقط.
prepare-image
إعداد صورة جهاز
يقوم الأمر prepare-image بإجراء بعض الخطوات اللازمة لإنشاء صور الأجهزة.
بالنسبة لصور النواة، لا يتم استدعاؤها مباشرة ولكن عادةً عبر ubuntu-image.
لإعداد الصور الكلاسيكية، فإنه يدعم وضع --classic
الاستخدام: snap [خيارات] prepare-image [خيارات-prepare-image]
--classic
تمكين الوضع الكلاسيكي لإعداد صورة نموذج كلاسيكي
--preseed
إعداد مسبق (UC20+ فقط)
--preseed-sign-key
اسم المفتاح المستخدم لتوقيع تأكيد الإعداد المسبق، وإلا فسيتم استخدام المفتاح الافتراضي.
--apparmor-features-dir
مسار اختياري لدليل ميزات AppArmor في النواة (فقط UC20+).
--sysfs-overlay
طبقة sysfs اختيارية لاستخدامها عند تشغيل خطوات الإعداد المسبق.
--arch حدد بنية لـ snaps لـ --classic عندما لا تحددها النموذج.
--channel
القناة المراد استخدامها.
--snap <snap>[=<channel>]
قم بتضمين snap المحدد من المتجر أو ملف محلي و/أو حدد القناة المراد تتبعها لـ snap المحدد.
--comp <snap>+<comp>
قم بتضمين المكون المحدد من المتجر أو ملف محلي.
--revisions
حدد ملف seeds.manifest يشير إلى المراجعات الدقيقة لـ snaps المقدمة والتي يجب تثبيتها.
--write-revisions [="./seed.manifest"]
يكتب ملف تعريف يحتوي على مراجع للمراجعات الدقيقة لـ snaps المستخدمة للصورة. المسار إلى ملف التعريف اختياري.
--validation
تحكم فيما إذا كان يجب تجاهل عمليات التحقق أو فرضها. (افتراضي: تجاهل)
--allow-snapd-kernel-mismatch
ما إذا كان مسموحًا بعدم تطابق بين إصدارات snapd snap و snapd في النواة.
--assert <filename>
قم بتضمين التأكيد من الملف المحلي.
quota
اعرض مجموعة الحصص لمجموعة من snaps.
يعرض الأمر quota معلومات حول مجموعة حصص، بما في ذلك مجموعة snaps وأي مجموعات فرعية تحتوي عليها، بالإضافة إلى قيود الموارد والاستخدام الحالي لتلك الموارد المقيدة.
quotas
اعرض مجموعات الحصص.
يعرض الأمر quotas جميع مجموعات الحصص.
reboot
أعد التشغيل إلى النظام والوضع المحددين.
يعيد الأمر reboot تشغيل النظام إلى وضع معين من نظام الاسترداد المحدد.
عند استدعائه بدون تسمية نظام وبدون وضع، فإنه سيؤدي ببساطة إلى تشغيل إعادة تشغيل عادية.
عند استدعائه بدون تسمية، سيتم استخدام النظام الحالي لوضع "التشغيل". سيتم استخدام نظام الاسترداد الافتراضي لوضعي "الاسترداد" و "إعادة تعيين المصنع" و "التثبيت".
لاحظ أن وضع "التشغيل" متاح فقط للنظام الحالي.
طريقة الاستخدام: snap [خيارات] reboot [خيارات إعادة التشغيل]
--run قم بالتمهيد في وضع التشغيل.
--install قم بالتمهيد في وضع التثبيت.
--recover قم بالتمهيد في وضع الاسترداد.
--factory-reset قم بالتمهيد في وضع إعادة تعيين المصنع.
recovery
اعرض أنظمة الاسترداد المتاحة.
يعرض الأمر recovery أنظمة الاسترداد المتاحة.
باستخدام --show-keys، فإنه يعرض مفاتيح الاسترداد التي يمكن استخدامها لفتح الأقسام المشفرة في حالة عدم عمل إلغاء القفل التلقائي الخاص بالجهاز.
طريقة الاستخدام: snap [خيارات] recovery [خيارات الاسترداد]
--color <افتراضي: "auto">
استخدم القليل من الألوان لإبراز بعض الأشياء.
--unicode <افتراضي: "auto">
استخدم القليل من Unicode لتحسين إمكانية القراءة.
--show-keys
اعرض مفاتيح الاسترداد (إذا كانت متوفرة) لفتح الأقسام المشفرة.
refresh
قم بتحديث snaps في النظام.
يقوم الأمر refresh بتحديث snaps المحددة، أو جميع snaps في النظام إذا لم يتم تحديد أي منها.
بدون خيارات أخرى، يتم تحديث snaps إلى أحدث مراجعة للقناة التي تتتبعها، مع الحفاظ على خيارات الاحتواء الخاصة بها. يتم سرد جميع القنوات المتاحة لـ snap في ناتج 'snap info'.
عند استخدام --revision، ستقوم عملية التحديث اللاحقة عادةً بإلغاء تجاوز التعديل.
يُستخدم Hold (أو --hold) لتأجيل تحديثات snap refresh لجميع التطبيقات المثبتة عبر Snap، أو للتطبيقات المحددة.
عند عدم تحديد أي تطبيقات، يكون الخيار --hold فعالاً فقط على التحديثات التلقائية ولن يمنع طلبات التحديث العامة من الأمر snap refresh أو طلبات التحديث الخاصة بتطبيق معين من الأمر snap refresh target-snap.
عند تحديد تطبيقات، يكون الخيار --hold فعالاً على كل من التحديثات التلقائية وطلبات التحديث العامة من الأمر snap refresh. ومع ذلك، تظل طلبات التحديث الخاصة بتطبيق معين من الأمر snap refresh target-snap غير محظورة وستستمر في العمل.
الاستخدام: `snap [OPTIONS] refresh [refresh-OPTIONS]`
`--color <default: "auto">`
استخدام بعض الألوان لتسليط الضوء على بعض الأشياء.
`--unicode <default: "auto">`
استخدام بعض الأحرف الخاصة لتحسين إمكانية القراءة.
`--abs-time`
عرض الأوقات المطلقة (بتنسيق RFC 3339). وإلا، سيتم عرض الأوقات النسبية حتى 60 يومًا، ثم بتنسيق YYYY-MM-DD.
`--no-wait`
عدم الانتظار حتى اكتمال العملية، ولكن فقط طباعة معرف التغيير.
`--channel`
استخدام هذا القناة بدلاً من القناة المستقرة.
`--edge`
التثبيت من قناة "edge".
`--beta`
التثبيت من قناة "beta".
`--candidate`
التثبيت من قناة "candidate".
`--stable`
التثبيت من قناة "stable".
`--devmode`
وضع التطبيق المثبت عبر Snap في وضع التطوير وتعطيل الحماية الأمنية.
`--jailmode`
وضع التطبيق المثبت عبر Snap في وضع الحماية الصارم.
`--classic`
وضع التطبيق المثبت عبر Snap في وضع "classic" وتعطيل الحماية الأمنية.
`--amend`
السماح بمحاولة التحديث لتطبيق غير معروف في المتجر.
`--revision`
التحديث إلى الإصدار المحدد.
`--cohort`
تحديث التطبيق إلى المجموعة المحددة.
`--leave-cohort`
تحديث التطبيق وإزالته من مجموعته.
`--list`
عرض الإصدارات الجديدة من التطبيقات التي سيتم تحديثها في التحديث التالي.
`--time`
عرض معلومات التحديث التلقائي دون إجراء تحديث.
`--ignore-validation`
تجاهل التحقق من التطبيقات الأخرى التي تمنع التحديث.
`--transaction <default: "per-snap">`
إجراء معاملة لكل تطبيق أو معاملة واحدة لجميع التطبيقات المحددة.
`--hold [="forever"]`
حظر التحديثات لفترة محددة (أو إلى الأبد، إذا لم يتم تحديد قيمة).
`--unhold`
إزالة حظر التحديث.
`remodel`
إعادة تصميم هذا الجهاز.
يغير الأمر remodel إقرار نموذج الجهاز، إما إلى إصدار جديد أو إلى نموذج جديد بالكامل.
في هذه العملية، يتم تطبيق أي تغييرات ضمنية على الجهاز: تطبيقات جديدة مطلوبة، أو نواة جديدة أو أداة جديدة، إلخ.
يتم تنزيل التطبيقات والإقرارات من المتجر ما لم يتم توفيرها كملفات محلية باستخدام الخيارات --snap و --assertion. إذا تم استخدام هذه الخيارات، فمن المتوقع توفير جميع التطبيقات والإقرارات المطلوبة محليًا، وإلا سيفشل إعادة التصميم.
الاستخدام: `snap [OPTIONS] remodel [remodel-OPTIONS]`
`--no-wait`
عدم الانتظار حتى اكتمال العملية، ولكن فقط طباعة معرف التغيير.
`--snap`
استخدام تطبيق أو أكثر متوفرين محليًا.
`--assertion`
استخدام ملف أو أكثر من ملفات الإقرار المتوفرة محليًا.
--offline
استخدم فقط اللقطات والتحقق من الصحة المثبتة محليًا والمقدمة. توفر أي لقطات أو عمليات تحقق من الصحة محليًا يعني استخدام الخيار --offline.
remove
إزالة اللقطات من النظام.
يزيل الأمر remove اللقطة المحددة من النظام.
افتراضيًا، تتم إزالة جميع إصدارات اللقطة، بما في ذلك بياناتها ودليل البيانات المشترك. عند تمرير الخيار --revision، تتم إزالة الإصدار المحدد فقط.
ما لم يتم تعطيل اللقطات التلقائية، يتم حفظ لقطة لجميع بيانات اللقطة عند إزالتها، والتي تكون متاحة لاحقًا للاستعادة باستخدام الأمر snap restore. يعطل الخيار --purge إنشاء لقطات تلقائية.
الاستخدام: snap [الخيارات] remove [خيارات الإزالة]
--no-wait
لا تنتظر حتى اكتمال العملية، بل اطبع معرف التغيير فقط.
--revision
أزل الإصدار المحدد فقط.
--purge
أزل اللقطة دون حفظ لقطة لبياناتها.
--terminate
أوقف العمليات قيد التشغيل المرتبطة باللقطة قبل إزالتها.
remove-quota
إزالة مجموعة الحصص.
يزيل الأمر remove-quota مجموعة الحصص المحددة.
حاليًا، يمكن إزالة مجموعات الحصص التي لا تحتوي على مجموعات فرعية فقط. من أجل إزالة مجموعة حصص تحتوي على مجموعات فرعية، يجب أولاً إزالة المجموعات الفرعية حتى لا تكون هناك مجموعات فرعية للمجموعة، ثم يمكن إزالة المجموعة نفسها.
الاستخدام: snap [الخيارات] remove-quota [خيارات إزالة الحصص]
--no-wait
restart
إعادة تشغيل الخدمات.
يعيد الأمر restart تشغيل الخدمات المحددة.
إذا تم إعطاء الخيار --reload، فسيتم إجراء إعادة تحميل بدلاً من إعادة التشغيل لكل خدمة يحتوي تطبيقها على أمر إعادة تحميل.
الاستخدام: snap [الخيارات] restart [خيارات إعادة التشغيل]
--no-wait
لا تنتظر حتى اكتمال العملية، بل اطبع معرف التغيير فقط.
--system
يجب أن تؤثر العملية على خدمات النظام فقط.
--user
يجب أن تؤثر العملية على خدمات المستخدم للمستخدم الحالي فقط.
--users
إذا تم توفيره وتم تعيينه على "all"، فيجب أن تؤثر العملية على الخدمات لجميع المستخدمين.
--reload
إذا كانت الخدمة تحتوي على أمر إعادة تحميل، فاستخدمه بدلاً من إعادة التشغيل.
restore
استعادة لقطة.
يستبدل الأمر restore بيانات المستخدم والنظام والتكوين الحالية للقطات المضمنة بالبيانات المقابلة من اللقطة المحددة.
افتراضيًا، يستعيد هذا الأمر جميع البيانات الموجودة في اللقطة. بدلاً من ذلك، يمكنك تحديد البيانات الخاصة باللقطات التي سيتم استعادتها، أو المستخدمين الذين سيتم استعادتها، أو مزيجًا من هذه الخيارات.
إذا كانت اللقطة مضمنة في عملية استعادة، فلا يمكن حاليًا استبعاد بيانات النظام والتكوين الخاصة بها من عملية الاستعادة. قد يتم رفع هذا القيد في المستقبل.
الاستخدام: snap [الخيارات] restore [خيارات الاستعادة]
--no-wait
لا تنتظر حتى اكتمال العملية، بل اطبع معرف التغيير فقط.
--users
استعادة بيانات المستخدمين المحددين فقط (مفصولة بفواصل) (افتراضي: جميع المستخدمين)
revert
يعيد اللقطة المحددة إلى الحالة السابقة.
يعيد الأمر revert اللقطة المحددة إلى حالتها قبل التحديث الأخير. سيؤدي ذلك إلى إعادة تنشيط إصدار اللقطة السابق، وسيستخدم البيانات الأصلية المرتبطة بهذا الإصدار، مع تجاهل أي تغييرات في البيانات التي تم إجراؤها بواسطة الإصدار الأخير. الاستثناء هو أن البيانات التي تختار اللقطة مشاركتها عبر الإصدارات لن يتم لمسها بواسطة عملية الرجوع.
الاستخدام: snap [خيارات] تراجع [خيارات-التراجع]
--no-wait
لا تنتظر حتى انتهاء العملية، بل اطبع فقط معرّف التغيير.
--devmode
ضع snap في وضع التطوير وقم بتعطيل الحماية الأمنية.
--jailmode
ضع snap في وضع الحماية المفروضة.
--classic
ضع snap في الوضع الكلاسيكي وقم بتعطيل الحماية الأمنية.
--revision
ارجع إلى الإصدار المحدد.
تشغيل
قم بتشغيل أمر snap المحدد.
يقوم الأمر `run` بتشغيل الأمر المحدد لـ snap مع الحماية والبيئة المناسبة.
الاستخدام: snap [خيارات] تشغيل [خيارات-التشغيل] <اسم-الـ snap>.<اسم-التطبيق> [وسيطات-التطبيق-الـ snap]
--shell
قم بتشغيل shell بدلاً من الأمر (مفيد لتصحيح الأخطاء).
--debug-log
قم بتمكين تسجيل الأخطاء أثناء مراحل بدء تشغيل snap المبكرة.
--strace [="with-strace"] <افتراضي: "no-strace">
قم بتشغيل الأمر باستخدام strace (مفيد لتصحيح الأخطاء). يمكن تحديد خيارات strace إضافية هنا أيضًا. مرر `--raw` إلى مساعدي snap في وقت مبكر.
--gdbserver [=":0"] <افتراضي: "no-gdbserver">
قم بتشغيل الأمر باستخدام gdbserver.
--trace-exec
اعرض بيانات توقيت استدعاءات exec.
حفظ
احفظ لقطة من البيانات الحالية.
يقوم الأمر `save` بإنشاء لقطة للبيانات الحالية للمستخدم والنظام والتكوين لـ snaps المحددة.
بشكل افتراضي، يقوم هذا الأمر بحفظ بيانات جميع snaps لجميع المستخدمين. بدلاً من ذلك، يمكنك تحديد بيانات snaps التي سيتم حفظها، أو للمستخدمين الذين سيتم حفظ البيانات لهم، أو مزيج من الاثنين.
إذا تم تضمين snap في عملية حفظ، فلا يمكن حاليًا استبعاد بيانات النظام والتكوين الخاصة به من اللقطة. قد تتم إزالة هذا القيد في المستقبل.
الاستخدام: snap [خيارات] حفظ [خيارات-الحفظ]
--no-wait
لا تنتظر حتى انتهاء العملية، بل اطبع فقط معرّف التغيير.
--abs-time
اعرض الأوقات المطلقة (بتنسيق RFC 3339). وإلا، اعرض الأوقات النسبية القصيرة.
--users
التقط بيانات المستخدمين المحددين فقط (مفصولة بفواصل) (افتراضي: جميع المستخدمين).
محفوظة
اعرض اللقطات المحفوظة حاليًا.
يعرض الأمر `saved` قائمة باللقطات التي تم إنشاؤها مسبقًا باستخدام الأمر `save`.
الاستخدام: snap [خيارات] محفوظة [خيارات-المحفوظة]
--abs-time
اعرض الأوقات المطلقة (بتنسيق RFC 3339). وإلا، اعرض الأوقات النسبية القصيرة.
--id
اعرض لقطة معينة فقط.
الخدمات
استعلم عن حالة الخدمات.
يقوم الأمر `services` بإدراج معلومات حول الخدمات المحددة، أو حول الخدمات في جميع snaps المثبتة حاليًا.
إذا تم تنفيذه كمستخدم الجذر، فسيشير عمود "البدء" لأي خدمة مستخدم إلى ما إذا كانت الخدمة ممكّنة عالميًا (أي أن `systemctl is-enabled` هي القيمة). لعرض الحالة الفعلية لـ "البدء" | "الحالي" لخدمات المستخدم الخاصة بمستخدم الجذر نفسه، يمكن توفير الخيار `--user`.
إذا تم تنفيذه كمستخدم غير الجذر، فسيكون حالة "تشغيل"|"الحالي" لخدمات المستخدم هي الحالة الحالية للمستخدم الذي قام بتشغيل الأمر. لعرض حالة التمكين العامة لخدمات المستخدم، يمكن توفير الخيار --global.
الاستخدام: snap [خيارات] services [خيارات-الخدمات]
-g، --global
عرض حالة التمكين العامة لخدمات المستخدم بدلاً من حالة المستخدم الحالي.
-u، --user
عرض الحالة الحالية لخدمات المستخدم بدلاً من حالة التمكين العامة.
set
تغيير خيارات التكوين.
يغير الأمر `set` خيارات التكوين المحددة حسب الطلب.
$ snap set snap-name username=frank password=$PASSWORD
يتم حفظ جميع تغييرات التكوين مرة واحدة، وفقط بعد إرجاع خطاف التكوين الخاص بالـ snap بنجاح.
يمكن تعديل القيم المتداخلة عبر مسار منقط:
$ snap set snap-name author.name=frank
يمكن إلغاء تعيين خيار التكوين باستخدام علامة التعجب:
$ snap set snap-name author!
الاستخدام: snap [خيارات] set [خيارات-set]
--no-wait
لا تنتظر حتى اكتمال العملية، ولكن اطبع فقط معرف التغيير.
-t
حلل القيمة بدقة باعتبارها مستند JSON.
-s
حلل القيمة كسلسلة.
set-quota
إنشاء أو تحديث مجموعة حصص.
يقوم الأمر `set-quota` بتحديث أو إنشاء مجموعة حصص بالـ snaps المحددة.
تحدد مجموعة الحصص قيود الموارد على مجموعة الـ snaps أو خدمات الـ snap التي تحتوي عليها. يمكن أن تكون الـ snaps في مجموعة حصص واحدة على الأكثر، ولكن يمكن أن تكون مجموعات الحصص متداخلة. تخضع مجموعات الحصص المتداخلة للقيود التي مفادها أن مجموع كل حصة موجودة في المجموعات الفرعية لا يمكن أن يتجاوز تلك الموجودة في المجموعة الأصلية التي تشكل جزءًا منها المجموعات المتداخلة.
تتم إضافة جميع الـ snaps المتوفرة إلى المجموعة؛ لإزالة snap من مجموعة حصص، يجب إزالة المجموعة بأكملها باستخدام `remove-quota` وإعادة إنشائها بدون الـ snap. لإزالة مجموعة فرعية من مجموعة الحصص، يجب إزالة المجموعة الفرعية مباشرةً باستخدام الأمر `remove-quota`.
لتعيين حدود على الخدمات الفردية، يمكن وضع خدمة واحدة أو أكثر في مجموعة فرعية. يجب أن ينتمي الـ snap المقابل لكل خدمة إلى المجموعة الأصلية للمجموعة الفرعية. سيكون لهذه المجموعات الفرعية نفس القيود التي تطبق على المجموعات المتداخلة، مما يعني أن استخدام الموارد المجمع الخاص بها لا يمكن أن يتجاوز حدود الموارد المحددة للمجموعة الأصلية. لا يمكن تعيين حصص سجلات للمجموعات الفرعية التي تحتوي على خدمات، وبدلاً من ذلك، ترث تلقائيًا أي حصة سجلات قد تكون لدى مجموعة الحصص الأصلية.
يمكن زيادة حد الذاكرة لمجموعة حصص ولكن لا يمكن تقليله. لتقليل حد الذاكرة لمجموعة حصص، يجب إزالة المجموعة بأكملها باستخدام الأمر `remove-quota` وإعادة إنشائها بحد أقل. لا يؤدي زيادة حد الذاكرة لمجموعة حصص إلى إعادة تشغيل أي خدمات مرتبطة بالـ snaps الموجودة في مجموعة الحصص.
يمكن زيادة حد وحدة المعالجة المركزية لمجموعة حصص وتقليله بعد تعيينه على مجموعة حصص. يمكن تحديد حد وحدة المعالجة المركزية كنسبة مئوية واحدة، مما يعني أن مجموعة الحصص مسموح لها بنسبة مئوية من موارد وحدة المعالجة المركزية. يعني تعيينه على 50٪ أن مجموعة الحصص مسموح لها باستخدام ما يصل إلى 50٪ من جميع نوى وحدة المعالجة المركزية في مجموعة وحدات المعالجة المركزية المسموح بها. يعني تعيين النسبة المئوية على 2100٪ أن مجموعة الحصص مسموح لها بما يصل إلى 100٪ على وحدتي معالجة مركزية.
يمكن تعديل حد مجموعة الحصص لوحدة المعالجة المركزية (CPU) لتضمين وحدات معالجة مركزية جديدة، أو لإزالة وحدات المعالجة المركزية الموجودة من الحصة التي تم تعيينها بالفعل.
يمكن زيادة حد سلاسل العمل (threads) لمجموعة حصص، ولكن لا يمكن تقليله. لتقليل حد سلاسل العمل لمجموعة حصص، يجب إزالة المجموعة بأكملها باستخدام الأمر remove-quota وإعادة إنشائها بحد أقل.
يمكن زيادة حدود التسجيل (journal) وتقليلها بعد تعيينها على مجموعة. سيؤدي تعيين حد للتسجيل إلى وضع اللقطات (snaps) الموجودة في المجموعة في نفس مساحة اسم التسجيل. سيؤثر ذلك على سلوك الأمر log.
يمكن تعيين حصص جديدة على مجموعات حصص موجودة، ولكن لا يمكن إزالة الحصص الموجودة من مجموعة حصص، دون إزالة المجموعة بأكملها وإعادة إنشائها.
سيؤدي إضافة لقطات جديدة إلى مجموعة حصص إلى إعادة تشغيل جميع الخدمات غير المعطلة في تلك اللقطة.
لا يمكن نقل مجموعة فرعية موجودة من مجموعة أصلية إلى مجموعة أصلية أخرى.
الاستخدام: `snap [OPTIONS] set-quota [set-quota-OPTIONS]`
`--no-wait`
لا تنتظر حتى اكتمال العملية، ولكن اطبع معرف التغيير فقط.
`--memory [=]`
حصة الذاكرة
`--cpu [=]`
حصة وحدة المعالجة المركزية
`--cpu-set [=]`
حصة مجموعة وحدات المعالجة المركزية
`--threads [=]`
حصة سلاسل العمل
`--journal-size [=]`
حصة حجم التسجيل
`--journal-rate-limit [=]`
حصة معدل التسجيل على شكل <عدد الرسائل>/<فترة الرسالة>
`--parent [=]`
مجموعة الحصص الأصلية
`start`
تشغيل الخدمات
يقوم الأمر `start` بتشغيل الخدمات المحددة، وربما تمكينها.
الاستخدام: `snap [OPTIONS] start [start-OPTIONS]`
`--no-wait`
لا تنتظر حتى اكتمال العملية، ولكن اطبع معرف التغيير فقط.
`--system`
يجب أن تؤثر العملية فقط على الخدمات النظامية.
`--user`
يجب أن تؤثر العملية فقط على خدمات المستخدم للمستخدم الحالي.
`--users`
إذا تم توفيرها وتم تعيينها على 'all'، فيجب أن تؤثر العملية على الخدمات لجميع المستخدمين.
`--enable`
بالإضافة إلى تشغيل الخدمة الآن، قم بترتيب تشغيلها عند بدء التشغيل.
`stop`
إيقاف الخدمات
يقوم الأمر `stop` بإيقاف الخدمات المحددة، وربما تعطيلها.
الاستخدام: `snap [OPTIONS] stop [stop-OPTIONS]`
`--no-wait`
لا تنتظر حتى اكتمال العملية، ولكن اطبع معرف التغيير فقط.
`--system`
يجب أن تؤثر العملية فقط على الخدمات النظامية.
`--user`
يجب أن تؤثر العملية فقط على خدمات المستخدم للمستخدم الحالي.
`--users`
إذا تم توفيرها وتم تعيينها على 'all'، فيجب أن تؤثر العملية على الخدمات لجميع المستخدمين.
`--disable`
بالإضافة إلى إيقاف الخدمة الآن، قم بترتيب عدم تشغيلها عند بدء التشغيل.
`switch`
تبديل اللقطة (snap) إلى قناة مختلفة
يقوم الأمر `switch` بتبديل اللقطة المحددة إلى قناة مختلفة دون إجراء تحديث. يتم سرد جميع القنوات المتاحة للقطة في إخراج `snap info`.
الاستخدام: `snap [OPTIONS] switch [switch-OPTIONS]`
--no-wait
لا تنتظر حتى انتهاء العملية، بل اطبع معرّف التغيير فقط.
--channel
استخدم هذا القناة بدلاً من القناة المستقرة.
--edge
ثبّت من قناة الإصدار التجريبي.
--beta
ثبّت من قناة البيتا.
--candidate
ثبّت من قناة المرشح.
--stable
ثبّت من القناة المستقرة.
--cohort
حوّل السناب إلى المجموعة المحددة.
--leave-cohort
حوّل السناب خارج مجموعته.
tasks
اعرض مهام التغيير.
تعرض الأمر tasks ملخصًا للمهام المرتبطة بتغيير معين.
الاستخدام: snap [خيارات] tasks [خيارات-tasks]
الأسماء المستعارة: change
--abs-time
اعرض الأوقات المطلقة (بتنسيق RFC 3339). وإلا، اعرض الأوقات النسبية حتى 60 يومًا، ثم YYYY-MM-DD.
--last
حدد آخر تغيير من نوع معين (تثبيت، تحديث، إزالة، تجربة، تحديث تلقائي، إلخ). تعني علامة الاستفهام في نهاية النوع أنه لا يجب فعل أي شيء (بدلاً من إرجاع خطأ) إذا لم يتم العثور على أي تغيير من النوع المحدد. لاحظ أنه قد يلزم حماية علامة الاستفهام من shell.
try
اختبر السناب الذي تم فك ضغطه في النظام.
يقوم الأمر try بتثبيت السناب الذي تم فك ضغطه في النظام لأغراض الاختبار. يستمر استخدام محتوى السناب الذي تم فك ضغطه حتى بعد التثبيت، لذلك يتم تطبيق التغييرات غير المتعلقة بالبيانات التعريفية على الفور. تتطلب التغييرات في البيانات التعريفية، مثل تلك التي يتم إجراؤها في ملف snap.yaml، إعادة التثبيت حتى يتم تطبيقها.
إذا تم حذف وسيطة snap-dir، فسيحاول الأمر try استنتاجها إذا تم العثور على ملف snapcraft.yaml و/أو دليل prime أو ملف meta/snap.yaml بالنسبة إلى الدليل الحالي.
الاستخدام: snap [خيارات] try [خيارات-try]
--no-wait
لا تنتظر حتى انتهاء العملية، بل اطبع معرّف التغيير فقط.
--devmode
ضع السناب في وضع التطوير وقم بتعطيل الحماية الأمنية.
--jailmode
ضع السناب في وضع الحماية المعززة.
--classic
ضع السناب في الوضع الكلاسيكي وقم بتعطيل الحماية الأمنية.
unalias
أزل اسمًا مستعارًا يدويًا، أو أزل جميع الأسماء المستعارة للسناب.
يزيل الأمر unalias اسمًا مستعارًا واحدًا إذا كان الوسيطة المقدمة اسمًا مستعارًا يدويًا، أو يعطل جميع الأسماء المستعارة للسناب، بما في ذلك الأسماء المستعارة اليدوية، إذا كانت الوسيطة اسم السناب.
الاستخدام: snap [خيارات] unalias [خيارات-unalias]
--no-wait
لا تنتظر حتى انتهاء العملية، بل اطبع معرّف التغيير فقط.
unset
أزل خيارات التكوين.
يزيل الأمر unset خيارات التكوين المقدمة.
$ snap unset snap-name name address
يتم حفظ جميع تغييرات التكوين مرة واحدة، وبعد أن يعود ربط تكوين السناب بنجاح.
يمكن إزالة القيم المتداخلة باستخدام مسار منقوط:
$ snap unset snap-name user.name
الاستخدام: snap [خيارات] unset [خيارات-unset]
--no-wait
لا تنتظر حتى انتهاء العملية، بل اطبع معرّف التغيير فقط.
validate
اعرض أو طبّق مجموعات التحقق من الصحة.
يعرض الأمر validate أو يطبّق مجموعات التحقق من الصحة التي تحدد السنابات المطلوبة أو المسموح بتثبيتها معًا، مع إمكانية تقييدها بإصدارات ثابتة.
يمكن أن تكون مجموعة التحقق من الصحة إما في وضع المراقبة، وفي هذه الحالة لا يتم تطبيق القيود الخاصة بها، أو في وضع التنفيذ، وفي هذه الحالة لن يسمح snapd بالعمليات التي تؤدي إلى مخالفة السنابات لقيود مجموعة التحقق من الصحة.
الاستخدام: snap [الخيارات] validate [خيارات-التحقق]
--monitor
راقب مجموعة التحقق المحددة
--enforce
قم بتطبيق مجموعة التحقق المحددة
--forget
انس مجموعة التحقق المحددة
--refresh
قم بتحديث أو تثبيت الحزم لتلبية مجموعات التحقق المطبقة
--color <افتراضي: "auto">
استخدم بعض الألوان لإبراز بعض الأشياء.
--unicode <افتراضي: "auto">
استخدم بعض أحرف يونيكود لتحسين سهولة القراءة.
--no-wait
لا تنتظر حتى اكتمال العملية، بل اطبع معرّف التغيير فقط.
version
اعرض تفاصيل الإصدار
يعرض الأمر `version` إصدارات العميل والخادم ونظام التشغيل قيد التشغيل.
wait
انتظر حتى يتم تكوين شيء ما
ينتظر الأمر `wait` حتى يصبح التكوين صحيحًا.
warnings
اعرض التحذيرات
يعرض الأمر `warnings` التحذيرات التي تم الإبلاغ عنها للنظام.
بمجرد سرد التحذيرات باستخدام الأمر `snap warnings`، يمكن استخدام الأمر `snap okay` لإسكاتها. لن يتم سرد التحذير الذي تمت إسكاته بهذه الطريقة مرة أخرى إلا إذا حدث مرة أخرى، ومر وقت "تهدئة".
تنتهي صلاحية التحذيرات تلقائيًا، وبمجرد انتهاء صلاحيتها، يتم نسيانها.
الاستخدام: snap [الخيارات] warnings [خيارات-التحذيرات]
--abs-time
اعرض الأوقات المطلقة (بتنسيق RFC 3339). وإلا، اعرض الأوقات النسبية حتى 60 يومًا، ثم بتنسيق YYYY-MM-DD.
--unicode <افتراضي: "auto">
استخدم بعض أحرف يونيكود لتحسين سهولة القراءة.
--all
اعرض جميع التحذيرات
--verbose
اعرض مزيدًا من المعلومات
watch
راقب تغييرًا قيد التقدم
ينتظر الأمر `watch` حتى ينتهي معرّف التغيير المحدد ويعرض التقدم (إذا كان متاحًا).
الاستخدام: snap [الخيارات] watch [خيارات-المراقبة]
--last
حدد آخر تغيير من نوع معين (تثبيت، تحديث، إزالة، محاولة، تحديث تلقائي، إلخ). تعني علامة الاستفهام في نهاية النوع عدم القيام بأي شيء (بدلاً من إرجاع خطأ) إذا لم يتم العثور على أي تغيير من النوع المحدد. لاحظ أنه قد يلزم حماية علامة الاستفهام من shell.
whoami
اعرض عنوان البريد الإلكتروني الذي تم تسجيل دخول المستخدم به
يعرض الأمر `whoami` عنوان البريد الإلكتروني الذي تم تسجيل دخول المستخدم به.
ملاحظات
وثائق عبر الإنترنت
https://docs.snapcraft.io
الأخطاء
يرجى الإبلاغ عن جميع الأخطاء عبر https://bugs.launchpad.net/snapd/+filebug