'\" t
.\"     Title: sbctl.conf
.\"    Author: [see the "Authors" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 08/10/2026
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: Persian
.\"
.TH "SBCTL\&.CONF" "5" "08/10/2026" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
sbctl.conf \- فایل پیکربندی sbctl
.SH "خلاصه دستور (SYNOPSIS)"
.sp
/etc/sbctl/sbctl\&.conf
.SH "توضیحات (DESCRIPTION)"
.sp
فایل پیکربندی sbctl یک فایل YAML است\&. این فایل در صورت وجود هنگام راه‌اندازی خوانده می‌شود\&.
.sp
از این فایل می‌توان برای راه‌اندازی و پیکربندی اولیه نصب sbctl استفاده کرد\&.
.SH "دایرکتوری‌های پیکربندی و اولویت (CONFIGURATION DIRECTORIES AND PRECEDENCE)"
.sp
فایل پیکربندی در حال حاضر فقط از مسیر /etc/sbctl خوانده می‌شود\&. این موضوع ممکن است در آینده تغییر کند\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fBkeydir:\fR /path/to/key/dir
.RS 4
دایرکتوری‌ای را مشخص می‌کند که sbctl در آن به دنبال کلیدها می‌گردد\&.

پیش‌فرض: /var/lib/sbctl/keys
.RE
.PP
\fBguid:\fR /path/to/guid/file
.RS 4
مکان فایلی که شناسه GUID ایجادشده توسط کاربر را مشخص می‌کند\&.

شناسه GUID برای شناسایی یکتای فهرست گواهی‌های ذخیره‌شده در متغیرهای EFI استفاده می‌شود\&.

پیش‌فرض: /var/lib/sbctl/GUID
.RE
.PP
\fBfiles_db:\fR /path/to/files/json
.RS 4
مکان فایل json که فایل‌های نیازمند امضا توسط sbctl را در خود ذخیره می‌کند\&.

پیش‌فرض: /var/lib/sbctl/files\&.json
.RE
.PP
\fBbundles_db:\fR /path/to/bundles/json
.RS 4
مکان فایل json که بسته‌های نیازمند امضا توسط sbctl را در خود ذخیره می‌کند\&.

پیش‌فرض: /var/lib/sbctl/bundles\&.json
.RE
.PP
\fBlandlock:\fR bool
.RS 4
فعال‌سازی یا غیرفعال‌سازی محدودسازی دسترسی (sandboxing) امنیتی landlock برای sbctl\&.

پیش‌فرض: true
.RE
.sp
\fBdb_additions:\fR [ options\&... ] کلیدها یا چک‌سام‌های اضافی را در پایگاه‌داده مجوز (authorization database) برای Secure Boot اضافه می‌کند\&. این مقادیر مترادف با گزینه‌های ارسال‌شده به \fBsbctl enroll\-keys\fR هستند\&. مقادیر معتبر: microsoft، tpm\-eventlog، firmware\-builtin، custom
.PP
\fBfiles:\fR [ [\fBpath:\fR /path/to/file \fBoutput:\fR /path/to/output ], \&... ]
.RS 4
فهرستی از فایل‌هایی که sbctl هنگام راه‌اندازی اولیه امضا خواهد کرد\&. از این فهرست برای مقداردهی اولیه files_db در طول راه‌اندازی اولیه استفاده می‌شود\&.
.PP
\fBpath\fR
.RS 4
مسیر مطلق به فایلی که sbctl باید آن را امضا کند\&.
.RE
.PP
\fBoutput\fR
.RS 4
یک مسیر خروجی مطلق اختیاری برای فایل امضاشده\&.
.RE
.RE
.PP
\fBkeys:\fR {\fBpk:\fR {\&...}, \fBkek:\fR {\&...}, \fBdb:\fR {\&...}}
.RS 4
یک جفت کلید\-مقدار برای تمام کلیدهای موجود در سلسله‌مراتب کلید مورد استفاده برای Secure Boot\&. از این بخش برای راه‌اندازی اولیه (bootstrap) در طول پیکربندی استفاده می‌شود\&.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
pk
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
kek
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
db
.RE
.RE
.PP
.RS 4
هر یک از سطوح سلسله‌مراتب می‌تواند نوع کلید و مکان فایل کلید خصوصی و گواهی را مستقل از یکدیگر مشخص کند\&. این قابلیت به کاربران اجازه می‌دهد بسته به نیازهای خود برخی کلیدها را روی رسانه‌های ذخیره‌سازی متفاوتی نگهداری کنند\&. برای نمونه می‌توان کلید db را به عنوان یک فایل رمزنگاری‌نشده و به سادگی در دسترس برای امضا نگه داشت، در حالی که PK روی یک محفظه سخت‌افزاری امن (hardware-backed enclave) قرار گیرد تا امنیت محتوای کلید بهتر تامین شود\&.
.PP
\fBprivkey:\fR /path/to/privatekey/file
.RS 4
مسیر کلید خصوصی\&.

پیش‌فرض‌ها:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBpk:\fR
/var/lib/sbctl/keys/PK/PK\&.key
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBkek:\fR
/var/lib/sbctl/keys/KEK/KEK\&.key
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBdb\fR: /var/lib/sbctl/keys/db/db\&.key
.RE
.RE
.PP
\fBpubkey:\fR /path/to/certificate/file
.RS 4
مسیر کلید عمومی\&.

پیش‌فرض‌ها:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBpk:\fR
/var/lib/sbctl/keys/PK/PK\&.pem
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBkek:\fR
/var/lib/sbctl/keys/KEK/KEK\&.pem
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBdb\fR: /var/lib/sbctl/keys/db/db\&.pem
.RE
.RE
.PP
\fBtype:\fR file
.RS 4
نوع کلید مورد استفاده برای این کلید امضا\&.

در حال حاضر تنها نوع کلید
\fBfile\fR
توسط sbctl پشتیبانی می‌شود\&.

پیش‌فرض: file
.RE
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
نمونه‌ای از یک فایل /etc/sbctl/sbctl\&.conf با مقادیر پیش‌فرض\&.
.sp
.if n \{\
.RS 4
.\}
.nf
\-\-\-
keydir: /var/lib/sbctl/keys
guid: /var/lib/sbctl/GUID
files_db: /var/lib/sbctl/files\&.json
bundles_db: /var/lib/sbctl/bundles\&.json
landlock: true
db_additions:
\- microsoft
files:
\- path: /boot/vmlinuz\-linux
  output: /boot/vmlinuz\-linux
\- path: /efi/EFI/Linux/arch\-linux\&.efi
  output: /efi/EFI/Linux/arch\-linux\&.efi
keys:
  pk:
    privkey: /var/lib/sbctl/keys/PK/PK\&.key
    pubkey: /var/lib/sbctl/keys/PK/PK\&.pem
    type: file
  kek:
    privkey: /var/lib/sbctl/keys/KEK/KEK\&.key
    pubkey: /var/lib/sbctl/keys/KEK/KEK\&.pem
    type: file
  db:
    privkey: /var/lib/sbctl/keys/db/db\&.key
    pubkey: /var/lib/sbctl/keys/db/db\&.pem
    type: file
.fi
.if n \{\
.RE
.\}
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBsbctl\fR(8)
.SH "نویسندگان (AUTHORS)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Morten Linderud <morten@linderud\&.pw>
.RE