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