.\"  Copyright (c) 2007-2022, The CHICKEN Team
.\"  All rights reserved.
.\"
.\"  Redistribution and use in source and binary forms, with or without
.\"  modification, are permitted provided that the following conditions
.\"  are met:
.\"  1. Redistributions of source code must retain the above copyright
.\"     notice, this list of conditions and the following disclaimer.
.\"  2. Redistributions in binary form must reproduce the above copyright
.\"     notice, this list of conditions and the following disclaimer in the
.\"     documentation and/or other materials provided with the distribution.
.\"  3. The name of the authors may not be used to endorse or promote products
.\"     derived from this software without specific prior written permission.
.\"
.\"  THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS OR
.\"  IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
.\"  OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
.\"  IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY DIRECT, INDIRECT,
.\"  INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
.\"  NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
.\"  DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
.\"  THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
.\"  (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\"  THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
.\"
.Dd 26 آوریل 2017
.Dt CHICKEN-INSTALL 1
.Os
.Sh "نام (NAME)"
.Nm chicken-install
.Nd ابزار دانلود و نصب بسته‌ها (eggs) در زبان Scheme CHICKEN
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm
.Op Ar OPTION ...
.Op Ar NAME[:VERSION] ...
.Sh "توضیحات (DESCRIPTION)"
دستور
.Nm
کتابخانه‌های افزونهٔ از پیش بسته‌بندی‌شده را از سورس (کد منبع) دانلود، کامپایل و نصب می‌کند.
اگر نام هیچ افزونه‌ای در خط فرمان مشخص نشود، هر فایل توصیف
.Em egg
موجود در دایرکتوری جاری به ترتیبی نامشخص اجرا خواهد شد.
.Pp
این برنامه گزینه‌ها و آرگومان‌های زیر را می‌پذیرد:
.Bl -tag -width Ds
.It Fl h , Fl help
نمایش راهنمای استفاده و خروج.
.It Fl version
نمایش نسخه و خروج.
.It Fl v , Fl verbose
چاپ اطلاعات تکمیلی و پرجزئیات در طول فرآیند نصب.
.It Fl force
نصب بدون درخواست تایید، حتی اگر نسخه‌ها مطابقت نداشته باشند.
.It Fl k , Fl keep
نگه‌داشتن فایل‌های موقت.
.It Fl s , Fl sudo
استفاده از یک برنامه خارجی برای ارتقای مجوزهای دسترسی جهت عملیات روی سیستم فایل.
برنامه پیش‌فرض
.Xr sudo 8
است اما می‌توان آن را با متغیر محیطی
.Ev SUDO
تغییر داد.
.It Fl r , Fl retrieve
فقط بسته (egg) را دریافت می‌کند و آن را نصب نمی‌کند
.No (مشخص کردن Fl r No بیش از یک بار به معنی Fl recursive No است).
.It Fl recursive
.No در صورت مشخص شدن Fl retrieve No ، وابستگی‌ها را نیز به‌صورت بازگشتی دریافت می‌کند.
.It Fl dry-run
صرف‌نظر از کامپایل و نصب، و فقط چاپ مسیر اسکریپت‌های تولیدشده برای بیلد و نصب.
.It Fl list-versions
فهرست کردن نسخه‌های موجود برای بسته‌های (eggs) مشخص‌شده.
.It Fl purge
حذف فایل‌های کش‌شده برای بسته‌های داده‌شده (یا پاکسازی کامل کش).
.It Fl host
هنگام کامپایل چندسکویی، افزونه‌ها را فقط برای سیستم میزبان (host) کامپایل می‌کند.
.It Fl target
هنگام کامپایل چندسکویی، افزونه‌ها را فقط برای سیستم مقصد (target) کامپایل می‌کند.
.It Fl test
اجرای آزمون‌های ارائه‌شده (test cases)، در صورت موجود بودن.
.It Fl n , Fl no-install
بسته را نصب نمی‌کند، فقط آن را کامپایل (بیلد) می‌کند.
.It Fl no-install-dependencies
وابستگی‌ها را نصب نمی‌کند. توجه داشته باشید که این گزینه ممکن است به دلیل نبود کتابخانه‌های افزونه منجر به شکست در کامپایل شود.
.It Fl u , Fl update-db
به‌روزرسانی پایگاه‌داده خروجی‌ها (export database).
.It Fl repository
چاپ مسیر مورد استفاده برای نصب بسته‌ها (eggs).
.It Fl override Ar filename
جایگزینی نسخه‌های بسته‌های نصب‌شده با اطلاعات برگرفته از
.Ar filename .
.It Fl from-list Ar filename
نصب بسته‌های فهرست‌شده در
.Ar filename
که قالبی مشابه با خروجی گزینه
.Fl list
دستور
.Xr chicken-status 1
دارد. این گزینه را می‌توان چندین بار مشخص کرد.
.It Fl cached
نصب بسته‌ها صرفاً از حافظهٔ کش و بدون دانلود مجدد.
.It Fl l , Fl location Ar directory
دریافت سورس بسته‌ها از دایرکتوری داده‌شده.
می‌توان این گزینه را چندین بار مشخص کرد.
مسیرهای تعیین‌شده در خط فرمان بر موارد تعیین‌شده در setup.defaults اولویت دارند.
.It Fl feature , Fl D Ar name
ثبت ویژگی با نام
.Ar name
که به عنوان شرط در عبارت‌های cond-expand قابل استفاده است.
.El
.Sh "محیط (ENVIRONMENT)"
متغیرهای محیطی زیر بر رفتار
.Nm
تأثیر می‌گذارند:
.Bl -tag -width CHICKEN_INSTALL_REPOSITORY
.It Ev CHICKEN_EGG_CACHE
مسیری که بسته‌ها در آن دریافت و کامپایل می‌شوند.
.It Ev CHICKEN_INSTALL_PREFIX
پیشوند مسیر برای تمام فایل‌های مقصد، همان‌طور که هنگام بیلد سیستم مشخص شده است.
از این متغیر برای تغییر مکان نصب برنامه‌ها، فایل‌های include و فایل‌های دادهٔ اضافی استفاده کنید.
.It Ev CHICKEN_INSTALL_REPOSITORY
مسیری که کتابخانه‌های افزونه در آن نصب می‌شوند. پیش‌فرض، مسیر کتابخانه بسته است که هنگام پیکربندی انتخاب شده است
.Pq معمولاً $prefix/lib/chicken/<binary-version> .
توجه داشته باشید که این متغیر بر CHICKEN_INSTALL_PREFIX اولویت دارد.
.It Ev SUDO
دستوری که هنگام استفاده از سوییچ
.Fl s
در خط فرمان اجرا می‌شود. در صورت مشخص نشدن، پیش‌فرض
.Xr sudo 8
است.
.El
.Sh "فایل‌ها (FILES)"
.Bl -tag -width 4n
.It Pa $XDG_CONFIG_HOME/chicken/setup.defaults
فایل setup.defaults اختصاصی کاربر (مقدار پیش‌فرض
.Ev $XDG_CONFIG_HOME
برابر با
.Pa $HOME/.config
است).
.It Pa $prefix/share/chicken/setup.default
فایل setup.defaults سرتاسری سیستم.
.It Pa $XDG_CACHE_HOME/chicken-install/
دایرکتوری پیش‌فرض برای بسته‌های کش‌شده (مقدار پیش‌فرض
.Ev $XDG_CACHE_HOME
برابر با
.Pa $HOME/.cache
است).
.El
.Sh "وضعیت خروج (EXIT STATUS)"
ابزار
.Nm
در صورت موفقیت با کد ۰ خارج می‌شود؛ در صورتی که کاربر عملیات را لغو کرده باشد با کد ۲؛ در صورتی که بدون نام صریح بسته فراخوانی شود و هیچ فایل *.egg در دایرکتوری جاری یافت نشود با کد ۳؛ و در صورت بروز هرگونه خطای دیگر با کدی بزرگ‌تر از ۰ خارج خواهد شد.
.Sh "مثال‌ها (EXAMPLES)"
نصب بسته
.Sq regex
توسط کاربر ریشه (root):
.Pp
.Dl # chicken-install regex
.Pp
نصب یک بسته توسط کاربر عادی اما با استفاده از
.Xr sudo 8 :
.Pp
.Dl $ chicken-install -s regex
.Pp
نصب یک بسته توسط کاربر عادی با ارتقای سطح دسترسی از طریق برنامه‌ای دیگر، مانند
.Xr doas 1
در OpenBSD:
.Pp
.Dl $ SUDO=/usr/bin/doas chicken-install -s regex
.Sh "همچنین ببینید (SEE ALSO)"
.Xr chicken 1 ,
.Xr chicken-status 1 ,
.Xr chicken-uninstall 1 ,
.Xr csc 1
.Pp
اطلاعات بیشتر را می‌توانید در
.Lk http://wiki.call-cc.org/manual/index "راهنمای کاربری CHICKEN"
بیابید.
.Sh "نویسندگان (AUTHORS)"
.An "تیم CHICKEN"
.Sh "اشکالات (BUGS)"
گزارش‌های اشکال را از طریق ایمیل به نشانی زیر ارسال کنید:
.Mt chicken-janitors@nongnu.org