'\" t
.\"     Title: zypper
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-09-04
.\"    Manual: ZYPPER
.\"    Source: SUSE Linux
.\"  Language: Persian
.\"
.TH "ZYPPER" "8" "2026-09-04" "SUSE Linux" "ZYPPER"
.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)"
zypper \- رابط خط فرمان برای کتابخانه مدیریت سیستم ZYpp (libzypp)
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBzypper\fP [\fI\-\-global\-opts\fP] \fIcommand\fP [\fI\-\-command\-opts\fP] [\fIcommand\-arguments\fP]
.sp
\fBzypper\fP \fIsubcommand\fP [\fI\-\-command\-opts\fP] [\fIcommand\-arguments\fP]
.sp
\fBzypper\fP \fBhelp\fP \fIcommand\fP
.SH "توضیحات (DESCRIPTION)"
.sp
دستور zypper یک رابط خط فرمان برای کتابخانه مدیریت سیستم ZYpp (libzypp) است. از آن می‌توان برای نصب، به‌روزرسانی، حذف نرم‌افزار، مدیریت مخازن، انجام پرس‌وجوهای گوناگون و موارد دیگر استفاده کرد.
.SS "سیستم‌های تراکنشی (Transactional systems)"
.sp
در یک سیستم تراکنشی که فایل‌سیستم ریشه به صورت فقط‌خواندنی سوار (mount) شده است، دستورات \fBzypper\fP که سیستم را تغییر می‌دهند نمی‌توانند مستقیماً اجرا شوند.
.sp
اگر سیستم ابزار کمکی \fBtransactional\-wrapper\fP را ارائه دهد، \fBzypper\fP به طور خودکار تلاش می‌کند آن را فراخوانی کند. این لفاف (wrapper) دستور \fBzypper\fP را به صورت شفاف درون یک اسنپ‌شات جدید و با قابلیت نوشتن اجرا می‌کند و چرخه حیات آن اسنپ‌شات را بر اساس وضعیت خروج دستور مدیریت می‌نماید.
.sp
در سیستم‌های تراکنشی فاقد \fBtransactional\-wrapper\fP، کاربران باید ابزارهای تخصصی \- مانند \fBtransactional\-update\fP \- را به صورت دستی فراخوانی کنند تا نرم‌افزار را نصب، به‌روزرسانی یا حذف نمایند.
.SH "مفاهیم (CONCEPTS)"
.sp
بیشتر مفاهیم زیر برای تمامی برنامه‌های مبتنی بر کتابخانه مدیریت بسته libzypp مشترک هستند، اما برخی ویژگی‌های مختص zypper نیز وجود دارند.
.SS "بسته‌های سیستمی (System Packages)"
.sp
مجموعه بسته‌های نصب‌شده روی یک سیستم گاهی به عنوان مخزن \fB@System\fP یا \fBSystem Packages\fP شناخته می‌شود. بر خلاف مخازن موجود که بسته‌های قابل نصب را ارائه می‌دهند، \fB@System\fP بسته‌هایی را ارائه می‌دهد که فقط می‌توانند حذف شوند. بسته‌های نصب‌شده‌ای که توسط حداقل یکی از مخازن موجود ارائه نمی‌شوند (نه در نسخه‌ای متفاوت و نه به عنوان بسته‌ای تغییرنام‌یافته) اغلب به عنوان بسته‌های \fIناخواسته\fP (unwanted)، \fIیتیم\fP (orphaned) یا \fIرهاشده\fP (dropped) در نظر گرفته می‌شوند.
.sp
\fIنکته:\fP اگر بسته‌هایی را نصب می‌کنید که درون یک مخزن عرضه نمی‌شوند \- مانند بسته‌هایی که دستی ساخته یا دانلود شده‌اند \-، آن‌ها را درون یک دایرکتوری محلی جمع‌آوری کرده و این دایرکتوری را به عنوان یک \fIمخزن plaindir\fP به سیستم خود اضافه کنید. به این ترتیب بسته‌ها به عنوان یتیم تلقی نخواهند شد و در طول یک \fBdist\-upgrade\fP محافظت می‌شوند.
.sp
ایجاد چنین مخزن plaindir بسیار ساده است:
.br
$ \fBmkdir /LocalRepo\fP
.br
$ \fBzypper addrepo \-\-refresh /LocalRepo LocalRepo\fP
.br
.sp
اگر نیاز دارید اطمینان حاصل کنید که بسته مورد نظر برای نصب از LocalRepo برداشته می‌شود، کافی است از یک آرگومان به سبک \fIREPO:PACKAGE\fP استفاده کنید:
.br
$ \fBcp example.rpm /LocalRepo\fP
.br
$ \fBzypper install LocalRepo:example\fP
.br
.sp
بسته به نوع بسته‌هایی که در مخزن محلی نگه می‌دارید، ممکن است بخواهید شیوه انجام بررسی‌های امضای GPG را تنظیم کنید. برای جزئیات به بخش \fBبررسی‌های GPG\fP مراجعه کنید.
.SS "مخازن (Repositories)"
.sp
کتابخانه Libzypp با فراداده‌های مخزن کار می‌کند؛ این اطلاعات درباره بسته‌ها و روابط بین آن‌ها است که از بسته‌های RPM و داده‌های دیگر مانند اطلاعات وصله (patch)، تعاریف الگو (pattern) و غیره استخراج می‌شود. این داده‌ها همراه با فایل‌های RPM در پوشه‌هایی به نام \fIمخازن\fP (repositories) ذخیره می‌شوند. مخازن را می‌توان روی رسانه‌های مختلفی مانند سرور HTTP یا FTP، دیسک DVD، یا پوشه‌ای روی دیسک محلی قرار داد.
.sp
مجموعه خاصی از دستورات در zypper برای دستکاری مخازن در نظر گرفته شده است. همچنین بسیاری از دستورات و گزینه‌ها یک مخزن را به عنوان آرگومان می‌پذیرند. برای جزئیات بیشتر به بخش \fBدستورات (COMMANDS)\fP، زیربخش \fBمدیریت مخازن (Repository Management)\fP مراجعه کنید.
.SS "بررسی‌های GPG (GPG checks)"
.sp
\fBغیرفعال کردن بررسی‌های GPG توصیه نمی‌شود.\fP امضا کردن داده‌ها به گیرنده امکان می‌دهد تا تأیید کند پس از امضا شدن داده‌ها هیچ تغییری رخ نداده است. پذیرش داده‌های بدون امضا، دارای امضای نادرست یا ناشناخته می‌تواند منجر به خراب شدن سیستم و در موارد حاد حتی به خطر افتادن امنیت سیستم شود.
.sp
کتابخانه ZYpp اصالت فراداده‌های مخزن را با بررسی امضای GPG آن‌ها تأیید می‌کند. اگر فراداده‌های مخزن با یک کلید معتمد امضا شده باشند و با موفقیت تأیید شوند، بسته‌های این مخزن در صورتی که با چک‌سام ارائه شده در فراداده همخوانی داشته باشند، برای نصب پذیرفته می‌شوند. استفاده از مخازن بدون امضا نیازمند تأیید است.
.sp
اگر فراداده‌های مخزن امضا نشده باشند، امضای GPG هر بسته rpm دانلود شده پیش از پذیرش آن برای نصب بررسی می‌شود. بسته‌های حاصل از مخازن بدون امضا نیازمند یک امضای معتبر GPG هستند. استفاده از بسته‌های بدون امضا نیازمند تأیید است.
.sp
موارد فوق رفتار پیش‌فرضی است که توسط تنظیمات موجود در /etc/zypp/zypp.conf تعیین می‌شود.
.sp
دستورات \fBaddrepo\fP و \fBmodifyrepo\fP گزینه‌های بیشتری را برای تنظیم این رفتار به ازای هر مخزن فراهم می‌کنند. به عنوان مثال، می‌توان الزام تأیید نصب بسته‌های بدون امضا را برای یک مخزن خاص غیرفعال کرد. اما اگر چنین کنید، باید کاملاً مطمئن باشید که یک نفوذگر به سختی بتواند داده‌های بسته را درون مخزن یا در مسیر انتقال به دستگاه شما تغییر دهد. برای جزئیات گزینه‌های دستور به بخش \fBدستورات (COMMANDS)\fP مراجعه کنید.
.SS "شناسه‌های منابع (URI)"
.sp
برای تعیین مکان مخازن یا سایر منابع (فایل‌های RPM، فایل‌های repo.) می‌توانید از هر نوع URI پشتیبانی‌شده توسط libzypp استفاده کنید. علاوه بر این، Zypper یک URI ویژه را برای شناسایی مخازن سرویس ساخت openSUSE (OBS) در دستور \fBaddrepo\fP می‌پذیرد. این URIها به شکل \fBobs://\fP\fIproject\fP\fB/\fP[\fIplatform\fP] هستند.
.sp
برای مشاهده فهرست کامل و مثال‌هایی از \fBقالب‌های URI پشتیبانی‌شده\fP، به بخش \fBدستورات (COMMANDS)\fP، زیربخش \fBمدیریت مخازن (Repository Management)\fP مراجعه کنید.
.SS "تازه‌سازی (Refresh)"
.sp
تازه‌سازی یک مخزن به معنای دانلود فراداده‌های بسته‌ها از رسانه (در صورت نیاز)، ذخیره آن در کَش محلی (معمولاً در دایرکتوری \fB/var/cache/zypp/raw/\fP\fIalias\fP) و پیش‌تجزیه فراداده‌ها به فایل‌های \fI.solv\fP (ساخت کَش solv)، معمولاً در \fB/var/cache/zypp/solv/\fP\fIalias\fP است.
.sp
فراداده‌ها یا به صورت خودکار یا به درخواست کاربر تازه‌سازی می‌شوند. یک \fIتازه‌سازی خودکار\fP دقیقاً پیش از خواندن فراداده از پایگاه‌داده صورت می‌گیرد، در صورتی که \fBauto\-refresh برای مخزن فعال باشد\fP و فراداده به عنوان منسوخ گزارش شده باشد. اگر \fIauto\-refresh غیرفعال باشد\fP، مخزن تنها با درخواست کاربر تازه‌سازی خواهد شد. شما می‌توانید با فراخوانی \fBzypper refresh\fP درخواست تازه‌سازی دهید (برای جزئیات به مستندات دستور \fBrefresh\fP مراجعه کنید).
.sp
فراداده‌های مخزن پیش از انجام واقعی تازه‌سازی، از نظر وجود تغییرات بررسی می‌شوند. تغییر با دانلود یک یا دو فایل نمایه فراداده (فایل‌های کوچک) و مقایسه چک‌سام‌های فایل‌های کَش‌شده با فایل‌های راه دور شناسایی می‌شود. اگر فایل‌ها متفاوت باشند، مخزن منسوخ شده و تازه‌سازی خواهد شد.
.sp
برای به تعویق انداختن بررسی به‌روز بودن (و در نتیجه تازه‌سازی خودکار) به مدت چند دقیقه مشخص، مقدار مشخصه \fBrepo.refresh.delay\fP را در فایل پیکربندی ZYpp (\fB/etc/zypp/zypp.conf\fP) ویرایش کنید. این بدان معناست که zypper حتی تلاشی برای دانلود و بررسی فایل‌های نمایه نخواهد کرد، و شما قادر خواهید بود بدون دسترسی به اینترنت یا دسترسی‌های ریشه، از zypper برای عملیاتی مانند جستجو یا دریافت اطلاعات استفاده کنید.
.sp
نکته: دستور \fBzypper \-vv ref\fP سرورهای آینه‌ای مورد استفاده برای دانلود فراداده را نمایش می‌دهد.
.SS "سرویس‌ها (Services)"
.sp
سرویس‌ها یک سطح بالاتر از مخازن قرار دارند و برای مدیریت مخازن یا انجام کارهای ویژه به کار می‌روند. Libzypp در حال حاضر از \fIRepository Index Service\fP (RIS) و \fIPlugin Service\fP پشتیبانی می‌کند.
.sp
سرویس نمایه مخزن (RIS) نوع خاصی از مخزن است که شامل فهرستی از مخازن دیگر است. این فهرست می‌تواند به صورت پویا توسط سرور بر اساس برخی پارامترهای URI یا نام کاربر ایجاد شود، یا می‌تواند ایستا باشد. هنگامی که چنین سرویسی به سیستم شما افزوده شد، zypper وظیفه افزودن، اصلاح، یا حذف این مخازن را در سیستم شما برای بازتاب فهرست فعلی به عهده می‌گیرد. برای جزئیات بیشتر به بخش \fBمدیریت سرویس‌ها (Service Management)\fP و \c
.URL "https://en.opensuse.org/openSUSE:Standards_Repository_Index_Service" "" ""
مراجعه کنید.
.SS "انواع بسته‌ها (Package Types)"
.sp
ابزار Zypper با چندین نوع شیء منبع به نام \fIقابل‌حل‌ها\fP (resolvables) کار می‌کند. یک قابل‌حل می‌تواند یک \fBpackage\fP (بسته)، \fBpatch\fP (وصله)، \fBpattern\fP (الگو)، یا \fBproduct\fP (محصول) باشد؛ اساساً هر \fIنوع شیء\fP با وابستگی به اشیاء دیگر.
.sp
\fBpackage\fP
.RS 4
یک بسته معمولی RPM.
.RE
.sp
\fBpatch\fP
.RS 4
یک وصله منتشرشده با نسخه‌های آسیب‌دیده/آسیب‌پذیر مجموعه‌ای از بسته‌ها تعارض دارد. تا زمانی که هر یک از این نسخه‌های آسیب‌دیده/آسیب‌پذیر نصب باشند، تعارض فعال می‌شود و وصله به عنوان \fBneeded\fP (مورد نیاز)، یا در صورتی که قفل شده باشد به عنوان \fBunwanted\fP (ناخواسته) دسته‌بندی می‌گردد.
.sp
با انتخاب وصله، تعارض از طریق به‌روزرسانی تمام بسته‌های نصب‌شده و آسیب‌دیده/آسیب‌پذیر به نسخه‌ای که حاوی اصلاحیه است برطرف می‌شود. هنگام به‌روزرسانی بسته‌ها، zypper همیشه جدیدترین نسخه موجود را هدف قرار می‌دهد. وصله‌های حل‌شده بسته به اینکه آیا به بسته‌های واقعاً نصب‌شده اشاره دارند یا خیر، به صورت \fBapplied\fP (اعمال‌شده) یا \fBnot needed\fP (غیرضروری) دسته‌بندی می‌شوند.
.sp
بنابراین نصب، به‌روزرسانی یا حذف بسته‌ها ممکن است دسته‌بندی وصله‌های مربوط به این بسته‌ها را تغییر دهد. از نسخه libzypp\-17.23.0 به بعد، فایل /var/log/zypp/history به خاطر می‌سپارد که آیا یک تراکنش نهایی‌شده دسته‌بندی وصله‌ای را تغییر داده است یا خیر. اگر داده‌های تاریخچه در دسترس باشند، جدول‌های وصله ستونی را نشان می‌دهند که بیانگر زمانی است که وصله در وضعیت فعلی خود قرار گرفته است (\fIsince\fP).
.sp
بسته به نوع نقص، وصله‌ها بر اساس \fIدسته‌بندی\fP (category) و \fIشدت\fP (severity) طبقه‌بندی می‌شوند. مقادیر رایج برای \fIcategory\fP عبارتند از \fBsecurity\fP (امنیتی)، (\fBrecommended\fP (توصیه‌شده)، \fBbugfix\fP (رفع اشکال))، (\fBoptional\fP (اختیاری)، \fBfeature\fP (قابلیت)، \fBenhancement\fP (بهبود))، \fBdocument\fP (مستندات) یا \fByast\fP. مقادیر رایج برای \fIseverity\fP عبارتند از \fBcritical\fP (بحرانی)، \fBimportant\fP (مهم)، \fBmoderate\fP (متوسط)، \fBlow\fP (کم) یا \fBunspecified\fP (نامشخص). نام‌های داخل پرانتز به صورت مترادف استفاده می‌شوند.
.sp
توجه داشته باشید که دستور \fBpatch\fP به صورت پیش‌فرض \fIوصله‌های اختیاری را اعمال نمی‌کند\fP (دسته‌بندی \fBoptional\fP یا \fBfeature\fP). اگر واقعاً می‌خواهید تمام وصله‌های اختیاری به عنوان مورد نیاز در نظر گرفته شوند، دستور \fBpatch \-\-with\-optional\fP را اجرا کنید. وصله‌های خاص را می‌توان با استفاده از دستور \fBinstall\fP اعمال کرد (به عنوان مثال \fBzypper install patch:openSUSE\-2014\-7\fP).
.sp
اگر صادرکننده تصمیم به پس گرفتن یک وصله منتشرشده بگیرد، وضعیت وصله به صورت \fBretracted\fP (پس‌گرفته‌شده) نشان داده خواهد شد. بسته‌های ارائه‌شده توسط وصله پس‌گرفته‌شده هنوز قابل مشاهده هستند اما دارای برچسب پس‌گرفته‌شده (\fBR\fP) خواهند بود. حل‌کننده وابستگی از انتخاب خودکار بسته‌های پس‌گرفته‌شده خودداری می‌کند. اگر مطمئن هستید که یک بسته پس‌گرفته‌شده باید روی سیستم شما نصب شود، باید آن را به صراحت انتخاب کنید.
.RE
.sp
\fBpattern\fP
.RS 4
گروهی از بسته‌ها که برای نصب یک قابلیت، مورد نیاز یا توصیه‌شده هستند.
.RE
.sp
\fBproduct\fP
.RS 4
گروهی از بسته‌ها که برای نصب یک محصول ضروری هستند.
.RE
.sp
\fBsrcpackage\fP
.RS 4
بسته کد منبع (.src.rpm). این نوع در دستورات \fBsearch\fP و \fBinstall\fP کار می‌کند.
.RE
.sp
\fBapplication\fP
.RS 4
منسوخ: از نسخه libzypp\-17.7.0 این نوع دیگر در دسترس نیست.
.RE
.sp
در سرتاسر این راهنما ما اغلب از resolvables به سادگی با عنوان \fIبسته‌ها\fP (packages) و از انواع resolvable با عنوان \fIنوع بسته\fP یا \fIگونه\fP (kind) یاد خواهیم کرد. این نام‌های نوع را می‌توان به عنوان آرگومان‌های گزینه \fB\-\-type\fP در چندین دستور مانند \fBinstall\fP، \fBinfo\fP یا \fBsearch\fP به کار برد. دستورات همچنین باید اجازه دهند که اشیاء resolvable را به صورت \fIKIND\fP\fB:\fP\fINAME\fP تعیین کنید (مانند \fBpatch:openSUSE\-2014\-7\fP).
.SS "وابستگی‌های بسته (Package Dependencies)"
.sp
بسته‌های نرم‌افزاری به روش‌های مختلفی به یکدیگر وابسته هستند. بسته‌ها معمولاً به بسته‌های دیگر \fIنیاز دارند\fP (require) یا آن‌ها را \fIتوصیه می‌کنند\fP (recommend)، اما می‌توانند با آن‌ها \fIتعارض\fP (conflict) نیز داشته باشند. بسته‌ها ممکن است از سخت‌افزار یا تنظیمات زبانی خاصی پشتیبانی کنند. ابزار Zypper از یک \fIحل‌کننده وابستگی\fP (dependency solver) برای تشخیص اینکه چه بسته‌هایی باید برای برآورده کردن درخواست کاربر نصب شوند استفاده می‌کند.
.sp
اگر نسخه خاصی از یک بسته را درخواست نکنید، حل‌کننده یک نسخه مناسب را برمی‌گزیند. رویکرد کلی حل‌کننده هنگام پردازش یک وظیفه، تمرکز بر نصب بهترین نسخه از بسته درخواستی و افزودن یا به‌روزرسانی وابستگی‌ها بر اساس نیاز است. به غیر از این حالت \fIFocus on Job\fP (تمرکز بر وظیفه) که حالت پیش‌فرض است، دو حالت تمرکز دیگر نیز در دسترس هستند:
.sp
در حالت \fIFocus on Installed\fP (تمرکز بر موارد نصب‌شده)، حل‌کننده بر اعمال کمترین تغییرات ممکن روی بسته‌های نصب‌شده تمرکز می‌کند. انتخاب نسخه‌ای قدیمی‌تر از یک بسته درخواستی در صورتی که وابستگی‌های آن به تغییرات کمتری در سیستم نیاز داشته باشند معتبر است. حل‌کننده تلاش خواهد کرد تا از به‌روزرسانی بسته‌های از قبل نصب‌شده اجتناب کند.
.sp
در حالت \fIFocus on Update\fP (تمرکز بر به‌روزرسانی)، حل‌کننده بر به‌روزرسانی بسته درخواستی و تمام وابستگی‌های آن تا حد ممکن تمرکز می‌کند. توجه داشته باشید که نصب یک تک‌بسته در این حالت به راحتی می‌تواند منجر به یک به‌روزرسانی سراسری کوچک در سیستم شود.
.sp
برای یک دستور واحد، حالت تمرکز را می‌توان با استفاده از سوییچ \fB\-\-solver\-focus MODE\fP تنظیم کرد. حالت‌های معتبر عبارتند از \fBJob\fP، \fBInstalled\fP یا \fBUpdate\fP. اگر می‌خواهید حالت پیش‌فرض را برای سیستم خود تغییر دهید، مقدار [/etc/zypp/zypp.conf:solver.focus] را روی مقدار مورد نظر تنظیم کنید.
.SS "بسته‌های نصب‌شده خودکار (Automatically installed packages)"
.sp
بسته‌هایی که توسط حل‌کننده وابستگی به منظور رفع درخواست کاربر اضافه می‌شوند، به عنوان بسته‌های \fIبه‌طور خودکار نصب‌شده\fP به خاطر سپرده می‌شوند. این بسته‌ها ممکن است بعداً در صورتی که هیچ بسته نصب‌شده توسط کاربر به آن‌ها وابسته نباشد، حذف شوند (مثلاً با دستور \fBzypper remove \-\-clean\-deps\fP).
.sp
در ستون \fBS\fPtatus، دستور \fBsearch\fP بین بسته‌های نصب‌شده توسط کاربر (\fBi+\fP) و بسته‌های به‌طور خودکار نصب‌شده (\fBi\fP) تمایز قائل می‌شود.
.SS "تعارض‌های فایل بسته (Package File Conflicts)"
.sp
تعارض فایل زمانی رخ می‌دهد که دو بسته تلاش کنند فایل‌هایی با نام یکسان اما محتوای متفاوت نصب نمایند. این حالت ممکن است زمانی رخ دهد که در حال نصب نسخه جدیدتری از یک بسته بدون پاک کردن نسخه قدیمی‌تر باشید، یا زمانی که دو بسته نامرتبط هر کدام فایلی با نام یکسان نصب کنند.
.sp
از آنجا که بررسی تعارض فایل نیازمند دسترسی به فهرست کامل فایل‌های هر بسته در حال نصب است، zypper تنها در صورتی قادر به بررسی تعارض فایل خواهد بود که همه بسته‌ها از قبل دانلود شده باشند (به \fB\-\-download\-in\-advance\fP مراجعه کنید). اگر از \fB\-\-dry\-run\fP استفاده می‌کنید، هیچ بسته‌ای دانلود نمی‌شود، بنابراین بررسی تعارض فایل از بسته‌هایی که در کَش بسته‌ها موجود نیستند صرف‌نظر خواهد کرد. برای انجام یک بررسی معنادار تعارض فایل، از \fB\-\-dry\-run\fP به همراه \fB\-\-download\-only\fP استفاده کنید.
.sp
از آنجا که علت تعارض فایل معمولاً طراحی ضعیف بسته یا عدم هماهنگی بین سازندگان بسته‌ها است، حل آن‌ها ساده نیست. با استفاده از گزینه \fB\-\-replacefiles\fP می‌توانید zypper را وادار به جایگزینی فایل‌های دارای تعارض کنید. با این وجود، این کار ممکن است به بسته‌ای که فایل آن جایگزین می‌شود آسیب برساند.
.SH "دستورات (COMMANDS)"
.sp
ابزار zypper مجموعه‌ای از \fIدستورات\fP را فراهم می‌کند. هر دستور گزینه‌های فهرست‌شده در بخش \fBگزینه‌های سراسری (GLOBAL OPTIONS)\fP را می‌پذیرد. این گزینه‌ها باید \fIپیش از\fP نام دستور مشخص شوند. علاوه بر این، بسیاری از دستورات دارای گزینه‌های ویژه‌ای هستند که در این بخش فهرست شده‌اند. این گزینه‌های مختص دستور باید \fIپس از\fP نام دستور و \fIپیش از\fP هر یک از آرگومان‌های دستور مشخص شوند.
.sp
ابزار Zypper همچنین پشتیبانی محدودی از نوشتن افزونه‌ها/زیردستورها به هر زبانی ارائه می‌دهد. برای جزئیات به بخش \fBزیردستورها (SUBCOMMANDS)\fP مراجعه کنید.
.SS "دستورات عمومی (General Commands)"
.sp
\fBhelp\fP [\fIcommand\fP]
.RS 4
متن‌های راهنما را نمایش می‌دهد. اگر بدون هیچ آرگومانی اجرا شود (فقط \fBzypper\fP یا \fBzypper help\fP)، zypper متن راهنمای سراسری را نمایش می‌دهد که تمام گزینه‌های سراسری و دستورات موجود را فهرست می‌کند.
.sp
اگر با یک آرگومان نام \fIcommand\fP اجرا شود، در صورتی که چنین دستوری وجود داشته باشد، zypper راهنمای دستور مشخص‌شده را نمایش می‌دهد. هر دو نگارش بلند و کوتاه نام‌های دستورات قابل استفاده هستند.
.sp
برای راحتی شما، \fBzypper help\fP را می‌توان به هر یک از روش‌های زیر نیز فراخوانی کرد:
.sp

.RS 4
$ \fBzypper \-h\fP|\fB\-\-help\fP [\fIcommand\fP]
.RE
.sp

.RS 4
$ \fBzypper\fP [\fIcommand\fP] \fB\-h\fP|\fB\-\-help\fP
.RE
.RE
.sp
\fBshell\fP (\fBsh\fP)
.RS 4
یک پوسته برای وارد کردن چندین دستور در یک نشست باز می‌کند. خروج از پوسته با استفاده از \fBexit\fP، \fBquit\fP یا \fICtrl\-D\fP انجام می‌شود.
.sp
پشتیبانی از پوسته کامل نیست، بنابراین انتظار وجود اشکالاتی در آن داشته باشید. با این حال، به لطف سریع شدن چشمگیر libzypp با حل‌کننده SAT و ابزارهای آن (openSUSE 11.0)، نیاز مبرمی به استفاده از پوسته وجود ندارد، اما با این حال می‌توانید با آن آزمایش کنید.
.RE
.SS "دستورات مدیریت بسته (Package Management Commands)"
.sp
\fBinfo\fP (\fBif\fP) [\fIoptions\fP] \fIname\fP[\-\fIversion\fP[\-\fIrelease\fP]].\|.\|.
.RS 4
اطلاعات دقیق بسته‌های مشخص‌شده را نشان می‌دهد. به صورت پیش‌فرض، فقط بسته‌هایی نمایش داده می‌شوند که دقیقاً با نام‌های ارائه‌شده مطابقت داشته باشند. برای در نظر گرفتن بسته‌هایی که مطابقت جزئی دارند، از گزینه \fB\-\-match\-substrings\fP یا کاراکترهای عام (* یا ?) درون نام استفاده کنید.
.sp
اگر هیچ قید نسخه‌ای مشخص نشده باشد، اطلاعات مربوط به بهترین بسته موجود نمایش داده می‌شود. توجه داشته باشید که هر دو شماره نسخه و انتشار باید همیشه دقیقاً مطابقت داشته باشند.
.sp
اگر یک پرس‌وجو هیچ نتیجه‌ای در بر نداشته باشد، zypper مقدار \fBZYPPER_EXIT_INF_CAP_NOT_FOUND\fP را بازمی‌گرداند مگر اینکه گزینه سراسری \fB\-\-ignore\-unknown\fP تنظیم شده باشد.
.sp
\fB\-s\fP, \fB\-\-match\-substrings\fP
.RS 4
شامل کردن بسته‌هایی که مطابقت جزئی با نام‌های ارائه‌شده دارند.
.RE
.sp
\fB\-r\fP, \fB\-\-repo\fP \fIalias\fP|\fIname\fP|\fI#\fP|\fIURI\fP
.RS 4
تنها کار کردن با مخزن مشخص‌شده توسط نام مستعار، نام، شماره یا URI. این گزینه می‌تواند چندین بار استفاده شود.
.RE
.sp
\fB\-t\fP, \fB\-\-type\fP \fItype\fP
.RS 4
نوع بسته (پیش‌فرض: package). برای فهرست انواع بسته‌های موجود به بخش \fBانواع بسته‌ها (Package Types)\fP مراجعه کنید.
.RE
.sp
\fB\-\-provides\fP
.RS 4
نمادهایی را که بسته ارائه می‌دهد نمایش می‌دهد.
.RE
.sp
\fB\-\-requires\fP
.RS 4
نمادهایی را که بسته به آن‌ها نیاز دارد نمایش می‌دهد.
.RE
.sp
\fB\-\-conflicts\fP
.RS 4
نمادهایی را که بسته با آن‌ها تعارض دارد نمایش می‌دهد.
.RE
.sp
\fB\-\-obsoletes\fP
.RS 4
نمادهایی را که بسته منسوخ می‌کند نمایش می‌دهد.
.RE
.sp
\fB\-\-recommends\fP
.RS 4
نمادهایی را که بسته توصیه می‌کند نمایش می‌دهد.
.RE
.sp
\fB\-\-suggests\fP
.RS 4
نمادهایی را که بسته پیشنهاد می‌کند نمایش می‌دهد.
.RE
.sp
\fB\-\-supplements\fP
.RS 4
نمادهایی را که بسته تکمیل می‌کند نمایش می‌دهد.
.RE
.sp
\fB\-\-enhances\fP
.RS 4
نمادهایی را که بسته بهبود می‌بخشد نمایش می‌دهد.
.RE
.sp
مثال‌ها:
.RS 4

.sp
$ \fBzypper info workrave\fP
.RS 4
نمایش اطلاعات درباره \fIبسته workrave\fP
.RE
.sp
$ \fBzypper info \-t patch libzypp\fP
.RS 4
نمایش اطلاعات درباره \fIوصله libzypp\fP
.RE
.sp
$ \fBzypper info \-t pattern lamp_server\fP
.RS 4
نمایش اطلاعات درباره \fIالگوی lamp_server\fP
.RE
.RE
.RE
.sp
\fBinstall\fP (\fBin\fP) [\fIoptions\fP] \fIname\fP|\fIcapability\fP|\fIrpm_file_uri\fP.\|.\|.
.RS 4
نصب یا به‌روزرسانی بسته‌ها.
.sp
بسته‌ها را می‌توان بر اساس \fIname\fP (نام) آن‌ها یا بر اساس یک \fIcapability\fP (قابلیت) که ارائه می‌دهند انتخاب کرد.
.sp
یک \fIقابلیت\fP به صورت "\fINAME\fP[\fB.\fP\fIARCH\fP][ \fIOP EDITION\fP]" تشکیل می‌شود، که در آن \fIARCH\fP کد معماری است، \fIOP\fP یکی از \fB<\fP، \fB<=\fP، \fB=\fP، \fB>=\fP یا \fB>\fP است و \fIEDITION\fP به صورت "\fIVERSION\fP[\fB\-\fP\fIRELEASE\fP]" می‌باشد. برای مثال: \fBzypper=0.8.8\-2\fP.
.RS 4
.sp
جزء \fINAME\fP در یک قابلیت نه تنها نام یک بسته، بلکه هر نماد ارائه‌شده توسط بسته‌ها است: \fB/bin/vi\fP، \fBlibcurl.so.3\fP، \fBperl(Time::ParseDate)\fP. فقط به یاد داشته باشید که برای محافظت از نویسه‌های خاص در برابر پوسته از نقل‌قول استفاده کنید، برای مثال: \fBzypper\(rs>0.8.10\fP یا \fB\*(Aqzypper>0.8.10\*(Aq\fP.
.sp
اگر \fIEDITION\fP مشخص نشده باشد، جدیدترین نسخه قابل نصب، نصب خواهد شد. این بدان معناست که اگر بسته از قبل نصب شده باشد و نسخه‌های جدیدتری در دسترس باشند، به جدیدترین نسخه قابل نصب ارتقا می‌یابد.
.sp
اگر \fIARCH\fP مشخص نشده باشد، یا آخرین نقطه در رشته نام قابلیت با یک معماری شناخته‌شده دنبال نشود، حل‌کننده با کل رشته به عنوان یک نام قابلیت رفتار خواهد کرد. اگر ARCH شناخته‌شده باشد، حل‌کننده بسته‌ای مطابق با آن معماری را انتخاب می‌کند و در صورت نیافتن چنین بسته‌ای خطا می‌دهد.
.sp
اگر می‌خواهید اطمینان حاصل کنید که بسته‌ای از یک \fIREPOSITORY\fP خاص انتخاب می‌شود، از \fIREPOSITORY:PACKAGENAME\fP به عنوان آرگومان استفاده کنید.
.RE
.sp
ابزار Zypper همچنین قادر به نصب \fIفایل‌های ساده RPM\fP است در حالی که تلاش می‌کند وابستگی‌های آن‌ها را با استفاده از بسته‌های مخازن تعریف‌شده برطرف کند. می‌توانید یک فایل ساده RPM را با مشخص کردن مکان آن در آرگومان‌های دستور install به صورت یک مسیر محلی یا یک URI نصب کنید. به عنوان مثال:
.RS 4
.sp
$ \fBzypper install ~/rpms/foo.rpm http://some.site/bar.rpm\fP
.sp
ابزار Zypper بسته‌هایی را که نتواند پیدا کند گزارش خواهد داد. علاوه بر این، در حالت تعاملی، zypper به نصب بقیه بسته‌های درخواستی ادامه می‌دهد، و در حالت غیرتعاملی فوراً متوقف می‌شود. در هر دو حالت، zypper پس از اتمام عملیات مقدار \fBZYPPER_EXIT_INF_CAP_NOT_FOUND\fP را بازمی‌گرداند.
.sp
ابزار Zypper فایل‌ها را در یک مخزن موقت \fBplaindir\fP جمع‌آوری کرده و بسته‌های مربوطه را برای نصب علامت‌گذاری می‌کند. اگر از \fB\-\-download\-only\fP استفاده شود، بسته‌های دانلودشده تا زمانی که واقعاً آن‌ها را نصب کنید یا دستور \fBzypper clean\fP را برای پاکسازی کَش‌های بسته اجرا نمایید، در \fB/var/cache/zypper/RPMS\fP در دسترس خواهند بود. آن‌ها بخشی از کَش سراسری بسته در \fB/var/cache/zypp/packages\fP نخواهند شد (همچنین به گزینه سراسری \fB\-\-pkg\-cache\-dir\fP مراجعه کنید).
.RE
.sp
در دستور install، می‌توانید بسته‌هایی را که می‌خواهید حذف شوند نیز با افزودن نویسه \fI\-\fP یا \fI!\fP به ابتدای نام آن‌ها مشخص کنید. برای مثال:
.RS 4
.sp
$ \fBzypper install \(rs!Firefox\fP\~
.sp
بر خلاف \fBzypper remove Firefox\fP که فایرفاکس و بسته‌های وابسته به آن را حذف می‌کند، دستور install تلاش می‌کند با جستجوی جایگزین‌های فایرفاکس، بسته‌های وابسته را نصب‌شده نگه دارد.
.sp
توجه داشته باشید که اگر تصمیم گرفتید از \fB\-\fP با اولین بسته‌ای که مشخص می‌کنید استفاده کنید، باید \fB\-\-\fP را قبل از آن بنویسید تا از تفسیر آن به عنوان یک گزینه دستور جلوگیری شود:
.sp
$ \fBzypper install \-\-\~ \-boring\-game great\-game great\-game\-manual\fP\~
.RE
.sp
\-r, \-\-repo alias|name|#|URI
.RS 4
تنها کار کردن با مخزن مشخص‌شده توسط نام مستعار، نام، شماره یا URI. این گزینه می‌تواند چندین بار استفاده شود.
.sp
استفاده از \-\-repo \fIتوصیه نمی‌شود\fP زیرا در حال حاضر مخازن ذکرنشده را از حل‌کننده پنهان می‌کند و منجر به تصمیم‌گیری‌های غیربهینه می‌شود. در آینده \-\-repo به یک نام مستعار برای \fB\-\-from\fP تبدیل خواهد شد.
.sp
اگر می‌خواهید بسته‌ای را از یک مخزن خاص نصب کنید، از \fIREPOSITORY:PACKAGENAME\fP به عنوان آرگومان استفاده کنید.
.RE
.sp
\fB\-t\fP, \fB\-\-type\fP \fItype\fP
.RS 4
نوع بسته برای نصب (پیش‌فرض: package). برای فهرست انواع بسته‌های موجود به بخش \fBانواع بسته‌ها (Package Types)\fP مراجعه کنید. از \fBzypper se \-t\fP \fItype\fP [\fIname\fP] برای جستجوی موارد موجود از این نوع و از \fBzypper info \-t\fP \fItype name\fP برای نمایش اطلاعات دقیق‌تر درباره مورد استفاده کنید.
.sp
اگر \fIpatch\fP مشخص شود، zypper بسته‌ها را برای برآورده کردن وصله مشخص‌شده نصب و/یا حذف خواهد کرد. این روشی برای اطمینان از نصب یک رفع اشکال خاص است. برای یافتن وصله‌های قابل اعمال از \fBzypper list\-patches\fP استفاده کنید.
.sp
اگر \fIproduct\fP یا \fIpattern\fP مشخص شود، zypper اطمینان حاصل می‌کند که تمام بسته‌های مورد نیاز (و در صورت تمایل توصیه‌شده) نصب شوند.
.RE
.sp
\fB\-n\fP, \fB\-\-name\fP
.RS 4
انتخاب بسته‌ها بر اساس نام آن‌ها؛ تلاشی برای انتخاب بر اساس قابلیت‌ها صورت نمی‌گیرد.
.RE
.sp
\fB\-f\fP, \fB\-\-force\fP
.RS 4
نصب حتی در صورتی که مورد از قبل نصب شده باشد (نصب مجدد)، تنزل یافته باشد یا توزیع‌کننده یا معماری آن تغییر کند.
.RE
.sp
\fB\-\-oldpackage\fP
.RS 4
اجازه می‌دهد یک مورد جدیدتر با یک مورد قدیمی‌تر جایگزین شود. هنگام بازگردانی سیستم (rollback) کاربردی است. بر خلاف \-\-force، اگر مورد قبلاً با همان نسخه درخواستی نصب شده باشد، نصب مجدد را تحمیل نمی‌کند.
.RE
.sp
\fB\-\-from\fP \fIalias\fP|\fIname\fP|\fI#\fP|\fIURI\fP
.RS 4
انتخاب بسته‌ها از مخزن مشخص‌شده. اگر رشته‌های مشخص‌شده به عنوان آرگومان‌های دستور install با بسته‌های موجود در مخازن تعیین‌شده در این گزینه مطابقت داشته باشند، برای نصب علامت‌گذاری می‌شوند. این گزینه در حال حاضر شامل \fB\-\-name\fP می‌شود، اما امکان استفاده از کاراکترهای عام (wildcards) را برای تعیین بسته‌ها فراهم می‌کند.
.RE
.sp
\fB\-C\fP, \fB\-\-capability\fP
.RS 4
انتخاب بسته‌ها بر اساس قابلیت‌ها.
.RE
.sp
\fB\-l\fP, \fB\-\-auto\-agree\-with\-licenses\fP
.RS 4
پاسخ مثبت (\fIyes\fP) خودکار به اعلان تأیید مجوز نرم‌افزارهای شخص ثالث. با استفاده از این گزینه، موافقت خود را با مجوزهای تمام نرم‌افزارهای شخص ثالثی که این دستور نصب خواهد کرد اعلام می‌کنید. این گزینه به ویژه برای مدیرانی مفید است که مجموعه یکسانی از بسته‌ها را روی چندین دستگاه (از طریق یک فرآیند خودکار) نصب می‌کنند و مجوزها را از قبل تأیید کرده‌اند.
.RE
.sp
\fB\-\-auto\-agree\-with\-product\-licenses\fP
.RS 4
پذیرش خودکار فقط برای مجوزهای محصول. این گزینه توسط ابزارهایی مانند SUSEconnect استفاده می‌شود که پیش از ثبت محصول درخواست تأیید می‌کنند؛ بنابراین نیازی به تأیید مجدد مجوز محصول در هنگام نصب نیست.
.RE
.sp
\fB\-\-replacefiles\fP
.RS 4
نصب بسته‌ها حتی در صورتی که فایل‌هایی از سایر بسته‌های از قبل نصب‌شده را جایگزین کنند. رفتار پیش‌فرض این است که تعارض فایل به عنوان یک خطا در نظر گرفته شود. گزینه \fB\-\-download\-as\-needed\fP بررسی تعارض فایل را غیرفعال می‌کند زیرا برای انجام بررسی، دسترسی پیشاپیش به فهرست فایل‌های تمام بسته‌ها مورد نیاز است.
.RE
.sp
\fB\-D\fP, \fB\-\-dry\-run\fP
.RS 4
آزمایش نصب بدون نصب واقعی هیچ بسته‌ای. اگر همراه با \fB\-\-download\-only\fP استفاده شود، می‌توان بررسی معناداری از تعارض‌های فایل انجام داد (به بخش \fBتعارض‌های فایل بسته (Package File Conflicts)\fP مراجعه کنید).
.RE
.sp
\fB\-\-details\fP
.RS 4
نمایش خلاصه دقیق نصب.
.RE
.sp
\-y, \-\-no\-confirm
.RS 4
عدم نیاز به تعامل با کاربر. توصیه می‌شود به جای آن از گزینه سراسری \fB\-\-non\-interactive\fP استفاده کنید. گزینه‌های سراسری پیش از دستور وارد می‌شوند (\fBzypper \-\-non\-interactive\fP \fICOMMAND .\|.\|.\fP). بر خلاف گزینه دستور no\-confirm، گزینه سراسری را می‌توان همراه با هر دستور zypper استفاده کرد.
.RE
.sp
\fB\-\-allow\-unsigned\-rpm\fP
.RS 4
نصب بی سر و صدای بسته‌های rpm. بدون امضا که به عنوان پارامترهای خط فرمان داده شده‌اند. این گزینه بر بسته‌های بدون امضای ارائه‌شده توسط مخازن تأثیری ندارد. برای اجازه دادن به یک مخزن جهت ارائه بسته‌های بدون امضا بدون تأیید صریح، گزینه \fB\-\-gpgcheck\-allow\-unsigned\-package\fP مخزن را تنظیم کنید. برای جزئیات به دستورات \fBaddrepo\fP و \fBmodifyrepo\fP مراجعه کنید.
.RE
.sp
گزینه‌های مربوط به حل‌کننده (Solver):
.RS 4

.RE
.sp
\fB\-\-debug\-solver\fP
.RS 4
ایجاد مورد آزمون حل‌کننده برای اشکال‌زدایی. اگر احساس می‌کنید وابستگی‌ها به درستی حل نشده‌اند از این گزینه استفاده کنید. هنگام استفاده از این گزینه هیچ بسته‌ای نصب یا حذف نخواهد شد. در عوض یک مورد آزمون حل‌کننده در /var/log/zypper.solverTestCase نوشته می‌شود. می‌توانید آن دایرکتوری را فشرده کرده و به گزارش اشکال خود پیوست کنید.
.RE
.sp
\fB\-\-force\-resolution\fP
.RS 4
اجبار حل‌کننده به یافتن یک راه‌حل (\fIحتی یک راه‌حل تهاجمی\fP) به جای پرسش از کاربر.
.sp
به منظور انجام وظیفه درخواستی، حل‌کننده مجاز است هر خط‌مشی فعالی را نقض کند. این شامل مجوز حذف بسته‌ها و همچنین نادیده گرفتن خط‌مشی‌های صراحتاً تنظیم‌شده (توسط \fB\-\-no\-allow\fP\-\fIpolicy\fP یا در فایل‌های کانفیگ) می‌باشد. \fBاستفاده از این گزینه در محیط‌های بدون نظارت توصیه نمی‌شود\fP.
.sp
مجوز حذف بسته‌های وابسته، هنگام حذف بسته‌ها (\fBzypper remove\fP) رفتار پیش‌فرض است.
.RE
.sp
\fB\-R\fP, \fB\-\-no\-force\-resolution\fP
.RS 4
عدم اجبار حل‌کننده به یافتن راه‌حل. در عوض، مشکلات وابستگی را گزارش کرده و از کاربر می‌خواهد آن‌ها را به صورت دستی حل کند. این رفتار پیش‌فرض است مگر هنگام حذف بسته‌ها (\fBzypper remove\fP).
.RE
.sp
\fB\-\-solver\-focus\fP \fIMODE\fP
.RS 4
تنظیم رویکرد کلی حل‌کننده هنگام حل یک وظیفه. حالت‌های معتبر عبارتند از \fBJob\fP، \fBInstalled\fP یا \fBUpdate\fP. برای جزئیات به بخش \fBوابستگی‌های بسته (Package Dependencies)\fP مراجعه کنید.
.RE
.sp
\fB\-\-recommends\fP
.RS 4
نصب بسته‌های توصیه‌شده علاوه بر بسته‌های مورد نیاز. رفتار پیش‌فرض توسط [zypp.conf:solver.onlyRequires] تعیین می‌شود.
.RE
.sp
\fB\-\-no\-recommends\fP
.RS 4
عدم نصب بسته‌های توصیه‌شده و تنها نصب بسته‌های مورد نیاز. رفتار پیش‌فرض توسط [zypp.conf:solver.onlyRequires] تعیین می‌شود.
.RE
.sp
گزینه‌های حالت دانلود و نصب:
.RS 4

.RE
.sp
\fB\-d\fP, \fB\-\-download\-only\fP
.RS 4
تنها دانلود بسته‌ها برای نصب در آینده (همچنین به گزینه سراسری \fB\-\-pkg\-cache\-dir\fP مراجعه کنید).
.sp
اگر همراه با \fB\-\-dry\-run\fP استفاده شود، می‌توان بررسی معناداری از تعارض‌های فایل انجام داد (به بخش \fBتعارض‌های فایل بسته (Package File Conflicts)\fP مراجعه کنید).
.RE
.sp
\fB\-\-download\-in\-advance\fP
.RS 4
ابتدا دانلود تمام بسته‌ها و سپس آغاز نصب. این رفتار پیش‌فرض است.
.RE
.sp
\fB\-\-download\-in\-heaps\fP
.RS 4
حداقل مجموعه‌ای از بسته‌ها را که می‌توان بدون بر جای گذاشتن سیستم در وضعیت خراب نصب کرد دانلود کرده و نصب می‌کند. سپس دسته دیگری را دانلود و نصب می‌کند تا زمانی که همه نصب شوند. این کار به حفظ یکپارچگی سیستم بدون نیاز به دانلود پیشاپیش \fIهمه\fP بسته‌ها کمک می‌کند، که مزایای \fB\-\-download\-in\-advance\fP و \fB\-\-download\-as\-needed\fP را با هم ترکیب می‌کند.
.if n .sp
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
.B نکته
.ps -1
.br
.sp
تا زمانی که حل‌کننده قادر به ساخت دسته‌ها نباشد، این گزینه رفتاری مشابه با \fB\-\-download\-in\-advance\fP خواهد داشت.
.sp .5v
.RE
.RE
.sp
\fB\-\-download\-as\-needed\fP
.RS 4
دانلود یک بسته، نصب بلافاصله آن، و ادامه با بقیه بسته‌ها تا زمانی که همه نصب شوند.
.RE
.sp
\fB\-\-download\fP \fImode\fP
.RS 4
استفاده از حالت مشخص‌شده برای دانلود و نصب. حالت‌های موجود عبارتند از:
\fBonly\fP، \fBin\-advance\fP، \fBin\-heaps\fP، \fBas\-needed\fP.
برای توضیحات آن‌ها به گزینه‌های متناظر \fB\-\-download\-\fP\fImode\fP مراجعه کنید.
.RE
.sp
گزینه‌های پیشرفته (Expert Options):
.RS 4
از آن‌ها استفاده نکنید مگر اینکه بدانید به آن‌ها نیاز دارید.
.RE
.sp
\fB\-\-allow\-downgrade\fP, \fB\-\-no\-allow\-downgrade\fP
.RS 4
تعیین اینکه آیا تنزل نسخه موارد قابل‌حل نصب‌شده مجاز است یا خیر.
.RE
.sp
\fB\-\-allow\-name\-change\fP, \fB\-\-no\-allow\-name\-change\fP
.RS 4
تعیین اینکه آیا تغییر نام موارد قابل‌حل نصب‌شده مجاز است یا خیر. تنظیم این گزینه روی \fBno\fP بسته‌هایی را که تغییر نام یافته‌اند جایگزین نخواهد کرد.
.RE
.sp
\fB\-\-allow\-arch\-change\fP, \fB\-\-no\-allow\-arch\-change\fP
.RS 4
تعیین اینکه آیا تغییر معماری موارد قابل‌حل نصب‌شده مجاز است یا خیر.
.RE
.sp
\fB\-\-allow\-vendor\-change\fP, \fB\-\-no\-allow\-vendor\-change\fP
.RS 4
تعیین اینکه آیا تغییر توزیع‌کننده (تولیدکننده) موارد قابل‌حل نصب‌شده مجاز است یا خیر. تنظیم این گزینه روی \fBno\fP ممکن است زمانی مفید باشد که نمی‌خواهید بسته‌های مخازن خارجی به نسخه توزیع تغییر یابند (یا برعکس).
.RE
.sp
مثال‌ها:
.RS 4

.sp
$ \fBzypper install \-t pattern lamp_server\fP
.RS 4
نصب الگوی lamp_server.
.RE
.sp
$ \fBzypper install \-\-no\-recommends gv\fP
.RS 4
نصب نمایشگر GhostScript، اما بدون در نظر گرفتن بسته‌های توصیه‌شده.
.RE
.sp
$ \fBzypper install virtualbox\-ose\-2.0.6\fP
.RS 4

.RE
.sp
$ \fBzypper install virtualbox\-ose=2.0.6\fP
.RS 4

.RE
.sp
$ \fBzypper install virtualbox\-ose = 2.0.6\fP
.RS 4
نصب نسخه 2.0.6 از بسته virtualbox\-ose.
.RE
.RE
.RE
.sp
\fBsource\-install\fP (\fBsi\fP) \fIname\fP.\|.\|.
.RS 4
بسته‌های منبع مشخص‌شده و وابستگی‌های ساخت آن‌ها را نصب می‌کند. اگر نام یک بسته دودویی (باینری) داده شود، بسته منبع متناظر جستجو شده و به‌جای آن نصب می‌شود.
.sp
این دستور تلاش خواهد کرد تا جدیدترین نسخه‌های موجود بسته‌های منبع را پیدا کرده و از \fBrpm \-i\fP برای نصب آن‌ها استفاده کند، به صورت اختیاری همراه با تمامی بسته‌هایی که برای ساخت بسته منبع مورد نیاز است. مکان پیش‌فرضی که rpm بسته‌های منبع را در آن نصب می‌کند \fI/usr/src/packages/{SPECS,SOURCES}\fP است، اما این مقادیر را می‌توان در پیکربندی محلی rpm تغییر داد. در صورت تردید، اجرای \fBrpm \-\-eval "%{_specdir} and %{_sourcedir}"\fP را امتحان کنید.
.sp
توجه داشته باشید که بسته‌های منبع باید در مخازنی که استفاده می‌کنید موجود باشند. با استفاده از دستور زیر می‌توانید بررسی کنید که آیا یک مخزن حاوی بسته منبع است یا خیر:
.sp

.RS 4
$ \fBzypper search \-t srcpackage \-r\fP \fIalias\fP|\fIname\fP|\fI#\fP|\fIURI\fP
.RE
.sp

.RS 4
$ \fBzypper search \-t srcpackage \-r\fP \fIalias\fP|\fIname\fP|\fI#\fP|\fIURI\fP
.RE
.sp
\fB\-d\fP, \fB\-\-build\-deps\-only\fP
.RS 4
تنها وابستگی‌های ساخت بسته‌های مشخص‌شده را نصب می‌کند.
.RE
.sp
\fB\-D\fP, \fB\-\-no\-build\-deps\fP
.RS 4
وابستگی‌های ساخت را نصب نمی‌کند.
.RE
.sp
\fB\-r\fP, \fB\-\-repo\fP \fIalias\fP|\fIname\fP|\fI#\fP|\fIURI\fP
.RS 4
تنها با مخزن مشخص‌شده توسط نام مستعار (alias)، نام، شماره یا URI کار می‌کند. از این گزینه می‌توان چندین بار استفاده کرد.
.RE
.sp
\fB\-\-download\-only\fP
.RS 4
تنها بسته‌ها را بارگیری کرده و آن‌ها را نصب نمی‌کند.
.RE
.sp
مثال‌ها:
.RS 4

.sp
$ \fBzypper si \-d dbus\-1\fP
.RS 4
نصب وابستگی‌های ساخت بسته منبع dbus\-1.
.RE
.RE
.RE
.sp
\fBverify\fP (\fBve\fP) [\fIoptions\fP]
.RS 4
بررسی می‌کند که آیا وابستگی‌های بسته‌های نصب‌شده برآورده شده‌اند یا خیر.
.sp
در صورتی که هرگونه مشکل وابستگی پیدا شود، zypper بسته‌هایی را برای نصب یا حذف جهت رفع آن‌ها پیشنهاد می‌دهد.
.sp
\fB\-D\fP, \fB\-\-dry\-run\fP
.RS 4
تعمیر را آزمایش می‌کند، بدون اینکه عملاً تغییری در سیستم ایجاد کند. اگر همراه با \fB\-\-download\-only\fP استفاده شود، می‌توان بررسی معناداری برای تداخل فایل‌ها انجام داد (بخش \fBPackage File Conflicts\fP را ببینید).
.RE
.sp
\fB\-\-details\fP
.RS 4
نمایش خلاصه باجزئیات فرایند نصب.
.RE
.sp
\fB\-r\fP, \fB\-\-repo\fP \fIalias\fP|\fIname\fP|\fI#\fP|\fIURI\fP
.RS 4
تنها با مخزن مشخص‌شده توسط نام مستعار (alias)، نام، شماره یا URI کار می‌کند. از این گزینه می‌توان چندین بار استفاده کرد.
.RE
.sp
\-y, \-\-no\-confirm
.RS 4
نیازی به تعامل با کاربر ندارد. توصیه می‌شود به جای آن از گزینه سراسری \fB\-\-non\-interactive\fP استفاده کنید. گزینه‌های سراسری پیش از دستور ارسال می‌شوند (\fBzypper \-\-non\-interactive\fP \fICOMMAND .\|.\|.\fP). بر خلاف گزینه دستوری no\-confirm، گزینه سراسری را می‌توان همراه با هر دستور zypper استفاده کرد.
.RE
.sp
گزینه‌های مربوط به حل‌کننده (Solver):
.RS 4

.RE
.sp
\fB\-\-debug\-solver\fP
.RS 4
ایجاد یک مورد آزمایشی (test case) حل‌کننده برای اشکال‌زدایی. اگر فکر می‌کنید وابستگی‌ها به درستی حل نشده‌اند، از این گزینه استفاده کنید. هنگام استفاده از این گزینه هیچ بسته‌ای نصب یا حذف نخواهد شد. در عوض، یک مورد آزمایشی حل‌کننده در مسیر /var/log/zypper.solverTestCase نوشته می‌شود. می‌توانید این پوشه را فشرده کرده و به گزارش باگ خود پیوست کنید.
.RE
.sp
\fB\-\-force\-resolution\fP
.RS 4
حل‌کننده را مجبور می‌کند تا به‌جای پرسیدن از کاربر، راه‌حلی (\fIحتی تهاجمی\fP) پیدا کند.
.sp
به منظور انجام وظیفه درخواستی، حل‌کننده مجاز است هر خط‌مشی فعال در غیر این صورت را نقض کند. این شامل مجوز حذف بسته‌ها و همچنین عدم رعایت حتی خط‌مشی‌های صراحتاً تعیین‌شده (توسط \fB\-\-no\-allow\fP\-\fIpolicy\fP یا در فایل‌های پیکربندی) است. \fBاستفاده از این گزینه در محیط‌های بدون نظارت توصیه نمی‌شود\fP.
.sp
مجوز حذف بسته‌های وابسته هنگام حذف بسته‌ها (zypper remove) حالت پیش‌فرض است.
.RE
.sp
\fB\-R\fP, \fB\-\-no\-force\-resolution\fP
.RS 4
حل‌کننده را برای یافتن راه‌حل مجبور نمی‌کند. در عوض، مشکلات وابستگی را گزارش کرده و از کاربر می‌خواهد آن‌ها را به صورت دستی حل کند. این حالت پیش‌فرض است، مگر در هنگام حذف بسته‌ها (\fBzypper remove\fP).
.RE
.sp
\fB\-\-solver\-focus\fP \fIMODE\fP
.RS 4
رویکرد کلی حل‌کننده را هنگام حل یک وظیفه تنظیم می‌کند. حالت‌های معتبر عبارتند از \fBJob\fP، \fBInstalled\fP یا \fBUpdate\fP. برای جزئیات بخش \fBPackage Dependencies\fP را ببینید.
.RE
.sp
\fB\-\-recommends\fP
.RS 4
علاوه بر بسته‌های الزامی، بسته‌های توصیه‌شده را نیز نصب می‌کند. رفتار پیش‌فرض توسط [zypp.conf:solver.onlyRequires] تعیین می‌شود.
.RE
.sp
\fB\-\-no\-recommends\fP
.RS 4
بسته‌های توصیه‌شده را نصب نمی‌کند، بلکه تنها بسته‌های الزامی را نصب می‌کند. رفتار پیش‌فرض توسط [zypp.conf:solver.onlyRequires] تعیین می‌شود.
.RE
.sp
گزینه‌های پیشرفته:
.RS 4
از آن‌ها استفاده نکنید مگر اینکه بدانید واقعاً به آن‌ها نیاز دارید.
.RE
.sp
\fB\-\-allow\-downgrade\fP, \fB\-\-no\-allow\-downgrade\fP
.RS 4
تعیین مجاز بودن تنزل نسخه (downgrade) موارد قابل‌حل نصب‌شده.
.RE
.sp
\fB\-\-allow\-name\-change\fP, \fB\-\-no\-allow\-name\-change\fP
.RS 4
تعیین مجاز بودن تغییر نام موارد قابل‌حل نصب‌شده. تنظیم این گزینه روی \fBno\fP بسته‌هایی را که تغییر نام داده‌اند جایگزین نخواهد کرد.
.RE
.sp
\fB\-\-allow\-arch\-change\fP, \fB\-\-no\-allow\-arch\-change\fP
.RS 4
تعیین مجاز بودن تغییر معماری موارد قابل‌حل نصب‌شده.
.RE
.sp
\fB\-\-allow\-vendor\-change\fP, \fB\-\-no\-allow\-vendor\-change\fP
.RS 4
تعیین مجاز بودن تغییر توزیع‌کننده (vendor) موارد قابل‌حل نصب‌شده. تنظیم این گزینه روی \fBno\fP زمانی مفید است که نمی‌خواهید بسته‌های مخازن خارجی به نسخه توزیع تغییر یابند (یا بالعکس).
.RE
.sp
این دستور همچنین \fBگزینه‌های حالت بارگیری و نصب\fP شرح‌داده‌شده در دستور \fBinstall\fP را می‌پذیرد.
.RS 4

.RE
.RE
.sp
\fBinstall\-new\-recommends\fP (\fBinr\fP) [\fIoptions\fP]
.RS 4
بسته‌های تازه اضافه‌شده را که توسط بسته‌های از قبل نصب‌شده توصیه شده‌اند، نصب می‌کند. این دستور اساساً توصیه‌های تمامی بسته‌های نصب‌شده را مجدداً ارزیابی کرده و سیستم را بر این اساس تکمیل می‌کند. \fIشما نمی‌خواهید این دستور را بدون قید و شرط\fP روی سیستم‌های کوچک یا کمینه اجرا کنید، زیرا ممکن است به سادگی تعداد زیادی بسته اضافه کند.
.sp
در صورت فراخوانی به صورت \fBzypper inr \-\-no\-recommends\fP، دستور محدود می‌شود تا فقط به دنبال بسته‌هایی باشد که از سخت‌افزارها، زبان‌ها یا سیستم‌های فایل موجود پشتیبانی می‌کنند. این امر پس از افزودن مثلاً سخت‌افزار جدید یا مخازن درایور مفید است. همچنین اگر [zypp.conf:solver.onlyRequires] را تنظیم کرده باشید، این رفتار پیش‌فرض خواهد بود.
.sp
\fB\-r\fP, \fB\-\-repo\fP \fIalias\fP|\fIname\fP|\fI#\fP|\fIURI\fP
.RS 4
تنها با مخزن مشخص‌شده توسط نام مستعار (alias)، نام، شماره یا URI کار می‌کند. از این گزینه می‌توان چندین بار استفاده کرد.
.RE
.sp
\fB\-D\fP, \fB\-\-dry\-run\fP
.RS 4
نصب را آزمایش می‌کند، بدون اینکه عملاً چیزی نصب کند. اگر همراه با \fB\-\-download\-only\fP استفاده شود، می‌توان بررسی معناداری برای تداخل فایل‌ها انجام داد (بخش \fBPackage File Conflicts\fP را ببینید).
.RE
.sp
\fB\-\-details\fP
.RS 4
نمایش خلاصه باجزئیات فرایند نصب.
.RE
.sp
گزینه‌های مربوط به حل‌کننده (Solver):
.RS 4

.RE
.sp
\fB\-\-debug\-solver\fP
.RS 4
ایجاد یک مورد آزمایشی (test case) حل‌کننده برای اشکال‌زدایی. اگر فکر می‌کنید وابستگی‌ها به درستی حل نشده‌اند، از این گزینه استفاده کنید. هنگام استفاده از این گزینه هیچ بسته‌ای نصب یا حذف نخواهد شد. در عوض، یک مورد آزمایشی حل‌کننده در مسیر /var/log/zypper.solverTestCase نوشته می‌شود. می‌توانید این پوشه را فشرده کرده و به گزارش باگ خود پیوست کنید.
.RE
.sp
\fB\-\-force\-resolution\fP
.RS 4
حل‌کننده را مجبور می‌کند تا به‌جای پرسیدن از کاربر، راه‌حلی (\fIحتی تهاجمی\fP) پیدا کند.
.sp
به منظور انجام وظیفه درخواستی، حل‌کننده مجاز است هر خط‌مشی فعال در غیر این صورت را نقض کند. این شامل مجوز حذف بسته‌ها و همچنین عدم رعایت حتی خط‌مشی‌های صراحتاً تعیین‌شده (توسط \fB\-\-no\-allow\fP\-\fIpolicy\fP یا در فایل‌های پیکربندی) است. \fBاستفاده از این گزینه در محیط‌های بدون نظارت توصیه نمی‌شود\fP.
.sp
مجوز حذف بسته‌های وابسته هنگام حذف بسته‌ها (zypper remove) حالت پیش‌فرض است.
.RE
.sp
\fB\-R\fP, \fB\-\-no\-force\-resolution\fP
.RS 4
حل‌کننده را برای یافتن راه‌حل مجبور نمی‌کند. در عوض، مشکلات وابستگی را گزارش کرده و از کاربر می‌خواهد آن‌ها را به صورت دستی حل کند. این حالت پیش‌فرض است، مگر در هنگام حذف بسته‌ها (\fBzypper remove\fP).
.RE
.sp
\fB\-\-solver\-focus\fP \fIMODE\fP
.RS 4
رویکرد کلی حل‌کننده را هنگام حل یک وظیفه تنظیم می‌کند. حالت‌های معتبر عبارتند از \fBJob\fP، \fBInstalled\fP یا \fBUpdate\fP. برای جزئیات بخش \fBPackage Dependencies\fP را ببینید.
.RE
.sp
\fB\-\-recommends\fP
.RS 4
علاوه بر بسته‌های الزامی، بسته‌های توصیه‌شده را نیز نصب می‌کند. رفتار پیش‌فرض توسط [zypp.conf:solver.onlyRequires] تعیین می‌شود.
.RE
.sp
\fB\-\-no\-recommends\fP
.RS 4
بسته‌های توصیه‌شده را نصب نمی‌کند، بلکه تنها بسته‌های الزامی را نصب می‌کند. رفتار پیش‌فرض توسط [zypp.conf:solver.onlyRequires] تعیین می‌شود.
.RE
.sp
گزینه‌های پیشرفته:
.RS 4
از آن‌ها استفاده نکنید مگر اینکه بدانید واقعاً به آن‌ها نیاز دارید.
.RE
.sp
\fB\-\-allow\-downgrade\fP, \fB\-\-no\-allow\-downgrade\fP
.RS 4
تعیین مجاز بودن تنزل نسخه (downgrade) موارد قابل‌حل نصب‌شده.
.RE
.sp
\fB\-\-allow\-name\-change\fP, \fB\-\-no\-allow\-name\-change\fP
.RS 4
تعیین مجاز بودن تغییر نام موارد قابل‌حل نصب‌شده. تنظیم این گزینه روی \fBno\fP بسته‌هایی را که تغییر نام داده‌اند جایگزین نخواهد کرد.
.RE
.sp
\fB\-\-allow\-arch\-change\fP, \fB\-\-no\-allow\-arch\-change\fP
.RS 4
تعیین مجاز بودن تغییر معماری موارد قابل‌حل نصب‌شده.
.RE
.sp
\fB\-\-allow\-vendor\-change\fP, \fB\-\-no\-allow\-vendor\-change\fP
.RS 4
تعیین مجاز بودن تغییر توزیع‌کننده (vendor) موارد قابل‌حل نصب‌شده. تنظیم این گزینه روی \fBno\fP زمانی مفید است که نمی‌خواهید بسته‌های مخازن خارجی به نسخه توزیع تغییر یابند (یا بالعکس).
.RE
.sp
این دستور همچنین \fBگزینه‌های حالت بارگیری و نصب\fP شرح‌داده‌شده در دستور \fBinstall\fP را می‌پذیرد.
.RS 4

.RE
.RE
.sp
\fBremove\fP (\fBrm\fP) [\fIoptions\fP] \fIname\fP.\|.\|.
.RS 4

.RE
.sp
\fBremove\fP (\fBrm\fP) [\fIoptions\fP] \fB\-\-capability\fP \fIcapability\fP.\|.\|.
.RS 4
بسته‌ها را حذف (لغو نصب) می‌کند.
.sp
دستور remove بسته‌های انتخاب‌شده و بسته‌های وابسته به آن‌ها را لغو نصب می‌کند. این دستور برای نگه داشتن بسته‌های وابسته، تلاشی برای نصب گزینه‌های جایگزین نخواهد کرد. اگر این رفتار را می‌خواهید، از \fBzypper install !\fP\fIname\fP استفاده کنید.
.sp
بسته‌ها را می‌توان بر اساس نام آن‌ها یا قابلیتی که ارائه می‌دهند انتخاب کرد. برای جزئیات در مورد انتخاب بسته، به توضیحات دستور \fBinstall\fP مراجعه کنید.
.sp
\fB\-r\fP, \fB\-\-repo\fP \fIalias\fP|\fIname\fP|\fI#\fP|\fIURI\fP
.RS 4
تنها با مخزن مشخص‌شده توسط نام مستعار (alias)، نام، شماره یا URI کار می‌کند. از این گزینه می‌توان چندین بار استفاده کرد.
.RE
.sp
\fB\-t\fP, \fB\-\-type\fP \fItype\fP
.RS 4
نوع بسته (پیش‌فرض: package). برای فهرست انواع بسته‌های موجود، بخش \fBPackage Types\fP را ببینید.
.sp
از آنجا که وصله‌ها (\fBpatches\fP) به مفهوم کپی کردن فایل‌ها یا ثبت یک مدخل در پایگاه‌داده نصب نمی‌شوند، نمی‌توان آن‌ها را لغو نصب کرد؛ حتی با اینکه zypper آن‌ها را به صورت نصب‌شده نمایش می‌دهد. وضعیت نصب‌شده صرفاً بر اساس وضعیت نصب وابستگی‌های مورد نیاز آن تعیین می‌شود. اگر این وابستگی‌ها برآورده شده باشند، وصله به عنوان نصب‌شده در نظر گرفته می‌شود.
.RE
.sp
\fB\-n\fP, \fB\-\-name\fP
.RS 4
انتخاب بسته‌ها بر اساس نام آن‌ها (پیش‌فرض).
.RE
.sp
\fB\-C\fP, \fB\-\-capability\fP
.RS 4
انتخاب بسته‌ها بر اساس قابلیت‌ها.
.RE
.sp
\fB\-D\fP, \fB\-\-dry\-run\fP
.RS 4
حذف بسته‌ها را آزمایش می‌کند، بدون اینکه عملاً چیزی را حذف کند.
.RE
.sp
\fB\-\-details\fP
.RS 4
نمایش خلاصه باجزئیات فرایند نصب.
.RE
.sp
\-y, \-\-no\-confirm
.RS 4
نیازی به تعامل با کاربر ندارد. توصیه می‌شود به جای آن از گزینه سراسری \fB\-\-non\-interactive\fP استفاده کنید. گزینه‌های سراسری پیش از دستور ارسال می‌شوند (\fBzypper \-\-non\-interactive\fP \fICOMMAND .\|.\|.\fP). بر خلاف گزینه دستوری no\-confirm، گزینه سراسری را می‌توان همراه با هر دستور zypper استفاده کرد.
.RE
.sp
گزینه‌های مربوط به حل‌کننده (Solver):
.RS 4

.RE
.sp
\fB\-\-debug\-solver\fP
.RS 4
ایجاد یک مورد آزمایشی (test case) حل‌کننده برای اشکال‌زدایی. اگر فکر می‌کنید وابستگی‌ها به درستی حل نشده‌اند، از این گزینه استفاده کنید. هنگام استفاده از این گزینه هیچ بسته‌ای نصب یا حذف نخواهد شد. در عوض، یک مورد آزمایشی حل‌کننده در مسیر /var/log/zypper.solverTestCase نوشته می‌شود. می‌توانید این پوشه را فشرده کرده و به گزارش باگ خود پیوست کنید.
.RE
.sp
\fB\-\-force\-resolution\fP
.RS 4
حل‌کننده را مجبور می‌کند تا به‌جای پرسیدن از کاربر، راه‌حلی (\fIحتی تهاجمی\fP) پیدا کند.
.sp
به منظور انجام وظیفه درخواستی، حل‌کننده مجاز است هر خط‌مشی فعال در غیر این صورت را نقض کند. این شامل مجوز حذف بسته‌ها و همچنین عدم رعایت حتی خط‌مشی‌های صراحتاً تعیین‌شده (توسط \fB\-\-no\-allow\fP\-\fIpolicy\fP یا در فایل‌های پیکربندی) است. \fBاستفاده از این گزینه در محیط‌های بدون نظارت توصیه نمی‌شود\fP.
.sp
مجوز حذف بسته‌های وابسته هنگام حذف بسته‌ها (zypper remove) حالت پیش‌فرض است.
.RE
.sp
\fB\-R\fP, \fB\-\-no\-force\-resolution\fP
.RS 4
حل‌کننده را برای یافتن راه‌حل مجبور نمی‌کند. در عوض، مشکلات وابستگی را گزارش کرده و از کاربر می‌خواهد آن‌ها را به صورت دستی حل کند. این حالت پیش‌فرض است، مگر در هنگام حذف بسته‌ها (\fBzypper remove\fP).
.RE
.sp
\fB\-\-solver\-focus\fP \fIMODE\fP
.RS 4
رویکرد کلی حل‌کننده را هنگام حل یک وظیفه تنظیم می‌کند. حالت‌های معتبر عبارتند از \fBJob\fP، \fBInstalled\fP یا \fBUpdate\fP. برای جزئیات بخش \fBPackage Dependencies\fP را ببینید.
.RE
.sp
\fB\-u\fP, \fB\-\-clean\-deps\fP
.RS 4
حذف خودکار وابستگی‌هایی که پس از حذف بسته‌های درخواستی دیگر مورد نیاز نیستند.
.RE
.sp
\fB\-U\fP, \fB\-\-no\-clean\-deps\fP
.RS 4
عدم حذف خودکار وابستگی‌های غیرضروری.
.RE
.RE
.sp
\fBremoveptf\fP (\fBrmptf\fP) [\fIoptions\fP] <PTF|CAPABILITY> .\|.\|.
.RS 4
حذف بسته‌های PTF (و نه تنها آن‌ها).
.sp
یک دستور حذف که جایگزینی بسته‌های وابسته را به حذف آن‌ها نیز ترجیح می‌دهد. در واقع این یک دستور کامل install همراه با اصلاح‌کننده حذف (\-) است که روی آرگومان‌های ساده آن اعمال شده است. بنابراین \fIremoveptf foo\fP معادل \fIinstall \(em \-foo\fP است. به همین دلیل است که این دستور همان گزینه‌های دستور install را می‌پذیرد. این روش توصیه‌شده برای حذف یک PTF (اصلاحیه موقت برنامه یا Program Temporary Fix) است.
.sp
یک PTF معمولاً به محض اینکه اصلاحیه ارائه‌شده توسط آن در آخرین به‌روزرسانی رسمی بسته‌های وابسته اعمال شود، حذف می‌گردد. اما شما نمی‌خواهید بسته‌های وابسته همراه با PTF حذف شوند؛ کاری که دستور remove انجام می‌دهد. با این حال دستور removeptf تلاش خواهد کرد تا بسته‌های وابسته را با نسخه‌های به‌روزرسانی رسمی آن‌ها جایگزین کند.
.sp
\fBاز تمامی گزینه‌هایی که دستور install پشتیبانی می‌کند، پشتیبانی می‌کند\fP
.RS 4
.RE
.RE
.sp
\fBpurge\-kernels\fP [\fIoptions\fP]
.RS 4
هسته‌های نصب‌شده را به صورت خودکار حذف می‌کند.
.sp
پاک‌سازی خودکار هسته‌های نصب‌شده مطابق با قوانین تعریف‌شده در [zypp.conf:multiversion.kernels] که می‌توانند به صورت \fI<version>\fP، \fBlatest\fP[\fB\-\fP\fIN\fP]، \fBrunning\fP، \fBoldest\fP[\fB+\fP\fIN\fP] مشخص شوند.
.sp
\fB\-\-details\fP
.RS 4
نمایش خلاصه باجزئیات فرایند نصب.
.RE
.sp
\fB\-D\fP, \fB\-\-dry\-run\fP
.RS 4
حذف بسته‌ها را آزمایش می‌کند، بدون اینکه عملاً چیزی را حذف کند.
.RE
.RE
.SS "دستورات مدیریت به‌روزرسانی (Update Management Commands)"
.sp
\fBlist\-updates\fP (\fBlu\fP) [\fIoptions\fP]
.RS 4
فهرست کردن به‌روزرسانی‌های موجود.
.sp
این دستور فقط به‌روزرسانی‌های قابل‌نصب را فهرست می‌کند؛ یعنی به‌روزرسانی‌هایی که فاقد مشکل وابستگی بوده یا ارائه‌دهنده (vendor) بسته را تغییر نمی‌دهند. این فهرست شامل مواردی است که دستور \fBupdate\fP برای نصب پیشنهاد خواهد کرد. برای فهرست کردن تمام بسته‌هایی که نسخه جدیدتری از آن‌ها در دسترس است، از گزینه \fB\-\-all\fP استفاده کنید.
.sp
\fB\-t\fP, \fB\-\-type\fP \fItype\fP
.RS 4
نوع بسته (پیش‌فرض: package). برای مشاهده فهرست انواع بسته‌های موجود، بخش \fBPackage Types\fP را ببینید.
.sp
اگر \fBpatch\fP مشخص شود، zypper به‌گونه‌ای عمل می‌کند که گویی دستور \fBlist\-patches\fP اجرا شده است.
.RE
.sp
\fB\-r\fP, \fB\-\-repo\fP \fIalias\fP|\fIname\fP|\fI#\fP|\fIURI\fP
.RS 4
تنها با مخزن مشخص‌شده توسط نام مستعار (alias)، نام، شماره یا URI کار می‌کند. از این گزینه می‌توان چندین بار استفاده کرد.
.RE
.sp
\fB\-a\fP, \fB\-\-all\fP
.RS 4
فهرست کردن تمام بسته‌هایی که نسخه جدیدتری از آن‌ها در دسترس است، صرف‌نظر از این‌که قابل‌نصب هستند یا خیر.
.RE
.sp
\fB\-\-best\-effort\fP
.RS 4
برای توضیحات، دستور \fBupdate\fP را ببینید.
.RE
.sp
\fB\-\-filter\-version\-change\fP \fILEVEL\fP
.RS 4
فیلتر کردن به‌روزرسانی‌ها بر اساس اهمیت تغییر نسخه برای کاهش اطلاعات زائد. مقدار \fILEVEL\fP یکی از موارد زیر است:
.sp
\fBnone\fP
.RS 4
نمایش تمام به‌روزرسانی‌های موجود. این حالت پیش‌فرض است.
.RE
.sp
\fBrebuild\fP
.RS 4
پنهان کردن به‌روزرسانی‌هایی که در آن‌ها فقط شمارنده بازسازی (rebuild counter) تغییر کرده است (آخرین بخش جداشده با نقطه در رشته release). نسخه بالادستی (upstream) و ثبت بسته‌بندی (checkin) یکسان هستند.
.RE
.sp
\fBpackage\fP
.RS 4
پنهان کردن به‌روزرسانی‌هایی که در آن‌ها فقط انتشار (release) تغییر کرده است (checkin و/یا rebuild). نسخه بالادستی یکسان است. این حالت سخت‌گیرانه‌تر از \fBrebuild\fP است.
.sp
تغییرات Epoch هرگز فیلتر نمی‌شوند. این گزینه برای وصله‌ها (patches) اعمال نمی‌شود (به جای آن از فیلترهای \fBlist\-patches\fP استفاده کنید).
.RE
.RE
.sp
گزینه‌های پیشرفته (Expert Options):
.RS 4
از آن‌ها استفاده نکنید مگر اینکه مطمئن باشید به آن‌ها نیاز دارید.
.RE
.sp
\fB\-\-allow\-downgrade\fP, \fB\-\-no\-allow\-downgrade\fP
.RS 4
آیا تنزل نسخه (downgrade) مولفه‌های قابل‌حل (resolvables) نصب‌شده مجاز باشد یا خیر.
.RE
.sp
\fB\-\-allow\-name\-change\fP, \fB\-\-no\-allow\-name\-change\fP
.RS 4
آیا تغییر نام مولفه‌های قابل‌حل نصب‌شده مجاز باشد یا خیر. تنظیم این گزینه روی \fBno\fP بسته‌هایی را که تغییر نام یافته‌اند جایگزین نخواهد کرد.
.RE
.sp
\fB\-\-allow\-arch\-change\fP, \fB\-\-no\-allow\-arch\-change\fP
.RS 4
آیا تغییر معماری مولفه‌های قابل‌حل نصب‌شده مجاز باشد یا خیر.
.RE
.sp
\fB\-\-allow\-vendor\-change\fP, \fB\-\-no\-allow\-vendor\-change\fP
.RS 4
آیا تغییر ارائه‌دهنده (vendor) مولفه‌های قابل‌حل نصب‌شده مجاز باشد یا خیر. تنظیم این گزینه روی \fBno\fP ممکن است زمانی مفید باشد که نمی‌خواهید بسته‌های مخازن خارجی به نسخه توزیع تغییر یابند (یا برعکس).
.RE
.RE
.sp
\fBupdate\fP (\fBup\fP) [\fIoptions\fP] [\fIpackagename\fP].\|.\|.
.RS 4
به‌روزرسانی بسته‌های نصب‌شده با نسخه‌های جدیدتر، در صورت امکان.
.sp
این دستور بسته‌هایی را که نیازمند تغییر ارائه‌دهنده بسته باشند به‌روزرسانی نخواهد کرد، مگر اینکه ارائه‌دهنده در \fB/etc/zypp/vendors.d\fP مشخص شده باشد، یا نیازمند حل دستی مشکلات وابستگی‌ها باشند. چنین به‌روزرسانی‌های غیرقابل‌نصبی در بخش جداگانه‌ای از خلاصه وضعیت با عنوان "\fIThe following package updates will NOT be installed:\fP" فهرست خواهند شد.
.sp
برای به‌روزرسانی بسته‌های منفرد، یک یا چند نام بسته را مشخص کنید. می‌توانید از نویسه‌های عامه‌نمای (wildcard) \fB*\fP و \fB?\fP در نام بسته‌ها برای مشخص کردن چندین بسته منطبق با الگو استفاده کنید.
.sp
\fB\-t\fP, \fB\-\-type\fP \fItype\fP
.RS 4
نوع بسته (پیش‌فرض: package). برای مشاهده فهرست انواع بسته‌های موجود، بخش \fBPackage Types\fP را ببینید.
.sp
اگر \fBpatch\fP مشخص شود، zypper به‌گونه‌ای عمل می‌کند که گویی دستور \fBpatches\fP اجرا شده است.
.RE
.sp
\fB\-r\fP, \fB\-\-repo\fP \fIalias\fP|\fIname\fP|\fI#\fP|\fIURI\fP
.RS 4
تنها با مخزن مشخص‌شده با نام مستعار، نام، شماره یا URI کار می‌کند. از این گزینه می‌توان چندین بار استفاده کرد.
.RE
.sp
\fB\-\-skip\-interactive\fP
.RS 4
وصله‌های تعاملی را نادیده می‌گیرد؛ یعنی وصله‌هایی که نیازمند راه‌اندازی مجدد هستند، حاوی پیامی می‌باشند، یا بسته‌ای را به‌روزرسانی می‌کنند که مجوز آن نیاز به تایید دارد.
.RE
.sp
\fB\-\-with\-interactive\fP
.RS 4
جلوگیری از نادیده گرفتن وصله‌های تعاملی در هنگام کار در حالت غیرتعاملی.
.RE
.sp
\fB\-l\fP, \fB\-\-auto\-agree\-with\-licenses\fP
.RS 4
پاسخ خودکار \fIyes\fP به اعلان تایید مجوزهای شخص ثالث. با استفاده از این گزینه، شما موافقت با مجوزهای تمام نرم‌افزارهای شخص ثالثی را که این دستور نصب خواهد کرد می‌پذیرید. این گزینه به ویژه برای مدیران سیستمی مفید است که مجموعه یکسانی از بسته‌ها را روی چندین ماشین (توسط یک فرآیند خودکار) نصب می‌کنند و مجوزها را از قبل تایید نموده‌اند.
.RE
.sp
\fB\-\-auto\-agree\-with\-product\-licenses\fP
.RS 4
پذیرش خودکار فقط مجوزهای محصول. این گزینه توسط ابزارهایی مانند SUSEconnect استفاده می‌شود که پیش از ثبت محصول درخواست تایید می‌کنند؛ بنابراین نیازی به تایید مجدد مجوز محصول در زمان نصب نیست.
.RE
.sp
\fB\-\-replacefiles\fP
.RS 4
نصب بسته‌ها حتی اگر فایل‌هایی از بسته‌های دیگر که قبلاً نصب شده‌اند را جایگزین کنند. حالت پیش‌فرض این است که تداخل فایل‌ها به عنوان یک خطا در نظر گرفته شود. گزینه \fB\-\-download\-as\-needed\fP بررسی تداخل فایل‌ها را غیرفعال می‌کند، زیرا برای انجام این بررسی به دسترسی زودهنگام به فهرست فایل‌های همه بسته‌ها نیاز است.
.RE
.sp
\fB\-D\fP, \fB\-\-dry\-run\fP
.RS 4
آزمایش به‌روزرسانی بدون این‌که عملاً بسته‌ای نصب یا به‌روزرسانی شود. اگر همراه با \fB\-\-download\-only\fP استفاده شود، یک بررسی معنادار تداخل فایل‌ها می‌تواند انجام گیرد (بخش \fBPackage File Conflicts\fP را ببینید).
.RE
.sp
\fB\-\-details\fP
.RS 4
نمایش خلاصه نصب به صورت باجزئیات.
.RE
.sp
\fB\-\-best\-effort\fP
.RS 4
استفاده از رویکرد «بیشترین تلاش» (\fIbest effort\fP) برای به‌روزرسانی. این روش به صراحت بسته‌هایی با بهترین نسخه و معماری را انتخاب نمی‌کند، بلکه درخواست نصب بسته‌ای با نسخه بالاتر از نسخه نصب‌شده را ثبت می‌کند و باقی کار را به حل‌کننده وابستگی‌ها واگذار می‌نماید. این روش همیشه برای بسته‌ها به کار می‌رود و برای محصولات و الگوها اختیاری است. این گزینه برای وصله‌ها کاربردی ندارد.
.RE
.sp
\-y, \-\-no\-confirm
.RS 4
عدم نیاز به تعامل با کاربر. توصیه می‌شود به جای این گزینه از گزینه عمومی \fB\-\-non\-interactive\fP استفاده کنید. گزینه‌های عمومی پیش از دستور درج می‌شوند (\fBzypper \-\-non\-interactive\fP \fICOMMAND .\|.\|.\fP). برخلاف گزینه no\-confirm این دستور، گزینه عمومی می‌تواند همراه با هر دستور zypper استفاده شود.
.RE
.sp
گزینه‌های مربوط به حل‌کننده وابستگی‌ها (Solver related options):
.RS 4

.RE
.sp
\fB\-\-debug\-solver\fP
.RS 4
ایجاد مورد آزمایشی حل‌کننده برای اشکال‌زدایی. اگر فکر می‌کنید وابستگی‌ها به درستی حل نشده‌اند از این گزینه استفاده کنید. هنگام استفاده از این گزینه هیچ بسته‌ای نصب یا حذف نخواهد شد. در عوض یک مورد آزمایشی حل‌کننده در /var/log/zypper.solverTestCase نوشته می‌شود. می‌توانید این پوشه را فشرده کرده و به گزارش باگ خود پیوست کنید.
.RE
.sp
\fB\-\-force\-resolution\fP
.RS 4
مجبور کردن حل‌کننده به یافتن یک راهکار (\fIحتی یک راهکار تهاجمی\fP) به جای سوال پرسیدن از کاربر.
.sp
به منظور انجام کار درخواستی، حل‌کننده مجاز است هر خط‌مشی که در حالت عادی فعال است را نقض کند. این شامل مجوز حذف بسته‌ها و همچنین عدم رعایت خط‌مشی‌هایی است که صریحاً تنظیم شده‌اند (توسط \fB\-\-no\-allow\fP\-\fIpolicy\fP یا در فایل‌های کانفیگ). \fBاستفاده از این گزینه در محیط‌های بدون نظارت توصیه نمی‌شود\fP.
.sp
مجوز حذف بسته‌های وابسته، هنگام حذف بسته‌ها (\fBzypper remove\fP) رفتار پیش‌فرض است.
.RE
.sp
\fB\-R\fP, \fB\-\-no\-force\-resolution\fP
.RS 4
حل‌کننده را به یافتن راهکار مجبور نمی‌کند؛ بلکه مشکلات وابستگی را گزارش کرده و از کاربر می‌خواهد آن‌ها را به صورت دستی حل کند. این حالت پیش‌فرض است، مگر هنگام حذف بسته‌ها (\fBzypper remove\fP).
.RE
.sp
\fB\-\-solver\-focus\fP \fIMODE\fP
.RS 4
تنظیم رویکرد کلی حل‌کننده هنگام حل یک کار. حالت‌های معتبر عبارتند از \fBJob\fP، \fBInstalled\fP یا \fBUpdate\fP. برای جزئیات، بخش \fBPackage Dependencies\fP را ببینید.
.RE
.sp
\fB\-\-recommends\fP
.RS 4
علاوه بر بسته‌های لازم (required)، بسته‌های توصیه‌شده (recommended) را نیز نصب می‌کند. رفتار پیش‌فرض توسط [zypp.conf:solver.onlyRequires] تعیین می‌شود.
.RE
.sp
\fB\-\-no\-recommends\fP
.RS 4
بسته‌های توصیه‌شده را نصب نمی‌کند، بلکه تنها بسته‌های لازم را نصب می‌نماید. رفتار پیش‌فرض توسط [zypp.conf:solver.onlyRequires] تعیین می‌شود.
.RE
.sp
گزینه‌های پیشرفته (Expert Options):
.RS 4
از آن‌ها استفاده نکنید مگر اینکه مطمئن باشید به آن‌ها نیاز دارید.
.RE
.sp
\fB\-\-allow\-downgrade\fP, \fB\-\-no\-allow\-downgrade\fP
.RS 4
آیا تنزل نسخه مولفه‌های قابل‌حل نصب‌شده مجاز باشد یا خیر.
.RE
.sp
\fB\-\-allow\-name\-change\fP, \fB\-\-no\-allow\-name\-change\fP
.RS 4
آیا تغییر نام مولفه‌های قابل‌حل نصب‌شده مجاز باشد یا خیر. تنظیم این گزینه روی \fBno\fP بسته‌هایی را که تغییر نام یافته‌اند جایگزین نخواهد کرد.
.RE
.sp
\fB\-\-allow\-arch\-change\fP, \fB\-\-no\-allow\-arch\-change\fP
.RS 4
آیا تغییر معماری مولفه‌های قابل‌حل نصب‌شده مجاز باشد یا خیر.
.RE
.sp
\fB\-\-allow\-vendor\-change\fP, \fB\-\-no\-allow\-vendor\-change\fP
.RS 4
آیا تغییر ارائه‌دهنده مولفه‌های قابل‌حل نصب‌شده مجاز باشد یا خیر. تنظیم این گزینه روی \fBno\fP ممکن است زمانی مفید باشد که نمی‌خواهید بسته‌های مخازن خارجی به نسخه توزیع تغییر یابند (یا برعکس).
.RE
.sp
این دستور همچنین \fBگزینه‌های حالت بارگیری و نصب (Download\-and\-install mode options)\fP شرح داده شده در توضیحات دستور \fBinstall\fP را می‌پذیرد.
.RS 4

.RE
.RE
.sp
\fBlist\-patches\fP (\fBlp\fP) [\fIoptions\fP]
.RS 4
فهرست کردن تمام وصله‌های قابل‌اعمال.
.sp
این دستور مشابه \fBzypper list\-updates \-t patch\fP است.
.sp
توجه داشته باشید که \fIآرگومان‌های اختیاری\fP برخی از گزینه‌های زیر باید با استفاده از \fB=\fP به جای فاصله مشخص شوند.
.sp
\fB\-b\fP, \fB\-\-bugzilla\fP[\fB=\fP\fI#\fP[,\fI.\|.\|.\fP]]
.RS 4
فهرست کردن وصله‌های قابل‌اعمال برای تمام گزارش‌های باگ‌زیلا (Bugzilla) یا مواردی که شماره آن‌ها با رشته ارائه‌شده مطابقت دارد.
.RE
.sp
\fB\-\-cve\fP[\fB=\fP\fI#\fP[,\fI.\|.\|.\fP]]
.RS 4
فهرست کردن وصله‌های قابل‌اعمال برای تمام گزارش‌های CVE یا مواردی که شماره آن‌ها با رشته ارائه‌شده مطابقت دارد.
.RE
.sp
\fB\-\-date\fP \fIYYYY\-MM\-DD\fP[,\fI.\|.\|.\fP]
.RS 4
تنها وصله‌های منتشرشده تا تاریخ مشخص‌شده (بدون شامل شدن خود آن روز) را فهرست می‌کند.
.RE
.sp
\fB\-g\fP, \fB\-\-category\fP \fIcategory\fP[,\fI.\|.\|.\fP]
.RS 4
تنها وصله‌های متعلق به این دسته‌بندی را فهرست می‌کند. برای مشاهده فهرستی از مقادیر متداول \fIcategory\fP، بخش \fBPackage Types\fP را ببینید.
.RE
.sp
\fB\-\-severity\fP \fIseverity\fP[,\fI.\|.\|.\fP]
.RS 4
تنها وصله‌های دارای این سطح شدت را فهرست می‌کند. برای مشاهده فهرستی از مقادیر متداول \fIseverity\fP، بخش \fBPackage Types\fP را ببینید.
.RE
.sp
\fB\-\-issue\fP[\fB=\fP\fIstring\fP[,\fI.\|.\|.\fP]]
.RS 4
جستجو برای مسائلی که شماره، خلاصه یا توضیحات آن‌ها با \fIstring\fP مشخص‌شده مطابقت دارد. مسائلی که بر اساس شماره پیدا می‌شوند جدا از مسائلی که بر اساس توضیحات یافت شده‌اند نمایش می‌یابند. در حالت دوم، از دستور \fBzypper patch\-info\fP \fIpatchname\fP برای دریافت اطلاعات درباره مسائلی که وصله برطرف می‌کند استفاده کنید.
.RE
.sp
\fB\-a\fP, *\-\-all
.RS 4
به طور پیش‌فرض، فقط وصله‌هایی که روی سیستم شما قابل‌اعمال هستند فهرست می‌شوند. این گزینه باعث می‌شود تمام وصله‌های منتشرشده موجود فهرست شوند. این گزینه می‌تواند با تمام گزینه‌های دیگر دستور \fBlist\-updates\fP ترکیب شود.
.RE
.sp
\fB\-\-with\-optional\fP, \fB\-\-without\-optional\fP
.RS 4
آیا وصله‌های اختیاری قابل‌اعمال باید به عنوان مورد نیاز در نظر گرفته شوند یا نادیده گرفته شوند. رفتار پیش‌فرض نادیده گرفتن وصله‌های اختیاری است.
.RE
.sp
\fB\-r\fP, \fB\-\-repo\fP \fIalias\fP|\fIname\fP|\fI#\fP|\fIURI\fP
.RS 4
تنها با مخزن مشخص‌شده با نام مستعار، نام، شماره یا URI کار می‌کند. از این گزینه می‌توان چندین بار استفاده کرد.
.RE
.RE
.sp
\fBpatch\-check\fP (\fBpchk\fP)
.RS 4
بررسی وجود وصله‌ها. تعداد وصله‌های قابل‌اعمال و اینکه چه تعداد از آن‌ها در دسته‌بندی امنیتی هستند را نمایش می‌دهد.
.sp
همچنین برای جزئیات در مورد وضعیت‌های خروج \fB0\fP، \fB100\fP و \fB101\fP بازگردانده‌شده توسط این دستور، بخش \fBEXIT CODES\fP را ببینید.
.sp
\fB\-\-updatestack\-only\fP
.RS 4
تنها وصله‌هایی را بررسی می‌کند که بر خود مدیریت بسته‌ها اثر می‌گذارند.
.RE
.sp
\fB\-\-with\-optional\fP, \fB\-\-without\-optional\fP
.RS 4
آیا وصله‌های اختیاری قابل‌اعمال باید به عنوان مورد نیاز در نظر گرفته شوند یا نادیده گرفته شوند. رفتار پیش‌فرض نادیده گرفتن وصله‌های اختیاری است.
.RE
.sp
\fB\-r\fP, \fB\-\-repo\fP \fIalias\fP|\fIname\fP|\fI#\fP|\fIURI\fP
.RS 4
بررسی وجود وصله‌ها تنها در مخزن مشخص‌شده با نام مستعار، نام، شماره یا URI. از این گزینه می‌توان چندین بار استفاده کرد.
.RE
.RE
.sp
\fBpatch\fP [\fIoptions\fP]
.RS 4
نصب تمام وصله‌های مورد نیاز و موجود.
.sp
هنگام به‌روزرسانی بسته‌های تحت‌تاثیر قرار گرفته/آسیب‌پذیر شرح داده شده توسط یک وصله، zypper همیشه جدیدترین نسخه موجود را هدف قرار می‌دهد. برای جزئیات بیشتر درباره نحوه عملکرد وصله‌ها، بخش \fBPackage Types\fP را ببینید.
.sp
اگر وصله‌هایی وجود داشته باشند که بر خود مدیریت بسته‌ها اثر می‌گذارند، ابتدا آن‌ها نصب خواهند شد و از شما خواسته می‌شود دستور \fBpatch\fP را مجدداً اجرا کنید.
.sp
این دستور مشابه \fBzypper update \-t patch\fP است.
.sp
\fB\-\-updatestack\-only\fP
.RS 4
تنها وصله‌هایی را که بر خود مدیریت بسته‌ها اثر می‌گذارند نصب کرده و خارج می‌شود.
.RE
.sp
\fB\-\-skip\-not\-applicable\-patches\fP
.RS 4
نادیده گرفتن وصله‌های مورد نیازی که بدون تداخل اعمال نمی‌شوند. در حالت عملکرد عادی، این تداخل‌ها باید به صورت تعاملی حل شوند، در غیر این صورت دستور \fBpatch\fP با شکست مواجه می‌شود.
.sp
در محیط‌های اسکریپتی و بدون نظارت، ممکن است تمایل داشته باشید حداقل تا جای ممکن وصله‌ها اعمال شوند تا سیستم کاملاً بدون به‌روزرسانی نماند. اکیداً توصیه می‌شود پس از آن دستور \fBzypper patch\-check\fP را اجرا کنید تا
ببینید آیا وصله‌های مورد نیازی وجود دارند که همچنان منتظر حل تعاملی باشند.
.RE
.sp
\fB\-\-with\-update\fP
.RS 4
تلاش مضاعف برای به‌روزرسانی تمام بسته‌هایی که تحت پوشش وصله‌ها قرار نگرفته‌اند. این اساساً مشابه اجرای دستور \fBzypper update\fP پس از اتمام کار است.
.sp
اگر دستور وصله ابتدا نیاز به به‌روزرسانی پشته به‌روزرسانی (update stack) داشته باشد، این گزینه نادیده گرفته می‌شود؛ بنابراین نمی‌توان آن را با گزینه \fB\-\-updatestack\-only\fP ترکیب کرد.
.RE
.sp
\fB\-\-with\-optional\fP, \fB\-\-without\-optional\fP
.RS 4
آیا وصله‌های اختیاری قابل‌اعمال باید به عنوان مورد نیاز در نظر گرفته شوند یا نادیده گرفته شوند. رفتار پیش‌فرض نادیده گرفتن وصله‌های اختیاری است.
.RE
.sp
\fB\-b\fP, \fB\-\-bugzilla\fP \fI#\fP[,\fI.\|.\|.\fP]
.RS 4
انتخاب وصله‌های قابل‌اعمال برای یک گزارش باگ‌زیلا مشخص‌شده بر اساس شماره. از دستور \fBlist\-patches \-\-bugzilla\fP برای دریافت فهرستی از وصله‌های قابل‌اعمال برای گزارش‌های خاص استفاده کنید.
.RE
.sp
\fB\-\-cve\fP \fI#\fP[,\fI.\|.\|.\fP]
.RS 4
انتخاب وصله‌های قابل‌اعمال برای یک مورد CVE از MITRE مشخص‌شده بر اساس شماره. از دستور \fBlist\-patches \-\-cve\fP برای دریافت فهرستی از وصله‌های قابل‌اعمال برای مسائل خاص استفاده کنید.
.RE
.sp
\fB\-\-date\fP \fIYYYY\-MM\-DD\fP[,\fI.\|.\|.\fP]
.RS 4
تنها وصله‌های منتشرشده تا تاریخ مشخص‌شده (بدون شامل شدن خود آن روز) را انتخاب می‌کند.
.RE
.sp
\fB\-g\fP, \fB\-\-category\fP \fIcategory\fP[,\fI.\|.\|.\fP]
.RS 4
تنها وصله‌های متعلق به این دسته‌بندی را انتخاب می‌کند. از دستور \fBlist\-patches \-\-category\fP برای دریافت فهرستی از وصله‌های موجود با یک دسته‌بندی خاص استفاده کنید. برای فهرستی از مقادیر متداول \fIcategory\fP، بخش \fBPackage Types\fP را ببینید.
.RE
.sp
\fB\-\-severity\fP \fIseverity\fP[,\fI.\|.\|.\fP]
.RS 4
تنها وصله‌های با این سطح شدت را انتخاب می‌کند. از دستور \fBlist\-patches \-\-severity\fP برای دریافت فهرستی از وصله‌های موجود با یک شدت خاص استفاده کنید. برای فهرستی از مقادیر متداول \fIseverity\fP، بخش \fBPackage Types\fP را ببینید.
.RE
.sp
\fB\-r\fP, \fB\-\-repo\fP \fIalias\fP|\fIname\fP|\fI#\fP|\fIURI\fP
.RS 4
تنها با مخزن مشخص‌شده با نام مستعار، نام، شماره یا URI کار می‌کند. از این گزینه می‌توان چندین بار استفاده کرد.
.RE
.sp
\fB\-\-skip\-interactive\fP
.RS 4
وصله‌های تعاملی را نادیده می‌گیرد؛ یعنی وصله‌هایی که نیازمند راه‌اندازی مجدد هستند، حاوی پیامی می‌باشند، یا بسته‌ای را به‌روزرسانی می‌کنند که مجوز آن نیاز به تایید دارد.
.RE
.sp
\fB\-\-with\-interactive\fP
.RS 4
جلوگیری از نادیده گرفتن وصله‌های تعاملی در هنگام کار در حالت غیرتعاملی.
.RE
.sp
\fB\-l\fP, \fB\-\-auto\-agree\-with\-licenses\fP
.RS 4
پاسخ خودکار \fIyes\fP به اعلان تایید مجوزهای شخص ثالث. با استفاده از این گزینه، شما موافقت با مجوزهای تمام نرم‌افزارهای شخص ثالثی را که این دستور نصب خواهد کرد می‌پذیرید. این گزینه به ویژه برای مدیران سیستمی مفید است که مجموعه یکسانی از بسته‌ها را روی چندین ماشین (توسط یک فرآیند خودکار) نصب می‌کنند و مجوزها را از قبل تایید نموده‌اند.
.RE
.sp
\fB\-\-auto\-agree\-with\-product\-licenses\fP
.RS 4
پذیرش خودکار فقط مجوزهای محصول. این گزینه توسط ابزارهایی مانند SUSEconnect استفاده می‌شود که پیش از ثبت محصول درخواست تایید می‌کنند؛ بنابراین نیازی به تایید مجدد مجوز محصول در زمان نصب نیست.
.RE
.sp
\fB\-\-replacefiles\fP
.RS 4
نصب بسته‌ها حتی اگر فایل‌هایی از بسته‌های دیگر که قبلاً نصب شده‌اند را جایگزین کنند. حالت پیش‌فرض این است که تداخل فایل‌ها به عنوان یک خطا در نظر گرفته شود. گزینه \fB\-\-download\-as\-needed\fP بررسی تداخل فایل‌ها را غیرفعال می‌کند، زیرا برای انجام این بررسی به دسترسی زودهنگام به فهرست فایل‌های همه بسته‌ها نیاز است.
.RE
.sp
\fB\-D\fP, \fB\-\-dry\-run\fP
.RS 4
آزمایش به‌روزرسانی بدون این‌که عملاً به‌روزرسانی انجام شود. اگر همراه با \fB\-\-download\-only\fP استفاده شود، یک بررسی معنادار تداخل فایل‌ها می‌تواند انجام پذیرد (بخش \fBPackage File Conflicts\fP را ببینید).
.RE
.sp
\fB\-\-details\fP
.RS 4
نمایش خلاصه نصب به صورت باجزئیات.
.RE
.sp
\-y, \-\-no\-confirm
.RS 4
عدم نیاز به تعامل با کاربر. توصیه می‌شود به جای این گزینه از گزینه عمومی \fB\-\-non\-interactive\fP استفاده کنید. گزینه‌های عمومی پیش از دستور درج می‌شوند (\fBzypper \-\-non\-interactive\fP \fICOMMAND .\|.\|.\fP). برخلاف گزینه no\-confirm این دستور، گزینه عمومی می‌تواند همراه با هر دستور zypper استفاده شود.
.RE
.sp
گزینه‌های مربوط به حل‌کننده وابستگی‌ها (Solver related options):
.RS 4

.RE
.sp
\fB\-\-debug\-solver\fP
.RS 4
ایجاد مورد آزمایشی حل‌کننده برای اشکال‌زدایی. اگر فکر می‌کنید وابستگی‌ها به درستی حل نشده‌اند از این گزینه استفاده کنید. هنگام استفاده از این گزینه هیچ بسته‌ای نصب یا حذف نخواهد شد. در عوض یک مورد آزمایشی حل‌کننده در /var/log/zypper.solverTestCase نوشته می‌شود. می‌توانید این پوشه را فشرده کرده و به گزارش باگ خود پیوست کنید.
.RE
.sp
\fB\-\-force\-resolution\fP
.RS 4
مجبور کردن حل‌کننده به یافتن یک راهکار (\fIحتی یک راهکار تهاجمی\fP) به جای سوال پرسیدن از کاربر.
.sp
به منظور انجام کار درخواستی، حل‌کننده مجاز است هر خط‌مشی که در حالت عادی فعال است را نقض کند. این شامل مجوز حذف بسته‌ها و همچنین عدم رعایت خط‌مشی‌هایی است که صریحاً تنظیم شده‌اند (توسط \fB\-\-no\-allow\fP\-\fIpolicy\fP یا در فایل‌های کانفیگ). \fBاستفاده از این گزینه در محیط‌های بدون نظارت توصیه نمی‌شود\fP.
.sp
مجوز حذف بسته‌های وابسته، هنگام حذف بسته‌ها (\fBzypper remove\fP) رفتار پیش‌فرض است.
.RE
.sp
\fB\-R\fP, \fB\-\-no\-force\-resolution\fP
.RS 4
حل‌کننده را به یافتن راهکار مجبور نمی‌کند؛ بلکه مشکلات وابستگی را گزارش کرده و از کاربر می‌خواهد آن‌ها را به صورت دستی حل کند. این حالت پیش‌فرض است، مگر هنگام حذف بسته‌ها (\fBzypper remove\fP).
.RE
.sp
\fB\-\-solver\-focus\fP \fIMODE\fP
.RS 4
تنظیم رویکرد کلی حل‌کننده هنگام حل یک کار. حالت‌های معتبر عبارتند از \fBJob\fP، \fBInstalled\fP یا \fBUpdate\fP. برای جزئیات، بخش \fBPackage Dependencies\fP را ببینید.
.RE
.sp
\fB\-\-recommends\fP
.RS 4
علاوه بر بسته‌های لازم (required)، بسته‌های توصیه‌شده (recommended) را نیز نصب می‌کند. رفتار پیش‌فرض توسط [zypp.conf:solver.onlyRequires] تعیین می‌شود.
.RE
.sp
\fB\-\-no\-recommends\fP
.RS 4
بسته‌های توصیه‌شده را نصب نمی‌کند، بلکه تنها بسته‌های لازم را نصب می‌نماید. رفتار پیش‌فرض توسط [zypp.conf:solver.onlyRequires] تعیین می‌شود.
.RE
.sp
گزینه‌های پیشرفته (Expert Options):
.RS 4
از آن‌ها استفاده نکنید مگر اینکه مطمئن باشید به آن‌ها نیاز دارید.
.RE
.sp
\fB\-\-allow\-downgrade\fP, \fB\-\-no\-allow\-downgrade\fP
.RS 4
آیا تنزل نسخه مولفه‌های قابل‌حل نصب‌شده مجاز باشد یا خیر.
.RE
.sp
\fB\-\-allow\-name\-change\fP, \fB\-\-no\-allow\-name\-change\fP
.RS 4
آیا تغییر نام مولفه‌های قابل‌حل نصب‌شده مجاز باشد یا خیر. تنظیم این گزینه روی \fBno\fP بسته‌هایی را که تغییر نام یافته‌اند جایگزین نخواهد کرد.
.RE
.sp
\fB\-\-allow\-arch\-change\fP, \fB\-\-no\-allow\-arch\-change\fP
.RS 4
آیا تغییر معماری مولفه‌های قابل‌حل نصب‌شده مجاز باشد یا خیر.
.RE
.sp
\fB\-\-allow\-vendor\-change\fP, \fB\-\-no\-allow\-vendor\-change\fP
.RS 4
آیا تغییر ارائه‌دهنده مولفه‌های قابل‌حل نصب‌شده مجاز باشد یا خیر. تنظیم این گزینه روی \fBno\fP ممکن است زمانی مفید باشد که نمی‌خواهید بسته‌های مخازن خارجی به نسخه توزیع تغییر یابند (یا برعکس).
.RE
.sp
این دستور همچنین \fBگزینه‌های حالت بارگیری و نصب (Download\-and\-install mode options)\fP شرح داده شده در توضیحات دستور \fBinstall\fP را می‌پذیرد.
.RS 4

.RE
.RE
.sp
\fBdist\-upgrade\fP (\fBdup\fP) [\fIoptions\fP]
.RS 4
ارتقای توزیع را انجام می‌دهد. این دستور وضعیت مخازن (مشخص‌شده) را بر روی سیستم اعمال می‌کند؛ بسته‌های نصب‌شده را به نسخه‌های موجود در مخازن ارتقا (یا حتی تنزل) می‌دهد، بسته‌هایی را که دیگر در مخازن وجود ندارند و مانع وابستگی برای ارتقا ایجاد می‌کنند حذف می‌نماید، تقسیم و تغییر نام بسته‌ها را مدیریت می‌کند و غیره.
.sp
اگر هیچ مخزنی از طریق گزینه \fB\-\-from\fP مشخص نشده باشد، zypper یک ارتقای سراسری با تمام مخازن تعریف‌شده انجام خواهد داد. این حالت سراسری dup بسته‌های بدون تغییر نصب‌شده را نیز مد نظر قرار داده و وابستگی‌های آن‌ها را مجدداً ارزیابی می‌کند. اگر سیستم حاوی مخازن متناقض باشد (مانند مخازن دو انتشار مختلف توزیع)، این امر می‌تواند مشکل‌ساز شود. این حالت اغلب زمانی رخ می‌دهد که کاربر پس از افزودن مخزن یک انتشار جدید، فراموش کند مخزن انتشار قدیمی‌تر را حذف کند؛ مثلاً openSUSE 13.1 و openSUSE 13.2.
.sp
برای تمام مخازنی که نسخه توزیع را درون نشانی URL خود دارند (مانند https://download.opensuse.org/distribution/\fI13.1\fP/repo/oss)، استفاده از متغیر \fB$releasever\fP به جای آن می‌تواند مفید باشد (https://download.opensuse.org/distribution/\fB$releasever\fP/repo/oss). این متغیر به طور پیش‌فرض با نسخه فعلی توزیع (\fI13.1\fP) جایگزین می‌شود.
.sp
این مقدار را می‌توان به صورت موقت در دستور جاری zypper با استفاده از گزینه عمومی \fB\-\-releasever\fP بازنویسی کرد. فراخوانی دستور به‌صورت \fBzypper \-\-releasever 13.2\fP\fI.\|.\|.\fP باعث می‌شود این مخازن بدون نیاز به افزودن یا حذف هیچ موردی، از مکان جدید (https://download.opensuse.org/distribution/\fI13.2\fP/repo/oss) استفاده کنند. اما تا زمانی که ارتقای توزیع عملاً انجام شود، باید از \fB\-\-releasever 13.2\fP همراه با هر دستور zypper استفاده کنید. پس از پایان عملیات \fBdup\fP، مقدار \fB$releasever\fP به طور پیش‌فرض نسخه جدید توزیع \fI13.2\fP خواهد بود و دیگر به \fB\-\-releasever\fP نیازی نیست.
.sp
تنظیم دائمی \fB$releasever\fP روی مقدار توزیع هدف می‌تواند زحمت کمتری داشته باشد تا اصلاً نیازی به \-\-releasever نباشد. برای اطلاعات بیشتر درباره جایگزینی متغیرها و تعریف متغیرهای سفارشی، بخش \fBRepository Management\fP را ببینید.
.sp
\fIیادداشت:\fP اجرای ارتقای توزیع به طور خودکار یک مورد آزمایشی حل‌کننده در /var/log/updateTestcase\-YYYY\-MM\-DD\-hh\-mm\-ss (تاریخ و زمان اجرای دستور) ایجاد خواهد کرد.
.sp
\fIیادداشت:\fP ارتقای توزیع در openSUSE در حال حاضر فقط بین انتشارهای متوالی پشتیبانی می‌شود. برای ارتقا در میان چند انتشار، هر انتشار متوالی را یکی‌یکی ارتقا دهید. برای جزئیات بیشتر به نشانی \fB\c
.URL "http://en.opensuse.org/SDB:System_upgrade" "" "\fP"
و \fIیادداشت‌های انتشار openSUSE\fP در نشانی \fB
.URL "http://doc.opensuse.org/release\-notes" "" "\fP."
مراجعه فرمایید.
.sp
\fIیادداشت:\fP به دلیل نحوه برخورد با بسته‌های یتیم، dist\-upgrade بیش از هر دستور دیگری به پیکربندی صحیح مخازن وابسته است. در صورتی که بازخوانی مخازن فعال ناموفق باشد، این دستور نباید ادامه یابد، زیرا این امر می‌تواند آسیب شدیدی به سیستم وارد کند. اگر مخزن دارای خطا در واقع مورد نیاز نیست، باید غیرفعال شود.
.RE
.sp
\fB\-\-from\fP \fIalias\fP|\fIname\fP|\fI#\fP|\fIURI\fP
.RS 4
این گزینه می‌تواند چندین بار استفاده شود و ارتقا را تنها به مخازن مشخص‌شده محدود می‌کند. با این حال، تمام مخازن فعال برای حل‌کننده مرئی بوده و برای برطرف کردن مشکلات وابستگی در نظر گرفته خواهند شد.
.RE
.sp
\fB\-\-remove\-orphaned\fP
.RS 4
حذف بسته‌های یتیم (orphaned). بسته‌های نصب‌شده‌ای که توسط حداقل یکی از مخازن موجود ارائه نشده باشند، به عنوان یتیم یا حذف‌شده (dropped) در نظر گرفته می‌شوند. در صورتی که بسته‌های یتیم مانع ارتقای بسته‌های مورد نظر شوند، \fBdist\-upgrade\fP آن‌ها را حذف می‌کند. با این گزینه، تمام بسته‌های یتیم غیرضروری حذف می‌شوند.
.sp
.if n .RS 4
.nf
.fam C
\*(Aqیادداشت:\*(Aq بسته‌هایی که درون یک مخزن عرضه نشده‌اند \- بسته‌های دست‌ساز یا بارگیری‌شده \- را می‌توان در یک مخزن plaindir جمع‌آوری کرد تا از برخورد با آن‌ها به عنوان بسته یتیم جلوگیری شود. برای جزئیات، بخش *System Packages* را ببینید.
.fam
.fi
.if n .RE
.RE
.sp
\-r, \-\-repo alias|name|#|URI
.RS 4
تنها با مخزن مشخص‌شده با نام مستعار (alias)، نام، شماره یا URI کار می‌کند.
.sp
استفاده از \-\-repo \fIتوصیه نمی‌شود\fP زیرا در حال حاضر مخازن ذکر‌نشده را از دید حل‌کننده پنهان می‌کند و منجر به تصمیم‌گیری‌های غیرکارشناسانه می‌شود. دلیل این امر آن است که بسته‌هایی که در ابتدا از مخازن پنهان‌شده نصب شده بودند، اکنون به عنوان \fIیتیم\fP یا \fIحذف‌شده\fP تلقی می‌شوند و اگر در تداخل وابستگی دخیل باشند ممکن است بدون اعلان حذف شوند. در آینده \-\-repo به یک نام مستعار برای \fB\-\-from\fP تبدیل خواهد شد.
.RE
.sp
\fB\-l\fP, \fB\-\-auto\-agree\-with\-licenses\fP
.RS 4
پاسخ خودکار \fIyes\fP به اعلان تایید مجوزهای شخص ثالث. با استفاده از این گزینه، شما موافقت با مجوزهای تمام نرم‌افزارهای شخص ثالثی را که این دستور نصب خواهد کرد می‌پذیرید. این گزینه به ویژه برای مدیران سیستمی مفید است که مجموعه یکسانی از بسته‌ها را روی چندین ماشین (توسط یک فرآیند خودکار) نصب می‌کنند و مجوزها را از قبل تایید نموده‌اند.
.RE
.sp
\fB\-\-auto\-agree\-with\-product\-licenses\fP
.RS 4
پذیرش خودکار فقط مجوزهای محصول. این گزینه توسط ابزارهایی مانند SUSEconnect استفاده می‌شود که پیش از ثبت محصول درخواست تایید می‌کنند؛ بنابراین نیازی به تایید مجدد مجوز محصول در زمان نصب نیست.
.RE
.sp
\fB\-\-replacefiles\fP
.RS 4
نصب بسته‌ها حتی اگر فایل‌هایی از بسته‌های دیگر که قبلاً نصب شده‌اند را جایگزین کنند. حالت پیش‌فرض این است که تداخل فایل‌ها به عنوان یک خطا در نظر گرفته شود. گزینه \fB\-\-download\-as\-needed\fP بررسی تداخل فایل‌ها را غیرفعال می‌کند، زیرا برای انجام این بررسی به دسترسی زودهنگام به فهرست فایل‌های همه بسته‌ها نیاز است.
.RE
.sp
\fB\-D\fP, \fB\-\-dry\-run\fP
.RS 4
آزمایش ارتقا، بدون این‌که عملاً بسته‌ای نصب یا به‌روزرسانی شود. اگر همراه با \fB\-\-download\-only\fP استفاده شود، یک بررسی معنادار تداخل فایل‌ها می‌تواند انجام گیرد (بخش \fBPackage File Conflicts\fP را ببینید).
.RE
.sp
\-y, \-\-no\-confirm
.RS 4
عدم نیاز به تعامل با کاربر. توصیه می‌شود به جای این گزینه از گزینه عمومی \fB\-\-non\-interactive\fP استفاده کنید. گزینه‌های عمومی پیش از دستور درج می‌شوند (\fBzypper \-\-non\-interactive\fP \fICOMMAND .\|.\|.\fP). برخلاف گزینه no\-confirm این دستور، گزینه عمومی می‌تواند همراه با هر دستور zypper استفاده شود.
.RE
.sp
\fB\-\-details\fP
.RS 4
نمایش خلاصه نصب به صورت باجزئیات.
.RE
.sp
گزینه‌های مربوط به حل‌کننده وابستگی‌ها (Solver related options):
.RS 4

.RE
.sp
\fB\-\-debug\-solver\fP
.RS 4
ایجاد مورد آزمایشی حل‌کننده برای اشکال‌زدایی. اگر فکر می‌کنید وابستگی‌ها به درستی حل نشده‌اند از این گزینه استفاده کنید. هنگام استفاده از این گزینه هیچ بسته‌ای نصب یا حذف نخواهد شد. در عوض یک مورد آزمایشی حل‌کننده در /var/log/zypper.solverTestCase نوشته می‌شود. می‌توانید این پوشه را فشرده کرده و به گزارش باگ خود پیوست کنید.
.RE
.sp
\fB\-\-force\-resolution\fP
.RS 4
مجبور کردن حل‌کننده به یافتن یک راهکار (\fIحتی یک راهکار تهاجمی\fP) به جای سوال پرسیدن از کاربر.
.sp
به منظور انجام کار درخواستی، حل‌کننده مجاز است هر خط‌مشی که در حالت عادی فعال است را نقض کند. این شامل مجوز حذف بسته‌ها و همچنین عدم رعایت خط‌مشی‌هایی است که صریحاً تنظیم شده‌اند (توسط \fB\-\-no\-allow\fP\-\fIpolicy\fP یا در فایل‌های کانفیگ). \fBاستفاده از این گزینه در محیط‌های بدون نظارت توصیه نمی‌شود\fP.
.sp
مجوز حذف بسته‌های وابسته، هنگام حذف بسته‌ها (\fBzypper remove\fP) رفتار پیش‌فرض است.
.RE
.sp
\fB\-R\fP, \fB\-\-no\-force\-resolution\fP
.RS 4
حل‌کننده را به یافتن راهکار مجبور نمی‌کند؛ بلکه مشکلات وابستگی را گزارش کرده و از کاربر می‌خواهد آن‌ها را به صورت دستی حل کند. این حالت پیش‌فرض است، مگر هنگام حذف بسته‌ها (\fBzypper remove\fP).
.RE
.sp
\fB\-\-solver\-focus\fP \fIMODE\fP
.RS 4
تنظیم رویکرد کلی حل‌کننده هنگام حل یک کار. حالت‌های معتبر عبارتند از \fBJob\fP، \fBInstalled\fP یا \fBUpdate\fP. برای جزئیات، بخش \fBPackage Dependencies\fP را ببینید.
.RE
.sp
\fB\-\-recommends\fP
.RS 4
علاوه بر بسته‌های لازم (required)، بسته‌های توصیه‌شده (recommended) را نیز نصب می‌کند. رفتار پیش‌فرض توسط [zypp.conf:solver.onlyRequires] تعیین می‌شود.
.RE
.sp
\fB\-\-no\-recommends\fP
.RS 4
بسته‌های توصیه‌شده را نصب نمی‌کند، بلکه تنها بسته‌های لازم را نصب می‌نماید. رفتار پیش‌فرض توسط [zypp.conf:solver.onlyRequires] تعیین می‌شود.
.RE
.sp
گزینه‌های پیشرفته (Expert Options):
.RS 4
از آن‌ها استفاده نکنید مگر اینکه مطمئن باشید به آن‌ها نیاز دارید.
.RE
.sp
\fB\-\-allow\-downgrade\fP, \fB\-\-no\-allow\-downgrade\fP
.RS 4
آیا تنزل نسخه مولفه‌های قابل‌حل نصب‌شده مجاز باشد یا خیر.
.RE
.sp
\fB\-\-allow\-name\-change\fP, \fB\-\-no\-allow\-name\-change\fP
.RS 4
آیا تغییر نام مولفه‌های قابل‌حل نصب‌شده مجاز باشد یا خیر. تنظیم این گزینه روی \fBno\fP بسته‌هایی را که تغییر نام یافته‌اند جایگزین نخواهد کرد.
.RE
.sp
\fB\-\-allow\-arch\-change\fP, \fB\-\-no\-allow\-arch\-change\fP
.RS 4
آیا تغییر معماری مولفه‌های قابل‌حل نصب‌شده مجاز باشد یا خیر.
.RE
.sp
\fB\-\-allow\-vendor\-change\fP, \fB\-\-no\-allow\-vendor\-change\fP
.RS 4
آیا تغییر ارائه‌دهنده مولفه‌های قابل‌حل نصب‌شده مجاز باشد یا خیر. تنظیم این گزینه روی \fBno\fP ممکن است زمانی مفید باشد که نمی‌خواهید بسته‌های مخازن خارجی به نسخه توزیع تغییر یابند (یا برعکس).
.RE
.sp
این دستور همچنین \fBگزینه‌های حالت بارگیری و نصب (Download\-and\-install mode options)\fP شرح داده شده در توضیحات دستور \fBinstall\fP را می‌پذیرد.
.RS 4

.RE
.sp
مثال‌ها (Examples):
.RS 4

.sp
$ \fBzypper dup \-\-from factory \-\-from packman\fP
.RS 4
ارتقای سیستم به آخرین نسخه‌های ارائه‌شده توسط مخازن \fIfactory\fP و \fIpackman\fP.
.RE
.RE
.SS "دستورات پرس‌وجو (Query Commands)"
.sp
\fBsearch\fP (\fBse\fP) [\fIoptions\fP] [\fIquerystring\fP|\fIcapability\fP].\|.\|.
.RS 4
جستجو برای بسته‌هایی که با هر یک از رشته‌های جستجوی ارائه‌شده مطابقت دارند. نویسه‌های جانشین (\fIwildcard\fP) \fB*\fP و \fB?\fP می‌توانند درون رشته‌های جستجو استفاده شوند. اگر رشته جستجو درون \fB/\fP محصور شده باشد (مانند \fB/^k.*e$/\fP)، به عنوان یک \fIعبارت باقاعده\fP (regular expression) تفسیر می‌شود. برای جزئیات در مورد نحوه مشخص کردن یک \fIقابلیت\fP (\fIcapability\fP)، دستور \fBinstall\fP را ببینید.
.sp
اگر رشته جستجو با یک \fB/\fP آغاز شود، نام یک فایل فرض می‌شود و جستجو به طور خودکار درون فهرست فایل‌های بسته‌ها را بررسی می‌کند. در غیر این صورت از \fB\-f\fP استفاده کنید تا در فهرست فایل‌های بسته‌ها نیز جستجو شود.
.sp
نتایج جستجو در یک جدول با ستون‌های وضعیت (\fBS\fPtatus)، نام (\fBName\fP)، خلاصه (\fBSummary\fP) و نوع (\fBType\fP) بسته چاپ می‌شوند. در صورتی که نتیجه پرس‌وجو خالی باشد، zypper مقدار \fBZYPPER_EXIT_INF_CAP_NOT_FOUND\fP را برمی‌گرداند، مگر اینکه گزینه سراسری \fB\-\-ignore\-unknown\fP تنظیم شده باشد.
.sp
در نمای پرجزئیات (\fBse \-s\fP)، تمام نمونه‌های موجود از بسته‌های منطبق نشان داده می‌شوند؛ هر نسخه در هر مخزن در یک خط جداگانه، با ستون‌های وضعیت (\fBS\fPtatus)، نام (\fBName\fP)، نوع (\fBType\fP)، نسخه (\fBVersion\fP)، معماری (\fBArch\fPitecture) و مخزن (\fBRepository\fP). برای بسته‌های نصب‌شده، ستون \fBRepository\fP یا مخزنی را نشان می‌دهد که دقیقاً نسخه نصب‌شده بسته را ارائه می‌دهد، یا اگر نسخه دقیق توسط هیچ مخزن شناخته‌شده‌ای ارائه نشود، \fB(System Packages)\fP (یا \fB@System\fP) را نمایش می‌دهد. آن دسته از بسته‌های نصب‌شده که توسط هیچ مخزنی ارائه نمی‌شوند، اغلب به عنوان ناخواسته (\fIunwanted\fP)، یتیم (\fIorphaned\fP) یا کنارگذاشته‌شده (\fIdropped\fP) مشخص می‌شوند.
.sp
ستون وضعیت (\fBS\fPtatus) می‌تواند شامل مقادیر زیر باشد:
.RS 4
.sp
\fBi+\fP
.RS 4
نصب‌شده به درخواست کاربر
.RE
.sp
\fBi\fP
.RS 4
نصب‌شده به‌صورت خودکار (توسط حل‌کننده وابستگی، بخش \fBبسته‌های به‌طور خودکار نصب‌شده (Automatically installed packages)\fP را ببینید)
.RE
.sp
\fBv\fP
.RS 4
نسخه متفاوتی نصب شده است
.RE
.sp
\fIempty\fP
.RS 4
هیچ‌کدام از موارد بالا
.RE
.sp
\fB!\fP
.RS 4
یک وصله در وضعیت مورد نیاز (\fBneeded\fP)
.RE
.sp

.RS 4

.RE
.sp
\&.\fBl\fP
.RS 4
اگر مورد قفل شده باشد در ستون ۲ نشان داده می‌شود (بخش \fBمدیریت قفل‌های بسته (Package Locks Management)\fP را ببینید)
.RE
.sp
\&.\fBP\fP
.RS 4
اگر مورد بخشی از یک PTF باشد (یک اصلاح موقت برنامه که باید به‌طور صریح انتخاب شود و در غیر این صورت در حل وابستگی در نظر گرفته نمی‌شود)، در ستون ۲ نمایش داده می‌شود.
.RE
.sp
\&.\fBR\fP
.RS 4
اگر مورد پس‌گرفته شده باشد (بخش \fBpatch\fP در قسمت \fBPackage Types\fP را ببینید)، در ستون ۲ نشان داده می‌شود.
.RE
.RE
.RE
.sp

.RS 4
وضعیت \fBv\fP فقط زمانی نشان داده می‌شود که نسخه یا مخزن اهمیت داشته باشد (گزینه‌های \fB\-\-details\fP یا \fB\-\-repo\fP را ببینید)، و نمونه نصب‌شده با نمونه فهرست‌شده از نظر نسخه یا مخزن متفاوت باشد.
.sp
نمای پرجزئیات (\fBse \-v\fP؛ که متضمن \fB\-s\fP است) همچنین خود موارد منطبق را درون متادیتای بسته‌ها نشان می‌دهد.
.sp
این دستور گزینه‌های زیر را می‌پذیرد:
.sp
\fB\-\-match\-substrings\fP
.RS 4
تطابق‌ها برای رشته‌های جستجو می‌توانند کلمات جزئی (زیررشته) باشند (پیش‌فرض).
.RE
.sp
\fB\-\-match\-words\fP
.RS 4
تطابق‌ها برای رشته‌های جستجو تنها می‌توانند کلمات کامل باشند.
.RE
.sp
\fB\-x\fP, \fB\-\-match\-exact\fP
.RS 4
برای نام دقیق بسته جستجو می‌کند.
.RE
.sp
\fB\-\-provides\fP
.RS 4
جستجو برای بسته‌هایی که رشته‌های جستجو را ارائه می‌دهند (provides).
.RE
.sp
\fB\-\-requires\fP
.RS 4
جستجو برای بسته‌هایی که به رشته‌های جستجو نیاز دارند (requires).
.RE
.sp
\fB\-\-recommends\fP
.RS 4
جستجو برای بسته‌هایی که رشته‌های جستجو را توصیه می‌کنند (recommends).
.RE
.sp
\fB\-\-suggests\fP
.RS 4
جستجو برای بسته‌هایی که رشته‌های جستجو را پیشنهاد می‌دهند (suggests).
.RE
.sp
\fB\-\-conflicts\fP
.RS 4
جستجو برای بسته‌هایی که با رشته‌های جستجو تضاد دارند (conflicts).
.RE
.sp
\fB\-\-obsoletes\fP
.RS 4
جستجو برای بسته‌هایی که رشته‌های جستجو را منسوخ می‌کنند (obsoletes).
.RE
.sp
\fB\-\-supplements\fP
.RS 4
جستجو برای بسته‌هایی که مکمل رشته‌های جستجو هستند (supplements).
.RE
.sp
\fB\-\-enhances\fP
.RS 4
جستجو برای بسته‌هایی که رشته‌های جستجو را بهبود می‌بخشند (enhances).
.RE
.sp
\fB\-\-provides\-pkg\fP
.RS 4
جستجو برای تمام بسته‌هایی که هر یک از نیازمندی‌های ارائه‌شده (provides) توسط بسته(های) منطبق با پارامترهای ورودی را ارائه می‌دهند.
.RE
.sp
\fB\-\-requires\-pkg\fP
.RS 4
جستجو برای تمام بسته‌هایی که به هر یک از نیازمندی‌های ارائه‌شده (provides) توسط بسته(های) منطبق با پارامترهای ورودی نیاز دارند.
.RE
.sp
\fB\-\-recommends\-pkg\fP
.RS 4
جستجو برای تمام بسته‌هایی که هر یک از نیازمندی‌های ارائه‌شده (provides) توسط بسته(های) منطبق با پارامترهای ورودی را توصیه می‌کنند.
.RE
.sp
\fB\-\-supplements\-pkg\fP
.RS 4
جستجو برای تمام بسته‌هایی که مکمل هر یک از نیازمندی‌های ارائه‌شده (provides) توسط بسته(های) منطبق با پارامترهای ورودی هستند.
.RE
.sp
\fB\-\-conflicts\-pkg\fP
.RS 4
جستجو برای تمام بسته‌هایی که با هر یک از بسته(های) منطبق با پارامترهای ورودی تضاد دارند.
.RE
.sp
\fB\-\-obsoletes\-pkg\fP
.RS 4
جستجو برای تمام بسته‌هایی که هر یک از بسته(های) منطبق با پارامترهای ورودی را منسوخ می‌کنند.
.RE
.sp
\fB\-\-suggests\-pkg\fP
.RS 4
جستجو برای تمام بسته‌هایی که هر یک از نیازمندی‌های ارائه‌شده (provides) توسط بسته(های) منطبق با پارامترهای ورودی را پیشنهاد می‌دهند.
.RE
.sp
\fB\-\-enhances\-pkg\fP
.RS 4
جستجو برای تمام بسته‌هایی که هر یک از نیازمندی‌های ارائه‌شده (provides) توسط بسته(های) منطبق با پارامترهای ورودی را بهبود می‌بخشند.
.RE
.sp
\fB\-n\fP, \fB\-\-name\fP
.RS 4
همراه با گزینه‌های وابستگی کاربرد دارد، در غیر این صورت جستجو در نام بسته پیش‌فرض است.
.RE
.sp
\fB\-f\fP, \fB\-\-file\-list\fP
.RS 4
جستجو در فهرست فایل‌های بسته‌ها. توجه داشته باشید که فهرست کامل فایل‌ها فقط برای بسته‌های نصب‌شده موجود است. برای بسته‌های راه دور فقط خلاصه‌ای از فهرست فایل‌های آن‌ها در متادیتا موجود است (فایل‌های حاوی /etc/، /bin/ یا /sbin/).
.RE
.sp
\fB\-d\fP, \fB\-\-search\-descriptions\fP
.RS 4
جستجو در خلاصه‌ها و توضیحات نیز انجام شود.
.RE
.sp
\fB\-C\fP, \fB\-\-case\-sensitive\fP
.RS 4
انجام جستجوی حساس به بزرگی و کوچکی حروف.
.RE
.sp
\fB\-i\fP, \fB\-\-installed\-only\fP
.RS 4
نمایش فقط بسته‌های نصب‌شده.
.RE
.sp
\fB\-u\fP, \fB\-\-not\-installed\-only\fP
.RS 4
نمایش فقط بسته‌هایی که نصب نشده‌اند.
.sp
نام قدیمی گزینه \-\-uninstalled\-only همچنان قابل قبول است، اما باید منسوخ تلقی شود.
.RE
.sp
\fB\-t\fP, \fB\-\-type\fP \fItype\fP
.RS 4
جستجو فقط برای بسته‌هایی از نوع مشخص‌شده. برای مشاهده فهرست انواع بسته‌های موجود، بخش \fBPackage Types\fP را ببینید. استفاده هم‌زمان از چندین گزینه \fB\-\-type\fP مجاز است.
.sp
همچنین دستورات پرس‌وجوی ویژه هر نوع مانند \fBpackages\fP، \fBpatterns\fP و غیره را ببینید.
.RE
.sp
\fB\-r\fP, \fB\-\-repo\fP \fIalias\fP|\fIname\fP|\fI#\fP|\fIURI\fP
.RS 4
تنها با مخزن مشخص‌شده توسط نام مستعار، نام، شماره یا URI کار می‌کند. این گزینه می‌تواند چندین بار استفاده شود.
.RE
.sp
\fB\-\-sort\-by\-name\fP
.RS 4
مرتب‌سازی بسته‌ها بر اساس نام (پیش‌فرض).
.RE
.sp
\fB\-\-sort\-by\-repo\fP
.RS 4
مرتب‌سازی بسته‌ها بر اساس مخزن، نه بر اساس نام.
.RE
.sp
\fB\-s\fP, \fB\-\-details\fP
.RS 4
نمایش تمام نسخه‌های موجود از بسته‌های منطبق، هر نسخه در هر مخزن در یک خط جداگانه.
.RE
.sp
\fB\-v\fP, \fB\-\-verbose\fP
.RS 4
مانند \fB\-\-details\fP همراه با اطلاعات اضافی درباره مکان‌هایی که جستجو در آن‌ها مطابقت یافته است (مفید هنگام جستجو برای وابستگی‌ها، مانند \fB\-\-provides\fP).
.RE
.sp
مثال‌ها:
.RS 4

.sp
$ \fBzypper se \*(Aqyast*\*(Aq\fP
.RS 4
جستجو برای بسته‌های YaST (رشته را در علامت نقل‌قول قرار دهید تا شل نویسه جانشین را بسط ندهد).
.RE
.sp
$ \fBzypper se \-s \-\-match\-exact kernel\-default\fP
.RS 4
نمایش تمامی نسخه‌های موجود بسته kernel\-default
.RE
.sp
$ \fBzypper se \-dC \-\-match\-words RSI\fP
.RS 4
جستجوی سرواژه RSI (به‌صورت حساس به حروف بزرگ و کوچک)، همچنین درون خلاصه‌ها و توضیحات.
.RE
.RE
.RE
.sp
\fBpackages\fP (\fBpa\fP) [\fIoptions\fP] [\fIrepository\fP].\|.\|.
.RS 4
فهرست کردن تمام بسته‌های موجود یا تمام بسته‌های مخازن مشخص‌شده. مشابه \fBzypper search \-s \-t package\fP.
.sp
\fB\-r\fP, \fB\-\-repo\fP \fIalias\fP|\fIname\fP|\fI#\fP|\fIURI\fP
.RS 4
روش دیگری برای مشخص کردن مخازن.
.RE
.sp
\fB\-i\fP, \fB\-\-installed\-only\fP
.RS 4
نمایش فقط بسته‌های نصب‌شده.
.RE
.sp
\fB\-u\fP, \fB\-\-not\-installed\-only\fP
.RS 4
نمایش فقط بسته‌هایی که نصب نشده‌اند.
.sp
نام قدیمی گزینه \-\-uninstalled\-only همچنان قابل قبول است، اما باید منسوخ تلقی شود.
.RE
.sp
*\-\-autoinstalled
.RS 4
نمایش بسته‌های نصب‌شده‌ای که به‌طور خودکار توسط حل‌کننده وابستگی انتخاب شده‌اند.
.RE
.sp
\fB\-\-userinstalled\fP
.RS 4
نمایش بسته‌های نصب‌شده‌ای که به‌طور صریح توسط کاربر انتخاب شده‌اند.
.RE
.sp
\fB\-\-system\fP
.RS 4
نمایش بسته‌های نصب‌شده‌ای که توسط هیچ مخزنی ارائه نمی‌شوند.
.RE
.sp
\fB\-\-orphaned\fP
.RS 4
نمایش بسته‌های سیستمی که یتیم (orphaned) هستند (بدون مخزن و بدون کاندیدای به‌روزرسانی). در صورت ترکیب با \fB\-\-system\fP، وضعیت بسته‌های یتیم با برچسب \fB(o)\fP مشخص می‌شود.
.RE
.sp
\fB\-\-suggested\fP
.RS 4
نمایش بسته‌هایی که پیشنهاد شده‌اند.
.RE
.sp
\fB\-\-recommended\fP
.RS 4
نمایش بسته‌هایی که توصیه شده‌اند.
.RE
.sp
\fB\-\-unneeded\fP
.RS 4
نمایش بسته‌هایی که غیرضروری هستند.
.RE
.RE
.sp
\fBpatches\fP (\fBpch\fP) [\fIoptions\fP] [\fIrepository\fP].\|.\|.
.RS 4
فهرست کردن تمام وصله‌های موجود از مخازن مشخص‌شده، شامل مواردی که مورد نیاز نیستند. کوتاه‌شده‌ی \fBzypper lp \-a\fP.
.sp
\fB\-r\fP, \fB\-\-repo\fP \fIalias\fP|name_|\fI#\fP|\fIURI\fP
.RS 4
روش دیگری برای مشخص کردن مخازن.
.RE
.RE
.sp
\fBpatterns\fP (\fBpt\fP) [\fIoptions\fP] [\fIrepository\fP].\|.\|.
.RS 4
فهرست کردن تمام الگوهای موجود یا تمام الگوها از مخازن مشخص‌شده. مشابه \fBzypper search \-s \-t pattern\fP.
.sp
\fB\-r\fP, \fB\-\-repo\fP \fIalias\fP|\fIname\fP|\fI#\fP|\fIURI\fP
.RS 4
روش دیگری برای مشخص کردن مخازن.
.RE
.sp
\fB\-i\fP, \fB\-\-installed\-only\fP
.RS 4
نمایش فقط الگوهای نصب‌شده.
.RE
.sp
\fB\-u\fP, \fB\-\-not\-installed\-only\fP
.RS 4
نمایش فقط الگوهایی که نصب نشده‌اند.
.sp
نام قدیمی گزینه \-\-uninstalled\-only همچنان قابل قبول است، اما باید منسوخ تلقی شود.
.RE
.RE
.sp
\fBproducts\fP (\fBpd\fP) [\fIoptions\fP] [\fIrepository\fP].\|.\|.
.RS 4
فهرست کردن تمام محصولات موجود یا تمام محصولات از مخازن مشخص‌شده. مشابه \fBzypper search \-s \-t product\fP، اما نوع محصول (\fBbase\fP، \fBadd\-on\fP) را نیز نشان می‌دهد.
.sp
\fB\-r\fP, \fB\-\-repo\fP \fIalias\fP|\fIname\fP|\fI#\fP|\fIURI\fP
.RS 4
روش دیگری برای مشخص کردن مخازن.
.RE
.sp
\fB\-i\fP, \fB\-\-installed\-only\fP
.RS 4
نمایش فقط محصولات نصب‌شده.
.RE
.sp
\fB\-u\fP, \fB\-\-not\-installed\-only\fP
.RS 4
نمایش فقط محصولاتی که نصب نشده‌اند.
.sp
نام قدیمی گزینه \-\-uninstalled\-only همچنان قابل قبول است، اما باید منسوخ تلقی شود.
.RE
.sp
\fB\-\-xmlfwd\fP \fItag\fP
.RS 4
تنها در خروجی XML: تگ XML با نام \fItag\fP را، در صورتی که در فایل prod.\- یک محصول نصب‌شده (در \fB/etc/products.d\fP) یافت شود، دقیقاً به خروجی فوروارد می‌کند.
.sp
با استفاده از این گزینه، برای هر محصول نصب‌شده یک گره \fB<xmlfwd>\fP در داخل گره خروجی \fB<product>\fP آن محصول ایجاد می‌شود.
.sp
آرگومان Tag نام (یا مسیر جداشده با \fI/\fP) یک تگ xml درون فایل prod.\- محصول نصب‌شده را مشخص می‌کند. اگر این تگ درون فایل prod.\- محصول وجود داشته باشد، تگ و محتوای آن دقیقاً به گره خروجی \fB<xmlfwd>\fP محصول هدایت می‌شود.
.sp
این گزینه می‌تواند چندین بار مشخص شود.
.RE
.sp
مثال‌ها:
.RS 4

.sp
$ \fBzypper \-x pd \-\-xmlfwd name \-\-xmlfwd register/target\fP
.RS 4

.RE
.RE
.RE
.sp
\fBwhat\-provides\fP (\fBwp\fP) \fIcapability\fP
.RS 4
فهرست کردن تمام بسته‌های ارائه‌دهنده قابلیت مشخص‌شده (جستجوی غیرحساس به حروف بزرگ و کوچک). همچنین برای اطلاعات درباره تعیین \fIقابلیت‌ها\fP دستور \fBinstall\fP را ببینید.
.sp
خط فرمان به‌طور خودکار به دستور متناظر \fBsearch\fP تبدیل می‌شود:
.RS 4

.sp
$ \fBzypper what\-provides \*(Aqzypper>1.6\*(Aq\fP
.RS 4
$ \fBzypper search \-\-provides \-\-match\-exact \*(Aqzypper>1.6\*(Aq\fP
.RE
.sp
برای یک جستجوی حساس به بزرگی و کوچکی حروف، اجرا کنید:
.RS 4
$ \fBzypper search \-\-provides \-\-match\-exact \-\-case\-sensitive \*(Aqzypper>1.6\*(Aq\fP
.RE
.RE
.RE
.SS "مدیریت مخازن (Repository Management)"
.sp
زیپر قادر به کار با مخازن نرم‌افزاری YaST، RPM\-MD (yum) و پوشه‌های ساده حاوی فایل‌های rpm. (بدون پیوند نمادین) است.
.sp
مخازن در درجه اول با استفاده از \fIURI\fP یا نام مستعار (\fIalias\fP) خود شناسایی می‌شوند. نام مستعار به عنوان نامی کوتاه برای URI طولانی یا نام مخزن عمل می‌کند. نام (\fIname\fP) مخزن باید مخزن را به‌طور خلاصه توصیف کند و در جدول‌ها و پیام‌ها به کاربر نشان داده می‌شود. نام الزامی نیست و اگر مشخص نشده باشد، نام مستعار به‌جای آن نشان داده می‌شود. نام مستعار الزامی است و مخزن را به‌طور یکتا روی سیستم شناسایی می‌کند.
.sp
می‌توان از نام مستعار (\fIalias\fP)، نام (\fIname\fP)، \fIURI\fP، یا شماره (\fInumber\fP) برگرفته از فهرست \fBzypper repos\fP برای مشخص کردن یک مخزن به عنوان آرگومان دستورات و گزینه‌های مختلف زیپر مانند \fBrefresh\fP، \fB\-\-repo\fP، یا \fB\-\-from\fP استفاده کرد.
.sp
جدا از موارد بالا، مخازن چندین ویژگی دیگر دارند که می‌توان آن‌ها را با استفاده از دستورات شرح‌داده‌شده در این بخش زیر تنظیم کرد، یا با ویرایش دستی فایل‌های تعریف مخزن (فایل‌های \fB.repo\fP، بخش \fBفایل‌ها (FILES)\fP را ببینید).
.SS "جایگزینی متغیرها (Variable substitution):"
.sp
می‌توانید از متغیرهای زیر درون مقادیر \fIname\fP و \fIURI\fP در فایل‌های \fB.repo\fP یا \fB.service\fP استفاده کنید:
.sp
\fB$arch\fP
.RS 4
از این متغیر برای اشاره به معماری CPU سیستم استفاده کنید.
.RE
.sp
\fB$basearch\fP
.RS 4
از این متغیر برای اشاره به معماری پایه سیستم استفاده کنید. به عنوان مثال، سیستم‌های iX86 دارای معماری پایه \fBi386\fP هستند، در حالی که AMD64 و Intel64 دارای \fBx86_64\fP هستند.
.RE
.sp
\fB$releasever\fP, \fB$releasever_major\fP, \fB$releasever_minor\fP
.RS 4
از این متغیر برای اشاره به نسخه openSUSE یا SUSE Linux خود استفاده کنید. این مقدار از گره XML مربوط به \fI/product/version\fP در \fB/etc/products.d/baseproduct\fP به دست می‌آید.
.sp
این ویژگی برای مخازن مرتبط مانند پک‌من (\fBhttp://ftp.gwdg.de/pub/linux/packman/suse/$releasever\fP) مفید است که باید همیشه با توزیع نصب‌شده سازگار باشند، حتی پس از ارتقای توزیع.
.sp
برای تسهیل انجام ارتقای توزیع، مقدار \fB$releasever\fP را می‌توان با ایجاد یک متغیر سفارشی با همین نام (در زیر ببینید) به‌طور دائمی روی یک مقدار تعریف‌شده توسط کاربر تنظیم کرد. به این ترتیب می‌توانید به راحتی همه مخازن استفاده‌کننده از \fB$releasever\fP را به نسخه جدید منتقل کنید (به شرطی که ساختار سرور تغییر نکرده باشد و مخازن جدید از قبل در دسترس باشند).
.sp
برای یک دستور تکی زیپر، مقدار \fB$releasever\fP را می‌توان با استفاده از گزینه سراسری \fB\-\-releasever\fP به‌طور موقت رونویسی کرد.
.sp
علاوه بر این، \fB$releasever_major\fP روی بخش ابتدایی تا نقطه اول (بدون احتساب خود نقطه) تنظیم می‌شود؛ و \fB$releasever_minor\fP روی بخش انتهایی پس از نقطه اول تنظیم خواهد شد. اگر نقطه‌ای در \fB$releasever\fP وجود نداشته باشد، \fB$releasever_major\fP با \fB$releasever\fP برابر خواهد بود و \fB$releasever_minor\fP خالی می‌ماند.
.RE
.sp
\fBمتغیرهای سفارشی (Custom Variables)\fP
.RS 4
یک متغیر سفارشی مخزن با ایجاد یک فایل در \fB/etc/zypp/vars.d\fP تعریف می‌شود. نام متغیر برابر با نام فایل است. خط اول فایل (تا قبل از نویسه خط جدید) مقدار متغیر را تعیین می‌کند. نام‌های معتبر برای متغیر (فایل) فقط شامل حروف و ارقام و زیرخط هستند.
.RE
.sp
به این صورت می‌توانید یک متغیر سفارشی، مثلاً \fB$releasever\fP را روی مقدار \fB99.0\fP تنظیم کنید:
.RS 4
\fBecho "99.0" >/etc/zypp/vars.d/releasever\fP
.RE
.sp
برای حذف متغیر سفارشی، به سادگی فایل آن را در \fB/etc/zypp/vars.d\fP حذف کنید:
.RS 4
\fBrm /etc/zypp/vars.d/releasever\fP
.RE
.sp
برای بررسی جاهایی که در حال حاضر از \fB$releasever\fP استفاده می‌کنید، اجرا کنید:
.RS 4
\fBzypper \-\-releasever @\-\-HERE\-\-@ lr \-u\fP
.RE
.sp
به یاد داشته باشید که هنگام استفاده از این متغیرها در خط فرمان شل، کاراکتر \fB$\fP را محافظت (escape) کنید:
.RS 4
zypper ar \-f http://ftp.gwdg.de/pub/linux/packman/suse/\fB\(rs$\fPreleasever packman
.RE
.sp
اگر پس از یک متغیر نویسه‌ای الفبانومریک یا زیرخط بیاید، باید در \fB{}\fP محصور شود:
.RS 4
zypper ar \-f http://ftp.gwdg.de/pub/linux/packman/suse/\fB\(rs${\fP\fIreleasever\fP\fB}\fP_packman
.RE
.sp
تعریف مقدار پیش‌فرض \fB${\fP\fIvariable\fP\fB:\-\fP\fIword\fP\fB}\fP و جایگزین \fB${\fP\fIvariable\fP\fB:+\fP\fIword\fP\fB}\fP به سبک بش:
.RS 4
SLE\-\fB${\fP\fIreleasever_major\fP\fB}${\fP\fIreleasever_minor\fP\fB:+\fP\-SP\-\fI$releasever_minor\fP\fB}\fP
.RE
.sp
نکته:
.RS 4
جایگزینی متغیر در بخش authority یک URI تنها به \fBhost\fP و \fBport\fP محدود می‌شود. تعریف مقادیر پیش‌فرض و جایگزین به سبک بش پشتیبانی نمی‌شود. در بخش‌های \fBscheme\fP، \fBuser\fP و \fBpassword\fP یک URI نمی‌توان از متغیرها استفاده کرد.
.RE
.SS "قالب‌های URI پشتیبانی‌شده (Supported URI formats):"
.sp
\fIscheme\fP\fB:\fP\fB@\fP]\fIhost\fP[\fB:\fP\fIport\fP]]\fB/\fP\fIpath\fP[\fB?\fP\fIquery\fP][\fB#\fP\fIfragment\fP]
.RS 4
نویسه‌های خاص موجود در مؤلفه‌های URI (مانند یک \*(Aq\fB@\fP\*(Aq در گذرواژه) باید به‌صورت کدگذاری درصدی %\-encoded (مانند \*(Aq\fB%40\fP\*(Aq) نوشته شوند.
.RE
.sp
درایو CD یا DVD
.RS 4
به‌طور اختیاری همراه با فهرست \fIdevices\fP برای بررسی و شناسایی.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fBcd:///\fP
.br
\fBdvd:/subdir\fP\fI?devices=/dev/sr0,/dev/sr1\fP
.RE
.RE
.sp
درخت پوشه FTP/HTTP/HTTPS
.RS 4
طرحواره نشانی وب ftp از مسیرهای مطلق و نسبی نسبت به پوشه پیش‌فرض سرور ftp پشتیبانی می‌کند (RFC1738، بخش 3.2.2). برای استفاده از یک مسیر مطلق، باید در ابتدای مسیر یک اسلش اضافی قرار دهید، که منجر به ترکیب \fB/%2f\fP (اسلش دوم کدگذاری‌شده به صورت \fB%2f\fP) در ابتدای مسیر URL می‌شود. این امر به‌ویژه در ftp با احراز هویت کاربر اهمیت دارد، جایی که پوشه خانگی کاربر معمولاً پوشه پیش‌فرض سرور است (مگر زمانی که سرور در پوشه خانگی کاربر chroot کند).
.sp
تنظیمات صریح پروکسی را می‌توان از طریق پارامترهای اختیاری \fIproxy\fP، \fIproxyport\fP، \fIproxyuser\fP و \fIproxypass\fP ارسال کرد.
.sp
روش‌های احراز هویت HTTP قابل استفاده را می‌توان به عنوان یک فهرست جداشده با کاما از طریق پارامتر اختیاری \fIauth\fP تعیین کرد. روش‌های معتبر به عنوان مثال شامل \fIbasic\fP، \fIdigest\fP، \fIntlm\fP، \fInegotiate\fP هستند. توجه داشته باشید که این فهرست به روش‌های پشتیبانی‌شده توسط کتابخانه curl وابسته است.
.sp
رفتار اعتبارسنجی SSL را می‌توان با استفاده از گزینه \fIssl_verify\fP تغییر داد (از این گزینه باید با احتیاط استفاده شود). مقادیر معتبر عبارتند از \fByes\fP (پیش‌فرض امن)، \fBhost\fP، \fBpeer\fP یا \fBno\fP. مقدار \fIHost\fP فقط بررسی می‌کند که فیلد "Common Name" یا فیلد "Subject Alternate Name" در گواهی سرور با نام میزبان موجود در URL مطابقت داشته باشد. مقدار \fIPeer\fP فقط اصالت گواهی ارائه‌شده توسط سرور را در برابر زنجیره امضاهای دیجیتال موجود در ssl_capath تایید می‌کند. مقدار \fINo\fP هیچ بررسی انجام نمی‌دهد. مقدار \fIYes\fP پیش‌فرض امن است که بررسی‌های host و peer را با هم انجام می‌دهد.
.sp
برای احراز هویت با گواهی کلاینت SSL، از گزینه‌های \fIssl_clientcert\fP برای مشخص کردن مسیر گواهی کلاینت ssl و \fIssl_clientkey\fP برای مشخص کردن مسیر کلید کلاینت SSL استفاده کنید. از \fIssl_capath\fP برای تغییر پوشه حاوی گواهی‌های CA استفاده کنید (پیش‌فرض \fB/etc/ssl/certs\fP است).
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fBftp://user:pass@server/path/to/media/dir\fP
.br
\fBftp://user:pass@server/%2fhome/user/path/to/media/dir\fP
.br
\fBhttp://user:pass@server/path\fP
.br
\fBhttps://user:pass@server/path\fP\fI?proxy=foo&proxyuser=me&proxypass=pw\fP
.br
\fBhttps://server/path\fP\fI?ssl_clientcert=/entitlement/1234.pem&ssl_clientkey=/entitlement/1234\-key.pem\fP
.RE
.RE
.sp
حجم دیسک (پارتیشن)
.RS 4
پارامتر اجباری \fBdevice\fP نام دستگاه بلوکی را برای سوار کردن (mount) مشخص می‌کند. نام اختیاری \fIfilesystem\fP به طور پیش‌فرض "auto" است.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fBhd:/subdir?device=/dev/sda1\fP\fI&filesystem=reiserfs\fP
.RE
.RE
.sp
درخت پوشه محلی
.RS 4
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fBdir:/directory/name\fP
.RE
.RE
.sp
رسانه در یک تصویر ISO (سوارشده به‌صورت loopback)
.RS 4
پارامتر اجباری \fBiso\fP نام فایل iso را مشخص می‌کند. پارامتر اختیاری \fIurl\fP نشانی URL پوشه حاوی فایل iso را مشخص می‌کند. پارامتر اختیاری \fImnt\fP نقطه اتصال ترجیحی را برای نشانی منبع رسانه مشخص می‌کند. نام اختیاری \fIfilesystem\fP سیستم‌فایل استفاده‌شده در فایل iso را مشخص می‌کند و به طور پیش‌فرض "auto" است.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fBiso:/?iso=CD1.iso\fP\fI&url=nfs://server/path/to/media\fP
.br
\fBiso:/?iso=CD1.iso\fP\fI&url=hd:/?device=/dev/hda\fP
.br
\fBiso:/subdir?iso=DVD1.iso\fP\fI&url=nfs://nfs\-server/directory&mnt=/nfs/attach/point&filesystem=udf\fP
.RE
.RE
.sp
درخت پوشه به اشتراک گذاشته‌شده با NFS
.RS 4
برای استفاده از NFSv4 یا از طرحواره \fItnfsv4://\fP استفاده کنید یا پارامتر اختیاری \fItype=nfs4\fP را پاس دهید. گزینه‌های اضافی سوار کردن (\fImountoptions\fP) را می‌توان به صورت یک فهرست جداشده با کاما ارسال کرد. مقدار پیش‌فرض "ro" (فقط‌خواندنی) است.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fBnfs://nfs\-server/exported/path\fP
.br
\fBnfs://nfs\-server/exported/path\fP\fI?mountoptions=ro&type=nfs4\fP
.br
\fBnfs4://nfs\-server/exported/path\fP\fI?mountoptions=ro\fP
.RE
.RE
.sp
درخت پوشه CIFS/SMB
.RS 4
دیگر تفاوتی میان طرحواره cifs و smb وجود ندارد. در هر دو حالت از سیستم‌فایل \fIcifs\fP استفاده می‌شود. گزینه‌های اضافی سوار کردن (\fImountoptions\fP) را می‌توان به صورت یک فهرست جداشده با کاما ارسال کرد. مقدار پیش‌فرض "ro,guest" است. برای غیرفعال کردن "guest" مقدار "noguest" را مشخص کنید. این کار زمانی ضروری است که Samba طوری پیکربندی شده باشد که اتصالات مهمان را رد کند.
.sp
پارامتر اختیاری \fIworkgroup\fP یا \fIdomain\fP نام workgroup را مشخص می‌کند. به عنوان جایگزینی برای ارسال \fIusername:password\fP در بخش authority نشانی URI، می‌توان از پارامترهای \fIuser\fP و \fIpass\fP استفاده کرد.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fBsmb://servername/share/path/on/the/share\fP
.br
\fBcifs://usern:passw@servername/share/path/on/the/share\fP\fI?mountoptions=ro,noguest\fP
.br
\fBcifs://usern:passw@servername/share/path/on/the/share\fP\fI?workgroup=mygroup\fP
.br
\fBcifs://servername/share/path/on/the/share\fP\fI?user=usern&pass=passw\fP
.RE
.RE
.sp
مخازن سرویس ساخت اوپن‌سوزه (OBS - OpenSUSE Build Service)
.RS 4
زیپر همچنین URIهای ویژه‌ای را که مخازن سرویس ساخت اوپن‌سوزه (OBS) را مشخص می‌کنند در دستور \fBaddrepo\fP می‌پذیرد. این URIها به شکل \fBobs://\fP\fIproject\fP\fB/\fP[\fIplatform\fP] هستند، که در آن \fIproject\fP نام پروژه OBS و \fIplatform\fP پلتفرم مقصد (سیستم‌عامل) است که مخزن برای آن در نظر گرفته شده است.
.sp
اگر \fIplatform\fP حذف شود، از \fBopenSUSE_$releasever\fP استفاده می‌شود مگر اینکه مقداری برای \fBobs.platform\fP در zypper.conf تعریف شده باشد. اگر از \fBopenSUSE_Factory\fP یا \fBopenSUSE_Tumbleweed\fP پیروی می‌کنید، ممکن است لازم باشد این‌ها را به عنوان پلتفرم پیش‌فرض خود تنظیم کنید. اما ما فقط می‌توانیم حدس بزنیم که پوشه حاوی مخزن متناسب با توزیع شما روی سرور چگونه نام‌گذاری شده است. در صورت شک، باید URL مناسب را در یک مرورگر بررسی کنید.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\fBobs://zypp:Head/\fP
.br
\fBobs://zypp:Head/openSUSE_Factory\fP
.br
\fBobs://zypp:Head/openSUSE_Factory_Staging_Gcc49_standard\fP
.RE
.RE
.SS "دستورها (Commands):"
.sp
\fBaddrepo\fP (\fBar\fP) [\fIoptions\fP] \fIURI\fP \fIalias\fP
.RS 4

.RE
.sp
\fBaddrepo\fP (\fBar\fP) [\fIoptions\fP] \fIFILE\fP*.repo*
.RS 4
یک مخزن جدید مشخص‌شده توسط URI اضافه می‌کند و نام مستعار مشخص‌شده را به آن اختصاص می‌دهد، یا URI یک فایل .repo را مشخص می‌کند.
.sp
مخازن تازه‌افزوده‌شده به صورت پیش‌فرض بازخوانی خودکار (auto\-refresh) غیرفعال دارند (به جز مخازنی که از یک فایل .repo درون‌ریزی شده‌اند که بازخوانی خودکار در آن‌ها فعال است). برای فعال‌سازی بازخوانی خودکار از \fBaddrepo \-f\fP یا گزینه \fB\-\-refresh\fP دستور \fBmodifyrepo\fP استفاده کنید.
.sp
همچنین این دستور مخازن تازه‌افزوده‌شده را به طور خودکار بازخوانی نمی‌کند. مخازن در اولین باری که استفاده شوند بازخوانی خواهند شد، یا می‌توانید پس از پایان تغییرات خود با دستورات \fB*repo\fP، از دستور \fBrefresh\fP استفاده کنید.
.sp
\fB\-r\fP, \fB\-\-repo\fP \fIfile\fP\fB.repo\fP
.RS 4
خواندن URI و نام مستعار از فایل .repo مشخص‌شده
.RE
.sp
\fB\-c\fP, \fB\-\-check\fP
.RS 4
بررسی و سنجش URI داده‌شده.
.RE
.sp
\fB\-C\fP, \fB\-\-no\-check\fP
.RS 4
عدم بررسی URI؛ سنجش بعداً در زمان بازخوانی انجام می‌شود.
.RE
.sp
\fB\-n\fP, \fB\-\-name\fP \fIname\fP
.RS 4
تعیین نام توصیفی برای مخزن.
.RE
.sp
\fB\-e\fP, \fB\-\-enable\fP
.RS 4
فعال‌سازی مخزن (پیش‌فرض).
.RE
.sp
\fB\-d\fP, \fB\-\-disable\fP
.RS 4
افزودن مخزن به صورت غیرفعال. مخازن به صورت پیش‌فرض فعال اضافه می‌شوند.
.RE
.sp
\fB\-f\fP, \fB\-\-refresh\fP
.RS 4
فعال‌سازی بازخوانی خودکار مخزن. بازخوانی خودکار هنگام افزودن مخازن جدید به صورت پیش‌فرض غیرفعال است.
.RE
.sp
\fB\-F\fP, \fB\-\-no\-refresh\fP
.RS 4
غیرفعال‌سازی بازخوانی خودکار مخزن.
.RE
.sp
\fB\-p\fP, \fB\-\-priority\fP \fI[1\-2147483647]\fP|\fI0\fP
.RS 4
تنظیم اولویت مخزن. اولویت \fB1\fP بالاترین و \fB2147483647\fP پایین‌ترین است.
\fB\-p 0\fP اولویت را به مقدار پیش‌فرض (\fB99\fP) بازمی‌گرداند.
بسته‌های حاصل از مخازن با اولویت بالاتر استفاده خواهند شد، حتی اگر نسخه‌های بهتری در مخزنی با اولویت پایین‌تر موجود باشند.
.RE
.sp
\fB\-k\fP, \fB\-\-keep\-packages\fP
.RS 4
فعال‌سازی حافظه موقت (کش) فایل‌های RPM برای مخزن.
.RE
.sp
\fB\-K\fP, \fB\-\-no\-keep\-packages\fP
.RS 4
غیرفعال‌سازی حافظه موقت (کش) فایل‌های RPM.
.RE
.sp
\fB\-g\fP, \fB\-\-gpgcheck\fP
.RS 4
فعال‌سازی بررسی GPG برای این مخزن. رفتار آن در بخش \fBGPG checks\fP شرح داده شده است.
.RE
.sp
\fB\-\-gpgcheck\-strict\fP
.RS 4
فعال‌سازی بررسی سخت‌گیرانه GPG برای این مخزن. حتی بسته‌های حاصل از مخازن امضاشده نیز نیازمند امضای GPG معتبر هستند و استفاده از بسته‌های امضانشده باید تأیید شود.
.RE
.sp
\fB\-\-gpgcheck\-allow\-unsigned\fP
.RS 4
حالت خلاصه برای \fB\-\-gpgcheck\-allow\-unsigned\-repo \-\-gpgcheck\-allow\-unsigned\-package\fP
.RE
.sp
\fB\-\-gpgcheck\-allow\-unsigned\-repo\fP
.RS 4
فعال‌سازی بررسی GPG اما اجازه دادن به امضانشده بودن متاداده‌های مخزن.
.RE
.sp
\fB\-\-gpgcheck\-allow\-unsigned\-package\fP
.RS 4
فعال‌سازی بررسی GPG اما اجازه دادن به نصب بسته‌های امضانشده از این مخزن.
.RE
.sp
\fB\-G\fP, \fB\-\-no\-gpgcheck\fP
.RS 4
غیرفعال‌سازی بررسی GPG برای این مخزن.
.sp
\fBغیرفعال کردن بررسی‌های GPG توصیه نمی‌شود.\fP امضای داده‌ها گیرنده را قادر می‌سازد بررسی کند که پس از امضای داده‌ها هیچ تغییری رخ نداده است. پذیرش داده‌های بدون امضا، دارای امضای نادرست یا ناشناخته می‌تواند منجر به آسیب‌دیدگی سیستم و در موارد حاد حتی به خطر افتادن امنیت سیستم شود.
.RE
.sp
\fB\-\-default\-gpgcheck\fP
.RS 4
استفاده از تنظیمات سراسری بررسی GPG تعریف‌شده در \fB/etc/zypp/zypp.conf\fP. این مقدار پیش‌فرض است.
.sp
مگر اینکه تنظیمات zypp.conf خود را تغییر داده باشید، این همان \fB\-\-gpgcheck\fP است که رفتار آن در بخش \fBGPG checks\fP توصیف شده است.
.RE
.sp
مثال‌ها:
.RS 4

.sp
$ \fBzypper ar \-c \-n \*(AqPackman 11.1 repo\*(Aq http://packman.iu\-bremen.de/suse/11.1 packman\fP
.RS 4
یک مخزن HTTP اضافه می‌کند، آن را می‌سنجد، نام آن را \fIPackman 11.1 repo\fP می‌گذارد و از \fIpackman\fP به عنوان نام مستعار استفاده می‌کند.
.RE
.sp
$ \fBzypper ar https://download.opensuse.org/repositories/zypp:/svn/openSUSE_Factory/zypp:svn.repo\fP
.RS 4

.RE
.sp
$ \fBzypper ar myreposbackup.repo\fP
.RS 4
افزودن مخازن از یک فایل .repo.
.RE
.RE
.RE
.sp
\fBremoverepo\fP (\fBrr\fP) [\fIoptions\fP] \fIalias\fP|\fIname\fP|\fI#\fP|\fIURI\fP.\|.\|.
.RS 4
حذف مخازن مشخص‌شده توسط نام‌های مستعار، نام‌ها، شماره‌ها، URIها یا یکی از گزینه‌های جمعی (aggregate).
.sp
\fB\-\-loose\-auth\fP
.RS 4
نادیده گرفتن داده‌های احراز هویت کاربر در URI
.RE
.sp
\fB\-\-loose\-query\fP
.RS 4
نادیده گرفتن رشته پرس‌وجو (query string) در URI
.RE
.sp
\fB\-a\fP, \fB\-\-all\fP
.RS 4
اعمال تغییرات روی همه مخازن.
.RE
.sp
\fB\-l\fP, \fB\-\-local\fP
.RS 4
اعمال تغییرات روی همه مخازن محلی.
.RE
.sp
\fB\-t\fP, \fB\-\-remote\fP
.RS 4
اعمال تغییرات روی همه مخازن دوردست (http/https/ftp).
.RE
.sp
\fB\-m\fP, \fB\-\-medium\-type\fP \fItype\fP
.RS 4
اعمال تغییرات روی مخازن از نوع مشخص‌شده. این نوع با شناسه طرح‌واره (scheme) URI مخزن مانند http، dvd و غیره مطابقت دارد. می‌توانید فهرست کامل انواع معتبر را در \c
.URL "http://en.opensuse.org/openSUSE:Libzypp_URIs" "" "."
.RE
.RE
.sp
\fBrepos\fP (\fBlr\fP) [\fIoptions\fP] [\fIrepo\fP].\|.\|.
.RS 4
فهرست کردن همه مخازن تعریف‌شده یا نمایش اطلاعات تفصیلی درباره آن‌هایی که به عنوان آرگومان مشخص شده‌اند
.sp
داده‌های زیر می‌توانند برای هر مخزن یافت‌شده در سیستم چاپ شوند: \fI#\fP (شماره مخزن)، \fIAlias\fP (شناسه یکتا)، \fIName\fP (نام)، \fIEnabled\fP (آیا مخزن فعال است یا خیر)، \fIGPG Check\fP (آیا بررسی GPG برای متاداده مخزن (\fBr\fP) یا بسته‌های rpm بارگیری‌شده (\fBp\fP) فعال است یا خیر)، \fIRefresh\fP (آیا بازخوانی خودکار برای مخزن فعال است یا خیر)، \fIPriority\fP (اولویت)، \fIType\fP (نوع متاداده مخزن: rpm\-md، yast2، plaindir). اینکه کدام داده‌ها نمایش داده شوند توسط گزینه‌های خط فرمان فهرست‌شده در زیر و تنظیم main.repoListColumns در zypper.conf تعیین می‌شود. به طور پیش‌فرض، #، Alias، Name، Enabled، GPG Check و Refresh نمایش داده می‌شوند.
.sp
شماره مخزن یک شناسه یکتا از مخزن در مجموعه فعلی مخازن است. اگر مخزنی را اضافه، حذف یا تغییر دهید، ممکن است شماره‌ها تغییر کنند. هنگام استفاده از شماره‌ها همراه با دستورات مدیریت مخزن، این نکته را در نظر داشته باشید. از سوی دیگر، استفاده از نام مستعار به جای شماره همواره ایمن است.
.sp
برای نمایش اطلاعات تفصیلی درباره مخازن خاص، آن‌ها را به عنوان آرگومان مشخص کنید، چه با نام مستعار، نام، شماره حاصل از \fBzypper lr\fP ساده، یا با URI؛ مانند \fBzypper lr factory\fP یا \fBzypper lr 2\fP.
.sp
\fB\-e\fP, \fB\-\-export\fP \fIFILE\fP\fB.repo\fP|\fI\-\fP
.RS 4
این گزینه باعث می‌شود zypper تعریف تمام مخازن تعریف‌شده را در قالب فایل repo درون یک فایل واحد بنویسد. اگر به جای نام فایل، \fB\-\fP مشخص شود، مخازن در خروجی استاندارد نوشته خواهند شد.
.RE
.sp
\fB\-a\fP, \fB\-\-alias\fP
.RS 4
افزودن ستون نام مستعار (alias) به خروجی.
.RE
.sp
\fB\-n\fP, \fB\-\-name\fP
.RS 4
افزودن ستون نام به خروجی.
.RE
.sp
\fB\-u\fP, \fB\-\-uri\fP
.RS 4
افزودن ستون پایه URI به خروجی.
.RE
.sp
\fB\-p\fP, \fB\-\-priority\fP
.RS 4
افزودن ستون اولویت مخزن به خروجی.
.RE
.sp
\fB\-r\fP, \fB\-\-refresh\fP
.RS 4
افزودن ستون بازخوانی خودکار به خروجی.
.RE
.sp
\fB\-k\fP, \fB\-\-keep\-packages\fP
.RS 4
افزودن ستون keep\-packages به خروجی. این ستون اگر keep\-packages صریحاً برای این مخزن فعال شده باشد، مقدار \fBYes\fP را نشان می‌دهد. در غیر این صورت، در صورتی که فایل \fB.keep_packages\fP در دایرکتوری pkg\-cache وجود داشته باشد، مقدار \fB\-\fP یا \fB+\fP نمایش داده می‌شود (بخش \fBFILES\fP را ببینید).
.RE
.sp
\fB\-d\fP, \fB\-\-details\fP
.RS 4
نمایش اطلاعات بیشتر مانند URI، اولویت، نوع و غیره.
.RE
.sp
\fB\-E\fP, \fB\-\-show\-enabled\-only\fP
.RS 4
فقط مخازن فعال را نمایش می‌دهد.
.RE
.sp
\fB\-U\fP, \fB\-\-sort\-by\-uri\fP
.RS 4
افزودن ستون پایه URI و مرتب‌سازی فهرست بر اساس آن.
.RE
.sp
\fB\-P\fP, \fB\-\-sort\-by\-priority\fP
.RS 4
افزودن ستون اولویت مخزن و مرتب‌سازی فهرست بر اساس آن.
.RE
.sp
\fB\-A\fP, \fB\-\-sort\-by\-alias\fP
.RS 4
مرتب‌سازی فهرست بر اساس نام مستعار.
.RE
.sp
\fB\-N\fP, \fB\-\-sort\-by\-name\fP
.RS 4
مرتب‌سازی فهرست بر اساس نام.
.RE
.sp
مثال‌ها:
.RS 4

.sp
$ \fBzypper repos \-e myreposbackup.repo\fP
.RS 4
پشتیبان‌گیری از پیکربندی مخازن خود:
.RE
.sp
$ \fBzypper lr \-pu\fP
.RS 4
فهرست کردن مخازن به همراه URIها و اولویت‌های آن‌ها:
.RE
.RE
.RE
.sp
\fBrenamerepo\fP (\fBnr\fP) \fIalias\fP|\fIname\fP|\fI#\fP|\fIURI\fP \fInew\-alias\fP
.RS 4
اختصاص نام مستعار جدید به مخزن مشخص‌شده توسط نام مستعار، نام، شماره یا URI.
.sp
مثال‌ها:
.RS 4

.sp
$ \fBzypper nr 8 myrepo\fP
.RS 4
تغییر نام مخزن \fIشماره ۸\fP به \fBmyrepo\fP (مفید در مواقعی که مخزن دارای نام مستعار نامناسبی است که در خط فرمان به راحتی قابل استفاده نیست).
.RE
.RE
.RE
.sp
\fBmodifyrepo\fP (\fBmr\fP) \fIoptions\fP \fIalias\fP|\fIname\fP|\fI#\fP|\fIURI\fP.\|.\|.
.RS 4

.RE
.sp
\fBmodifyrepo\fP (\fBmr\fP) \fIoptions\fP \fB\-\-all\fP|\fB\-\-remote\fP|\fB\-\-local\fP|\fB\-\-medium\-type\fP
.RS 4
تغییر ویژگی‌های مخازن مشخص‌شده توسط نام مستعار، نام، شماره یا URI یا یکی از گزینه‌های جمعی (aggregate).
.sp
\fB\-n\fP, \fB\-\-name\fP \fIname\fP
.RS 4
تنظیم نام توصیفی برای مخزن.
.RE
.sp
\fB\-e\fP, \fB\-\-enable\fP
.RS 4
فعال‌سازی مخزن.
.RE
.sp
\fB\-d\fP, \fB\-\-disable\fP
.RS 4
غیرفعال‌سازی مخزن.
.RE
.sp
\fB\-f\fP, \fB\-\-refresh\fP (legacy: \-r)
.RS 4
فعال‌سازی بازخوانی خودکار برای مخزن.
.RE
.sp
\fB\-F\fP, \fB\-\-no\-refresh\fP (legacy: \-R)
.RS 4
غیرفعال‌سازی بازخوانی خودکار برای مخزن.
.RE
.sp
\fB\-p\fP, \fB\-\-priority\fP \fI[1\-2147483647]\fP|\fI0\fP
.RS 4
تنظیم اولویت مخزن. اولویت \fB1\fP بالاترین و \fB2147483647\fP پایین‌ترین است.
\fB\-p 0\fP اولویت را به مقدار پیش‌فرض (\fB99\fP) بازمی‌گرداند.
بسته‌های حاصل از مخازن با اولویت بالاتر استفاده خواهند شد، حتی اگر نسخه‌های بهتری در مخزنی با اولویت پایین‌تر موجود باشند.
.RE
.sp
\fB\-k\fP, \fB\-\-keep\-packages\fP
.RS 4
فعال‌سازی حافظه موقت (کش) فایل‌های RPM.
.RE
.sp
\fB\-K\fP, \fB\-\-no\-keep\-packages\fP
.RS 4
غیرفعال‌سازی حافظه موقت (کش) فایل‌های RPM.
.RE
.sp
\fB\-g\fP, \fB\-\-gpgcheck\fP
.RS 4
فعال‌سازی بررسی GPG برای این مخزن. رفتار آن در بخش \fBGPG checks\fP شرح داده شده است.
.RE
.sp
\fB\-\-gpgcheck\-strict\fP
.RS 4
فعال‌سازی بررسی سخت‌گیرانه GPG برای این مخزن. حتی بسته‌های حاصل از مخازن امضاشده نیز نیازمند امضای GPG معتبر هستند و استفاده از بسته‌های امضانشده باید تأیید شود.
.RE
.sp
\fB\-\-gpgcheck\-allow\-unsigned\fP
.RS 4
حالت خلاصه برای \fB\-\-gpgcheck\-allow\-unsigned\-repo \-\-gpgcheck\-allow\-unsigned\-package\fP
.RE
.sp
\fB\-\-gpgcheck\-allow\-unsigned\-repo\fP
.RS 4
فعال‌سازی بررسی GPG اما اجازه دادن به امضانشده بودن متاداده‌های مخزن.
.RE
.sp
\fB\-\-gpgcheck\-allow\-unsigned\-package\fP
.RS 4
فعال‌سازی بررسی GPG اما اجازه دادن به نصب بسته‌های امضانشده از این مخزن.
.RE
.sp
\fB\-G\fP, \fB\-\-no\-gpgcheck\fP
.RS 4
غیرفعال‌سازی بررسی GPG برای این مخزن.
.sp
\fBغیرفعال کردن بررسی‌های GPG توصیه نمی‌شود.\fP امضای داده‌ها گیرنده را قادر می‌سازد بررسی کند که پس از امضای داده‌ها هیچ تغییری رخ نداده است. پذیرش داده‌های بدون امضا، دارای امضای نادرست یا ناشناخته می‌تواند منجر به آسیب‌دیدگی سیستم و در موارد حاد حتی به خطر افتادن امنیت سیستم شود.
.RE
.sp
\fB\-\-default\-gpgcheck\fP
.RS 4
استفاده از تنظیمات سراسری بررسی GPG تعریف‌شده در \fB/etc/zypp/zypp.conf\fP. این مقدار پیش‌فرض است.
.sp
مگر اینکه تنظیمات zypp.conf خود را تغییر داده باشید، این همان \fB\-\-gpgcheck\fP است که رفتار آن در بخش \fBGPG checks\fP توصیف شده است.
.RE
.sp
\fB\-a\fP, \fB\-\-all\fP
.RS 4
اعمال تغییرات روی همه مخازن.
.RE
.sp
\fB\-l\fP, \fB\-\-local\fP
.RS 4
اعمال تغییرات روی همه مخازن محلی.
.RE
.sp
\fB\-t\fP, \fB\-\-remote\fP
.RS 4
اعمال تغییرات روی همه مخازن دوردست (http/https/ftp).
.RE
.sp
\fB\-m\fP, \fB\-\-medium\-type\fP \fItype\fP
.RS 4
اعمال تغییرات روی مخازن از نوع مشخص‌شده. این نوع با شناسه طرح‌واره (scheme) URI مخزن مانند http، dvd و غیره مطابقت دارد. می‌توانید فهرست کامل انواع معتبر را در \c
.URL "http://en.opensuse.org/openSUSE:Libzypp_URIs" "" "."
.RE
.sp
مثال‌ها:
.RS 4

.sp
$ \fBzypper mr \-kt\fP
.RS 4
فعال‌سازی نگهداری بسته‌ها برای همه مخازن دوردست.
.RE
.sp
$ \fBzypper mr \-er updates\fP
.RS 4
فعال‌سازی مخزن \fIupdates\fP و روشن کردن بازخوانی خودکار برای آن مخزن.
.RE
.sp
$ \fBzypper mr \-da\fP
.RS 4
غیرفعال‌سازی همه مخازن.
.RE
.RE
.RE
.sp
\fBrefresh\fP (\fBref\fP) [\fIalias\fP|\fIname\fP|\fI#\fP|\fIURI\fP].\|.\|.
.RS 4
بازخوانی مخازن مشخص‌شده با نام مستعار، نام، شماره یا URI. اگر هیچ مخزنی مشخص نشود، همه مخازن فعال بازخوانی خواهند شد.
.sp
\fB\-f\fP, \fB\-\-force\fP
.RS 4
اجبار به بازخوانی کامل مخازن مشخص‌شده. این گزینه باعث می‌شود بارگیری متاداده خام و تجزیه متاداده هر دو اجباری شوند، حتی اگر همه شواهد نشان دهند نیازی به بازخوانی نیست.
.RE
.sp
\fB\-b\fP, \fB\-\-force\-build\fP
.RS 4
فقط تجزیه مجدد متاداده‌های کش‌شده و بازسازی پایگاه‌داده را اجباری می‌کند. بارگیری متاداده خام اجباری نخواهد شد.
.RE
.sp
\fB\-d\fP, \fB\-\-force\-download\fP
.RS 4
فقط بارگیری نسخه جاری متاداده مخزن را اجباری می‌کند. تجزیه و بازسازی پایگاه‌داده اجباری نخواهد شد.
.RE
.sp
\fB\-B\fP, \fB\-\-build\-only\fP
.RS 4
فقط تجزیه متاداده و ساخت پایگاه‌داده انجام شود و متاداده خام در حافظه موقت (کش) بارگیری نشود. این قابلیت شما را قادر می‌سازد پایگاه‌داده آسیب‌دیده را بدون دسترسی به شبکه و صرفاً از روی داده‌های کش‌شده تعمیر کنید.
.RE
.sp
\fB\-D\fP, \fB\-\-download\-only\fP
.RS 4
فقط بارگیری متاداده خام انجام شود و تجزیه آن یا ساخت پایگاه‌داده صورت نگیرد.
.RE
.sp
\fB\-\-include\-all\-archs\fP
.RS 4
مخازن چندمعماری (Multi\-Arch): بارگیری متاداده خام برای تمام معماری‌های ارائه‌شده حتی اگر مخزن از فیلتر کردن پشتیبانی کند. در غیر این صورت، تنها متاداده معماری‌های سازگار با سیستم محلی بارگیری خواهد شد. شما به این گزینه نیازی ندارید مگر اینکه بخواهید zypper متاداده کامل را به منظور آینه‌سازی (mirroring) مخزن فراهم کند.
.RE
.sp
\fB\-s\fP, \fB\-\-services\fP
.RS 4
سرویس‌ها نیز قبل از بازخوانی مخازن، بازخوانی شوند.
.RE
.RE
.sp
\fBclean\fP (\fBcc\fP) [\fIoptions\fP] [\fIalias\fP|\fIname\fP|\fI#\fP|\fIURI\fP].\|.\|.
.RS 4
پاکسازی حافظه‌های موقت (کش‌های) محلی برای تمام مخازن شناخته‌شده یا مشخص‌شده. به صورت پیش‌فرض، فقط کش بسته‌های بارگیری‌شده پاکسازی می‌شود.
.sp
\fB\-m\fP, \fB\-\-metadata\fP
.RS 4
پاکسازی کش متاداده‌های مخزن به جای کش بسته‌ها.
.RE
.sp
\fB\-M\fP, \fB\-\-raw\-metadata\fP
.RS 4
پاکسازی کش متاداده‌های خام مخزن به جای کش بسته‌ها.
.RE
.sp
\fB\-a\fP, \fB\-\-all\fP
.RS 4
پاکسازی هر دو کش متاداده‌های مخزن و بسته‌ها.
.RE
.RE
.SS "مدیریت سرویس (Service Management)"
.sp
دستورات \fBservices\fP، \fBaddservice\fP، \fBremoveservice\fP، \fBmodifyservice\fP و \fBrefresh\-services\fP برای مدیریت و دستکاری سرویس‌ها به کار می‌روند. یک سرویس توسط URI خود مشخص می‌شود و باید یک نام مستعار یکتا (در بین هم سرویس‌ها و هم مخازن) برای آن تعریف شده باشد.
.sp
با مخازن مستقل (که متعلق به هیچ سرویسی نیستند) نیز مانند سرویس‌ها رفتار می‌شود. دستور \fBls\fP آن‌ها را فهرست می‌کند، دستور \fBms\fP آن‌ها را تغییر می‌دهد و غیره. البته گزینه‌های مختص مخزن، مانند \fB\-\-keep\-packages\fP در اینجا در دسترس نیستند. برای دستکاری آن‌ها می‌توانید از دستورات مدیریت مخزن استفاده کنید.
.sp
\fBaddservice\fP (\fBas\fP) [\fIoptions\fP] \fIURI\fP \fIalias\fP
.RS 4
سرویس مشخص‌شده با \fBURI\fP را به سیستم اضافه می‌کند. نام مستعار (\fIalias\fP) باید یکتا باشد و برای شناسایی سرویس به کار می‌رود. اگر سرویسی با \fIنام مستعار و URI یکسان\fP از قبل وجود داشته باشد، این دستور مانند \fBmodifyservice\fP عمل کرده و تنظیمات را مطابق با آن به‌روزرسانی می‌کند.
.sp
سرویس‌های تازه‌افزوده‌شده به طور خودکار بازخوانی نمی‌شوند. برای بازخوانی آن‌ها از دستور \fBrefresh\-services\fP استفاده کنید. زیپر هنگام افزودن سرویس به URI سرویس دسترسی پیدا نمی‌کند، بنابراین نوع سرویس تا زمانی که بازخوانی نشود، نامشخص خواهد بود.
.sp
\fB\-n\fP, \fB\-\-name\fP \fIname\fP
.RS 4
تعیین نام توصیفی برای سرویس.
.RE
.sp
\fB\-e\fP, \fB\-\-enable\fP
.RS 4
فعال‌سازی سرویس (این حالت پیش‌فرض است).
.RE
.sp
\fB\-d\fP, \fB\-\-disable\fP
.RS 4
افزودن سرویس به صورت غیرفعال.
.RE
.sp
\fB\-f\fP, \fB\-\-refresh\fP
.RS 4
فعال‌سازی بازخوانی خودکار سرویس.
.RE
.sp
\fB\-F\fP, \fB\-\-no\-refresh\fP
.RS 4
غیرفعال‌سازی بازخوانی خودکار سرویس.
.RE
.RE
.sp
\fBremoveservice\fP (\fBrs\fP) [\fIoptions\fP] \fIalias\fP|\fIname\fP|\fI#\fP|\fIURI\fP.\|.\|.
.RS 4
حذف سرویس مشخص‌شده از سیستم. حذف یک سرویس همچنین تمام مخازن متعلق به آن را نیز حذف خواهد کرد.
.sp
\fB\-\-loose\-auth\fP
.RS 4
نادیده گرفتن داده‌های احراز هویت کاربر در URI.
.RE
.sp
\fB\-\-loose\-query\fP
.RS 4
نادیده گرفتن رشته پرس‌وجو (query string) در URI.
.RE
.RE
.sp
\fBmodifyservice\fP (\fBms\fP) \fIoptions\fP \fIalias\fP|\fIname\fP|\fI#\fP|\fIURI\fP
.RS 4

.RE
.sp
\fBmodifyservice\fP (\fBms\fP) \fIoptions\fP \fB\-\-all\fP|\fB\-\-remote\fP|\fB\-\-local\fP|\fB\-\-medium\-type\fP
.RS 4
تغییر ویژگی‌های سرویس‌های مشخص‌شده.
.sp
گزینه‌های عمومی (Common Options)
.RS 4
این گزینه‌ها بین تمام انواع سرویس‌ها و مخازن مشترک هستند.
.RE
.sp
\fB\-n\fP, \fB\-\-name\fP \fIname\fP
.RS 4
تنظیم نام توصیفی برای سرویس.
.RE
.sp
\fB\-e\fP, \fB\-\-enable\fP
.RS 4
فعال‌سازی یک سرویس غیرفعال.
.RE
.sp
\fB\-d\fP, \fB\-\-disable\fP
.RS 4
غیرفعال‌سازی سرویس (اما آن را حذف نمی‌کند).
.RE
.sp
\fB\-f\fP, \fB\-\-refresh\fP  (legacy: \-r)
.RS 4
فعال‌سازی بازخوانی خودکار سرویس.
.RE
.sp
\fB\-F\fP, \fB\-\-no\-refresh\fP  (legacy: \-R)
.RS 4
غیرفعال‌سازی بازخوانی خودکار سرویس.
.RE
.sp
\fB\-a\fP, \fB\-\-all\fP
.RS 4
اعمال تغییرات روی همه سرویس‌ها.
.RE
.sp
\fB\-l\fP, \fB\-\-local\fP
.RS 4
اعمال تغییرات روی همه سرویس‌های محلی.
.RE
.sp
\fB\-t\fP, \fB\-\-remote\fP
.RS 4
اعمال تغییرات روی همه سرویس‌های دوردست.
.RE
.sp
\fB\-m\fP, \fB\-\-medium\-type\fP \fItype\fP
.RS 4
اعمال تغییرات روی سرویس‌های از نوع مشخص‌شده.
.RE
.sp
گزینه‌های خاص سرویس RIS (RIS Service Specific Options)
.RS 4
این گزینه‌ها توسط سرویس‌هایی به جز سرویس‌های نمایه‌سازی مخزن (Repository Index Services) نادیده گرفته می‌شوند.
.RE
.sp
\fB\-i\fP, \fB\-\-ar\-to\-enable\fP \fIalias\fP
.RS 4
زمان‌بندی فعال‌سازی یک مخزن سرویس RIS در بازخوانی بعدی سرویس.
.RE
.sp
\fB\-I\fP, \fB\-\-ar\-to\-disable\fP \fIalias\fP
.RS 4
زمان‌بندی غیرفعال‌سازی یک مخزن سرویس RIS در بازخوانی بعدی سرویس.
.RE
.sp
\fB\-j\fP, \fB\-\-rr\-to\-enable\fP \fIalias\fP
.RS 4
حذف یک مخزن سرویس RIS از فهرست فعال‌سازی.
.RE
.sp
\fB\-J\fP, \fB\-\-rr\-to\-disable\fP \fIalias\fP
.RS 4
حذف یک مخزن سرویس RIS از فهرست غیرفعال‌سازی.
.RE
.sp
\fB\-k\fP, \fB\-\-cl\-to\-enable\fP
.RS 4
پاک کردن فهرست مخازن RIS تعیین‌شده برای فعال‌سازی.
.RE
.sp
\fB\-K\fP, \fB\-\-cl\-to\-disable\fP
.RS 4
پاک کردن فهرست مخازن RIS تعیین‌شده برای غیرفعال‌سازی.
.RE
.RE
.sp
\fBservices\fP (\fBls\fP) [\fIoptions\fP]
.RS 4
فهرست کردن سرویس‌های تعریف‌شده در سیستم.
.sp
\fB\-u\fP, \fB\-\-uri\fP
.RS 4
نمایش URI پایه مخازن نیز در خروجی.
.RE
.sp
\fB\-p\fP, \fB\-\-priority\fP
.RS 4
نمایش اولویت مخزن نیز در خروجی.
.RE
.sp
\fB\-d\fP, \fB\-\-details\fP
.RS 4
نمایش اطلاعات بیشتر مانند URI، اولویت، نوع.
.RE
.sp
\fB\-r\fP, \fB\-\-with\-repos\fP
.RS 4
نمایش مخازن متعلق به سرویس‌ها نیز در خروجی.
.RE
.sp
\fB\-P\fP, \fB\-\-sort\-by\-priority\fP
.RS 4
مرتب‌سازی فهرست بر اساس اولویت مخزن.
.RE
.sp
\fB\-E\fP, \fB\-\-show\-enabled\-only\fP
.RS 4
فقط سرویس‌های فعال را نمایش می‌دهد. اگر همراه با \fB\-\-with\-repos\fP استفاده شود، سرویس‌های غیرفعالی که مخازن فعال (به صورت دستی) دارند نیز نمایش داده می‌شوند.
.RE
.sp
\fB\-U\fP, \fB\-\-sort\-by\-uri\fP
.RS 4
مرتب‌سازی فهرست بر اساس URI.
.RE
.sp
\fB\-N\fP, \fB\-\-sort\-by\-name\fP
.RS 4
مرتب‌سازی فهرست بر اساس نام.
.RE
.RE
.sp
\fBrefresh\-services\fP (\fBrefs\fP) [\fIoptions\fP] \fIalias\fP|\fIname\fP|\fI#\fP|\fIURI\fP.\|.\|.
.RS 4
بازخوانی یک سرویس به معنای اجرای وظیفه ویژه آن سرویس است.
.sp
سرویس‌های RIS بر اساس محتوای فعلی نمایه مخزن، مخازنی را به سیستم شما اضافه، حذف یا ویرایش می‌کنند. با این حال، تفاوت در وضعیت فعال/غیرفعال ناشی از فراخوانی دستی \fBmodify\-repo\fP روی یک مخزن سرویس بازگردانده نخواهد شد، مگر اینکه از گزینه \fB\-\-restore\-status\fP استفاده شود یا نمایه مخزن صریحاً این تغییر را درخواست کند.
.sp
سرویس‌ها فقط مخازن تعریف‌شده را مدیریت می‌کنند و آن‌ها را بازخوانی نمی‌کنند. برای بازخوانی مخازن نیز، از گزینه \fB\-\-with\-repos\fP یا دستور \fBrefresh\fP استفاده کنید.
.sp
\fB\-f\fP, \fB\-\-force\fP
.RS 4
اجبار به بازخوانی کامل سرویس‌های مشخص‌شده. این گزینه باعث می‌شود بارگیری متاداده خام و تجزیه متاداده هر دو اجباری شوند، حتی اگر همه شواهد نشان دهند نیازی به بازخوانی نیست.
.RE
.sp
\fB\-r\fP, \fB\-\-with\-repos\fP
.RS 4
بازخوانی مخازن سرویس نیز انجام شود.
.RE
.sp
\fB\-R\fP, \fB\-\-restore\-status\fP
.RS 4
همچنین بازگرداندن وضعیت فعال/غیرفعال مخازن سرویس به مقدار پیش‌فرض نمایه مخزن. این گزینه پس از تغییر دستی وضعیت فعال بودن برخی مخازن سرویس مفید است.
.RE
.RE
.SS "مدیریت قفل بسته‌ها (Package Locks Management)"
.sp
قفل بسته‌ها با هدف جلوگیری از اعمال تغییرات در مجموعه بسته‌های نصب‌شده روی سیستم به کار می‌روند. قفل‌ها به عنوان \fIپرس‌وجوها\fP در فایل /etc/zypp/locks ذخیره می‌شوند (همچنین locks(5) را ببینید). بسته‌های منطبق با پرس‌وجو از تغییر وضعیت نصب خود منع می‌شوند؛ یک بسته نصب‌شده نمی‌تواند حذف یا ارتقا داده شود و یک بسته نصب‌نشده نمی‌تواند نصب گردد. هنگام درخواست برای نصب، ارتقا یا حذف چنین بسته قفل‌شده‌ای، کادر گفتگوی مشکل وابستگی دریافت خواهید کرد.
.sp
یک \fIlock\-spec\fP به صورت "\fINAME\fP [\fIOP EDITION\fP]" تشکیل می‌شود، که در آن \fINAME\fP همچنین می‌تواند یک الگوی جستجوی چندگانه (glob) با استفاده از نویسه‌های عمومی \fB*\fP و \fB?\fP باشد. انواع غیربسته‌ای ممکن است رشته نوع آن‌ها در ابتدا درج شود (مانند \fIpatch:foo\fP یا \fIproduct:baa\fP) یا از گزینه \fB\-\-type\fP دستورات استفاده کنند.
.sp
فرم پایه همه نسخه‌های موارد منطبق را قفل خواهد کرد. می‌توانید در صورت تمایل قفل را محدود کنید تا با نسخه خاص یا دامنه‌ای از نسخه‌ها با استفاده از \fB=\fP، \fB<\fP، \fB<=\fP، \fB>\fP، \fB>=\fP یا \fB!=\fP پس از نسخه مطابقت داشته باشد.
.if n .sp
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
.B نکته (Note)
.ps -1
.br
.sp
اگر در اطراف عملگر از فاصله خالی استفاده می‌کنید، باید بر اساس قوانین پوسته‌ای (shell) که استفاده می‌کنید، رشته را در گیومه قرار داده یا فاصله‌ها را اسکیپ کنید.
.sp .5v
.RE
.sp
\fBlocks\fP (\fBll\fP)
.RS 4
فهرست کردن قفل‌های بسته فعال فعلی.
.sp
\fB\-m\fP, \fB\-\-matches\fP
.RS 4
نمایش تعداد موارد قابل‌حل (resolvables) منطبق با هر قفل. این گزینه نیازمند بارگیری مخازن است.
.RE
.sp
\fB\-s\fP, \fB\-\-solvables\fP
.RS 4
فهرست کردن موارد قابل‌حل منطبق با هر قفل. این گزینه نیازمند بارگیری مخازن است.
.RE
.RE
.sp
\fBaddlock\fP (\fBal\fP) [\fIoptions\fP] \fIlock\-spec\fP.\|.\|.
.RS 4
افزودن قفل بسته. بسته‌ها را برای قفل کردن همان‌طور که در بالا توضیح داده شد مشخص کنید.
.sp
\fB\-r\fP, \fB\-\-repo\fP \fIalias\fP|\fIname\fP|\fI#\fP|\fIURI\fP
.RS 4
محدود کردن قفل به مخزن مشخص‌شده.
.RE
.sp
\fB\-t\fP, \fB\-\-type\fP \fItype\fP
.RS 4
فقط بسته‌های نوع مشخص‌شده قفل شوند (پیش‌فرض: package). برای فهرست انواع بسته‌های موجود، بخش \fBPackage Types\fP را ببینید.
.RE
.sp
\fB\-m\fP, \fB\-\-comment\fP \fIcomment\fP
.RS 4
افزودن یادداشت برای قفل بسته.
.RE
.RE
.sp
\fBremovelock\fP (\fBrl\fP) [\fIoptions\fP] \fIlock\-number\fP|\fIlock\-spec\fP.\|.\|.
.RS 4
حذف قفل بسته. قفل مورد نظر برای حذف را با شماره آن که از \fBzypper locks\fP به دست آمده یا توسط \fIlock\-spec\fP مشخص کنید.
.sp
\fB\-r\fP, \fB\-\-repo\fP \fIalias\fP|\fIname\fP|\fI#\fP|\fIURI\fP
.RS 4
محدود کردن قفل به مخزن مشخص‌شده.
.RE
.sp
\fB\-t\fP, \fB\-\-type\fP \fItype\fP
.RS 4
محدود کردن قفل به بسته‌های نوع مشخص‌شده (پیش‌فرض: package). برای فهرست انواع بسته‌های موجود، بخش \fBPackage Types\fP را ببینید.
.RE
.RE
.sp
\fBcleanlocks\fP (\fBcl\fP)
.RS 4
حذف قفل‌های بلااستفاده.
.sp
این دستور قفل‌هایی را جستجو می‌کند که در حال حاضر (با توجه به مخازن استفاده‌شده) هیچ بسته‌ای را قفل نمی‌کنند و برای هر یک از این قفل‌ها از کاربر می‌پرسد که آیا آن را حذف کند یا خیر.
.RE
.SS "مدیریت محلی‌سازی (Locale Management)"
.sp
این دستورات اطلاعاتی درباره محلی‌سازی‌های درخواستی ارائه داده و امکان مدیریت آن‌ها را فراهم می‌کنند. یک محلی‌سازی با یک کد زبان تعریف می‌شود. برای بسیاری از بسته‌ها، بسته‌های وابسته به محلی‌سازی موجود هستند که ترجمه‌ها یا فرهنگ‌های لغت را ارائه می‌دهند. برای نصب شدن این موارد، محلی‌سازی زبان مورد نظر باید توسط کتابخانه مدیر بسته به عنوان درخواستی علامت‌گذاری شود.
.sp
\fBlocales\fP (\fBlloc\fP) [OPTIONS] [LOCALE] .\|.\|.
.RS 4
فهرست کردن محلی‌سازی‌های درخواستی. در صورت فراخوانی بدون آرگومان، محلی‌سازی‌هایی را که از قبل به عنوان درخواستی علامت‌گذاری شده‌اند فهرست می‌کند. مشخص کردن محلی‌سازی(های) خاص، اطلاعات را فقط برای همان مورد(ها) چاپ می‌کند.
.sp
\fB\-a\fP, \fB\-\-all\fP
.RS 4
فهرست کردن تمام محلی‌سازی‌های موجود.
.RE
.sp
\fB\-p\fP, \fB\-\-packages\fP
.RS 4
نمایش بسته‌های متناظر.
.RE
.RE
.sp
\fBaddlocale\fP (\fBaloc\fP) [OPTIONS] <LOCALE> .\|.\|.
.RS 4
افزودن محلی‌سازی(های) مشخص‌شده به فهرست محلی‌سازی‌های درخواستی.
.sp
\fB\-n\fP, \fB\-\-no\-packages\fP
.RS 4
عدم نصب بسته‌های متناظر.
.RE
.RE
.sp
\fBremovelocale\fP (\fBrloc\fP) [OPTIONS] <LOCALE> .\|.\|.
.RS 4
حذف محلی‌سازی(های) مشخص‌شده از فهرست محلی‌سازی‌های درخواستی.
.sp
\fB\-n\fP, \fB\-\-no\-packages\fP
.RS 4
عدم حذف بسته‌های متناظر.
.RE
.RE
.sp
مثال‌ها:
.RS 4

.sp
$ \fBzypper locales\fP
.RS 4
فهرست کردن محلی‌سازی‌های درخواستی.
.RE
.sp
$ \fBzypper locales \-\-packages de en\fP
.RS 4
دریافت فهرست بسته‌هایی که برای \fIde\fP و \fIen\fP موجود هستند (تطبیق دقیق).
.RE
.sp
$ \fBzypper locales en_\fP
.RS 4
دریافت تمام محلی‌سازی‌ها با کد زبان \fIen\fP که دارای کد کشور مخصوص به خود هستند، به استثنای حالت ذخیره (fallback) \fIen\fP.
.RE
.sp
$ \fBzypper locales en\fP*
.RS 4
دریافت تمام محلی‌سازی‌ها با کد زبان \fIen\fP با یا بدون کد کشور.
.RE
.sp
$ \fBzypper aloc \-\-packages de_CH\fP
.RS 4
درخواست \fBde_CH\fP و نصب بسته‌های وابسته به زبان.
.RE
.RE
.SS "سایر دستورات (Other Commands)"
.sp
\fBsystem\-architecture\fP
.RS 4
معماری شناسایی‌شده سیستم را چاپ می‌کند.
.RE
.sp
\fBversioncmp\fP (\fBvcmp\fP) \fIVERSION1\fP \fIVERSION2\fP
.RS 4
نسخه‌های ارائه‌شده به عنوان آرگومان را مقایسه می‌کند و مشخص می‌سازد که آیا VERSION1 از VERSION2 قدیمی‌تر یا جدیدتر است، یا این‌که دو رشته نسخه با هم مطابقت دارند. کد خروج در صورت برابر بودن نسخه‌ها 0، در صورت جدیدتر بودن VERSION1 مقدار 11، و در صورت جدیدتر بودن VERSION2 مقدار 12 است.
.sp
خروجی پیش‌فرض به صورت خوانا برای انسان است. اگر از گزینه سراسری \fB\-\-terse\fP استفاده شود، نتیجه یک عدد صحیح خواهد بود؛ در صورتی که VERSION1 از VERSION2 قدیمی‌تر/جدیدتر باشد منفی/مثبت، و در صورت مطابقت صفر است.
.sp
\fB\-m\fP, \fB\-\-match\fP
.RS 4
نبود شماره انتشار (release) را به منزله هر شماره انتشاری در نظر می‌گیرد.
.sp
برای مثال:
.sp
$ \fBzypper vcmp \-m 0.15.3 0.15.3\-2\fP
.RS 4
0.15.3 \fImatches\fP 0.15.3\-2
.RE
.sp
$ \fBzypper vcmp 0.15.3 0.15.3\-2\fP
.RS 4
0.15.3 \fIis older than\fP 0.15.3\-2
.RE
.RE
.RE
.sp
\fBtargetos\fP (\fBtos\fP)
.RS 4
رشته شناسه (ID) سیستم‌عامل مقصد را نمایش می‌دهد. این رشته با مدخل XPath:/product/register/target در (\fIcurrent\-rootdir\fP)\fB/etc/products.d/baseproduct\fP تعریف می‌شود.
.sp
اگر baseproduct این مدخل را ارائه ندهد، یا اگر اصلاً هیچ baseproductای نصب نشده باشد، در صورت استفاده از گزینه سراسری \fB\-\-terse\fP، مقدار خالی خواهد بود.
.sp
در حالت غیر terse، اگر یک baseproduct نصب شده باشد، برچسب توزیع به جای مقدار خالی نشان داده می‌شود.
.sp
\fB\-l\fP, \fB\-\-label\fP
.RS 4
در عوض، توزیع و برچسب کوتاه baseproduct را نشان می‌دهد.
.RE
.RE
.sp
\fBlicenses\fP
.RS 4
گزارشی درباره \fIمجوزها\fP و \fIEULA\fPهای بسته‌های نصب‌شده را در خروجی استاندارد چاپ می‌کند.
.sp
ابتدا فهرستی از تمام بسته‌ها و مجوزها و/یا EULAهای آن‌ها نمایش داده می‌شود. به دنبال آن خلاصه‌ای شامل تعداد کل بسته‌های نصب‌شده و تعداد بسته‌های نصب‌شده دارای EULA که نیازمند تأیید کاربر بودند ارائه می‌شود. از آنجا که EULAها روی سیستم ذخیره نمی‌شوند و تنها از طریق متاداده مخزن قابل خواندن هستند، این خلاصه همچنین شامل تعداد بسته‌های نصب‌شده‌ای است که معادل آن‌ها در مخازن وجود دارد. این گزارش با فهرستی از تمامی مجوزهای مورد استفاده توسط بسته‌های نصب‌شده پایان می‌یابد.
.sp
این دستور می‌تواند برای شرکت‌هایی که یک توزیع سفارشی (مانند applianceها) را بازتوزیع می‌کنند مفید باشد تا متوجه شوند به چه مجوزهایی پایبند هستند.
.RE
.sp
\fBdownload\fP [OPTIONS]
.RS 4
فایل‌های rpm مشخص‌شده در خط فرمان را در یک دایرکتوری محلی بارگیری می‌کند.
.sp
به طور پیش‌فرض بسته‌ها در کش بسته libzypp بارگیری می‌شوند (\fB/var/cache/zypp/packages\fP؛ برای کاربران غیر ریشه \fB$XDG_CACHE_HOME/zypp/packages\fP)، اما می‌توان این مسیر را با استفاده از گزینه سراسری \fB\-\-pkg\-cache\-dir\fP تغییر داد.
.sp
خروجی قابل تجزیه XML تولیدشده توسط \fBzypper \-\-xmlout\fP شامل یک گره \fB<download\-result>\fP برای هر بسته‌ای خواهد بود که زیپر سعی در بارگیری آن داشته است. در صورت موفقیت، مکان بسته بارگیری‌شده در صفت \fBpath\fP زیرگره \fB<localfile>\fP یافت می‌شود (مسیر xpath: \fBdownload\-result/localpath@path\fP):
.sp
.if n .RS 4
.nf
.fam C
        <download\-result>
          <solvable>
            <kind>package</kind>
            <name>zypper</name>
            <edition epoch="0" version="1.9.17" release="26.1"/>
            <arch>x86_64</arch>
            <repository name="repo\-oss\-update (13.1)" alias="openSUSE:repo\-oss\-update"/>
          </solvable>
          <localfile path="/var/cache/zypp/pac.../zypper\-1.9.17\-26.1.x86_64.rpm"/>
        </download\-result>
.fam
.fi
.if n .RE
.sp
\fB\-\-all\-matches\fP
.RS 4
	بارگیری تمامی نسخه‌های منطبق با آرگومان‌های خط فرمان. در غیر این صورت فقط بهترین نسخه از
هر بسته منطبق بارگیری می‌شود.
.RE
.sp
\fB\-\-dry\-run\fP
.RS 4
هیچ بسته‌ای را بارگیری نکنید، فقط گزارش دهید که چه کاری انجام خواهد شد.
.RE
.sp
\fB\-r\fP, \fB\-\-repo\fP \fIalias\fP|\fIname\fP|\fI#\fP|\fIURI\fP
.RS 4
تنها با مخزن مشخص‌شده توسط نام مستعار، نام، شماره یا URI کار می‌کند. از این گزینه می‌توان چندین بار استفاده کرد.
.RE
.sp
\fB\-\-from\fP \fIalias\fP|\fIname\fP|\fI#\fP|\fIURI\fP
.RS 4
انتخاب بسته‌ها فقط از مخزن مشخص‌شده. از این گزینه می‌توان چندین بار استفاده کرد.
.RE
.RE
.sp
\fBsource\-download\fP [OPTIONS]
.RS 4
بارگیری rpmهای سورس برای تمام بسته‌های نصب‌شده در یک دایرکتوری محلی.
.sp
\fB\-d\fP, \fB\-\-directory\fP \fIdir\fP
.RS 4
بارگیری تمام rpmهای سورس در این دایرکتوری. پیش‌فرض \fB/var/cache/zypper/source\-download\fP است.
.RE
.sp
\fB\-\-delete\fP
.RS 4
حذف rpmهای سورس اضافی در دایرکتوری محلی. این حالت پیش‌فرض است.
.RE
.sp
\fB\-\-no\-delete\fP
.RS 4
rpmهای سورس اضافی را حذف نکنید.
.RE
.sp
\fB\-\-status\fP
.RS 4
هیچ rpm سورسی را بارگیری نکنید، بلکه نشان دهید کدام rpmهای سورس مفقود یا اضافی هستند.
.RE
.RE
.sp
\fBps\fP [OPTIONS]
.RS 4
پس از هر ارتقا یا حذف بسته‌ها، ممکن است فرآیندهایی روی سیستم در حال اجرا باشند که همچنان از فایل‌هایی که در این میان حذف شده‌اند استفاده کنند. دستور \fBzypper ps\fP تمامی فرآیندهایی را که از فایل‌های حذف‌شده استفاده می‌کنند، به همراه فایل‌های مربوطه و راهنمای نام سرویس در صورت شناخته‌شده بودن، فهرست می‌کند. این کار نشان می‌دهد کدام سرویس‌ها ممکن است پس از یک به‌روزرسانی نیاز به راه‌اندازی مجدد داشته باشند؛ معمولاً برنامه‌هایی که همچنان به استفاده از کتابخانه‌های مشترک حذف‌شده ادامه می‌دهند. این فهرست شامل اطلاعات زیر است:
.sp
\fBPID\fP
.RS 4
شناسه فرآیند
.RE
.sp
\fBPPID\fP
.RS 4
شناسه فرآیند والد
.RE
.sp
\fBUID\fP
.RS 4
شناسه کاربر اجراکننده فرآیند
.RE
.sp
\fBLogin\fP
.RS 4
نام ورود کاربر اجراکننده فرآیند
.RE
.sp
\fBCommand\fP
.RS 4
دستور استفاده‌شده برای اجرای فرآیند
.RE
.sp
\fBService\fP
.RS 4
نام سرویس، در صورتی که دستور با یک سرویس سیستمی مرتبط باشد
.RE
.sp
\fBFiles\fP
.RS 4
فهرست فایل‌های حذف‌شده
.RE
.sp
\fB\-s\fP, \fB\-\-short\fP
.RS 4
ایجاد یک جدول کوتاه بدون نمایش فایل‌های حذف‌شده. اگر دو بار داده شود، فقط فرآیندهایی را نشان می‌دهد که با یک سرویس سیستمی مرتبط هستند. اگر سه بار داده شود، فقط نام سرویس‌های سیستمی مرتبط را فهرست می‌کند.
.RE
.sp
\fB\-\-print\fP \fIformat\fP
.RS 4
برای هر سرویس سیستمی مرتبط، \fIformat\fP را روی خروجی استاندارد چاپ می‌کند که پس از آن یک خط جدید می‌آید. هر دستورالعمل \fB%s\fP در \fIformat\fP با نام سرویس سیستمی جایگزین می‌شود.
.RE
.sp
\fB\-d\fP, \fB\-\-debugFile\fP \fIfilename\fP
.RS 4
خروجی دادن فایلی شامل تمامی مدخل‌های proc که به مجموعه نهایی فایل‌های باز مورد استفاده راه یافته‌اند. این فایل را می‌توان به عنوان اطلاعات اضافی در گزارش باگ ارسال کرد.
.RE
.sp
مثال‌ها:
.RS 4

.sp
$ \fBzypper ps \-ss\fP
.RS 4
فقط فرآیندهای مرتبط با یک سرویس سیستمی را نشان می‌دهد.
.RE
.sp
$ \fBzypper ps \-sss\fP
.RS 4
کوتاه‌شده \fBzypper ps \-\-print "%s"\fP؛ سرویس‌هایی را که ممکن است به راه‌اندازی مجدد نیاز داشته باشند فهرست می‌کند.
.RE
.sp
$ \fBzypper ps \-\-print "systemctl status %s"\fP
.RS 4
به زیپر امکان می‌دهد دستورات بازیابی اطلاعات وضعیت سرویس‌هایی را که ممکن است نیاز به راه‌اندازی مجدد داشته باشند چاپ کند.
.RE
.RE
.RE
.sp
\fBneeds\-rebooting\fP
.RS 4
بررسی می‌کند که آیا فلگ reboot\-needed بر اثر به‌روزرسانی یا نصب قبلی یک کتابخانه اصلی یا سرویس تنظیم شده است یا خیر.
.sp
فلگ reboot\-needed زمانی تنظیم می‌شود که بسته‌ای که \fBinstallhint(reboot\-needed)\fP را فراهم می‌کند، به‌روزرسانی یا نصب شود. علاوه بر این، یک فهرست از پیش‌تعریف‌شده (/etc/zypp/needreboot) از بسته‌های شناخته‌شده وجود دارد که باعث تنظیم بدون قید و شرط فلگ reboot\-needed می‌شوند. کد خروج \fBZYPPER_EXIT_INF_REBOOT_NEEDED\fP نشان می‌دهد که راه‌اندازی مجدد پیشنهاد می‌شود، در غیر این صورت کد خروج روی \fBZYPPER_EXIT_OK\fP تنظیم می‌گردد.
.sp
به اسکریپت‌ها توصیه می‌شود از این دستور برای آزمایش این‌که آیا راه‌اندازی مجدد سیستم پیشنهاد شده است استفاده کنند. از \fB\-\-quiet\fP برای جلوگیری از نمایش خروجی عادی استفاده کنید.
.RE
.SS "زیردستورها (Subcommands)"
.sp
\fBsubcommand\fP
.RS 4
زیردستورهای موجود در \fB/usr/lib/zypper/commands\fP و سایر مسیرهای موجود در \fB$PATH\fP شما را فهرست می‌کند. برای جزئیات بخش \fBزیردستورها (SUBCOMMANDS)\fP را ببینید.
.RE
.SH "گزینه‌های سراسری (GLOBAL OPTIONS)"
.sp
\fB\-h\fP, \fB\-\-help\fP
.RS 4
راهنما. اگر یک \fIدستور\fP همراه با گزینه \fB\-\-help\fP مشخص شود، راهنمای مخصوص همان دستور نمایش داده می‌شود.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
شماره نسخه زیپر را چاپ کرده و خارج می‌شود.
.RE
.sp
\fB\-c\fP, \fB\-\-config\fP \fIfile\fP
.RS 4
استفاده از فایل پیکربندی مشخص‌شده زیپر به جای فایل پیش‌فرض \fBzypper.conf\fP. سایر گزینه‌های خط فرمان که همراه با \fB\-\-config\fP مشخص شده‌اند و معادل آن‌ها در فایل پیکربندی زیپر وجود دارد، همچنان اولویت خواهند داشت.
.sp
ترتیب اولویت با \fB\-\-config\fP به صورت زیر است:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 1." 4.2
.\}
گزینه‌های خط فرمان
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 2." 4.2
.\}
\fB\-\-config\fP \fIfile\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 3." 4.2
.\}
[\fB/etc/zypp/zypp.conf\fP] (پیش‌فرض‌های سراسری سیستم برای تمام برنامه‌های مبتنی بر libzypp)
.RE
.if n .sp
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
.B نکته
.ps -1
.br
.sp
استفاده و مکان فایل سراسری سیستم \fB/etc/zypp/zypp.conf\fP را نمی‌توان به این روش تغییر داد. این فایل صرفاً از این جهت در اینجا ذکر شده که برخی از گزینه‌های خط فرمان زیپر امکان بازنویسی پیش‌فرض‌های سراسری سیستم تعریف‌شده در \fBzypp.conf\fP را فراهم می‌کنند.
.sp .5v
.RE
.sp
همچنین برای اطلاعات بیشتر بخش \fBفایل‌ها (FILES)\fP را ببینید.
.RE
.sp
\fB\-v\fP, \fB\-\-verbose\fP
.RS 4
افزایش پرگویی خروجی. برای خروجی اشکال‌زدایی (دیباگ) این گزینه را دو بار مشخص کنید. به عنوان مثال \fBzypper \-vv ref\fP آینه‌های مورد استفاده برای بارگیری متاداده را نشان می‌دهد.
.RE
.sp
\fB\-q\fP, \fB\-\-quiet\fP
.RS 4
جلوگیری از نمایش خروجی عادی. با این حال، پیام‌های مختصر (به‌ویژه اعلان نتیجه) و پیام‌های خطا همچنان چاپ خواهند شد. اگر همراه با گزینه متناقض \fB\-\-verbose\fP استفاده شود، گزینه \fB\-\-verbose\fP اولویت خواهد داشت.
.RE
.sp
\fB\-\-color\fP, \fB\-\-no\-color\fP
.RS 4
تعیین استفاده از رنگ‌ها در خروجی در صورتی که tty پشتیبانی کند. برای جزئیات بخش \fB[color]\fP در \fBzypper.conf\fP را ببینید.
.RE
.sp
\fB\-A\fP, \fB\-\-no\-abbrev\fP
.RS 4
متن‌ها را در جدول‌ها مخفف نکنید. به طور پیش‌فرض زیپر تلاش می‌کند متن‌ها را در برخی ستون‌ها کوتاه کند تا جدول در عرض صفحه نمایش جا شود. اگر لازم است متن کامل را ببینید، از این گزینه استفاده کنید.
.RE
.sp
\fB\-t\fP, \fB\-\-terse\fP
.RS 4
خروجی فشرده و موجز برای پردازش ماشینی. مستلزم \fB\-\-no\-abbrev\fP و \fB\-\-no\-color\fP است.
.RE
.sp
\fB\-s\fP, \fB\-\-table\-style\fP \fIinteger\fP
.RS 4
انتخاب از بین مجموعه‌های مختلف کاراکترهای رسم خط از پیش‌تعریف‌شده برای کشیدن جدول. سبک جدول با یک عدد صحیح مشخص می‌شود. سبک \fB0\fP پیش‌فرض است، سبک‌های \fB1\fP تا \fB9\fP از ترکیب کاراکترهای مختلف رسم جعبه استفاده می‌کنند که شکل آن‌ها ممکن است به فونت مورد استفاده در ترمینال بستگی داشته باشد. سبک \fB10\fP ستون‌ها را با دو نقطه جدا می‌کند و سبک \fB11\fP اصلاً هیچ خطی رسم نمی‌کند.
.RE
.sp
\fB\-n\fP, \fB\-\-non\-interactive\fP
.RS 4
تغییر حالت به غیرتعاملی. در این حالت زیپر از کاربر نمی‌خواهد برای اعلان‌های مختلف پاسخ تایپ کند، بلکه پاسخ‌های پیش‌فرض را به صورت خودکار به کار می‌برد. این پاسخ‌های پیش‌فرض به گزینه‌های دیگری مانند \fB\-\-no\-gpg\-checks\fP یا \fB\-\-ignore\-unknown\fP نیز بستگی دارند.
.RE
.sp
\fB\-\-non\-interactive\-include\-reboot\-patches\fP
.RS 4
در حالت غیرتعاملی، از وصله‌هایی که فلگ rebootSuggested دارند صرف‌نظر نکنید. در غیر این صورت این وصله‌ها تعاملی در نظر گرفته می‌شوند، مانند وصله‌هایی که شامل یک مجوز یا پیامی برای تأیید هستند. نکته: این گزینه حالت غیرتعاملی را فعال نمی‌کند.
.RE
.sp
\fB\-x\fP, \fB\-\-xmlout\fP
.RS 4
تغییر خروجی به قالب XML. این گزینه برای اسکریپت‌ها یا رابط‌های گرافیکی که از زیپر استفاده می‌کنند مفید است.
.RE
.sp
\fB\-i\fP, \fB\-\-ignore\-unknown\fP
.RS 4
نادیده گرفتن بسته‌های ناشناخته. این گزینه برای اسکریپت‌ها مفید است، زیرا هنگام نصب در حالت \fB\-\-non\-interactive\fP زیپر انتظار دارد هر آرگومان خط فرمان حداقل با یک بسته شناخته‌شده مطابقت داشته باشد. نام‌های ناشناخته یا عبارت‌های الگو (globbing) بدون تطابق، به عنوان خطا تلقی می‌شوند مگر اینکه از این گزینه استفاده شود.
.sp
برای دستورات \fBsearch\fP و \fBinfo\fP این گزینه باعث می‌شود که اگر پرس‌وجو هیچ تطابقی پیدا نکرد، زیپر به جای \fBZYPPER_EXIT_INF_CAP_NOT_FOUND\fP مقدار \fBZYPPER_EXIT_OK\fP را برگرداند.
.RE
.sp
\fB\-D\fP, \fB\-\-reposd\-dir\fP \fIdir\fP
.RS 4
استفاده از دایرکتوری مشخص‌شده برای جستجوی فایل‌های تعریف مخزن (\fB.repo\fP). مقدار پیش‌فرض \fB/etc/zypp/repos.d\fP است.
.RE
.sp
\fB\-\-servicesd\-dir\fP \fIdir\fP
.RS 4
استفاده از دایرکتوری مشخص‌شده برای جستجوی فایل‌های تعریف سرویس (\fB.service\fP). مقدار پیش‌فرض \fB/etc/zypp/services.d\fP است.
.RE
.sp
\fB\-C\fP, \fB\-\-cache\-dir\fP \fIdir\fP
.RS 4
استفاده از یک دایرکتوری ریشه جایگزین برای تمامی حافظه‌های موقت (کش‌ها). مقدار پیش‌فرض \fB/var/cache/zypp\fP است.
.RE
.sp
\fB\-\-raw\-cache\-dir\fP \fIdir\fP
.RS 4
استفاده از دایرکتوری مشخص‌شده برای ذخیره رونوشت‌های خام فایل‌های متاداده مخزن. مقدار پیش‌فرض \fB/var/cache/zypp/raw\fP است.
.RE
.sp
\fB\-\-solv\-cache\-dir\fP \fIdir\fP
.RS 4
استفاده از دایرکتوری مشخص‌شده برای ذخیره فایل‌های پایگاه داده کش متاداده مخزن (فایل‌های solv). مقدار پیش‌فرض \fB/var/cache/zypp/solv\fP است.
.RE
.sp
\fB\-\-pkg\-cache\-dir\fP \fIdir\fP
.RS 4
	استفاده از دایرکتوری مشخص‌شده برای ذخیره بسته‌های rpm بارگیری‌شده از مخازن (دستور \fBaddrepo \-\-keep\-packages\fP را ببینید). مقدار پیش‌فرض \fB/var/cache/zypp/packages\fP است.
+ بسته‌ها در زیردایرکتوری‌هایی که بر اساس نام مستعار مخزن نام‌گذاری شده‌اند و با همان مسیری که در رسانه مخازن دارند ذخیره می‌شوند.
.RE
.sp
\fB\-\-userdata\fP \fIstring\fP
.RS 4
انتظار می‌رود داده‌های کاربر یک رشته ساده بدون کاراکترهای خاص یا خطوط جدید تعبیه‌شده باشد و می‌تواند به عنوان شناسه تراکنش عمل کند. این مقدار در تمامی ورودی‌های لاگ تاریخچه نصب که در طول این فراخوانی مشخص زیپر ایجاد می‌شوند نوشته خواهد شد. همچنین به پلاگین‌های zypp که هنگام ثبت (commit) اجرا می‌شوند ارسال می‌گردد. این امر به عنوان مثال به یک پلاگین btrfs امکان می‌دهد تصاویر فوری (snapshots) ایجادشده را با این رشته برچسب‌گذاری کند. این رشته برای خود زیپر هیچ معنای خاصی ندارد.
.RE
.sp
گزینه‌های مخزن:
.RS 4

.RE
.sp
\fB\-\-no\-gpg\-checks\fP
.RS 4
نادیده گرفتن خطاهای بررسی GPG و ادامه دادن. اگر هنگام استفاده از این گزینه یک مشکل GPG رخ دهد، زیپر یک هشدار را چاپ و ثبت می‌کند و بدون ایجاد وقفه در عملیات، به طور خودکار ادامه می‌دهد. از این گزینه با احتیاط استفاده کنید، زیرا با استفاده از آن ممکن است به راحتی متوجه مشکلات امنیتی نشوید (بخش \fBبررسی‌های GPG (GPG checks)\fP را ببینید).
.RE
.sp
\fB\-\-gpg\-auto\-import\-keys\fP
.RS 4
اگر کلید امضای جدیدی برای مخزن یافت شد، سوال نپرسید؛ به آن اعتماد کرده و آن را به طور خودکار وارد کنید. این گزینه باعث می‌شود که کلید جدید در حالت غیرتعاملی نیز وارد شود، جایی که در غیر این صورت رد می‌شد.
.RE
.sp
\fB\-p\fP, \fB\-\-plus\-repo\fP \fIURI\fP
.RS 4
استفاده از یک مخزن اضافی برای این عملیات. مخزنی با نام مستعار tmp# و آدرس مشخص‌شده با URI برای این عملیات اضافه شده و در پایان حذف خواهد شد. می‌توانید این گزینه را چندین بار مشخص کنید.
.RE
.sp
\fB\-\-plus\-content\fP \fItag\fP
.RS 4
علاوه بر این، استفاده از مخازن غیرفعال مشخص‌شده توسط \fItag\fP برای این عملیات. اگر \fItag\fP با \fIنام مستعار\fP، \fIنام\fP یا \fIURL\fP یک مخزن مطابقت داشته باشد، یا یک \fIکلیدواژه\fP تعریف‌شده در متاداده مخزن باشد، آن مخزن به طور موقت برای این عملیات فعال خواهد شد. سپس مخزن بر اساس قوانین دستور تازه‌سازی شده و مورد استفاده قرار می‌گیرد. می‌توانید این گزینه را چندین بار مشخص کنید.
.sp
اگر متاداده‌های یک مخزن غیرفعال در کش محلی موجود نباشد، برای یافتن کلیدواژه‌های منطبق بارگیری خواهند شد. در غیر این صورت، اسکن کلیدواژه از متاداده‌های موجود در کش محلی استفاده خواهد کرد. تنها در صورتی که همراه با دستور \fBrefresh\fP استفاده شود، اسکن کلیدواژه \fIتمام\fP مخازن غیرفعال را تازه‌سازی خواهد کرد.
.sp
برای تازه‌سازی متاداده تمام مخازن غیرفعال:
.RS 4
\fBzypper \-\-plus\-content \*(Aq\*(Aq ref\fP
.RE
.sp
برای گنجاندن مخزن غیرفعال \fIrepo\-debug\fP در یک جستجو:
.RS 4
\fBzypper \-\-plus\-content repo\-debug search\fP \fI.\|.\|.\fP
.RE
.sp
برای جستجو فقط در مخزن غیرفعال \fIrepo\-debug\fP:
.RS 4
\fBzypper \-\-plus\-content repo\-debug search \-r repo\-debug\fP \fI.\|.\|.\fP
.RE
.sp
برای فعال کردن تمام مخازنی که کلیدواژه \fIdebug\fP را ارائه می‌دهند:
.RS 4
\fBzypper in \-\-plus\-content debug\fP \fIsome \-debuginfo or \-debugsource package\fP
.RE
.RE
.sp
\fB\-\-disable\-repositories\fP
.RS 4
عدم خواندن متاداده از مخازن. این گزینه مانع از بارگیری بسته‌ها از مخازن می‌شود، و در نتیجه باعث می‌شود زیپر تنها با بسته‌های نصب‌شده کار کند (در صورتی که \fB\-\-disable\-system\-resolvables\fP مشخص نشده باشد).
.RE
.sp
\fB\-\-no\-refresh\fP
.RS 4
مخازن به طور خودکار تازه‌سازی نشوند (نادیده گرفتن تنظیمات تازه‌سازی خودکار). برای صرفه‌جویی در زمان هنگام انجام عملیاتی مانند جستجو، در صورتی که نیازی به داشتن متاداده کاملاً به‌روز نباشد، مفید است.
.RE
.sp
\fB\-\-no\-cd\fP
.RS 4
نادیده گرفتن مخازن CD/DVD. هنگامی که این گزینه مشخص شود، زیپر طوری عمل می‌کند که گویی مخازن CD/DVD اصلاً تعریف نشده‌اند.
.RE
.sp
\fB\-\-no\-remote\fP
.RS 4
نادیده گرفتن مخازن دوردست مانند http، ftp، smb و موارد مشابه. این امر استفاده از زیپر را در حالت آفلاین آسان‌تر می‌کند. هنگامی که این گزینه مشخص شود، زیپر طوری عمل می‌کند که گویی مخازن دوردست اصلاً تعریف نشده‌اند.
.RE
.sp
\fB\-\-releasever\fP \fIversion\fP
.RS 4
برای دستور جاری، مقدار متغیر مخزن \fB$releasever\fP را روی \fIversion\fP تنظیم می‌کند. این کار می‌تواند برای جابه‌جایی به مخازن توزیع جدید هنگام انجام ارتقای توزیع به کار رود. برای جزئیات بیشتر در مورد استفاده از متغیر مخزن \fB$releasever\fP، دستور \fBdist\-upgrade\fP (\fBdup\fP) و بخش \fBمدیریت مخزن (Repository Management)\fP را ببینید.
.sp
برای بررسی این‌که هم‌اکنون در کجا از \fB$releasever\fP استفاده می‌کنید، دستور زیر را اجرا کنید:
.RS 4
\fBzypper \-\-releasever @\-\-HERE\-\-@ lr \-u\fP
.RE
.RE
.sp
گزینه‌های مقصد:
.RS 4

.RE
.sp
\fB\-R\fP, \fB\-\-root\fP \fIdir\fP
.RS 4
روی یک دایرکتوری ریشه متفاوت عمل می‌کند. این گزینه بر مکان دایرکتوری repos.d و دایرکتوری کش متاداده تأثیر می‌گذارد و همچنین باعث می‌شود rpm با گزینه \fB\-\-root\fP اجرا شود تا نصب یا حذف واقعی بسته‌ها انجام پذیرد. بخش \fBفایل‌ها (FILES)\fP را نیز ببینید.
.RE
.sp
\fB\-\-installroot\fP \fIdir\fP
.RS 4
مانند \fB\-\-root\fP رفتار می‌کند اما مخازن را با سیستم میزبان به اشتراک می‌گذارد.
.RE
.sp
\fB\-\-disable\-system\-resolvables\fP
.RS 4
این گزینه عمدتاً برای اهداف آزمایشی کاربرد دارد. این گزینه باعث می‌شود زیپر طوری عمل کند که گویی هیچ بسته‌ای در سیستم نصب نشده است. با احتیاط استفاده کنید زیرا می‌توانید با این گزینه به سیستم خود آسیب برسانید.
.RE
.SH "زیردستورها (SUBCOMMANDS)"
.sp
زیردستورهای زیپر از \fBgit\fP(1) الهام گرفته شده‌اند. زیردستورها برنامه‌های اجرایی مستقلی هستند که در دایرکتوری zypper_execdir (\fB/usr/lib/zypper/commands\fP) قرار دارند. برای زیردستورها، زیپر یک پوشش (wrapper) فراهم می‌کند که مکان زیردستورها را می‌داند و آن‌ها را با ارسال گزینه‌ها و آرگومان‌های دستور اجرا می‌کند. اگر زیردستوری در zypper_execdir پیدا نشود، پوشش در بقیه مسیرهای موجود در \fB$PATH\fP شما به دنبال آن خواهد گشت. بنابراین، نوشتن افزونه‌های محلی زیپر که در فضای سیستمی نیستند امکان‌پذیر است. این قابلیت را می‌توان با تنظیم "subcommand.seachSubcommandInPath" روی "no" در فایل zypper.conf غیرفعال کرد.
.sp
نحوه افزودن زیردستور خودتان به شکل \fBzypper\fP \fImytask\fP به این صورت است:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
فایل اجرایی باید \fBzypper\-\fP\fImytask\fP نامیده شود.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
فایل اجرایی باید در مسیر \fB$PATH\fP شما قرار داشته باشد.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
یک صفحه راهنما (manpage) برای \fBzypper\-\fP\fImytask\fP باید ارائه شود و گزینه‌ها و مقادیر بازگشتی دستور را توضیح دهد. این صفحه راهنما هنگام فراخوانی \fBzypper help\fP \fImytask\fP نشان داده خواهد شد.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
دستورات توکار زیپر نسبت به زیردستورهای هم‌نام اولویت دارند.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
فراخوانی زیپر یا استفاده از libzypp از داخل زیردستور شما بلامانع است.
.RE
.sp
می‌توانید از دستور توکار \fBzypper subcommand\fP برای دریافت فهرستی از تمام زیردستورها در zypper_execdir و سایر مکان‌های موجود در $PATH خود استفاده کنید.
.sp
استفاده از \fIگزینه‌های سراسری\fP زیپر همراه با زیردستورها، و همچنین اجرای زیردستورها در \fBzypper shell\fP در حال حاضر پشتیبانی نمی‌شود.
.SH "فایل‌ها (FILES)"
.sp
\fB/etc/zypp/zypper.conf\fP, \fB$HOME/.zypper.conf\fP
.RS 4
فایل پیکربندی سراسری (سیستمی) و کاربر برای \fIzypper\fP. این فایل‌ها هنگام راه‌اندازی زیپر و در صورت عدم استفاده از گزینه \fB\-\-config\fP خوانده می‌شوند.
.sp
تنظیمات کاربر بر تنظیمات سراسری ترجیح داده می‌شوند. به طور مشابه، گزینه‌های خط فرمان بر تنظیمات هر یک از این فایل‌ها برتری دارند. به طور خلاصه، ترتیب اولویت به صورت زیر است (از بیشترین به کمترین):
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 1." 4.2
.\}
\fIگزینه‌های خط فرمان\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 2." 4.2
.\}
\fB$HOME/.zypper.conf\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 3." 4.2
.\}
\fB/etc/zypp/zypper.conf\fP
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 4." 4.2
.\}
[\fB/etc/zypp/zypp.conf\fP] (پیش‌فرض‌های سراسری سیستم برای تمامی برنامه‌های مبتنی بر libzypp)
.RE
.sp
برای فهرستی از گزینه‌های موجود و توضیحات آن‌ها، توضیحات درون \fB/etc/zypp/zypper.conf\fP را ببینید.
.if n .sp
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
.B نکته
.ps -1
.br
.sp
فایل سراسری سیستم \fB/etc/zypp/zypp.conf\fP صرفاً از این جهت در اینجا ذکر شده که برخی از گزینه‌های خط فرمان زیپر امکان بازنویسی پیش‌فرض‌های سراسری سیستم تعریف‌شده در آن را می‌دهند. فایل‌های \fBzypp.conf\fP و \fBzypper.conf\fP محتوای متفاوتی دارند و اهداف متفاوتی را دنبال می‌کنند.
.sp .5v
.RE
.RE
.sp
\fB/etc/zypp/zypp.conf\fP
.RS 4
فایل پیکربندی ZYpp که بر تمام برنامه‌های مبتنی بر libzypp تأثیر می‌گذارد. برای توضیحات خصوصیات قابل پیکربندی، به نظرات درون فایل مراجعه کنید. بسیاری از مکان‌های فایل‌ها و دایرکتوری‌های فهرست‌شده در این بخش از طریق zypp.conf قابل پیکربندی هستند. مکان خود این فایل را تنها می‌توان با تنظیم متغیر محیطی \fB$ZYPP_CONF\fP مجدداً تعریف کرد.
.RE
.sp
\fB/etc/zypp/locks\fP
.RS 4
فایل حاوی تعاریف قفل بسته‌ها. برای دستکاری این فایل باید از دستورات قفل بسته (\fBlocks\fP، \fBaddlock\fP، \fBremovelock\fP و غیره) استفاده شود.
.sp
این فایل توسط تمامی برنامه‌های مبتنی بر ZYpp استفاده می‌شود.
.RE
.sp
\fB/etc/zypp/repos.d\fP
.RS 4
دایرکتوری حاوی فایل‌های تعریف مخزن (\fI*.repo\fP). می‌توانید از دستورات مدیریت مخزن برای دستکاری این فایل‌ها استفاده کنید، یا خودتان آن‌ها را ویرایش نمایید. در هر صورت، پس از انجام اصلاحات، اجرای *zypper refresh* اکیداً توصیه می‌شود.
.sp
می‌توانید از گزینه سراسری \fB\-\-reposd\-dir\fP برای استفاده از یک دایرکتوری جایگزین برای این منظور یا از گزینه \fB\-\-root\fP برای نسبی کردن این دایرکتوری به دایرکتوری ریشه مشخص‌شده استفاده کنید.
.sp
این دایرکتوری توسط تمامی برنامه‌های مبتنی بر ZYpp استفاده می‌شود.
.RE
.sp
\fB/etc/zypp/services.d\fP
.RS 4
دایرکتوری حاوی فایل‌های تعریف سرویس (\fI*.service\fP). می‌توانید از دستورات مدیریت سرویس برای دستکاری این فایل‌ها استفاده کنید، یا خودتان آن‌ها را ویرایش نمایید. پس از انجام اصلاحات، اجرای *zypper refs* توصیه می‌شود.
.sp
می‌توانید از گزینه سراسری \fB\-\-servicesd\-dir\fP برای استفاده از یک دایرکتوری جایگزین برای این منظور یا از گزینه \fB\-\-root\fP برای نسبی کردن این دایرکتوری به دایرکتوری ریشه مشخص‌شده استفاده کنید.
.sp
این دایرکتوری توسط تمامی برنامه‌های مبتنی بر ZYpp استفاده می‌شود.
.RE
.sp
\fB/usr/lib/zypper/commands\fP
.RS 4
دایرکتوری سیستمی حاوی افزونه‌های زیپر (بخش \fBزیردستورها (SUBCOMMANDS)\fP را ببینید)
.RE
.sp
\fB/var/cache/zypp/raw\fP
.RS 4
دایرکتوری ذخیره‌سازی متاداده‌های خام موجود در مخازن. از گزینه سراسری \fB\-\-raw\-cache\-dir\fP برای استفاده از یک دایرکتوری جایگزین برای این منظور یا از گزینه \fB\-\-root\fP برای نسبی کردن این دایرکتوری به دایرکتوری ریشه مشخص‌شده استفاده کنید.
.sp
این دایرکتوری توسط تمامی برنامه‌های مبتنی بر ZYpp استفاده می‌شود.
.RE
.sp
\fB/var/cache/zypp/solv\fP
.RS 4
دایرکتوری حاوی متاداده‌های پیش‌تحلیل‌شده در قالب فایل‌های \fIsolv\fP.
.sp
این دایرکتوری توسط تمامی برنامه‌های مبتنی بر ZYpp استفاده می‌شود.
.RE
.sp
\fB/var/cache/zypp/packages\fP
.RS 4
اگر ویژگی \fBkeep\-packages\fP برای یک مخزن تنظیم شده باشد (دستور \fBmodifyrepo\fP را ببینید)، تمام فایل‌های RPM بارگیری‌شده در حین نصب در اینجا نگهداری می‌شوند. بسته‌ها در زیردایرکتوری‌هایی ذخیره می‌شوند که بر اساس نام مستعار مخزن آن‌ها نام‌گذاری شده است.
.sp
زیردایرکتوری‌های مخازن حذف‌شده یا ناشناخته به طور خودکار پاکسازی می‌شوند. با ایجاد فایلی با نام \fB.no_auto_prune\fP در دایرکتوری pkg\-cache می‌توان از این پاکسازی خودکار جلوگیری کرد.
.sp
ایجاد یک فایل \fB.keep_packages\fP در دایرکتوری pkg\-cache، بسته‌های بارگیری‌شده را برای تمام مخازن کش‌شده در اینجا نگه می‌دارد و ویژگی \fBkeep\-packages\fP مخازن را نادیده می‌گیرد و بازنویسی می‌کند.
.sp
همچنین برای پاکسازی این دایرکتوری‌های کش، دستور \fBclean\fP را ببینید.
.sp
این دایرکتوری توسط تمامی برنامه‌های مبتنی بر ZYpp استفاده می‌شود.
.RE
.sp
\fB/var/log/zypper.log\fP
.RS 4
فایل لاگ زیپر. این فایل باید به تمام گزارش‌های باگ پیوست شود (همچنین zypper\-log(8) را ببینید).
.RE
.sp
\fB/var/log/zypper.solverTestCase\fP
.RS 4
مورد آزمون حل‌کننده که با استفاده از گزینه \fB\-\-debug\-solver\fP ایجاد شده است.
.RE
.sp
\fB/var/log/updateTestcase\-YYYY\-MM\-DD\-hh\-mm\-ss\fP
.RS 4
مورد آزمون حل‌کننده که به طور خودکار هنگام اجرای \fBzypper dup\fP ایجاد می‌شود.
.RE
.sp
\fB/var/log/zypp/history\fP
.RS 4
لاگ تاریخچه نصب.
.RE
.sp
\fB~/.zypper_history\fP
.RS 4
تاریخچه دستورات برای شل زیپر (دستور \fBshell\fP را ببینید).
.RE
.sp
\fB/etc/zypp/needreboot\fP
.RS 4
فایل حاوی فهرستی از بسته‌ها که در صورت نصب یا ارتقا، پرچم reboot\-needed را تنظیم می‌کنند.
.RE
.sp
\fB/etc/zypp/needreboot.d\fP
.RS 4
دایرکتوری که می‌توان با افزودن فایل‌های اضافی حاوی نام بسته‌های مورد نیاز، بسته‌هایی را تعریف کرد که پرچم reboot\-needed را فعال می‌کنند.
.RE
.SH "کدهای خروج (EXIT CODES)"
.sp
چندین کد خروج برای دستورات توکار زیپر جهت استفاده مثلاً در اسکریپت‌ها تعریف شده است. این کدها در فایل هدر src/zypper\-main.h در بسته سورس زیپر تعریف شده‌اند. کدهای زیر 100 نشان‌دهنده خطا هستند، کدهای بالای 100 اطلاعات خاصی ارائه می‌دهند، و 0 نشان‌دهنده اجرای موفق و عادی است. در ادامه فهرستی از این کدها به همراه توضیحات آمده است:
.sp
\fB0\fP \- \fBZYPPER_EXIT_OK\fP
.RS 4
اجرای موفقیت‌آمیز زیپر بدون اطلاعات خاص.
.RE
.sp
\fB1\fP \- \fBZYPPER_EXIT_ERR_BUG\fP
.RS 4
وضعیت غیرمنتظره‌ای رخ داده است، احتمالاً ناشی از یک باگ.
.RE
.sp
\fB2\fP \- \fBZYPPER_EXIT_ERR_SYNTAX\fP
.RS 4
زیپر با یک دستور یا گزینه نامعتبر، یا نحو نادرست فراخوانی شده است.
.RE
.sp
\fB3\fP \- \fBZYPPER_EXIT_ERR_INVALID_ARGS\fP
.RS 4
برخی از آرگومان‌های ارائه‌شده نامعتبر بودند. مثلاً یک URI نامعتبر به دستور \fBaddrepo\fP داده شده است.
.RE
.sp
\fB4\fP \- \fBZYPPER_EXIT_ERR_ZYPP\fP
.RS 4
مشکلی توسط کتابخانه ZYPP گزارش شده است.
.RE
.sp
\fB5\fP \- \fBZYPPER_EXIT_ERR_PRIVILEGES\fP
.RS 4
کاربر فراخواننده زیپر، مجوزهای کافی برای عملیات مشخص‌شده را ندارد.
.RE
.sp
\fB6\fP \- \fBZYPPER_EXIT_NO_REPOS\fP
.RS 4
هیچ مخزنی تعریف نشده است.
.RE
.sp
\fB7\fP \- \fBZYPPER_EXIT_ZYPP_LOCKED\fP
.RS 4
کتابخانه ZYPP قفل است، مثلاً packagekit در حال اجرا است.
.RE
.sp
\fB8\fP \- \fBZYPPER_EXIT_ERR_COMMIT\fP
.RS 4
خطایی هنگام نصب یا حذف بسته‌ها رخ داده است. می‌توانید برای اصلاح هرگونه مشکل وابستگی، \fBzypper verify\fP را اجرا کنید.
.RE
.sp
\fB100\fP \- \fBZYPPER_EXIT_INF_UPDATE_NEEDED\fP
.RS 4
توسط دستور patch\-check در صورتی که وصله‌هایی برای نصب در دسترس باشند برگردانده می‌شود.
.RE
.sp
\fB101\fP \- \fBZYPPER_EXIT_INF_SEC_UPDATE_NEEDED\fP
.RS 4
توسط دستور patch\-check در صورتی که وصله‌های امنیتی برای نصب در دسترس باشند برگردانده می‌شود.
.RE
.sp
\fB102\fP \- \fBZYPPER_EXIT_INF_REBOOT_NEEDED\fP
.RS 4
توسط دستور \fBneeds\-rebooting\fP در صورتی که راه‌اندازی مجدد سیستم پیشنهاد شود برگردانده می‌شود.
.sp
\fIقدیمی:\fP پس از نصب موفقیت‌آمیز وصله‌ای که نیازمند راه‌اندازی مجدد کامپیوتر است برگردانده می‌شود. این رفتار قدیمی حفظ شده است، اما عیب آن این است که فقط وصله‌ها را در بر می‌گیرد نه بسته‌ها را. دستور جدید \fBneeds\-rebooting\fP روش توصیه‌شده برای آزمایش این است که آیا راه‌اندازی مجدد سیستم پیشنهاد می‌شود یا خیر.
.RE
.sp
\fB103\fP \- \fBZYPPER_EXIT_INF_RESTART_NEEDED\fP
.RS 4
پس از نصب موفقیت‌آمیز وصله‌ای که نیازمند راه‌اندازی مجدد خود مدیر بسته است برگردانده می‌شود. این بدان معناست که یکی از وصله‌هایی که باید نصب شوند بر خود مدیر بسته تأثیر می‌گذارد و دستور مورد استفاده (مثلاً \fBzypper update\fP) باید یک بار دیگر برای نصب وصله‌های باقی‌مانده اجرا شود.
.RE
.sp
\fB104\fP \- \fBZYPPER_EXIT_INF_CAP_NOT_FOUND\fP
.RS 4
توسط دستور \fBinstall\fP و دستور \fBremove\fP در صورتی که هر یک از آرگومان‌ها با هیچ یک از نام بسته‌های موجود (یا نصب‌شده) یا سایر قابلیت‌ها مطابقت نداشته باشد، برگردانده می‌شود. در دستورات \fBsearch\fP و \fBinfo\fP نشان می‌دهد که هیچ موردی یافت نشد. همچنین گزینه سراسری \fB\-\-ignore\-unknown\fP را ببینید.
.RE
.sp
\fB105\fP \- \fBZYPPER_EXIT_ON_SIGNAL\fP
.RS 4
هنگام خروج پس از دریافت سیگنال SIGINT یا SIGTERM برگردانده می‌شود.
.RE
.sp
\fB106\fP \- \fBZYPPER_EXIT_INF_REPOS_SKIPPED\fP
.RS 4
برخی از مخازن به دلیل عدم موفقیت در تازه‌سازی مجبور به غیرفعال شدن موقت شدند. شما باید پیکربندی مخزن خود را بررسی کنید (مثلاً \fBzypper ref \-f\fP).
.RE
.sp
\fB107\fP \- \fBZYPPER_EXIT_INF_RPM_SCRIPT_FAILED\fP
.RS 4
نصب اساساً با موفقیت انجام شد، اما اسکریپت‌های post% نصب برخی از بسته‌ها خطا برگرداندند. این بسته‌ها با موفقیت روی دیسک باز شده و در پایگاه داده rpm ثبت شده‌اند، اما به دلیل اسکریپت نصب ناموفق ممکن است طبق انتظار کار نکنند. خروجی اسکریپت‌های ناموفق ممکن است مشخص کند واقعاً چه مشکلی پیش آمده است. هرگونه خروجی اسکریپت‌ها همچنین در \fB/var/log/zypp/history\fP ثبت می‌شود.
.RE
.sp
زیردستورهای زیپر (بخش \fBزیردستورها (SUBCOMMANDS)\fP را ببینید) ممکن است \fBکدهای متفاوتی\fP را برگردانند که باید در صفحه راهنمای دستورات شرح داده شوند. برای مشاهده صفحه راهنمای زیردستور در صورت ارائه شدن، \fBzypper help\fP \fIsubcommand\fP را فراخوانی کنید.
.SH "صفحه خانگی (HOMEPAGE)"
.sp
.URL "https://github.com/openSUSE/zypper" "" ""
.SH "نویسندگان (AUTHORS)"
.sp
پروژه زیپر توسط مارتین ویدنر (Martin Vidner)، یان کوپک (Jan Kupec)، مایکل آندرس (Michael Andres)، دانکن مک‌ویار پرت (Duncan Mac\-Vicar Prett)، جوزف ریدینگر (Josef Reidinger) و استانیسلاو ویشنوفسکی (Stanislav Visnovsky) آغاز شد. افراد بسیاری بعداً در آن مشارکت کردند.
.SH "همچنین ببینید (SEE ALSO)"
.sp
locks(5), zypper\-log(8), YaST2(8)