ICEWM-SESSION(1)                دستورات کاربری                ICEWM-SESSION(1)


نام (NAME)
       icewm-session - مدیریت نشست دسکتاپ و فرآیندهای جانبی IceWM

خلاصه دستور (SYNOPSIS)
       icewm-session [گزینه‌ها]

توضیحات (DESCRIPTION)
       برنامه icewm-session پیاده‌سازی مدیریت نشست X.Org است و می‌تواند از طریق
       راه‌اندازی نشست X11 اجرا شود. این برنامه icewm را به عنوان مدیر پنجره
       پیش‌فرض اجرا کرده و چرخه حیات برنامه‌های پشتیبان مرتبط را کنترل می‌کند.

گزینه‌ها (OPTIONS)
   گزینه‌های اختصاصی (SPECIFIC OPTIONS)
       -c, --config=FILE
           بارگذاری تنظیمات ترجیحی IceWM از FILE.

       -t, --theme=FILE
           بارگذاری پوسته از FILE توسط IceWM.

       -i, --icewm=FILE
           استفاده از FILE به عنوان مدیر پنجره IceWM.

       -o, --output=FILE
           تغییر مسیر تمام خروجی‌ها به FILE.  علامت مدک (~) ابتدای مسیر یا
           متغیرهای محیطی بسط داده می‌شوند.

       -a, --alpha
           استفاده از حالت بصری ۳۲ بیتی برای شفافیت و نیمه‌شفافی.

       -b, --nobg
           عدم اجرای icewmbg.

       -n, --notray
           عدم اجرای icewmtray.  این گزینه تنها زمانی کاربرد دارد که IceWM
           صراحتاً برای استفاده از فرآیند خارجی icewmtray پیکربندی شده باشد.

       -s, --sound
           اجرای icesound همزمان با شروع نشست.

       --replace
           جایگزینی مدیر پنجره فعال فعلی.

   گزینه‌های عمومی (GENERAL OPTIONS)
       -d, --display=DISPLAY
           استفاده از DISPLAY برای اتصال به کارساز X.  اگر این گزینه مشخص
           نشود، مقدار DISPLAY از متغیر محیطی "DISPLAY" خوانده می‌شود.

       --sync
           استفاده از حالت ارتباطی همگام (synchronous) کندتر با کارساز X11.

       -h, --help
           نمایش فهرستی از تمام گزینه‌های پشتیبانی‌شده و خروج.

       -V, --version
           نمایش نسخه برنامه و خروج.

       -C, --copying
           نمایش مجوزهای حق نشر و تکثیر و خروج.

   گزینه‌های اشکال‌زدایی (DEBUGGING OPTIONS)
       -v, ---valgrind
           اجرای icewm توسط "/usr/bin/valgrind".  اجرای icewm را به طور کامل و
           دقیق بررسی می‌کند.

       -g, ---catchsegv
           اجرای icewm توسط "/usr/bin/catchsegv".  در صورت بروز خطای
           segmentation fault در icewm، گزارش ردیابی پشته (backtrace) ارائه
           می‌دهد.

نحوه استفاده (USAGE)
       هنگام راه‌اندازی، icewm-session مراحل زیر را اجرا می‌کند.  ابتدا در صورت
       وجود پرونده env در دایرکتوری پیکربندی، متغیرهای محیطی اضافی را از آن
       بارگذاری می‌کند.  سپس icewmbg را برای مدیریت رنگ‌ها و تصاویر پس‌زمینه ریشه
       (root background) اجرا می‌کند.  همچنین در صورتی که در زمان پیکربندی فعال
       شده باشد، ممکن است icesound را نیز اجرا کند.  سپس icewm اجرا می‌شود.

       اگر اسکریپت اجرایی startup در دایرکتوری پیکربندی وجود داشته باشد، اجرا
       خواهد شد. این اسکریپت می‌تواند شامل دستوراتی برای مقداردهی اولیه تنظیمات
       X11 با xset، بارگذاری پیکربندی صفحه‌کلید، اجرای مدیر ترکیب‌بندی پنجره‌ها
       مانند compton و بارگذاری برنامه‌های سینی سیستم (system tray) باشد.

       هنگامی که icewm خارج می‌شود، icewm-session در صورت وجود اسکریپت shutdown
       در دایرکتوری پیکربندی، آن را اجرا می‌کند.  با پایان یافتن این اسکریپت،
       icewm-session فرآیندهای icewm، icewmbg و icesound را خاتمه می‌دهد. در
       نهایت، خود icewm-session خارج می‌شود.

       اگر فرآیند icewm دچار خرابی (crash) شود، icewm-session تلاش می‌کند آن را
       مجدداً راه‌اندازی کند. اگر دو خرابی از این دست در مدت زمان کوتاهی رخ دهد،
       icewm-session تلاش می‌کند با استفاده از یکی از ابزارهای yad، xmessage،
       kdialog یا zenity یک پنجره اعلان باز کند. این کادر گفتگو انتخابی بین
       راه‌اندازی مجدد icewm، اجرای یک ترمینال، یا لغو و توقف اجرای
       icewm-session را ارائه می‌دهد.

متغیرهای محیطی (ENVIRONMENT)
       ICEWM_OPTIONS
           فهرستی از گزینه‌ها که با فاصله جدا شده‌اند و به فراخوانی خط فرمان
           icewm افزوده می‌شوند. این مقدار را می‌توان در پرونده env تنظیم کرد.

همچنین ببینید (SEE ALSO)
       icewm(1), icewm-env(5), icewm-shutdown(5), icewm-startup(5),
       icewmbg(1).

گزارش باگ‌ها (BUGS)
       لطفاً باگ‌ها و مشکلات را در <https://github.com/ice-wm/icewm/issues>
       گزارش دهید.

نویسنده (AUTHOR)
       Brian Bidulock <mailto:bidulock@openss7.org>.

       برای مشاهده متن کامل اعلان حق نشر و مجوزهای تکثیر، گزینه --copying را
       ببینید.

مجوز (LICENSE)
       مدیر پنجره IceWM تحت مجوز GNU Library General Public License منتشر شده
       است.  برای مشاهده مجوزهای تکثیر پرونده COPYING را در بسته توزیع بررسی
       کنید یا از گزینه --copying برای نمایش مجوزها استفاده نمایید.

icewm 4.1.0                       2026-08-06                  ICEWM-SESSION(1)