.\" -*- mode: troff; coding: utf-8 -*-
.TH "ALPM-DB-FILES" "5" "" "Pacman" "راهنمای قالب‌های فایل"
.SH "نام (NAME)"
.LP
alpm-db-files \- قالب پرونده برای فهرست کردن پرونده‌ها، پوشه‌ها و متاداده‌های پشتیبان‌گیری موجود در یک \fBalpm-package\fR نصب‌شده.
.SH "توضیحات (DESCRIPTION)"
.LP
قالب \fBalpm-db-files\fR یک قالب متنی است که پوشه‌ها و پرونده‌های موجود در یک \fBalpm-package\fR منفرد را فهرست می‌کند.
علاوه بر این، جمع‌آزمای (checksum) هر پرونده‌ای را در یک بسته که در صورت تغییر در سیستم مقصد باید از آن پشتیبان‌گیری شود، کدگذاری می‌کند (برای قابلیت مربوطه، کلیدواژه \fBbackup\fR را در \fBPKGBUILD\fR، \fBPKGINFO\fR و \fBSRCINFO\fR ببینید).
.PP
چنین پرونده‌هایی \fBfiles\fR نامیده می‌شوند و در ساختارهای \fBalpm-db\fR قرار دارند.
آن‌ها توسط نرم‌افزار مدیریت بسته (مانند \fBpacman\fR) از محتویات پرونده‌های \fBalpm-package\fR (برای قابلیت \fBbackup\fR با کمک \fBPKGINFO\fR) ایجاد می‌شوند.
نرم‌افزار مدیریت بسته از آن‌ها برای فهرست کردن و پرس‌وجوی مسیرهای پوشه‌ها و پرونده‌های موجود در پرونده بسته و ردیابی وضعیت پرونده‌هایی که در صورت تغییر در سیستم مقصد باید پشتیبان‌گیری شوند، استفاده می‌کند.
.PP
مهم است که \fBalpm-db-files\fR را با \fBalpm-repo-files\fR که از همان نام پرونده (\fBfiles\fR) استفاده می‌کند اما در چارچوب یک \fBalpm-repo-db\fR به کار می‌رود، اشتباه نگیرید.
.SS
قالب کلی
.LP
یک پرونده \fBalpm-db-files\fR یک پرونده با کدگذاری UTF-8 و جداشده با خط جدید است.
.PP
این پرونده ممکن است خالی باشد، یا شامل یک یا دو سربرگ بخش باشد که هر کدام یک یا چند مدخل بخش دارند.
خطوط خالی نادیده گرفته می‌شوند.
از یادداشت‌ها (کامنت‌ها) پشتیبانی نمی‌شود.
.SS
بخش‌ها
.LP
هر خط سربرگ بخش شامل نام بخش با حروف تمام بزرگ است که با نشانه‌های درصد احاطه شده است (مانند \f(CR%FILES%\fR).
نام بخش‌ها به عنوان کلید برای هر مقدار مختص بخش عمل می‌کنند.
.PP
هر بخش پس از \fIخط سربرگ بخش\fR، امکان قرارگیری یک یا چند \fIمقدار مختص بخش\fR را فراهم می‌کند.
.PP
توجه داشته باشید که اگر یک بسته هیچ پرونده‌ای را ردیابی نکند (مانند \fBalpm-meta-package\fR)، هیچ‌یک از بخش‌های زیر وجود نخواهند داشت و پرونده \fBalpm-db-files\fR خالی خواهد بود.
.SS
%FILES%
.LP
هر مقدار در این بخش نمایانگر مسیر یک پرونده یا پوشه منفرد است.
قوانین قالب‌بندی زیر بر مسیرها اعمال می‌شوند:
.IP "\(bu" 3
پوشه‌ها همیشه با یک ممیز انتهایی (\f(CR/\fR) فهرست می‌شوند.
.if n \
.sp -1
.if t \
.sp -0.25v
.IP "\(bu" 3
تمام مسیرها نسبت به ریشه سیستم هستند (یعنی \f(CR/usr/bin/foo\fR به صورت \f(CRusr/bin/foo\fR نشان داده می‌شود).
.SS
%BACKUP%
.LP
هر مقدار در این بخش با یک مسیر پرونده منفرد، یک نویسه Tab و خلاصه درهم‌ساز \fBMD-5\fR(1) پرونده به همان صورتی که در \fBalpm-package\fR توصیف‌شده توسط پرونده \fBalpm-db-files\fR یافت می‌شود، نمایش داده می‌شود (مانند \f(CRetc/foo.conf d41d8cd98f00b204e9800998ecf8427e\fR).
.PP
تمام مسیرهای پرونده باید نسبت به ریشه سیستم باشند (یعنی \f(CR/usr/bin/foo\fR به صورت \f(CRusr/bin/foo\fR نشان داده می‌شود).
.PP
این بخش تنها در صورتی می‌تواند وجود داشته باشد که بخش \f(CR%FILES%\fR نیز موجود باشد و انتظار می‌رود هر مسیر پرونده به عنوان یک مقدار در بخش \f(CR%FILES%\fR نیز وجود داشته باشد.
.SH "مثال‌ها (EXAMPLES)"
.LP
در ادامه نمونه‌ای از یک پرونده \fBalpm-db-files\fR برای بسته‌ای به نام \f(CRfoo\fR آورده شده است:
.LP
.EX
%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
.EE
.PP
بخش \f(CR%FILES%\fR پرونده‌ها و مسیرهای پوشه متعلق به بسته را فهرست می‌کند، در حالی که بخش \f(CR%BACKUP%\fR خلاصه درهم‌ساز \fBMD-5\fR یک پرونده پیکربندی را همان‌طور که در پرونده بسته یافت می‌شود ثبت می‌کند.
.SH "همچنین ببینید (SEE ALSO)"
.LP
\fBPKGBUILD\fR(5), \fBPKGINFO\fR(5), \fBSRCINFO\fR(5), \fBalpm-repo-files\fR(5), \fBalpm-db\fR(7), \fBalpm-meta-package\fR(7), \fBalpm-package\fR(7), \fBalpm-package-name\fR(7), \fBalpm-repo-db\fR(7), \fBpacman\fR(8)
.SH "یادداشت‌ها (NOTES)"
.IP "1." 3
MD-5
.IP
.UR https://en.wikipedia.org/wiki/MD5
.UE