نام (NAME)

chicken-install — ابزار دانلود و نصب بسته‌ها (eggs) در زبان Scheme CHICKEN

خلاصه دستور (SYNOPSIS)

chicken-install [OPTION ...] [NAME[:VERSION] ...]

توضیحات (DESCRIPTION)

دستور chicken-install کتابخانه‌های افزونهٔ از پیش بسته‌بندی‌شده را از سورس (کد منبع) دانلود، کامپایل و نصب می‌کند. اگر نام هیچ افزونه‌ای در خط فرمان مشخص نشود، هر فایل توصیف egg موجود در دایرکتوری جاری به ترتیبی نامشخص اجرا خواهد شد.

این برنامه گزینه‌ها و آرگومان‌های زیر را می‌پذیرد:

-h, -help

نمایش راهنمای استفاده و خروج.

-version

نمایش نسخه و خروج.

-v, -verbose

چاپ اطلاعات تکمیلی و پرجزئیات در طول فرآیند نصب.

-force

نصب بدون درخواست تایید، حتی اگر نسخه‌ها مطابقت نداشته باشند.

-k, -keep

نگه‌داشتن فایل‌های موقت.

-s, -sudo

استفاده از یک برنامه خارجی برای ارتقای مجوزهای دسترسی جهت عملیات روی سیستم فایل. برنامه پیش‌فرض sudo(8) است اما می‌توان آن را با متغیر محیطی SUDO تغییر داد.

-r, -retrieve

فقط بسته (egg) را دریافت می‌کند و آن را نصب نمی‌کند (مشخص کردن -r بیش از یک بار به معنی -recursive است).

-recursive

در صورت مشخص شدن -retrieve ، وابستگی‌ها را نیز به‌صورت بازگشتی دریافت می‌کند.

-dry-run

صرف‌نظر از کامپایل و نصب، و فقط چاپ مسیر اسکریپت‌های تولیدشده برای بیلد و نصب.

-list-versions

فهرست کردن نسخه‌های موجود برای بسته‌های (eggs) مشخص‌شده.

-purge

حذف فایل‌های کش‌شده برای بسته‌های داده‌شده (یا پاکسازی کامل کش).

-host

هنگام کامپایل چندسکویی، افزونه‌ها را فقط برای سیستم میزبان (host) کامپایل می‌کند.

-target

هنگام کامپایل چندسکویی، افزونه‌ها را فقط برای سیستم مقصد (target) کامپایل می‌کند.

-test

اجرای آزمون‌های ارائه‌شده (test cases)، در صورت موجود بودن.

-n, -no-install

بسته را نصب نمی‌کند، فقط آن را کامپایل (بیلد) می‌کند.

-no-install-dependencies

وابستگی‌ها را نصب نمی‌کند. توجه داشته باشید که این گزینه ممکن است به دلیل نبود کتابخانه‌های افزونه منجر به شکست در کامپایل شود.

-u, -update-db

به‌روزرسانی پایگاه‌داده خروجی‌ها (export database).

-repository

چاپ مسیر مورد استفاده برای نصب بسته‌ها (eggs).

-override filename

جایگزینی نسخه‌های بسته‌های نصب‌شده با اطلاعات برگرفته از filename.

-from-list filename

نصب بسته‌های فهرست‌شده در filename که قالبی مشابه با خروجی گزینه -list دستور chicken-status(1) دارد. این گزینه را می‌توان چندین بار مشخص کرد.

-cached

نصب بسته‌ها صرفاً از حافظهٔ کش و بدون دانلود مجدد.

-l, -location directory

دریافت سورس بسته‌ها از دایرکتوری داده‌شده. می‌توان این گزینه را چندین بار مشخص کرد. مسیرهای تعیین‌شده در خط فرمان بر موارد تعیین‌شده در setup.defaults اولویت دارند.

-feature, -D name

ثبت ویژگی با نام name که به عنوان شرط در عبارت‌های cond-expand قابل استفاده است.

محیط (ENVIRONMENT)

متغیرهای محیطی زیر بر رفتار chicken-install تأثیر می‌گذارند:

CHICKEN_EGG_CACHE

مسیری که بسته‌ها در آن دریافت و کامپایل می‌شوند.

CHICKEN_INSTALL_PREFIX

پیشوند مسیر برای تمام فایل‌های مقصد، همان‌طور که هنگام بیلد سیستم مشخص شده است. از این متغیر برای تغییر مکان نصب برنامه‌ها، فایل‌های include و فایل‌های دادهٔ اضافی استفاده کنید.

CHICKEN_INSTALL_REPOSITORY

مسیری که کتابخانه‌های افزونه در آن نصب می‌شوند. پیش‌فرض، مسیر کتابخانه بسته است که هنگام پیکربندی انتخاب شده است (معمولاً $prefix/lib/chicken/<binary-version>). توجه داشته باشید که این متغیر بر CHICKEN_INSTALL_PREFIX اولویت دارد.

SUDO

دستوری که هنگام استفاده از سوییچ -s در خط فرمان اجرا می‌شود. در صورت مشخص نشدن، پیش‌فرض sudo(8) است.

فایل‌ها (FILES)

$XDG_CONFIG_HOME/chicken/setup.defaults

فایل setup.defaults اختصاصی کاربر (مقدار پیش‌فرض $XDG_CONFIG_HOME برابر با $HOME/.config است).

$prefix/share/chicken/setup.default

فایل setup.defaults سرتاسری سیستم.

$XDG_CACHE_HOME/chicken-install/

دایرکتوری پیش‌فرض برای بسته‌های کش‌شده (مقدار پیش‌فرض $XDG_CACHE_HOME برابر با $HOME/.cache است).

وضعیت خروج (EXIT STATUS)

ابزار chicken-install در صورت موفقیت با کد ۰ خارج می‌شود؛ در صورتی که کاربر عملیات را لغو کرده باشد با کد ۲؛ در صورتی که بدون نام صریح بسته فراخوانی شود و هیچ فایل *.egg در دایرکتوری جاری یافت نشود با کد ۳؛ و در صورت بروز هرگونه خطای دیگر با کدی بزرگ‌تر از ۰ خارج خواهد شد.

مثال‌ها (EXAMPLES)

نصب بسته ‘regex’ توسط کاربر ریشه (root):

نصب یک بسته توسط کاربر عادی اما با استفاده از sudo(8):

نصب یک بسته توسط کاربر عادی با ارتقای سطح دسترسی از طریق برنامه‌ای دیگر، مانند doas(1) در OpenBSD:

همچنین ببینید (SEE ALSO)

chicken(1), chicken-status(1), chicken-uninstall(1), csc(1)

اطلاعات بیشتر را می‌توانید در راهنمای کاربری CHICKEN بیابید.

نویسندگان (AUTHORS)

تیم CHICKEN

اشکالات (BUGS)

گزارش‌های اشکال را از طریق ایمیل به نشانی زیر ارسال کنید: chicken-janitors@nongnu.org