| ALPM-DB-FILES(5) | راهنمای قالبهای فایل | ALPM-DB-FILES(5) |
نام (NAME)
alpm-db-files - قالب پرونده برای فهرست کردن پروندهها، پوشهها و متادادههای پشتیبانگیری موجود در یک alpm-package نصبشده.
توضیحات (DESCRIPTION)
قالب alpm-db-files یک قالب متنی است که پوشهها و پروندههای موجود در یک alpm-package منفرد را فهرست میکند. علاوه بر این، جمعآزمای (checksum) هر پروندهای را در یک بسته که در صورت تغییر در سیستم مقصد باید از آن پشتیبانگیری شود، کدگذاری میکند (برای قابلیت مربوطه، کلیدواژه backup را در PKGBUILD، PKGINFO و SRCINFO ببینید).
چنین پروندههایی files نامیده میشوند و در ساختارهای alpm-db قرار دارند. آنها توسط نرمافزار مدیریت بسته (مانند pacman) از محتویات پروندههای alpm-package (برای قابلیت backup با کمک PKGINFO) ایجاد میشوند. نرمافزار مدیریت بسته از آنها برای فهرست کردن و پرسوجوی مسیرهای پوشهها و پروندههای موجود در پرونده بسته و ردیابی وضعیت پروندههایی که در صورت تغییر در سیستم مقصد باید پشتیبانگیری شوند، استفاده میکند.
مهم است که alpm-db-files را با alpm-repo-files که از همان نام پرونده (files) استفاده میکند اما در چارچوب یک alpm-repo-db به کار میرود، اشتباه نگیرید.
قالب کلی
یک پرونده alpm-db-files یک پرونده با کدگذاری UTF-8 و جداشده با خط جدید است.
این پرونده ممکن است خالی باشد، یا شامل یک یا دو سربرگ بخش باشد که هر کدام یک یا چند مدخل بخش دارند. خطوط خالی نادیده گرفته میشوند. از یادداشتها (کامنتها) پشتیبانی نمیشود.
بخشها
هر خط سربرگ بخش شامل نام بخش با حروف تمام بزرگ است که با نشانههای درصد احاطه شده است (مانند %FILES%). نام بخشها به عنوان کلید برای هر مقدار مختص بخش عمل میکنند.
هر بخش پس از خط سربرگ بخش، امکان قرارگیری یک یا چند مقدار مختص بخش را فراهم میکند.
توجه داشته باشید که اگر یک بسته هیچ پروندهای را ردیابی نکند (مانند alpm-meta-package)، هیچیک از بخشهای زیر وجود نخواهند داشت و پرونده alpm-db-files خالی خواهد بود.
%FILES%
هر مقدار در این بخش نمایانگر مسیر یک پرونده یا پوشه منفرد است. قوانین قالببندی زیر بر مسیرها اعمال میشوند:
- پوشهها همیشه با یک ممیز انتهایی (/) فهرست میشوند.
- تمام مسیرها نسبت به ریشه سیستم هستند (یعنی /usr/bin/foo به صورت usr/bin/foo نشان داده میشود).
%BACKUP%
هر مقدار در این بخش با یک مسیر پرونده منفرد، یک نویسه Tab و خلاصه درهمساز MD-5(1) پرونده به همان صورتی که در alpm-package توصیفشده توسط پرونده alpm-db-files یافت میشود، نمایش داده میشود (مانند etc/foo.conf d41d8cd98f00b204e9800998ecf8427e).
تمام مسیرهای پرونده باید نسبت به ریشه سیستم باشند (یعنی /usr/bin/foo به صورت usr/bin/foo نشان داده میشود).
این بخش تنها در صورتی میتواند وجود داشته باشد که بخش %FILES% نیز موجود باشد و انتظار میرود هر مسیر پرونده به عنوان یک مقدار در بخش %FILES% نیز وجود داشته باشد.
مثالها (EXAMPLES)
در ادامه نمونهای از یک پرونده alpm-db-files برای بستهای به نام foo آورده شده است:
%FILES% etc/ etc/foo.conf usr/ usr/bin/ usr/bin/foo usr/share/ usr/share/doc/ usr/share/doc/foo/ usr/share/doc/foo/README.md %BACKUP% etc/foo.conf d41d8cd98f00b204e9800998ecf8427e
بخش %FILES% پروندهها و مسیرهای پوشه متعلق به بسته را فهرست میکند، در حالی که بخش %BACKUP% خلاصه درهمساز MD-5 یک پرونده پیکربندی را همانطور که در پرونده بسته یافت میشود ثبت میکند.
همچنین ببینید (SEE ALSO)
PKGBUILD(5), PKGINFO(5), SRCINFO(5), alpm-repo-files(5), alpm-db(7), alpm-meta-package(7), alpm-package(7), alpm-package-name(7), alpm-repo-db(7), pacman(8)
یادداشتها (NOTES)
| Pacman |