greetd(5) File Formats Manual greetd(5)

greetd - فایل پیکربندی دیمون ورود به سیستم greetd

برنامه greetd برای تعیین رفتار خود از یک فایل پیکربندی ساده TOML استفاده می‌کند.

این پیکربندی به چند بخش (sections) تقسیم می‌شود. بخش‌ها به این صورت مشخص می‌گردند:

[section_name]
config_key = value

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

این بخش شامل پیکربندی ترمینال است.

vt = num|"next"|"current"

ترمینال مجازی (VT) که برنامه باید روی آن اجرا شود. این مقدار می‌تواند شماره یک VT خاص، مقدار "next" برای انتخاب ترمینال مجازی آزاد بعدی، یا "current" برای ماندن در همان ترمینالی باشد که greetd در آن آغاز به کار کرده است. ترمینال مجازی مشخص‌شده در زمان راه‌اندازی بررسی و ارزیابی می‌شود و در طول اجرای greetd تغییر نمی‌کند.

اگر از ترمینال فعلی (current) یا یک VT خاص استفاده می‌کنید، باید اطمینان حاصل کنید که کاربر یا پردازش دیگری از آن VT استفاده نمی‌کند. در صورت استفاده از systemd به همراه autovt و getty، می‌توان برای جلوگیری از بروز تداخل، در واحد سرویس عبارت "Conflicts=getty@ttyN.service" را تنظیم کرد (که در آن N شماره ترمینال مجازی است).

استفاده از یک VT مشخص همراه با روش مناسب جلوگیری از تداخل توصیه می‌شود.

switch = true|false

تعیین می‌کند که آیا به vt تغییر مکان داده شود (سوییچ شود) یا خیر.

اگر روی false تنظیم شود و vt ترمینال مجازی فعال فعلی نباشد، greetd پیش از انجام هر کاری (از جمله شروع به کار صفحه ورود/greeter)، منتظر فعال شدن vt خواهد ماند.

اگر روی true تنظیم شود، greetd ترمینال مجازی فعلی را به vt تغییر می‌دهد.

مقدار پیش‌فرض true است.

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

source_profile = true|false

تعیین می‌کند که هنگام اجرای دستورات، در صورت وجود فایل‌های ~/.profile و /etc/profile آیا محتوای آن‌ها بارگذاری (source) شود یا خیر. مقدار پیش‌فرض true است.

runfile = path-to-runfile

مسیر فایل اجرایی (runfile) برنامه greetd که در نخستین اجرا ایجاد می‌شود تا در صورت پایان یافتن نشست یا راه‌اندازی مجدد greetd، از اجرای مجدد نشست اولیه جلوگیری به عمل آید.

این فایل باید در مکانی قرار گیرد که هنگام راه‌اندازی مجدد سیستم (reboot) پاک می‌شود.

این بخش، نشست پیش‌فرض را توصیف می‌کند که به آن صفحه ورود (greeter) نیز گفته می‌شود.

command = command-line

خط فرمانی که greetd برای شروع نشست پیش‌فرض اجرا خواهد کرد، مانند "agreety -c sway";. نشست پیش‌فرض زمانی که هیچ نشست دیگری در حال اجرا نباشد، به طور خودکار شروع می‌شود؛ مانند زمانی که نشست یک کاربر پایان می‌یابد یا greetd در ابتدا بدون پیکربندی نشست اولیه راه‌اندازی می‌شود.

این خط فرمان توسط sh(1) اجرا می‌شود و بنابراین ساختار دستوری استاندارد پوسته POSIX را می‌پذیرد.

برای آگاهی از نحوه ایجاد نشست‌ها توسط یک صفحه ورود، به greetd-ipc(7) مراجعه فرمایید.

user = user

کاربری که برای اجرای صفحه ورود استفاده می‌شود. مقدار پیش‌فرض "greeter" است.

این بخش اختیاری، نشست اولیه را توصیف می‌کند که معمولاً به عنوان «ورود خودکار» (auto-login) شناخته می‌شود.

نشست اولیه فقط در نخستین اجرای greetd پس از بوت سیستم اجرا خواهد شد تا اطمینان حاصل شود که خروج از حساب کاربری به درستی کار می‌کند و در زمان خروج greetd یا صفحه ورود، از مشکلات امنیتی جلوگیری شود. این موضوع از طریق بررسی وجود فایل اجرایی (runfile) کنترل می‌گردد.

command = command-line

خط فرمانی که greetd برای شروع نشست اولیه اجرا خواهد کرد، مانند "sway". نشست اولیه در زمان راه‌اندازی نخستین بار greetd دقیقاً یک‌بار آغاز خواهد شد.

این خط فرمان توسط sh(1) اجرا می‌شود و از این رو ساختار دستوری استاندارد پوسته POSIX را می‌پذیرد.

user = user

کاربری که برای اجرای نشست اولیه استفاده می‌شود.

[terminal]
vt = 1
[default_session]
command = "agreety -c sway"

[terminal]
vt = 1
[default_session]
command = "agreety -c sway"
[initial_session]
command = "sway"
user = "john"

توسط Kenny Levinsen <contact@kl.wtf> نگهداری می‌شود. برای اطلاعات بیشتر درباره توسعه greetd، به نشانی https://git.sr.ht/~kennylevinsen/greetd مراجعه فرمایید.

greetd(1) greetd-ipc(7)

2026-03-27