نام (NAME)

ALPM-MTREEv1 - قالب توصیف سلسله‌مراتب دایرکتوری بسته

توضیحات (DESCRIPTION)

قالب mtree یک قالب متنی است که سلسله‌مراتب و متاداده‌های فایل‌ها را در یک دایرکتوری توصیف می‌کند.

قالب mtree قالبی شناخته‌شده است که می‌تواند برای مثال برای دستورالعمل‌های نصب یا برای اعتبارسنجی متاداده‌های فایل‌ها و سلسله‌مراتب یک دایرکتوری استفاده شود.

قالب ALPM-MTREE از مشخصات رسمی mtree پیروی می‌کند. با این حال، فایل‌های .MTREE که در زمینه بسته‌های ALPM استفاده می‌شوند، تنها از زیرمجموعه‌ای از قالب رسمی mtree استفاده می‌کنند که در حوزه بسته‌بندی کاربرد دارد.

ویژگی‌ها (Properties)

فایل‌های .MTREE تولید شده توسط makepkg تنها حاوی ویژگی‌های زیر هستند:

type
uid
gid
mode
time
size
md5
sha256
link

فایل‌های .MTREE در حوزه بسته‌های مبتنی بر ALPM استفاده می‌شوند و معمولاً به فایل‌های درون همان بسته‌های مربوطه اشاره دارند. به همین دلیل، تمام مسیرهای ارائه‌شده در یک فایل ALPM-MTREE باید نسبت به ریشه بسته نسبی باشند، به استثنای مقصدهای پیوند (link destinations) که می‌توانند نشان‌دهنده مسیرهای مطلق نیز باشند.

ویژگی نوع مسیر (Path Type Property)

برخلاف تمام انواع موجود در mtree، قالب ALPM-MTREE تنها سه نوع فایل را مجاز می‌داند:

dir یک دایرکتوری
file یک فایل
link یک پیوند نمادین (symbolic link)

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

فیلدهای الزامی بر اساس نوع فایل (Required Fields by File Type)

قالب ALPM-MTREE نیازمند مقادیر مشخصی برای برخی از انواع فایل است، چیزی که mtree بر اساس مشخصات خود الزامی نمی‌کند.

نوع مسیر dir نیازمند تنظیم ویژگی‌های زیر است:

path
uid
gid
mode
time

نوع مسیر file نیازمند تنظیم ویژگی‌های زیر است:

path
uid
gid
mode
size
md5_digest
sha256_digest
time

نوع مسیر link نیازمند تنظیم ویژگی‌های زیر است:

path
uid
gid
mode
link
time

کاربرد در Pacman (Usage in Pacman)

در Pacman فایل‌های ALPM-MTREE صرفاً برای اعتبارسنجی اینکه فایل‌های نصب‌شده با فایل‌های اصلی یکسان هستند بدون نیاز به نگهداری بسته اصلی استفاده می‌شوند. فایل‌های .MTREE هنگام ساخت بسته‌ها از طریق makepkg به‌طور ضمنی تولید و گنجانده می‌شوند. فایل .MTREE فشرده‌شده با gzip در ریشه بسته‌های مبتنی بر ALPM قرار دارد.

نسخه‌بندی (Versioning)

قالب ALPM-MTREE در چندین نسخه وجود دارد. اطلاعات موجود در این سند مربوط به نسخه ۱ است که منسوخ شده است. قالب ALPM-MTREE نسخه ۱ با انتشار pacman 4.6.0 در تاریخ ۲۰۱۲-۰۴-۳۰ معرفی شد.

مثال‌ها (EXAMPLES)

#mtree
/set type=file uid=0 gid=0 mode=644
./.BUILDINFO time=1696727741.0 size=5574 md5digest=04a85103d4780101c710a297aae33837 sha256digest=708be566788a6a2712bcd40425d93761569ede07371781374edb1f22e2a3eb96
./.PKGINFO time=1696727741.0 size=830 md5digest=bde30355e5b95a86c59afbd149cc28da sha256digest=3aa17bec02b34c157e7c739c62e0e37a9d19f1459d404d7c6f2c14c6008127cd
set mode=755 type=dir
./usr time=1731613789.0
./usr/bin time=1731613789.0
./usr/bin/resolvconf time=1731613789.0 mode=777 type=link link=resolvectl

تولید (Generation)

فایل‌های mtree مربوط به ALPM با فراخوانی زیر تولید می‌شوند:

bsdtar \
  --format=mtree \
  --options='!all,use-set,type,uid,gid,mode,time,size,md5,sha256,link' \
  $folder

کاربردها (Usages)

در چارچوب ALPM و pacman، هدف اصلی فایل mtree ارائه روشی با کارایی بالا جهت دریافت متاداده فایل‌های یک بسته بدون نیاز به استخراج و خواندن کل بسته است.

سپس از این داده‌ها برای اعتبارسنجی فایل‌های نصب‌شده روی سیستم هدف در برابر فایل‌های اصلی بسته استفاده می‌شود. برای جزئیات بیشتر به قابلیت بررسی پرسمان (query check) در pacman مراجعه کنید.

همچنین ببینید (SEE ALSO)

mtree(5), makepkg(8), pacman(8)