.TH "GPM" "8" "فوریه ۲۰۰۲" "gpm" "راهنمای مدیر سیستم" .SH "نام (NAME)" gpm \- کارساز موشواره و ابزار برش و چسباندن در کنسول متنی لینوکس .SH "خلاصه دستور (SYNOPSIS)" .B gpm [ .I گزینه‌ها ] .SH "توضیحات (DESCRIPTION)" این بسته تلاش می‌کند یک کارساز موشواره (mouse server) سودمند برای برنامه‌های در حال اجرا در کنسول لینوکس باشد. این برنامه بر پایه بسته .B "selection" توسعه یافته است و بخشی از کدهای آن مستقیماً از خود selection برگرفته شده است. این بسته به عنوان جایگزینی برای selection جهت ارائه مکانیزم برش و چسباندن (cut-and-paste) طراحی شده است و امکانات بیشتری را نیز فراهم می‌آورد. بسته .B "selection" نخستین پیاده‌سازی برش و چسباندن را در لینوکس با استفاده از دو دکمه موشواره ارائه داد و بافر برش در سراسر این سند همچنان «بافر انتخاب» (selection buffer) یا صرفاً «انتخاب» نامیده می‌شود. اطلاعات زیر از فایل texinfo استخراج شده که منبع ارجح اطلاعات است. .LP فایل اجرایی .B gpm برای فعالیت به صورت یک دیمن طراحی شده است (از این رو، شاید .B gpmd نام مناسب‌تری برای آن بود). این بخش به توصیف گزینه‌های خط فرمان .B gpm می‌پردازد، در حالی که ساختار درونی آن در بخش‌های بعدی تشریح شده است. .LP به دلیل محدودیت‌های فراخوان سیستمی .BR ioctl(TIOCLINUX) ، برنامه .B gpm باید توسط کاربر ارشد (superuser / root) اجرا شود. این محدودیت‌ها در اواخر هسته‌های نسخه 1.1 به منظور رفع یک رخنه امنیتی مربوط به انتخاب متن و ذخیره محتوای صفحه (screen dumping) اضافه شدند. .LP کارساز می‌تواند متناسب با سلیقه کاربر پیکربندی شود و هر برنامه‌ای که از موشواره استفاده کند، رفتار کارساز را به ارث خواهد برد. از نسخه 1.02 تا 1.19.2 امکان تغییر رفتار و حساسیت موشواره برای هر کاربری که به کنسول سیستم وارد شده بود با استفاده از گزینه .B \-q وجود داشت. این امکان به دلایل امنیتی دیگر میسر نیست. .LP از نسخه 0.97 به بعد، برنامه کارساز به صورت خودکار خود را به پس‌زمینه می‌برد. برای خاتمه دادن به اجرای .B gpm می‌توانید آن را مجدداً با سوییچ خط فرمان .B \-k اجرا کنید، اگرچه دستور .B killall gpm می‌تواند گزینه بهتری باشد. .SH "دستورات ویژه (SPECIAL COMMANDS)" نسخه 1.10 قابلیت اجرای دستورات ویژه را در شرایط خاص اضافه کرده است. دستورات ویژه به طور پیش‌فرض شامل راه‌اندازی مجدد (reboot) و توقف کامل سیستم (halt) هستند، اما کاربر می‌تواند انتخاب شخصی خود را تعیین کند. قابلیت فراخوانی دستورات با استفاده از موشواره برای برنامه‌نویسان بسیار کارآمد است، زیرا هنگامی که صفحه‌کلید قفل شده و شبکه‌ای برای بازگرداندن سیستم به حالت پایدار در دسترس نیست، امکان خاموش کردن ایمن سیستم را فراهم می‌کند. .LP دستورات ویژه با سه بار کلیک هم‌زمان دکمه‌های چپ و راست فعال می‌شوند؛ رویدادی که در حالت عادی بعید است رخ دهد. ساده‌ترین روش برای سه بار کلیک، فشردن و نگه‌داشتن یکی از دکمه‌ها و سه بار کلیک روی دکمه دیگر است. هنگامی که پردازش دستورات ویژه فعال می‌شود، پیامی در کنسول ظاهر شده (و بلندگوی سیستم، در صورت وجود، دو بار بوق می‌زند)؛ اگر کاربر تمامی دکمه‌ها را رها کند و ظرف مدت سه ثانیه دوباره یکی از آن‌ها را بفشارد، دستور ویژه متناظر با آن دکمه اجرا می‌شود. .LP دستورات ویژه پیش‌فرض عبارتند از: .TP .B "دکمه چپ" راه‌اندازی مجدد سیستم با ارسال سیگنال به فرایند .B init .TP .B "دکمه وسط (در صورت وجود)" اجرای دستور .B /sbin/shutdown \-h now .TP .B "دکمه راست" اجرای دستور .B /sbin/shutdown \-r now .LP سوییچ خط فرمان .B \-S پردازش دستورات ویژه را فعال کرده و امکان تغییر این سه دستور ویژه را فراهم می‌سازد. برای پذیرش دستورات پیش‌فرض از .B \-S "" (یعنی مشخص کردن یک آرگومان خالی) استفاده کنید. برای تعیین دستورات دلخواه، از یک فهرست جداشده با دونقطه (:) برای مشخص کردن دستورات وابسته به دکمه‌های چپ، وسط و راست استفاده نمایید. اگر هر یک از دستورات خالی رها شود، به معنای «ارسال سیگنال به فرایند init» تفسیر خواهد شد. این عملکرد خاص، علاوه بر اجرای دستورات بیرونی، به این دلیل پشتیبانی می‌شود که گاهی اشکالات وخیم مانع fork شدن فرایندها در سیستم می‌شوند؛ در چنین موارد نادری برنامه‌نویس باید بتواند به هر نحوی سیستم را خاموش کند و کشتن فرایند init از یک فرایند در حال اجرا تنها راه ممکن است. .LP به عنوان مثال، .B \-S ":telinit 1:/sbin/halt" ارسال سیگنال خاتمه به فرایند init را به دکمه چپ، رفتن به حالت تک‌کاربره (single-user) را به دکمه وسط و توقف کامل سیستم را به دکمه راست اختصاص می‌دهد. .LP مدیران سیستم بدیهی است که باید در مورد دستورات ویژه احتیاط کنند، زیرا .B gpm با دسترسی کاربر ارشد اجرا می‌شود. دستورات ویژه برای رایانه‌هایی مناسب‌ترند که موشواره آن‌ها تنها به صورت فیزیکی در دسترس افراد مورد اعتماد باشد. .SH "گزینه‌های خط فرمان (COMMAND LINE OPTIONS)" گزینه‌های خط فرمان موجود به شرح زیر است: .TP .BI \-a " accel" تنظیم مقدار شتاب (acceleration) که هنگامی استفاده می‌شود که یک رویداد حرکتی بزرگ‌تر از .B delta باشد (گزینه .B \-d را ببینید). .TP .BI \-A [limit] راه‌اندازی با غیرفعال بودن چسباندن متن انتخاب‌شده. این یک اقدام امنیتی است؛ زیرا یک حمله محتمل به سیستم این است که یک دستور مخرب شل (مانند .BR "rm \-rf /" ) به همراه نویسه خط بعد در بافر انتخاب قرار داده شود، و تنها کاری که قربانی باید انجام دهد کلیک روی دکمه وسط موشواره است... از نسخه 1.17.2، این ویژگی به یک سازوکار انقضای زمانی (aging) عمومی‌تر ارتقا یافته است؛ دیمن .B gpm می‌تواند پس از گذشت مدتی عدم فعالیت، چسباندن متن انتخاب‌شده را به طور خودکار غیرفعال کند. برای فعال‌سازی این حالت، پارامتر اختیاری .I limit را بدون فاصله بعد از گزینه وارد کنید (بدون هیچ فاصله‌ای میان آن‌ها!) که به عنوان زمان معتبر بودن و قابلیت چسباندن متن انتخاب‌شده بر حسب ثانیه تفسیر می‌شود. از نسخه 1.15.7، برنامه‌ای ساده به نام .B disable-paste ارائه شده است. افزودن قطعه کد زیر به فایل .I /etc/profile در صورتی که به چندین کاربر اجازه کار روی کنسول را می‌دهید، ایده مناسبی است: .IP .EX case $( /usr/bin/tty ) in /dev/tty[0\-9]*) /usr/bin/disable-paste ;; esac .EE .TP .BI \-b " baud" تنظیم نرخ باود (baud rate). .TP .BI \-B " sequence" تنظیم ترتیب دکمه‌ها. ترتیب عادی .B 123 است، .B 321 می‌تواند توسط افراد چپ‌دست استفاده شود، و .B 132 می‌تواند برای موشواره‌های دو دکمه‌ای (به‌ویژه در Emacs) سودمند باشد. تمامی جایگشت‌های دکمه‌ها مجاز هستند. .TP .BI \-d " delta" تنظیم مقدار دلتا. هنگامی که یک رویداد حرکتی منفرد بزرگ‌تر از .I delta باشد، .B accel به عنوان ضریب شتاب اعمال می‌شود (باید ۲ یا بیشتر باشد). .TP .B \-D پس از راه‌اندازی، به صورت خودکار به پس‌زمینه نرود و پیام‌ها به جای سازوکار syslog به جریان خطای استاندارد (stderr) لاگ شوند. این گزینه برای اشکال‌زدایی مفید است؛ در نسخه‌های قبلی این کار از طریق یک گزینه زمان کامپایل انجام می‌شد. .TP .BI \-g " number" در دستگاه‌های glidepoint (تاچ‌پد)، دکمه مشخص‌شده را با ضربه زدن (tapping) شبیه‌سازی می‌کند. مقدار .I number باید ۱، ۲ یا ۳ باشد و به شماره دکمه پیش از اعمال نگاشت دکمه‌ها با .B \-B اشاره دارد. این گزینه برای رمزگشایی mman و ps2 کاربرد دارد. به طور پیش‌فرض هیچ دکمه‌ای شبیه‌سازی نمی‌شود، زیرا ضربه زدن در ps2 با برخی موشواره‌های معمولی ps2 ناسازگار است. .TP .B \-h چاپ خلاصه گزینه‌های خط فرمان و خروج. .TP .BI \-i " interval" تنظیم .I interval به عنوان حد بالای زمانی برای کلیک‌های چندگانه. اگر فاصله زمانی بین رویداد رها کردن دکمه (button-up) و فشردن مجدد آن (button-down) کمتر از این مقدار باشد، کلیک دوگانه یا سه‌گانه در نظر گرفته می‌شود. زمان بر حسب میلی‌ثانیه است. .TP .B \-k خاتمه دادن به اجرای gpm در حال اجرا. این گزینه می‌تواند توسط کاربران busmouse برای متوقف کردن gpm پیش از اجرای سامانه پنجره‌ای X استفاده شود (مگر اینکه از .B \-R استفاده کنند یا محدودیت تک‌بازشدن (single-open) از هسته برداشته شده باشد). .TP .BI \-l " charset" انتخاب جدول جستجوی ()inword. آرگومان .I charset فهرستی از کاراکترها است. از .B \- برای تعیین بازه و از .B \\ برای اسکیپ کردن کاراکتر بعدی یا ارائه کدهای هشت‌هشتی (octal) استفاده می‌شود. تنها کاراکترهای مرئی می‌توانند در .I charset قرار گیرند، زیرا کاراکترهای کنترلی نمی‌توانند در حافظه ویدئویی حالت متنی که متن انتخابی از آن بریده می‌شود ظاهر شوند. .TP .BI \-m " filename" انتخاب فایل دستگاه موشواره برای باز کردن. این گزینه باید قبل از .B \-t و .B \-o قرار گیرد. .TP .B \-M فعال‌سازی حالت چندگانه (multiple mode). دیمن دو دستگاه موشواره مختلف را می‌خواند. هر گزینه‌ای که پس از این گزینه بیاید به دستگاه دوم اشاره خواهد داشت، در حالی که گزینه‌های پیش از آن برای دستگاه اول اعمال می‌شوند. این گزینه به طور خودکار گزینه تکرارکننده .RB ( \-R ) را فعال می‌کند. .TP .BI \-o " list-of-extra-options" این گزینه مشابه با گزینه «\-o» در دستور mount عمل می‌کند؛ و برای تعیین فهرستی از «گزینه‌های اضافی» مختص به هر نوع موشواره به کار می‌رود. این فهرست با کاما جدا می‌شود. گزینه‌های .BR dtr ، .B rts یا هر دو در مقداردهی اولیه پورت سریال برای تغییر وضعیت خطوط مودم به کار می‌روند تا با نسخه‌های پیشین gpm سازگار باشند؛ البته توجه داشته باشید که استفاده از .B \-o dtr همراه با موشواره‌های غیرسریالی خالص ممکن است خطا تولید کند. ضمناً، گزینه .B \-o را پس از .B \-m و .B \-t استفاده کنید. .TP .B \-p مکان‌نما را هنگام انتخاب متن مرئی نگه می‌دارد. این رفتار برنامه selection-1.7 است، اما گاهی گیج‌کننده است. حالت پیش‌فرض نمایش ندادن نشانگر است که آن هم می‌تواند به همان اندازه گیج‌کننده باشد. .TP .BI \-r " number" تنظیم میزان پاسخ‌دهی (responsiveness). مقدار پاسخ‌دهی بالاتر برای حرکت سریع‌تر مکان‌نما استفاده می‌شود. .TP .BI \-R [name] باعث می‌شود gpm به عنوان یک تکرارکننده (repeater) عمل کند: هرگونه داده موشواره دریافت شده در حالت گرافیکی، روی لوله نام‌گذاری‌شده (fifo) به نشانی .I /dev/gpmdata با پروتکل .IR name ، که به عنوان آرگومان اختیاری مشخص شده است (بدون فاصله در میان!)، بازتولید می‌شود. اصولاً می‌توانید از همان نام‌های معتبر برای گزینه .B \-t استفاده کنید، اگرچه بازتکرار در برخی پروتکل‌ها ممکن است هنوز پیاده‌سازی نشده باشد. علاوه بر این، می‌توانید .B raw را به عنوان .I name مشخص کنید تا داده‌های موشواره بایت به بایت بدون هیچ‌گونه تبدیل پروتکل بازتکرار شوند. اگر .I name ذکر نشود، به طور پیش‌فرض .B msc خواهد بود. با استفاده از gpm در حالت تکرارکننده، می‌توانید کارساز X را پیکربندی کنید تا از فایل fifo آن به عنوان دستگاه موشواره استفاده کند. این گزینه برای دارندگان موشواره‌های busmouse جهت غلبه بر محدودیت تک‌بازشدن (single-open) مفید است. همچنین روشی آسان برای مدیریت موشواره‌های دوحالته است که شما را مجبور می‌کنند هنگام تغییر حالت ویدئویی دکمه وسط را فشرده نگه دارید. این گزینه به اجبار توسط گزینه .B \-M فعال می‌شود. .TP .BI \-s " number" تنظیم نرخ نمونه‌برداری (sample rate) برای دستگاه موشواره. .TP .BI \-S " commands" فعال‌سازی پردازش دستورات ویژه، و در صورت تمایل تعیین دستورات سفارشی به صورت یک فهرست جدا شده با دونقطه (:). برای توصیف دقیق دستورات ویژه، بخش بالا را ببینید. .TP .BI \-t " name" تنظیم نوع موشواره. از .B "\-t help" برای دریافت فهرستی از انواع مجاز استفاده کنید. از نسخه 1.18.1، این فهرست همچنین پروتکل‌هایی را که به عنوان تکرارکننده در دسترس هستند (گزینه .B \-R در بالا را ببینید) با علامت ستاره («*») مشخص می‌کند. .IP پس از انتخاب دستگاه موشواره با .BR \-m ، از .B \-t استفاده کنید. .TP .B \-v چاپ اطلاعات نسخه و خروج. .TP .B \-2 اجبار به عملکرد دو دکمه‌ای. بدین معنا که دکمه وسط (در صورت وجود) همانند دکمه راست در نظر گرفته خواهد شد. .TP .B \-3 اجبار به عملکرد سه دکمه‌ای. به طور پیش‌فرض موشواره تا زمانی که دکمه وسط فشرده نشود، دو دکمه‌ای فرض می‌شود. اگر سه دکمه وجود داشته باشد، دکمه راست برای گسترش محدوده انتخاب و دکمه وسط برای چسباندن آن به کار می‌رود. هشدار: اگر از گزینه .B \-3 با یک موشواره دو دکمه‌ای استفاده کنید، قادر به چسباندن متن انتخاب‌شده نخواهید بود. .SH "نحوه عملکرد (OPERATION)" برای انتخاب متن، دکمه چپ موشواره را فشرده و موشواره را بکشید (drag). برای چسباندن متن در همان کنسول یا کنسولی دیگر، دکمه وسط را فشار دهید. دکمه راست همانند .B xterm برای گسترش دادن محدوده انتخاب به کار می‌رود. .LP موشواره‌های دو دکمه‌ای از دکمه راست برای چسباندن متن استفاده می‌کنند. .LP دو بار یا سه بار کلیک کردن به ترتیب تمام کلمه و تمام خط را انتخاب می‌کند. برای دریافت بهترین بازخورد بصری، استفاده از گزینه .B \-p توصیه می‌شود. .LP اگر فاصله پایانی پس از محتوای یک خط برجسته (highlight) شود و متن دیگری در ادامه آن خط وجود نداشته باشد، باقی‌مانده خط به طور خودکار انتخاب خواهد شد. اگر چندین خط انتخاب شوند، فاصله‌های پایانی برجسته‌شده در هر خط از بافر انتخاب حذف خواهند شد. .LP هرگونه خروجی روی کنسول مجازی دارای انتخاب، متن برجسته‌شده را به منظور حفظ یکپارچگی صفحه نمایش پاک می‌کند، هرچند محتویات بافر چسباندن دست‌نخورده باقی می‌ماند. .LP اگر کنسول مجازی کنترل‌کننده وارد حالت گرافیکی شود (برای نمونه هنگام اجرای سامانه پنجره‌ای X11)، سازوکار انتخاب غیرفعال می‌شود و با بازگشت به حالت متنی مجدداً فعال می‌گردد (اما بخش اشکالات را در زیر ببینید). .SH "اشکالات (BUGS)" کارساز gpm ممکن است در تعامل با سرور گرافیکی X با مشکلاتی مواجه شود: اگر دستگاه موشواره شما فقط قابلیت یک‌بار باز شدن هم‌زمان را دارد (مانند یک bus mouse)، باید .B gpm را قبل از اجرای X متوقف کنید یا از گزینه .B \-R (توضیح داده شده در بالا) استفاده نمایید. برای بستن gpm کافی است دستور .B gpm \-k را اجرا کنید. این مشکل برای موشواره‌های پورت سریال وجود ندارد. .LP دو نمونه از gpm نمی‌توانند به طور هم‌زمان روی یک سیستم اجرا شوند. اگر دو موشواره دارید، از گزینه .B \-M (توضیح داده شده در بالا) استفاده کنید. .LP هنگامی که کنسول فعلی در حالت گرافیکی است، gpm به خواب می‌رود تا زمانی که حالت متنی بازگردد (مگر اینکه از .B \-R استفاده شود). بنابراین به کلاینت‌ها پاسخ نخواهد داد. با این حال بعید است که کلاینت‌های نیازمند موشواره در کنسول‌های مخفی ناگهان فعال شوند. .LP برنامه‌های کلاینت ارائه‌شده همراه با gpm به‌روزرسانی نشده‌اند، بنابراین استفاده از آن‌ها ممکن است خطرات امنیتی بالقوه‌ای به همراه داشته باشد. .SH "نویسندگان (AUTHORS)" .nf Andrew Haylett (کد اولیه selection) Ian Zimmerman (نگه‌دارنده پیشین) Alessandro Rubini (نگه‌دارنده پیشین (هنوز کمک‌های شایانی می‌کند)) Nico Schottelius (نگه‌دارنده) مشارکت‌کنندگان بسیار برای هر دو پروژه selection و gpm. .fi .SH "نگه‌دارندگان (MAINTAINERS)" نگه‌دارنده فعلی Nico Schottelius است. اما بدون کمک Alessandro Rubini و فهرست پستی، نگه‌داری gpm برای من غیرممکن بود. فهرست پستی توسعه از طریق نشانی .B gpm@lists.linux.it در دسترس است. اطلاعات بیشتر درباره این فهرست در فایل .B README بخشی از توزیع سورس‌کد gpm قرار دارد. .SH "فایل‌ها (FILES)" .TP .I /var/run/gpm.pid شناسه فرایند (PID) مربوط به gpm در حال اجرا .TP .I /dev/gpmctl سوکت کنترلی برای کلاینت‌ها .TP .I /dev/gpmdata لوله نام‌گذاری‌شده (fifo) که توسط یک دیمن در حالت تکرارکننده .RB ( \-R ) نوشته می‌شود. .SH "همچنین ببینید (SEE ALSO)" .TP .BR mev (1) یک کلاینت نمونه برای دیمن gpm. .TP .BR gpm\-root (1) مدیریت‌کننده رویدادهای مهار-موشواره (Control-Mouse). .PP فایل info مربوط به .BR gpm ، که اطلاعات کامل‌تری ارائه می‌دهد و نحوه نوشتن کلاینت gpm را تشریح می‌کند.