fwupd-remotes.d(5) قالب پرونده مخزن راه دور fwupd-remotes.d(5)

fwupd-remotes.d - پرونده‌های پیکربندی مخازن راه دور fwupd

دایرکتوری‌های /etc/fwupd/remotes.d و /var/fwupd/remotes.d برای خواندن اطلاعات درباره منابع فراداده راه دور استفاده می‌شوند. شرح کامل قالب پرونده و پارامترهای ممکن در اینجا برای اهداف مرجع مستند شده است.

پرونده از چندین بخش همراه با پارامترهای اختیاری تشکیل شده است. پارامترها به شکل زیر هستند:

[section]
key = value

این پرونده مبتنی بر خط است؛ هر خط منتهی به نویسه خط جدید بیانگر یک توضیح، نام یک بخش یا یک پارامتر است.

نام بخش‌ها و پارامترها به حروف بزرگ و کوچک حساس هستند.

تنها نخستین علامت مساوی در یک پارامتر معنادار است. فاصله‌های خالی قبل یا بعد از نخستین علامت مساوی و همچنین فاصله‌های خالی ابتدا و انتهای مقدار پارامتر نادیده گرفته می‌شوند. فاصله‌های خالی درون مقدار پارامتر حفظ می‌شوند.

هر خطی که با نویسه هش (#) شروع شود نادیده گرفته می‌شود، همان‌طور که خطوط حاوی فقط فاصله‌های خالی نادیده گرفته می‌شوند.

مقادیر پس از علامت مساوی در پارامترها همگی یا یک رشته (بدون نیاز به علامت نقل‌قول)، اعداد صحیح بدون علامت، یا یک مقدار بولی هستند که می‌تواند به‌صورت true یا false مشخص شود. بزرگی و کوچکی حروف در مقادیر بولی اهمیتی ندارد، اما در مقادیر رشته‌ای حفظ می‌شود.

برای ذخیره‌سازی اطلاعات اعتباری به ازای هر کاربر، مقادیر Username و Password مخزن راه دور را می‌توان به‌جای /etc در XDG_CONFIG_HOME نیز ذخیره کرد؛ برای نمونه در ~/.config/fwupd/remotes.d/lvfs-embargo.conf.

بخش [fwupd Remote] می‌تواند شامل پارامترهای زیر باشد:

Enabled=false

مشخص می‌کند که آیا هنگام جستجوی انتشارها برای دستگاه‌ها، این مخزن راه دور باید در نظر گرفته شود یا خیر. تنها مخازن فعال هنگام استفاده از fwupdmgr refresh و هنگام بررسی این‌که چه به‌روزرسانی‌هایی برای هر دستگاه در دسترس است بازخوانی می‌شوند. این مقدار را می‌توان با استفاده از fwupdmgr enable-remote تغییر داد.

Title=

توضیح تک‌خطی برای نمایش در هرگونه ابزار رابط کاربری.

MetadataURI=

نشانی اینترنتی (URL) فراداده AppStream برای بارگیری و استفاده. این نشانی باید دارای پسوند .xml.gz برای فراداده‌های قدیمی و .xml.xz برای قالب مدرن‌تر باشد. در اینجا تنها پیشوندهای http://، https:// و file:// پشتیبانی می‌شوند.

FirmwareBaseURI=

نشانی پایه اختیاری آرشیوهای cabinet برای بارگیری. در صورت مشخص نشدن، نشانی پایه MetadataURI استفاده می‌شود. در اینجا تنها پیشوندهای http://، https:// و file:// پشتیبانی می‌شوند.

ApprovalRequired=false

در صورت تنظیم روی true، تنها انتشاراتی که با fwupdmgr set-approved-firmware در فهرست مجاز قرار گرفته‌اند در ابزارهای خط فرمان و رابط گرافیکی نمایش داده خواهند شد.

ReportURI=

نقطه پایانی (endpoint) برای ارسال گزارش‌های موفقیت برای میان‌افزار به‌دست‌آمده از این مخزن راه دور، یا خالی برای غیرفعال کردن این قابلیت.

AutomaticReports=false

اگر برابر با true باشد، پس از تکمیل به‌روزرسانی میان‌افزار، گزارش‌های موفقیت برای میان‌افزار به‌دست‌آمده از این مخزن راه دور را به‌صورت خودکار ارسال می‌کند.

AutomaticSecurityReports=false

اگر برابر با true باشد، هنگام اجرای fwupdmgr security گزارش‌های امنیتی بستر HSI را به‌صورت خودکار ارسال می‌کند.

NoPhasedUpdates=false

اگر برابر با true باشد، بررسی پیش‌نیاز برای استقرار مرحله‌ای تصادفی کلاینت را نادیده می‌گیرد.

واجد شرایط بودن یک سیستم برای به‌روزرسانی مرحله‌ای با مقداردهی اولیه تولیدکننده اعداد تصادفی توسط /etc/machine-id، نام پرونده آرشیو و زمان تغییر حافظه پنهان مخزن راه دور (mtime) تعیین می‌شود. اگر بذر اولیه بر مقدار phased_update ارائه‌شده در فراداده بدون باقی‌مانده بخش‌پذیر باشد، انتشار در نظر گرفته می‌شود. این امر همچنین بدان معناست که این بذر در یک دستگاه دیگر، برای یک به‌روزرسانی متفاوت، یا در صورت بازخوانی فراداده، متفاوت خواهد بود.

OrderBefore=

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

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

OrderAfter=

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

Username=

نام کاربری برای احراز هویت پایه (BASIC authentication) هنگام بارگیری فراداده و میان‌افزار از این مخزن راه دور، و برای بارگذاری گزارش‌های موفقیت.

Password=

گذرواژه (اگرچه در عمل این یک توکن کاربری خواهد بود) برای احراز هویت پایه هنگام بارگیری فراداده و میان‌افزار از این مخزن راه دور، و برای بارگذاری گزارش‌های موفقیت.

RefreshInterval=

مدت زمان به ثانیه که پس از آن ابزارهای سمت کاربر باید امضای فراداده را مجدداً بارگیری کنند، یا 0 برای بارگیری مجدد در هر بار.

نام پایه مسیر بدون پسوند به عنوان شناسه (ID) مخزن راه دور استفاده می‌شود. برای نمونه، پرونده مخزن راه دور /etc/fwupd/remotes.d/lvfs.conf دارای شناسه lvfs خواهد بود.

fwupd.conf(5)

2.1.7