.TH "fwupd.conf" "5" "" 2.1.7 "Configuration File Format" .hy .SH "نام (NAME)" fwupd.conf \- فایل پیکربندی برای دیمن fwupd .SH "خلاصه دستور (SYNOPSIS)" .PP فایل \f[B]/etc/fwupd/fwupd.conf\f[R] فایل پیکربندی اصلی برای دیمن fwupd است. شرح کامل قالب فایل و پارامترهای ممکن در اینجا جهت ارجاع مستند شده است. .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] مشخص شوند. بزرگی و کوچکی حروف در مقادیر بولی اهمیتی ندارد، اما در مقادیر رشته‌ای حفظ می‌شود. .SH "پارامترهای دیمن (DAEMON PARAMETERS)" .PP بخش \f[B][fwupd]\f[R] می‌تواند شامل پارامترهای زیر باشد: .PP \f[B]DisabledDevices=\f[R] .PP امکان مسدودسازی دستگاه‌های خاص با شناسه GUID آن‌ها، با استفاده از نقطه-ویرگول (;) به عنوان جداکننده. .PP \f[B]DisabledPlugins=\f[R] .PP امکان مسدودسازی افزونه‌های خاص بر پایه نام. از دستور \f[B]fwupdmgr get-plugins\f[R] برای دریافت فهرست افزونه‌ها استفاده کنید. .PP \f[B]ArchiveSizeMax=\f[R] .PP حداکثر اندازه آرشیوی که می‌تواند بارگیری شود برحسب مگابایت (Mb)، با مقدار پیش‌فرض ۲۵٪ از کل حافظه سیستم. .PP \f[B]IdleTimeout=300\f[R] .PP مدت‌زمان بیکاری برحسب ثانیه برای خاموش کردن دیمن؛ مقدار \f[B]0\f[R] نشان‌دهنده «هرگز» است. .PP \f[B]نکته:\f[R] برخی افزونه‌ها ممکن است مانع خاموش شدن خودکار شوند؛ برای نمونه thunderbolt. .PP \f[B]IdleInhibitStartupThreshold=500\f[R] .PP اگر راه‌اندازی اولیه دیمن بیش از این مدت (برحسب میلی‌ثانیه) طول بکشد، تایمر خاموش شدن در حالت بیکاری متوقف می‌شود. مقدار \f[B]0\f[R] نشان‌دهنده «هرگز» است. .PP \f[B]VerboseDomains=\f[R] .PP فهرستی جداشده با کاما از دامنه‌ها برای ثبت وقایع در حالت پرگو (verbose). در صورت تنظیم نشدن، هیچ دامنه‌ای روی حالت پرگو تنظیم نمی‌شود. اگر روی «*» تنظیم شود، تمام دامنه‌ها پرگو خواهند بود که معادل اجرای دیمن با \f[B]--verbose --verbose\f[R] است. .PP \f[B]UpdateMotd=true\f[R] .PP به‌روزرسانی پیام روز (MOTD) در زمان تغییرات دستگاه و متادیتا. .PP \f[B]EnumerateAllDevices=false\f[R] .PP برای برخی افزونه‌ها، فقط دستگاه‌های پشتیبانی‌شده توسط متادیتا شمارش شوند. .PP \f[B]ApprovedFirmware=\f[R] .PP فهرستی از مجموع‌های مقابله‌ای (checksums) سفت‌افزار که توسط مدیر سایت تأیید شده است. در صورت عدم تنظیم، تمام سفت‌افزارها تأییدشده هستند. .PP \f[B]UriSchemes=file;https;http;ipfs\f[R] .PP طرح‌های مجاز URI به ترتیب اولویت؛ در صورت عدم موفقیت بارگیری با نخستین طرح، تلاش با طرح بعدی به ترتیب تکرار می‌شود تا هیچ انتخابی باقی نماند. .PP \f[B]IgnorePower=false\f[R] .PP نادیده گرفتن سطوح انرژی و توان دستگاه‌ها هنگام اجرای به‌روزرسانی‌ها. .PP \f[B]IgnoreRequirements=false\f[R] .PP نادیده گرفتن برخی نیازمندی‌های دستگاه؛ برای نمونه حذف نیازمندی عمومی GUID مربوط به CHID، فرزند، والد یا همتا (sibling). این گزینه برای سیستم‌های عملیاتی توصیه نمی‌شود، هرچند ممکن است برای توسعه سفت‌افزار سودمند باشد. .PP \f[B]IgnoreEfivarsFreeSpace=false\f[R] .PP نادیده گرفتن نیازمندی فضای خالی efivars برای به‌روزرسانی‌های db، dbx، KEK و PK. این گزینه ممکن است در هسته‌های لینوکس قدیمی‌تر از 6.4 یا در شرایطی که سخت‌افزار از \f[B]RT->QueryVariableInfo\f[R] در UEFI پشتیبانی نمی‌کند، لازم باشد. .PP \f[B]OnlyTrustPostQuantumSignatures=false\f[R] .PP تنها به امضاهای رمزنگاری پساکوانتومی (post-quantum) اعتماد شود. این گزینه فقط زمانی توصیه می‌شود که مطمئن باشید سفت‌افزار دارای یک امضای معتبر PQ است. .PP \f[B]OnlyTrusted=true\f[R] .PP تنها از نصب سفت‌افزارهای امضاشده با کلید معتبر پشتیبانی شود. در یک سیستم عملیاتی یا مطمئن، این گزینه را روی \f[B]false\f[R] تنظیم نکنید. .PP \f[B]ShowDevicePrivate=true\f[R] .PP نمایش داده‌هایی مانند شماره سریال‌های دستگاه که ممکن است برخی کاربران آن‌ها را خصوصی بدانند. .PP \f[B]TrustedUids=\f[R] .PP شناسه‌های کاربری (UID) منطبق با این مقادیر که رابط D-Bus را فراخوانی می‌کنند، باید به عنوان معتبر علامت‌گذاری شوند. .PP \f[B]HostBkc=\f[R] .PP فهرستی جداشده با کاما از شناسه‌های بهترین پیکربندی شناخته‌شده (BKC) برای استفاده هنگام اجرای \f[B]fwupdmgr sync\f[R]. این گزینه می‌تواند سفت‌افزار را به نسخه‌های کارخانه‌ای تنزل دهد یا سفت‌افزار را به سطح پیکربندی پشتیبانی‌شده ارتقا دهد؛ مانند \f[B]vendor-factory-2021q1,mycompany-2023\f[R]. .PP \f[B]ReleaseDedupe=true\f[R] .PP حذف موارد تکراری انتشارها بر اساس مجموع مقابله‌ای (checksum) آرشیو در صورتی که از بیش از یک منبع در دسترس باشند. .PP \f[B]ReleasePriority=local\f[R] .PP هنگامی که یک نسخه از انتشار از بیش از یک منبع در دسترس باشد، این گزینه می‌تواند برای ترجیح دادن نسخه محلی (جلوگیری از بارگیری با هزینه احتمالی بالا) یا ترجیح دادن نسخه دوردست (که ممکن است حاوی متادیتای به‌روزشده مانند یادداشت‌های انتشار باشد) استفاده شود. .PP گزینه‌های ممکن عبارت‌اند از \f[B]local\f[R] یا \f[B]remote\f[R] یا مقدار خالی برای عدم اعمال هیچ‌گونه تغییری در خط‌مشی، که بر بخش‌های \f[B]OrderAfter\f[R] و \f[B]OrderBefore\f[R] در منبع دوردست تکیه می‌کند. .PP \f[B]EspLocation=\f[R] .PP تنظیم مسیر ترجیحی مورد استفاده برای پارتیشن سیستمی EFI (موسوم به ESP). این گزینه معمولاً زمانی به کار می‌رود که UDisks به هر دلیلی نتواند موقعیت آن را به صورت خودکار شناسایی کند. .PP \f[B]RequireImmutableEnumeration=false\f[R] .PP عدم اجازه به افزونه‌های fwupd برای تعامل مستقیم با دستگاه‌ها در طول مراحل بررسی (probe) یا راه‌اندازی اولیه (setup). هسته باید تمام اطلاعات دستگاه را در فایل‌های sysfs یا ویژگی‌های udev فراهم کند. این کار مانع از عملکرد برخی افزونه‌ها خواهد شد. .PP \f[B]Manufacturer=\f[R] .PP \f[B]ProductName=\f[R] .PP \f[B]ProductSku=\f[R] .PP \f[B]Family=\f[R] .PP \f[B]EnclosureKind=\f[R] .PP \f[B]BaseboardProduct=\f[R] .PP \f[B]BaseboardManufacturer=\f[R] .PP بازنویسی مقادیر مربوط به داده‌های SMBIOS یا درخت دستگاه (Device Tree) در سیستم محلی. این مقادیر تنها زمانی لازم هستند که داده‌های SMBIOS یا Device Tree نامعتبر یا ناموجود باشند یا برای شبیه‌سازی اجرا روی سیستمی دیگر استفاده شوند. برای پر کردن ورودی‌های خالی باید از مقادیر خالی، یا افزودن مقادیر برای پر کردن ورودی‌های خاص استفاده شود. .PP \f[B]TrustedReports=VendorId=$OEM\f[R] .PP گزارش‌های سازنده‌ای که با این عبارات مطابقت داشته باشند، انتشارهای آن‌ها به عنوان \f[B]trusted-report\f[R] نشانه‌گذاری می‌شوند. هر بخش *یا* (OR) با \f[B];\f[R] و هر بخش *و* (AND) با \f[B]&\f[R] جدا می‌شود؛ برای نمونه: .PP .IP \[bu] 2 \f[B]DistroId=chromeos\f[R] .PP هر گزارشی که از ChromeOS بارگذاری شده باشد، معتبر است. .PP .IP \[bu] 2 \f[B]DistroId=chromeos&RemoteId=lvfs\f[R] .PP هر گزارشی که در منبع دوردست \f[B]lvfs\f[R] یافت شود و از یک دستگاه ChromeOS بارگذاری شده باشد، معتبر است. .PP .IP \[bu] 2 \f[B]DistroId=fedora&VendorId=19\f[R] .PP هر گزارشی که از فدورا ۱۹ بارگذاری شده باشد، معتبر است. .PP .IP \[bu] 2 \f[B]DistroId=fedora&VendorId=$OEM\f[R] .PP هر گزارشی که از فدورا توسط OEM سخت‌افزار بارگذاری شده باشد، معتبر است. .PP .IP \[bu] 2 \f[B]DistroId=fedora;DistroId=rhel&DistroVersion=9\f[R] .PP هر گزارشی که از فدورا (هر نسخه‌ای) یا از RHEL 9 بارگذاری شده باشد، معتبر است. .PP \f[B]نکته:\f[R] مقدار \f[B]VendorId\f[R] برابر با \f[B]$OEM\f[R] نشان‌دهنده شناسه فروشنده OEM برای سازنده‌ای است که مالک سفت‌افزار می‌باشد؛ برای نمونه در شرایطی که واحد تضمین کیفیت (QA) شرکت لنوو یک گزارش امضاشده برای لپ‌تاپ لنوو ایجاد کرده است. .PP همچنین سه مقدار os-release در دسترس است: \f[B]$ID\f[R]، \f[B]$VERSION_ID\f[R] و \f[B]$VARIANT_ID\f[R]، که امکان استفاده از عباراتی مانند نمونه‌های زیر را فراهم می‌کنند: .PP .IP \[bu] 2 \f[B]DistroId=$ID\f[R] .PP .IP \[bu] 2 \f[B]DistroId=$ID,DistroVersion=$VERSION_ID\f[R] .PP .IP \[bu] 2 \f[B]Flags=is-upgrade,from-oem\f[R] .PP تمام پرچم‌های ذکرشده در اینجا باید توسط گزارش مطابقت داده شوند. .PP \f[B]P2pPolicy=metadata\f[R] .PP این گزینه مشخص می‌کند دیمن از چه خط‌مشی همتا‌به‌همتا (P2P) استفاده کند؛ برای نمونه استفاده از Passim، که یک سرویس اختیاری حافظه پنهان محلی است. بهره‌گیری از داده‌های همتا‌به‌همتا می‌تواند میزان پهنای باند مصرفی در شبکه شما را به طور چشمگیری کاهش دهد. .PP سه مقدار ممکن برای این گزینه وجود دارد: .PP .IP \[bu] 2 \f[B]nothing\f[R]: هیچ فایلی منتشر نشود. .PP .IP \[bu] 2 \f[B]metadata\f[R]: تنها متادیتای به اشتراک گذاشته‌شده که بین همه دستگاه‌ها مشترک است منتشر شود. .PP .IP \[bu] 2 \f[B]firmware\f[R]: آرشیوهای سفت‌افزار تنها \f[B]پس از راه‌اندازی مجدد بعدی\f[R] دستگاه منتشر شوند. .PP در آینده، fwupd مقدار پیش‌فرض را به \f[B]metadata,firmware\f[R] تغییر خواهد داد. .PP \f[B]TestDevices=false\f[R] .PP ایجاد دستگاه‌های آزمایشی مجازی و منبع دوردست برای اعتبارسنجی جریان‌های کاری دیمن. این گزینه تنها برای اهداف آزمایش در یکپارچه‌سازی مداوم (CI) و اهداف توسعه در نظر گرفته شده است. .SH "پارامترهای کپسول UEFI (UEFI_CAPSULE PARAMETERS)" .PP بخش \f[B][uefi_capsule]\f[R] می‌تواند شامل پارامترهای زیر باشد: .PP \f[B]EnableGrubChainLoad=false\f[R] .PP پیکربندی GRUB برای راه‌اندازی \f[B]fwupdx64.efi\f[R] به جای استفاده از روش‌های دیگر مانند NVRAM یا Capsule-On-Disk. .PP \f[B]DisableShimForSecureBoot=false\f[R] .PP بارگذار shim برای زنجیره‌کردن باینری EFI مربوط به fwupd الزامی است، مگر آنکه فایل \f[B]fwupd.efi\f[R] به صورت دستی و توسط خودتان امضا شده باشد (self-signed). .PP \f[B]RequireESPFreeSpace=0\f[R] .PP میزان فضای خالی لازم در ESP؛ برای نمونه مقدار \f[B]32\f[R] برای ۳۲ مگابایت. به طور پیش‌فرض این مقدار به صورت پویا حداقل دو برابر اندازه محموله (payload) تنظیم می‌شود. .PP \f[B]DisableCapsuleUpdateOnDisk=false\f[R] .PP امکان نادیده گرفتن پشتیبانی از CapsuleOnDisk که توسط سفت‌افزار اعلام شده است. .PP \f[B]EnableEfiDebugging=false\f[R] .PP فعال‌سازی اشکال‌زدایی سطح پایین \f[B]fwupdx64.efi\f[R] در متغیر EFI با نام \f[B]FWUPDATE_DEBUG_LOG\f[R]. .PP \f[B]نکته:\f[R] فعال کردن این گزینه فضای ذخیره‌سازی NVRAM را بسیار سریع‌تر پر می‌کند و فقط در زمان اشکال‌زدایی مشکلی در باینری EFI باید فعال شود. .PP همچنین این مقدار هنگام استفاده از Capsule-on-Disk تأثیری ندارد؛ زیرا باینری کمکی EFI در آن حالت به کار گرفته نمی‌شود. .PP \f[B]RebootCleanup=true\f[R] .PP حذف هرگونه فایل کپسول کپی‌شده در ESP، و پاکسازی متغیرهای EFI تنظیم‌شده برای به‌روزرسانی. .PP \f[B]نکته:\f[R] غیرفعال کردن این گزینه تنها برای اشکال‌زدایی فرآیند فلش کردن لازم است و کاربران عادی نیازی به تغییر این تنظیم ندارند. .PP \f[B]ScreenWidth=0\f[R] .PP بازنویسی عرض صفحه نمایش برحسب پیکسل برای بافر فریم EFI همان‌طور که توسط کپسول UX استفاده می‌شود. .PP \f[B]ScreenHeight=0\f[R] .PP بازنویسی ارتفاع صفحه نمایش برحسب پیکسل برای بافر فریم EFI همان‌طور که توسط کپسول UX استفاده می‌شود. .SH "پارامترهای پایگاه‌داده UEFI (UEFI_DB PARAMETERS)" .PP بخش \f[B][uefi_db]\f[R] می‌تواند شامل پارامترهای زیر باشد: .PP \f[B]UpdateWindowsCA=false\f[R] .PP فضای فلش مورداستفاده برای به‌روزرسانی‌های UEFI محدود است -- اگر مرجع صدور گواهی ویندوز (Windows CA) را به‌روزرسانی کنیم (در حالی که سیستم به صورت بوت دوگانه با ویندوز پیکربندی نشده است)، در این صورت از فضای فلشی استفاده می‌کنیم که برای به‌روزرسانی‌های db و dbx در UEFI به آن نیاز داریم. .PP این تنظیم باعث می‌شود گواهی UEFI ویندوز حتی در صورتی که مایکروسافت ویندوز شناسایی نشود، قابل به‌روزرسانی باشد. .SH "پارامترهای MSR (MSR PARAMETERS)" .PP بخش \f[B][msr]\f[R] می‌تواند شامل پارامتر زیر باشد: .PP \f[B]MinimumSmeKernelVersion=5.18.0\f[R] .PP حداقل نسخه هسته موردنیاز برای شناسایی مطمئن AMD SME از طریق SYSCFG MSR. .PP این گزینه تنها در هسته‌های سازمانی که این قابلیت را به هسته‌ای با نسخه قدیمی‌تر منتقل کرده‌اند (cherry-pick)، نیاز به تغییر دارد. .SH "پارامترهای رد‌فیش (REDFISH PARAMETERS)" .PP بخش \f[B][redfish]\f[R] می‌تواند شامل پارامترهای زیر باشد: .PP \f[B]Uri=\f[R] .PP آدرس URI سرویس Redfish با فرمت \f[B]scheme://ip:port\f[R]؛ برای نمونه \f[B]https://192.168.0.133:443\f[R] .PP \f[B]Username=\f[R] .PP نام کاربری مورد استفاده هنگام اتصال به سرویس Redfish. .PP \f[B]Password=\f[R] .PP گذرواژه مورد استفاده هنگام اتصال به سرویس Redfish. .PP \f[B]BearerToken=\f[R] .PP توکن حامل (bearer token) مورد استفاده برای احراز هویت در سرویس Redfish. .PP \f[B]CACheck=false\f[R] .PP بررسی یا عدم بررسی گواهی سرور. این گزینه به طور پیش‌فرض خاموش است. کنترل‌کننده‌های BMC که از گواهی‌های خودامضا استفاده می‌کنند کار نخواهند کرد، مگر اینکه افزونه آن را در برابر CAهای سیستم اعتبارسنجی نکند. .PP \f[B]IpmiDisableCreateUser=false\f[R] .PP عدم استفاده از IPMI KCS برای ایجاد یک حساب کاربری اولیه در صورت نبود داده‌های SMBIOS. تنظیم این گزینه روی \f[B]true\f[R] مانع از ایجاد خودکار حساب‌های کاربری در BMC می‌شود. .PP \f[B]ManagerResetTimeout=1800\f[R] .PP مدت‌زمان برحسب ثانیه برای انتظار جهت راه‌اندازی مجدد BMC. .SH "پارامترهای تاندربولت (THUNDERBOLT PARAMETERS)" .PP بخش \f[B][thunderbolt]\f[R] می‌تواند شامل پارامترهای زیر باشد: .PP \f[B]MinimumKernelVersion=4.13.0\f[R] .PP حداقل نسخه هسته برای مجاز دانستن استفاده از این افزونه. .PP این مورد تنها در هسته‌های سازمانی که این قابلیت را به هسته‌ای با شماره نسخه قدیمی‌تر منتقل کرده‌اند (cherry-pick)، نیاز به تغییر دارد. .PP \f[B]DelayedActivation=false\f[R] .PP اجبار به تأخیر در فعال‌سازی تا هنگام خاموش شدن/خروج از سیستم/راه‌اندازی مجدد. .SH "پارامترهای DELL_KESTREL (DELL_KESTREL PARAMETERS)" .PP بخش \f[B][dell_kestrel]\f[R] می‌تواند شامل پارامترهای زیر باشد: .PP \f[B]UpdateOnDisconnect=true\f[R] .PP به تأخیر انداختن فعال‌سازی سفت‌افزار تا زمانی که کابل داک (dock) جدا شود. .SH "پارامترهای آزمایشی (TEST PARAMETERS)" .PP بخش \f[B][test]\f[R] می‌تواند شامل پارامترهای زیر باشد: .PP \f[B]AnotherWriteRequired=false\f[R] .PP اجرای تابع نوشتن در دو مرحله (pass). .PP \f[B]CompositeChild=false\f[R] .PP آیا دستگاه باید دارای یک دستگاه فرزند باشد یا خیر. .PP \f[B]DecompressDelay=0\f[R] .PP تأخیر برحسب میلی‌ثانیه برای استفاده هنگام استخراج و رفع فشرده‌سازی دستگاه آزمایشی. .PP \f[B]NeedsActivation=false\f[R] .PP آیا دستگاه پیش از استقرار به‌روزرسانی نیازمند فعال‌سازی است یا خیر. .PP \f[B]NeedsReboot=false\f[R] .PP آیا دستگاه پیش از استقرار به‌روزرسانی نیازمند راه‌اندازی مجدد است یا خیر. .PP \f[B]RegistrationSupported=\f[R] .PP آیا دستگاه باید در سایر افزونه‌ها ثبت شود یا خیر. .PP \f[B]RequestDelay=10\f[R] .PP تأخیر برحسب میلی‌ثانیه برای استفاده در زمان درخواست ورودی از کاربر. .PP \f[B]RequestSupported=false\f[R] .PP آیا درخواست تعاملی دستگاه پشتیبانی می‌شود یا خیر. .PP \f[B]VerifyDelay=0\f[R] .PP تأخیر برحسب میلی‌ثانیه برای استفاده در زمان بررسی صحت دستگاه آزمایشی. .PP \f[B]WriteDelay=0\f[R] .PP تأخیر برحسب میلی‌ثانیه برای استفاده در زمان نوشتن روی دستگاه آزمایشی. .PP \f[B]WriteSupported=\f[R] .PP آیا نوشتن روی دستگاه پشتیبانی می‌شود یا خیر. در صورت عدم پشتیبانی، فرآیند نوشتن روی دستگاه آغاز نخواهد شد. .SH "نکات (NOTES)" .PP فایل \f[B]/etc/fwupd/fwupd.conf\f[R] ممکن است حاوی اطلاعات اعتبارسنجی هاردکدشده یا تولیدشده به صورت خودکار باشد و فقط باید توسط کاربری که فرآیند fwupd را اجرا می‌کند، که معمولاً کاربر ریشه (\f[B]root\f[R]) است، قابل خواندن باشد. .SH "همچنین ببینید (SEE ALSO)" .PP .BR fwupdmgr (1), .BR fwupd\-remotes.d (5)