قالب کلی

یک فایل alpm-db-desc فایلی با کدگذاری UTF-8 و جداشده با خط جدید است که از مجموعه‌ای از بخشها تشکیل شده است.

هر بخش با یک خط سربرگ بخش منحصربه‌فرد آغاز می‌شود. خط سربرگ بخش با یک یا چند خط دنبال می‌شود که هر کدام حاوی یک مقدار مختص بخش هستند. تمام مقادیر مختص بخش باید از نویسه‌های اسکی قابل چاپ[1] تشکیل شوند، مگر آنکه خلاف آن ذکر شده باشد. یک بخش زمانی پایان می‌یابد که به خط سربرگ بخش دیگری برخورد شود یا به پایان فایل برسد.

خطوط خالی میان بخش‌ها نادیده گرفته می‌شوند.

%NAME%

یک alpm-package-name، که نشان‌دهنده نام یک بسته است (مانند example).

%VERSION%

یک alpm-package-version (full یا full with epoch) که نشان‌دهنده نسخه یک بسته است (مانند 1.0-1).

%BASE%

یک alpm-package-base که پایه بسته را که بسته از آن سرچشمه می‌گیرد نشان می‌دهد. مقدار آن ممکن است با مقدار بخش %NAME% یکسان باشد.

%DESC%

توضیحات بسته. مقدار یک رشته UTF-8 به طول صفر یا بیشتر نویسه است (مانند A project used for something).

%URL%

نشانی اینترنتی (URL) برای پروژه بسته. مقدار یک URL معتبر یا یک رشته خالی است (مانند https://example.org).

%ARCH%

معماری بسته (برای اطلاعات بیشتر به alpm-architecture مراجعه کنید). مقدار باید از مجموعه نویسه‌های الفبایی-عددی و ‘_‘ تشکیل شده باشد (مانند x86_64 یا any).

%BUILDDATE%

تاریخی که ساخت بسته در آن آغاز شده است. مقدار باید عددی بوده و نشان‌دهنده ثانیه‌های سپری‌شده از مبدأ زمانی (Epoch)، معروف به ‘زمان یونیکس’ باشد (مانند 1729181726).

%INSTALLDATE%

تاریخی که بسته در آن روی سیستم نصب شده است. مقدار باید عددی بوده و نشان‌دهنده ثانیه‌های سپری‌شده از مبدأ زمانی (Epoch)، معروف به ‘زمان یونیکس’ باشد (مانند 1729181726).

%PACKAGER%

شناسه کاربری (User ID) موجودیتی که بسته را ساخته است. این مقدار برای جستجوی هویت در نظر گرفته شده و نمایانگر یک شناسه کاربری OpenPGP[2] است. به این ترتیب، این مقدار یک رشته کدگذاری‌شده با UTF-8 است که بر اساس عرف از یک نام و یک نشانی ایمیل تشکیل شده و با قالب توصیف‌شده در RFC 28223 مطابقت دارد.

%SIZE%

اندازه اختیاری محتویات بسته (فشرده‌نشده و استخراج‌شده) بر حسب بایت. مقدار یک عدد صحیح غیرمنفی است که اندازه مطلق محتویات بسته را نشان می‌دهد، به‌طوری‌که فایل‌های دارای چندین پیوند سخت (hardlink) تنها یک بار شمرده می‌شوند (مانند 181849963). اگر بسته فاقد اندازه باشد (برای نمونه به این دلیل که یک alpm-meta-package است)، از این بخش صرف‌نظر می‌شود.

%GROUPS%

یک alpm-package-group که نشان‌دهنده یک گروه در سطح توزیع است که بسته در آن قرار دارد. مقادیر ممکن است یک یا چند بار وجود داشته باشند. اگر بسته در هیچ گروهی نباشد، از این بخش صرف‌نظر می‌شود.

مقدار با یک رشته UTF-8 نمایش داده می‌شود. اگرچه استفاده از یک رشته UTF-8 امکان‌پذیر است، اما اکیداً توصیه می‌شود که به جای آن برای مقدار به قالب alpm-package-name تکیه شود، زیرا مدیران بسته ممکن است از یک گروه بسته برای نصب کل یک گروه از بسته‌ها استفاده کنند.

%REASON%

یک مقدار اختیاری که دلیل نصب بسته را نشان می‌دهد. مقدار باید یک عدد صحیح غیرمنفی باشد:

• 0: صریحاً نصب شده است
• 1: به عنوان یک وابستگی نصب شده است

اگر بسته صریحاً نصب شده باشد (مقدار 0)، از این بخش صرف‌نظر می‌شود.

%LICENSE%

مجموعه‌ای اختیاری از شناسه‌های مجوز که برای بسته اعمال می‌شوند. مقادیر ممکن است یک یا چند بار وجود داشته باشند. اگر هیچ شناسه مجوزی وجود نداشته باشد، از این بخش صرف‌نظر می‌شود.

هر مقدار نشان‌دهنده یک شناسه مجوز است که رشته‌ای با طول غیرصفر می‌باشد (مانند GPL). اگرچه به جز طول رشته هیچ محدودیت خاصی بر مقدار اعمال نمی‌شود، اما اکیداً توصیه می‌شود که بر عبارات مجوز SPDX تکیه شود (مانند GPL-3.0-or-later یا Apache-2.0 OR MIT). برای اطلاعات بیشتر، به فهرست مجوزهای SPDX[4] مراجعه کنید.

%VALIDATION%

روش‌های اعتبارسنجی استفاده‌شده هنگام نصب بسته برای اطمینان از اصالت آن. مقادیر ممکن است یک یا چند بار وجود داشته باشند. تنها مقادیر زیر قابل درک هستند:

• none: یکپارچگی و اصالت بسته اعتبارسنجی نمی‌شود.
• md5: بسته در برابر خلاصه درهم‌ساز MD-5 همراه در یک alpm-repo-db متعلق به مخزنی که بسته از آن نصب شده، اعتبارسنجی می‌شود.
• sha256: بسته در برابر خلاصه درهم‌ساز SHA-256 همراه در alpm-repo-db متعلق به مخزنی که بسته از آن نصب شده، اعتبارسنجی می‌شود.
• pgp: اصالت و یکپارچگی بسته با استفاده از یک امضای مجزای OpenPGP[5] و مجموعه‌ای سراسری از گواهی‌های OpenPGP[6] در سیستم اعتبارسنجی می‌شود. امضای دیجیتال ممکن است در فیلد %PGPSIG% از یک alpm-repo-db یا به صورت فایلی جداگانه در کنار فایل بسته وجود داشته باشد.

مقادیر md5، sha256 و pgp می‌توانند در ترکیب با یکدیگر استفاده شوند تا نشان دهند همه آن‌ها اعمال می‌شوند (برای نمونه، یک بسته ممکن است هم با خلاصه درهم‌ساز SHA-256 و هم با یک امضای مجزای OpenPGP اعتبارسنجی شود). با این حال، اگر هیچ اعتبارسنجی انجام نشود، تنها none به عنوان مقدار مجاز است.

%REPLACES%

یک مؤلفه مجازی یا بسته دیگر، که این بسته هنگام نصب جایگزین آن می‌شود. مقادیر ممکن است یک یا چند بار وجود داشته باشند. اگر بسته جایگزین چیزی نشود، از این بخش صرف‌نظر می‌شود. مقدار یک alpm-package-relation از نوع replacement است (مانند example یا example=1.0.0).

%DEPENDS%

یک وابستگی زمان اجرای بسته (مؤلفه مجازی یا بسته). مقادیر ممکن است یک یا چند بار وجود داشته باشند. اگر بسته هیچ وابستگی زمان اجرایی نداشته باشد، از این بخش صرف‌نظر می‌شود. مقدار یک alpm-package-relation از نوع run-time dependency است (مانند example یا example=1.0.0).

%OPTDEPENDS%

یک وابستگی اختیاری بسته (virtual component یا package). مقادیر ممکن است یک یا چند بار وجود داشته باشند. اگر بسته هیچ وابستگی اختیاری نداشته باشد، از این بخش صرف‌نظر می‌شود. مقدار یک alpm-package-relation از نوع optional dependency است (مانند example یا example: this is a description).

%CONFLICTS%

یک مؤلفه مجازی یا بسته دیگر، که این بسته با آن تداخل دارد. مقادیر ممکن است یک یا چند بار وجود داشته باشند. اگر بسته با چیزی تداخل نداشته باشد، از این بخش صرف‌نظر می‌شود. مقدار یک alpm-package-relation از نوع conflict است (مانند example یا example=1.0.0).

%PROVIDES%

یک مؤلفه مجازی یا بسته دیگر، که این بسته آن را فراهم می‌کند. مقادیر ممکن است یک یا چند بار وجود داشته باشند. اگر بسته چیزی فراهم نکند، از این بخش صرف‌نظر می‌شود. مقدار یک alpm-package-relation از نوع provision است (مانند example یا example=1.0.0).