| MC-TOOL(1) | ابزارهای کمکی | MC-TOOL(1) |
نام (NAME)
mc-tool - مدیریت حساب‌های Mission Control از طریق خط فرمان
خلاصه دستور (SYNOPSIS)
mc-tool list
mc-tool add PROFILE DISPLAY-NAME [PARAMETER-SETTINGS...]
mc-tool add MANAGER/PROTOCOL [PARAMETER-SETTINGS...]
mc-tool update ACCOUNT [PARAMETER-SETTINGS...]
mc-tool display ACCOUNT DISPLAY-NAME
mc-tool nick ACCOUNT NICKNAME
mc-tool service ACCOUNT SERVICE-NAME
mc-tool icon ACCOUNT ICON
mc-tool show ACCOUNT
mc-tool get ACCOUNT PARAMETER [PARAMETER...]
mc-tool auto-presence ACCOUNT STATUS [MESSAGE]
mc-tool request ACCOUNT STATUS [MESSAGE]
mc-tool auto-connect ACCOUNT on|off
mc-tool remove ACCOUNT
توضیحات (DESCRIPTION)
نحوهٔ عملکرد mc-tool به نخستین آرگومان آن («دستور») بستگی دارد.
مشخص کردن حساب‌ها
هر جا که نام حسابی مورد نیاز باشد، می‌توان آن را به‌صورت یک مسیر شیء کامل (مانند /org/freedesktop/Telepathy/Account/gabble/jabber/example) یا به‌صورت پسوند یکتای مختص حساب (مانند gabble/jabber/example) مشخص کرد.
مشخص کردن تنظیمات پارامترها
بسیاری از دستورها آرگومان‌هایی دریافت می‌کنند که نمایانگر پارامترهای مدیر اتصال Telepathy هستند (برای جزئیات بیشتر به Telepathy Specification مراجعه کنید). هر آرگومان دارای ساختار زیر است:
TYPE:NAME=VALUE
که در آن TYPE یکی از مقادیر int، uint، bool یا string است (انواع پارامتر دیگری نیز وجود دارند، اما در حال حاضر توسط mc-tool پشتیبانی نمی‌شوند)، NAME نام پارامتر مدیر اتصال است (مانند account یا password)، و VALUE مقدار پارامتر است (اعداد صحیح در مبنای ده‌دهی، و مقادیر بولی به‌صورت 0 یا 1).
دستور update همچنین آرگومان‌هایی با ساختار clear:NAME را می‌پذیرد که پارامتر نام‌برده را از پیکربندی حساب حذف می‌کند.
LIST
mc-tool list حساب‌های موجود را فهرست می‌کند.
ADD
mc-tool add یک حساب جدید اضافه می‌کند. مدیر اتصال و پروتکل را می‌توان هم با نام یک نمایه profile در Mission Control (مانند gtalk) و هم به‌صورت نام مدیر اتصال و پروتکل جدا شده با ممیز (مانند gabble/jabber) مشخص کرد.
DISPLAY
mc-tool display ACCOUNT DISPLAY-NAME ویژگی DisplayName حساب ACCOUNT را به DISPLAY-NAME تنظیم می‌کند.
NICK
mc-tool nick ACCOUNT NICKNAME ویژگی Nickname حساب ACCOUNT را به NICKNAME تنظیم می‌کند.
SERVICE
mc-tool service ACCOUNT SERVICE-NAME ویژگی Service حساب ACCOUNT را به SERVICE-NAME تنظیم می‌کند.
ICON
mc-tool icon ACCOUNT ICON ویژگی Icon حساب ACCOUNT را به ICON تنظیم می‌کند.
SHOW
mc-tool show ACCOUNT اطلاعات مربوط به ACCOUNT را نمایش می‌دهد.
GET
mc-tool get ACCOUNT PARAMETER [PARAMETER...] مقادیر پارامترهای مشخص‌شده از ACCOUNT را نمایش می‌دهد.
ENABLE
mc-tool enable ACCOUNT ویژگی Enabled حساب ACCOUNT را برابر با True قرار می‌دهد.
DISABLE
mc-tool disable ACCOUNT ویژگی Enabled حساب ACCOUNT را برابر با False قرار می‌دهد.
AUTO-PRESENCE
mc-tool auto-presence ACCOUNT STATUS [MESSAGE] ویژگی AutomaticPresence حساب ACCOUNT را به STATUS همراه با پیام اختیاری MESSAGE تنظیم می‌کند.
REQUEST
mc-tool request ACCOUNT STATUS [MESSAGE] ویژگی RequestedPresence حساب ACCOUNT را به STATUS همراه با پیام اختیاری MESSAGE تنظیم می‌کند؛ برای نمونه، با این دستور به یک حساب اعلام می‌شود که متصل شده یا آفلاین شود.
AUTO-CONNECT
mc-tool auto-connect ACCOUNT on ویژگی ConnectAutomatically حساب ACCOUNT را به True تنظیم می‌کند.
mc-tool auto-connect ACCOUNT off آن را به False تنظیم می‌کند.
| July 2009 | Telepathy |