نام (NAME)

gpm-root - گرداننده پیشفرض gpm جهت رسم منوها بر روی پنجره ریشه

خلاصه دستور (SYNOPSIS)

gpm-root [ گزینه‌ها ]

توضیحات (DESCRIPTION)

برنامه gpm-root برای مدیریت رویدادهای Control-Mouse جهت رسم منوها بر روی پس‌زمینه tty جاری طراحی شده است. منوهای واقعی توسط یک فایل پیکربندی در دایرکتوری خانگی کاربر تعریف می‌شوند.

لطفاً توجه داشته باشید که gpm-root باید با لینوکس نسخه 1.1.73 یا جدیدتر اجرا شود، زیرا هسته‌های پیشین فاقد برخی قابلیت‌های مدیریت صفحه‌نمایش مورد نیاز این برنامه هستند.

این برنامه از فایل‌های /dev/vcs* برای رسم بر روی صفحه کنسول استفاده می‌کند. این فایل‌ها تنها از هسته 1.1.81 به بعد در دسترس هستند. اگر این گره‌های دستگاه را ندارید، باید آن‌ها را با استفاده از create_vcs در دایرکتوری توزیع ایجاد کنید. این ابزار بر روی هسته‌های قدیمی‌تر از 1.1.81 اجرا نخواهد شد، زیرا فاقد قابلیت تخلیه/بازیابی (dump/restore) کامل صفحه بودند.

گزینه‌های خط فرمان موجود به شرح زیر است:

-m number: انتخاب کلید تغییردهنده (modifier) برای استفاده (به‌طور پیش‌فرض: control). کلید تغییردهنده می‌تواند به‌صورت یک عدد یا رشته نمادین ارائه شود. رشته‌های مجاز عبارتند از: shift، anyAlt، leftAlt، rightAlt و control.
-u: عدم استفاده از فایل‌های پیکربندی ویژه کاربر. با فعال بودن این گزینه، تنها فایل /etc/gpm-root.conf به‌عنوان منبع اطلاعات پیکربندی استفاده خواهد شد. این گزینه برای آن دسته از مدیران سیستمی در نظر گرفته شده است که نگران به خطر افتادن امنیت توسط این دیمن هستند. امنیت برنامه باید کافی باشد، اما اگر نقصی پیدا کردید لطفاً آن را گزارش دهید.
-D: عدم ورود خودکار به حالت اجرا در پس‌زمینه هنگام شروع به کار، و ثبت پیام‌ها در جریان خطای استاندارد (stderr) به‌جای سازوکار syslog. این گزینه برای اشکال‌زدایی مفید است؛ در نسخه‌های قبلی این کار از طریق یک گزینه زمان کامپایل انجام می‌شد.
-V verbosity increment: افزایش حداکثر سطح پیام‌هایی که ثبت خواهند شد. بنابراین یک آرگومان مثبت باعث می‌شود که برنامه خروجی پرجزئیات‌تری داشته باشد. همچنین می‌توان یک آرگومان منفی برای کم‌صدا کردن برنامه مشخص کرد؛ با این حال، توجه داشته باشید که طبق قواعد getopt(3) یک آرگومان منفی باید بدون فاصله دقیقاً پس از گزینه قرار گیرد (یعنی -V-1 و نه -V -1). Program Arguments,,,libc. این آرگومان اختیاری است و مقدار پیش‌فرض آن 1 است.

هر بار که منویی رسم می‌شود، در صورت تغییر فایل پیکربندی، مجدداً تجزیه می‌شود. این امر امکان تغییر تنظیمات شخصی را بدون نیاز به فراخوانی مجدد دیمن فراهم می‌کند.

فایل پیکربندی واقعی را می‌توان به بهترین شکل با بررسی فایل /etc/gpm-root.conf سیستم خود شناخت.

دستور زبان (syntax) این فایل در اینجا شرح داده نمی‌شود، زیرا از مثال‌های بالا کاملاً مشخص است. فاصله‌ها و خطوط جدید در تجزیه فایل نادیده گرفته می‌شوند و ساختار چیدمان فایل آزاد است. درج توضیحات در فایل مجاز است: هر علامت هش (#) که در ابتدای خط یا پس از نویسه‌های فاصله قرار گیرد، باعث می‌شود تجزیه‌کننده تمام محتوای تا انتهای آن خط را نادیده بگیرد. برای درج علامت نقل‌قول (") در رشته‌ها، پیش از آن از یک بک‌اسلش استفاده کنید.

توجه داشته باشید که منوهای بازگشتی (تودرتو) تا هر سطحی از بازگشت مجاز هستند.

کلیدواژه‌ها به سه گروه تعلق دارند: کلیدواژه button، کلیدواژه‌های cfg و کلیدواژه‌های عمل (action). همه آن‌ها در جدول زیر شرح داده شده‌اند:

button number menu: کلیدواژه button برای معرفی یک منو استفاده می‌شود. پس از آن شماره دکمه مربوطه (1=چپ، 2=وسط، 3=راست)، یک آکولاد باز، یک منو و یک آکولاد بسته قرار می‌گیرد. یک منو از دستورات cfg و به دنبال آن دستورات action تشکیل شده است. دستورات cfg می‌توانند به هر ترتیبی بیایند، در حالی که ترتیب دستورات action مشخص‌کننده ترتیب واقعی نمایش اعمال روی صفحه از بالا به پایین است.

دستورات زیر متعلق به مجموعه cfg هستند.

name string: در صورت وجود کلیدواژه name، رشته مشخص‌شده در string به‌عنوان نام منوی جاری استفاده خواهد شد.
background color: این دستور برای تعیین رنگ پس‌زمینه در منوی جاری استفاده می‌شود. مقدار color می‌تواند با یکی از هشت رشته استاندارد black، red، cyan و غیره مشخص شود. رنگ پس‌زمینه به‌طور پیش‌فرض black (سیاه) است.
foreground color: این دستور برای تعیین رنگ پیش‌زمینه گزینه‌های منو استفاده می‌شود. مقدار پیش‌فرض آن white (سفید) است. کلیدواژه اختیاری bright می‌تواند قبل از رنگ اصلی قرار گیرد.
border color: کلیدواژه border برای تعیین رنگ کادر منو استفاده می‌شود. مقدار پیش‌فرض آن white است. کلیدواژه اختیاری bright می‌تواند قبل از رنگ اصلی قرار گیرد.
head color: کلیدواژه head برای تعیین رنگ پیش‌زمینه عنوان منو استفاده می‌شود. مقدار پیش‌فرض آن white است. کلیدواژه اختیاری bright می‌تواند قبل از رنگ اصلی قرار گیرد.

دستورات زیر متعلق به مجموعه action هستند.

string f.fgcmd cmdstring: هنگامی که دکمه ماوس روی گزینه مربوطه در منو رها شود، cmdstring در صف صفحه‌کلید کنسول جاری الصاق (paste) می‌شود. این قابلیت هنوز پیاده‌سازی نشده است.
string f.bgcmd cmdstring: هنگامی که دکمه ماوس روی گزینه مربوطه در منو رها شود، یک پوسته (/bin/sh) انشعاب می‌یابد تا دستور مشخص‌شده را اجرا کند، در حالی که ورودی استاندارد (stdin) به /dev/null و خروجی استاندارد (stdout) و خطای استاندارد (stderr) به کنسول فعال متصل هستند.
string f.jptty ttynumber: هنگامی که دکمه ماوس روی گزینه مربوطه در منو رها شود، کنسول به شماره مشخص‌شده تغییر می‌یابد. مقدار ttynumber باید به‌صورت یک رشته مشخص شود. هر tty را می‌توان از این طریق در دسترس قرار داد، حتی مواردی که از طریق صفحه‌کلید قابل دسترسی نیستند.
string f.mktty ttynumber: هنگامی که دکمه ماوس روی گزینه مربوطه در منو رها شود، یک کنسول بلااستفاده انتخاب شده و /sbin/mingetty در آن اجرا می‌شود. کنسول جاری به کنسول تازه بازشده تغییر می‌یابد. از این دستور می‌توان برای صرفه‌جویی در حافظه هسته با باز کردن یک کنسول واحد از طریق /etc/inittab و درخواست سایر کنسول‌ها تنها در زمان نیاز به ورود به سیستم (login) استفاده کرد.
string Whole-menu: یک منو می‌تواند مستقیماً پس از رشته برچسب بیاید. هنگامی که اشاره‌گر ماوس در سطح string از کادر منو خارج شود، یک منوی ثانویه بر روی صفحه نمایش داده می‌شود.
string f.lock: هنگامی که دکمه ماوس روی گزینه مربوطه در منو رها شود، صفحه‌کلید و صفحه‌نمایش قفل می‌شوند و تنها کاربر قفل‌کننده یا مدیر سیستم (superuser) می‌توانند قفل آن‌ها را باز کنند. این قابلیت هنوز پیاده‌سازی نشده است.
string f.load: میانگین بار کاری سیستم (loadavg) فعلی در هنگام نمایش منو، به string الحاق می‌شود تا پیام واقعی نمایان‌شده بر روی صفحه ساخته شود. هنگام رها کردن دکمه هیچ اتفاقی نمی‌افتد.
string f.free: حافظه آزاد و مقدار سواپ (swap) هنگام نمایش منو، به string الحاق می‌شود تا پیام واقعی نمایان‌شده بر روی صفحه ایجاد شود. هنگام رها کردن دکمه هیچ اتفاقی نمی‌افتد.
string f.time: زمان جاری با استفاده از تابع strftime(3) و مطابق با string قالب‌بندی می‌شود. رشته حاصل پیام واقعی نمایان‌شده بر روی صفحه خواهد بود. هنگام رها کردن دکمه هیچ اتفاقی نمی‌افتد.
string f.pipe cmdline: هنگامی که اشاره‌گر ماوس در سطح string از کادر منو خارج شود، یک کادر پیام روی صفحه ظاهر می‌شود که ده خط آخر خروجی cmdline را نمایش می‌دهد. cmdline توسط /bin/sh اجرا می‌شود. این قابلیت هنوز پیاده‌سازی نشده است.
string f.nop: این دستور کاری انجام نمی‌دهد و تنها string را در منو نمایش می‌دهد.

متغیرهای محیطی HOME، LOGNAME و USER پیش از اجرای یک فرآیند خارجی (f.bgcmd، f.pipe) به مقادیر مربوط به کاربری که برنامه را فراخوانی کرده تنظیم می‌شوند. دایرکتوری جاری همیشه / است.

اشکالات (BUGS)

اشکالات شناخته‌شده برطرف شده‌اند. به‌ویژه، اگر gpm-root را بلافاصله پس از gpm اجرا کنید، چند ثانیه پیش از تلاش برای اتصال به دیمن تأخیر خواهد داشت.

نویسنده (AUTHOR)

Alessandro Rubini <rubini@linux.it>

فایلها (FILES)

/dev/gpmctl         سوکت مورداستفاده برای اتصال به gpm.
/etc/gpm-root.conf  فایل پیکربندی پیش‌فرض.
$(HOME)/.gpm-root   فایل پیکربندی کاربر.
/dev/vcs*           صفحه‌نمایش‌های کنسول مجازی (Virtual Console Screens)

همچنین ببینید (SEE ALSO)

 gpm(8)

فایل info درباره `gpm' که اطلاعات جامع‌تری ارائه می‌دهد و نحوه نوشتن یک کلاینت gpm را شرح می‌دهد.