.TH "fwupd-remotes.d" "5" "" "2.1.7" "قالب پرونده مخزن راه دور"
.hy
.SH "نام (NAME)"
fwupd\-remotes.d \- پرونده‌های پیکربندی مخازن راه دور fwupd
.SH "خلاصه (SYNOPSIS)"
.PP
دایرکتوری‌های \f[B]/etc/fwupd/remotes.d\f[R] و \f[B]/var/fwupd/remotes.d\f[R] برای خواندن اطلاعات درباره منابع فراداده راه دور استفاده می‌شوند. شرح کامل قالب پرونده و پارامترهای ممکن در اینجا برای اهداف مرجع مستند شده است.
.SH "قالب پرونده (FILE FORMAT)"
.PP
پرونده از چندین بخش همراه با پارامترهای اختیاری تشکیل شده است. پارامترها به شکل زیر هستند:
.PP
.nf
[section]
key = value
.fi
.PP
این پرونده مبتنی بر خط است؛ هر خط منتهی به نویسه خط جدید بیانگر یک توضیح، نام یک بخش یا یک پارامتر است.
.PP
نام بخش‌ها و پارامترها به حروف بزرگ و کوچک حساس هستند.
.PP
تنها نخستین علامت مساوی در یک پارامتر معنادار است. فاصله‌های خالی قبل یا بعد از نخستین علامت مساوی و همچنین فاصله‌های خالی ابتدا و انتهای مقدار پارامتر نادیده گرفته می‌شوند. فاصله‌های خالی درون مقدار پارامتر حفظ می‌شوند.
.PP
هر خطی که با نویسه هش (\f[B]#\f[R]) شروع شود نادیده گرفته می‌شود، همان‌طور که خطوط حاوی فقط فاصله‌های خالی نادیده گرفته می‌شوند.
.PP
مقادیر پس از علامت مساوی در پارامترها همگی یا یک رشته (بدون نیاز به علامت نقل‌قول)، اعداد صحیح بدون علامت، یا یک مقدار بولی هستند که می‌تواند به‌صورت \f[B]true\f[R] یا \f[B]false\f[R] مشخص شود. بزرگی و کوچکی حروف در مقادیر بولی اهمیتی ندارد، اما در مقادیر رشته‌ای حفظ می‌شود.
.PP
برای ذخیره‌سازی اطلاعات اعتباری به ازای هر کاربر، مقادیر \f[B]Username\f[R] و \f[B]Password\f[R] مخزن راه دور را می‌توان به‌جای \f[B]/etc\f[R] در \f[B]XDG_CONFIG_HOME\f[R] نیز ذخیره کرد؛ برای نمونه در \f[B]~/.config/fwupd/remotes.d/lvfs-embargo.conf\f[R].
.SH "پارامترهای مخزن راه دور (REMOTE PARAMETERS)"
.PP
بخش \f[B][fwupd Remote]\f[R] می‌تواند شامل پارامترهای زیر باشد:
.PP
\f[B]Enabled=false\f[R]
.PP
مشخص می‌کند که آیا هنگام جستجوی انتشارها برای دستگاه‌ها، این مخزن راه دور باید در نظر گرفته شود یا خیر. تنها مخازن فعال هنگام استفاده از \f[B]fwupdmgr refresh\f[R] و هنگام بررسی این‌که چه به‌روزرسانی‌هایی برای هر دستگاه در دسترس است بازخوانی می‌شوند. این مقدار را می‌توان با استفاده از \f[B]fwupdmgr enable-remote\f[R] تغییر داد.
.PP
\f[B]Title=\f[R]
.PP
توضیح تک‌خطی برای نمایش در هرگونه ابزار رابط کاربری.
.PP
\f[B]MetadataURI=\f[R]
.PP
نشانی اینترنتی (URL) فراداده AppStream برای بارگیری و استفاده. این نشانی باید دارای پسوند \f[B].xml.gz\f[R] برای فراداده‌های قدیمی و \f[B].xml.xz\f[R] برای قالب مدرن‌تر باشد. در اینجا تنها پیشوندهای \f[B]http://\f[R]، \f[B]https://\f[R] و \f[B]file://\f[R] پشتیبانی می‌شوند.
.PP
\f[B]FirmwareBaseURI=\f[R]
.PP
نشانی پایه اختیاری آرشیوهای cabinet برای بارگیری. در صورت مشخص نشدن، نشانی پایه \f[B]MetadataURI\f[R] استفاده می‌شود. در اینجا تنها پیشوندهای \f[B]http://\f[R]، \f[B]https://\f[R] و \f[B]file://\f[R] پشتیبانی می‌شوند.
.PP
\f[B]ApprovalRequired=false\f[R]
.PP
در صورت تنظیم روی \f[B]true\f[R]، تنها انتشاراتی که با \f[B]fwupdmgr set-approved-firmware\f[R] در فهرست مجاز قرار گرفته‌اند در ابزارهای خط فرمان و رابط گرافیکی نمایش داده خواهند شد.
.PP
\f[B]ReportURI=\f[R]
.PP
نقطه پایانی (endpoint) برای ارسال گزارش‌های موفقیت برای میان‌افزار به‌دست‌آمده از این مخزن راه دور، یا خالی برای غیرفعال کردن این قابلیت.
.PP
\f[B]AutomaticReports=false\f[R]
.PP
اگر برابر با \f[B]true\f[R] باشد، پس از تکمیل به‌روزرسانی میان‌افزار، گزارش‌های موفقیت برای میان‌افزار به‌دست‌آمده از این مخزن راه دور را به‌صورت خودکار ارسال می‌کند.
.PP
\f[B]AutomaticSecurityReports=false\f[R]
.PP
اگر برابر با \f[B]true\f[R] باشد، هنگام اجرای \f[B]fwupdmgr security\f[R] گزارش‌های امنیتی بستر HSI را به‌صورت خودکار ارسال می‌کند.
.PP
\f[B]NoPhasedUpdates=false\f[R]
.PP
اگر برابر با \f[B]true\f[R] باشد، بررسی پیش‌نیاز برای استقرار مرحله‌ای تصادفی کلاینت را نادیده می‌گیرد.
.PP
واجد شرایط بودن یک سیستم برای به‌روزرسانی مرحله‌ای با مقداردهی اولیه تولیدکننده اعداد تصادفی توسط /etc/machine-id، نام پرونده آرشیو و زمان تغییر حافظه پنهان مخزن راه دور (mtime) تعیین می‌شود. اگر بذر اولیه بر مقدار \f[B]phased_update\f[R] ارائه‌شده در فراداده بدون باقی‌مانده بخش‌پذیر باشد، انتشار در نظر گرفته می‌شود. این امر همچنین بدان معناست که این بذر در یک دستگاه دیگر، برای یک به‌روزرسانی متفاوت، یا در صورت بازخوانی فراداده، متفاوت خواهد بود.
.PP
\f[B]OrderBefore=\f[R]
.PP
این مخزن راه دور پیش از هر مخزن دیگری که در اینجا فهرست شده باشد مرتب می‌شود؛ کاما به عنوان جداکننده استفاده می‌شود.
.PP
\f[B]یادداشت:\f[R] هنگامی که یک انتشار میان‌افزار یکسان از چند مخزن راه دور در دسترس باشد، مخزنی که بالاترین اولویت را دارد استفاده خواهد شد.
.PP
\f[B]OrderAfter=\f[R]
.PP
این مخزن راه دور پس از هر مخزن دیگری که در اینجا فهرست شده باشد مرتب می‌شود؛ کاما به عنوان جداکننده استفاده می‌شود.
.PP
\f[B]Username=\f[R]
.PP
نام کاربری برای احراز هویت پایه (BASIC authentication) هنگام بارگیری فراداده و میان‌افزار از این مخزن راه دور، و برای بارگذاری گزارش‌های موفقیت.
.PP
\f[B]Password=\f[R]
.PP
گذرواژه (اگرچه در عمل این یک توکن کاربری خواهد بود) برای احراز هویت پایه هنگام بارگیری فراداده و میان‌افزار از این مخزن راه دور، و برای بارگذاری گزارش‌های موفقیت.
.PP
\f[B]RefreshInterval=\f[R]
.PP
مدت زمان به ثانیه که پس از آن ابزارهای سمت کاربر باید امضای فراداده را مجدداً بارگیری کنند، یا \f[B]0\f[R] برای بارگیری مجدد در هر بار.
.SH "یادداشت‌ها (NOTES)"
.PP
نام پایه مسیر بدون پسوند به عنوان شناسه (ID) مخزن راه دور استفاده می‌شود. برای نمونه، پرونده مخزن راه دور \f[B]/etc/fwupd/remotes.d/lvfs.conf\f[R] دارای شناسه \f[B]lvfs\f[R] خواهد بود.
.SH "همچنین ببینید (SEE ALSO)"
.PP
.BR fwupd.conf (5)