.\" Generated by scdoc 1.11.5
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "apk\-protected_paths" "5" "2026\-08\-31"
.PP
.SH "نام (NAME)"
apk\-protected_paths \- مسیرهای دارای رفتار ویژه توسط apk
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
فایل‌های موجود در \fI/etc/apk/protected_paths.\&d/*.\&list\fR فایل‌هایی را مشخص می‌کنند که محافظت‌شده هستند و توسط \fBapk\fR(8) رونویسی نمی‌شوند.\& معمولاً این پرونده‌ها، فایل‌های پیکربندی هستند که انتظار می‌رود توسط مدیر سیستم تغییر داده شوند.\& این فایل‌ها همچنین از سوی \fBapk\-audit\fR(8) رفتار ویژه‌ای دریافت می‌کنند.\&
.PP
اگر \fBapk\fR(8) بخواهد فایلی را در یک مسیر محافظت‌شده که تغییر یافته است نصب کند، در عوض فایل را درون پرونده‌ای با پسوند \fI.\&apk\-new\fR می‌نویسد.\&
.PP
به عنوان مثال، هنگامی که فایل \fI/etc/passwd\fR توسط مدیر محلی سیستم تغییر داده شود، \fBapk\fR(8) نباید هنگام ارتقا یا تعمیر بسته‌ها آن را رونویسی کند.\& به همین ترتیب، فایل‌های محافظت‌شده‌ای که توسط هرگونه خودکارسازی (از جمله اسکریپت‌های post\-install) تغییر یافته‌اند نیز رونویسی نمی‌شوند.\&
.PP
دستور \fBapk\-audit\fR(8) به‌طور پیش‌فرض مسیرهای محافظت‌شده را گزارش می‌دهد.\& هنگام استفاده از \fBapk audit \-\-system\fR یا \fBapk audit \-\-full\fR، فایل‌های محافظت‌شده از خروجی حذف می‌شوند.\& هنگام استفاده از \fBapk audit \-\-backup\fR، فایل‌های منطبق همیشه گزارش می‌شوند.\& این مورد به نوبه خود توسط \fBlbu commit\fR استفاده می‌شود.\&
.PP
.SH "قالب فایل (FILE FORMAT)"
.PP
هر خط یک قاعده منفرد متشکل از یک نماد و به دنبال آن یک عبارت الگو (glob) است، که نسبت به دایرکتوری ریشه ارزیابی می‌شود.\&
.PP
نماد اولیه باید یکی از موارد زیر باشد:
.PP
\fB+\fR
.RS 4
محافظت از مسیرهای منطبق، تنها در صورتی که چکسام (checksum) فایل با چکسام موجود در پایگاه داده apk مطابقت نداشته باشد.\&
.PP
.RE
\fB\-\fR
.RS 4
عدم محافظت از مسیرهای منطبق، حتی اگر با یک قاعده قبلی مطابقت داشته باشد.\&
.PP
.RE
\fB@\fR
.RS 4
محافظت از مسیرهای منطبق، تنها در صورتی که پیوندهای نمادین (symlinks) تغییریافته باشند.\&
.PP
.RE
\fB!\&\fR
.RS 4
محافظت بدون قید و شرط از مسیر منطبق.\&
.PP
.RE
خطوطی که با \fB#\fR آغاز می‌شوند و خطوط خالی نادیده گرفته می‌شوند.\&
.PP
.SH "پیش‌فرض‌ها (DEFAULTS)"
.PP
حتی اگر \fI/etc/apk/protected_paths.\&d/*.\&list\fR خالی باشد، موارد زیر به‌طور پیش‌فرض استفاده می‌شوند:
.PP
.nf
.RS 4
+etc/
@etc/init\&.d
!etc/apk
.fi
.RE
.PP
محتویات \fI/etc/apk/protected_paths.\&d/*.\&list\fR پس از پیش‌فرض‌های بالا اعمال می‌شوند.\& هنگامی که یک گزینه دایرکتوری \fIprotected_paths.\&d\fR را بازنویسی (override) کند، این پیش‌فرض‌ها را نیز بازنویسی می‌کند.\&
.PP
.SH "مثال‌های بیشتر (MORE EXAMPLES)"
.PP
.nf
.RS 4
# This line is ignored; it is a comment\&.
-etc/ssl/certs/ca\-cert\-*\&.pem
.fi
.RE
.PP
.SH "هشدارها (CAVEATS)"
.PP
اگر فایلی تغییر داده شود و محتوای آن در نهایت با آنچه در ابتدا توسط apk نصب شده بود یکسان گردد، آن فایل دست‌نخورده در نظر گرفته می‌شود.\&
.PP
الگوهای عمومی (wildcard) هنگام ایجاد فایل‌های \fB.\&apk\-new\fR به جای رونویسی فایل‌ها، توسط \fBapk\fR(8) در نظر گرفته نمی‌شوند.\&
.PP
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBapk\fR(8), \fBapk\-audit\fR(8)