.\" -*- mode: troff; coding: utf-8 -*-
.TH "" "5" ""
.SH "نام (NAME)"
.LP
alpm-install-scriptlet \- یک اسکریپت نصب سفارشی برای بسته‌های مبتنی بر ALPM.
.SH "توضیحات (DESCRIPTION)"
.LP
یک اسکریپت شل اختیاری که اقدامات سفارشی را برای اجرا در طول فرایند نصب، ارتقا یا حذف بسته تعریف می‌کند.
.PP
توابع شل در ریشهٔ (\f(CR/\fR) سیستم اجرا می‌شوند، بنابراین تمام مسیرها درون آن باید مطلق باشند.
.PP
چنین فایل‌هایی در ریشهٔ بسته‌های ALPM قرار دارند و نام آن‌ها \fB.INSTALL\fR است.
.SS "قالب کلی"
.LP
یک \fBalpm-install-scriptlet\fR ممکن است شامل صفر یا چند تابع شل مشخص باشد که اقداماتی را برای رویدادهای مختلف چرخهٔ حیات بسته تعریف می‌کنند.
تمامی این توابع اختیاری هستند و تنها توابعی که برای یک بسته خاص لازم هستند، می‌توانند گنجانده شوند.
.PP
این اسکریپت می‌تواند به زبان شلی نوشته شود که از گزینهٔ خط فرمان \f(CR-c\fR و فراخوانی توابع نام‌گذاری‌شده با آرگومان‌های اضافی از طریق رابط خط فرمان مفسر پشتیبانی می‌کند.
.PP
توجه داشته باشید که مفسر شل مورد استفاده توسط نرم‌افزار مدیریت بسته برای اجرای اسکریپت به صورت سراسری تعریف شده است (برای مثال به ازای هر توزیع).
هیچ شِبنگی (shebang) در اسکریپت استفاده نمی‌شود و تصمیم‌گیری دربارهٔ این که کدام شل برای اجرای آن استفاده شود بر اساس فراداده‌های بسته نیست، بلکه معمولاً در سطح توزیع یا سیستم تنظیم می‌شود.
این بدان معناست که مفسر شل را نمی‌توان برای هر بسته به صورت جداگانه تغییر داد.
.SS "توابع"
.LP
توابع موجود در زیر فهرست شده‌اند.
آن‌ها یک یا دو آرگومان می‌پذیرند که نسخه‌های بسته هستند و به صورت \fBalpm-package-version\fR ارائه می‌شوند.
.LP
.EX
pre_install
.EE
.PP
پیش از نصب بسته اجرا می‌شود، با نسخهٔ جدید بسته به عنوان آرگومان آن.
.LP
.EX
post_install
.EE
.PP
پس از نصب بسته اجرا می‌شود، با نسخهٔ جدید بسته به عنوان آرگومان آن.
.LP
.EX
pre_upgrade
.EE
.PP
پیش از ارتقای بسته اجرا می‌شود، با آرگومان‌های زیر:
.IP "1." 3
نسخهٔ جدید بسته
.if n \
.sp -1
.if t \
.sp -0.25v
.IP "2." 3
نسخهٔ قدیمی بسته
.LP
.EX
post_upgrade
.EE
.LP
پس از ارتقای بسته اجرا می‌شود، با آرگومان‌های زیر:
.IP "1." 3
نسخهٔ جدید بسته
.if n \
.sp -1
.if t \
.sp -0.25v
.IP "2." 3
نسخهٔ قدیمی بسته
.LP
.EX
pre_remove
.EE
.LP
پیش از حذف بسته اجرا می‌شود، با نسخهٔ قدیمی بسته به عنوان آرگومان آن.
.LP
.EX
post_remove
.EE
.PP
پس از حذف بسته اجرا می‌شود، با نسخهٔ قدیمی بسته به عنوان آرگومان آن.
.SH "مثال‌ها (EXAMPLES)"
.LP
نمونه‌ای از مشخص کردن اسکریپت نصب در فایل \fBPKGBUILD\fR:
.LP
.EX
install=example.install
.EE
.PP
نمونه‌ای از یک اسکریپت پایهٔ example.install:
.LP
.EX
pre_install() {
    echo \(dqPreparing to install package version $1\(dq
}

post_install() {
    echo \(dqPackage version $1 installed\(dq
}

pre_upgrade() {
    echo \(dqPreparing to upgrade from version $2 to $1\(dq
}

post_upgrade() {
    echo \(dqUpgraded from version $2 to $1\(dq
}

pre_remove() {
    echo \(dqPreparing to remove package version $1\(dq
}

post_remove() {
    echo \(dqPackage version $1 removed\(dq
}
.EE
.SH "همچنین ببینید (SEE ALSO)"
.LP
\fBbash\fR(1), \fBsh\fR(1), \fBPKGBUILD\fR(5), \fBalpm-package-version\fR(7), \fBpacman\fR(8), \fBmakepkg\fR(8)