.\" Man page generated from reStructuredText .\" by the Docutils 0.23 manpage writer. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "bluetoothctl" "1" "March 2024" "BlueZ" "Linux System Administration" .SH "نام (NAME)" bluetoothctl \- ابزار خط فرمان مدیریت بلوتوث .SH "خلاصه دستور (SYNOPSIS)" .sp \fBbluetoothctl\fP [\fB\-a\fP \fIcapability\fP] [\fB\-e\fP] [\fB\-m\fP] [\fB\-t\fP \fIseconds\fP] [\fB\-v\fP] [\fB\-h\fP] .SH "توضیحات (DESCRIPTION)" .sp ابزار تعاملی کنترل بلوتوث \fBbluetoothctl(1)\fP. این ابزار با کنترل‌کننده‌های بلوتوث سنتی (BR/EDR) و بلوتوث کم‌مصرف (LE) کار می‌کند. .sp این ابزار مبتنی بر منو است اما قابلیت خودکارسازی از طریق خط فرمان را نیز دارد. نمونه‌هایی در بخش خودکارسازی آورده شده است. .sp این ابزار از طریق D\-Bus با دیمن BlueZ ارتباط برقرار می‌کند، که عمدتاً با استفاده از رابط‌های \fBorg.bluez.Adapter(5)\fP و \fBorg.bluez.Device(5)\fP انجام می‌پذیرد. هر فرمان مشخص می‌کند که از کدام رابط D\-Bus و متد/ویژگی بهره می‌برد. .SH "گزینه‌ها (OPTIONS)" .INDENT 0.0 .TP .BI \-a \ capability\fR,\fB \ \-\-agent \ capability ثبت گرداننده عامل (agent handler): .TP .B \-e\fP,\fB \-\-endpoints ثبت نقاط پایانی رسانه (Media endpoints) .TP .B \-m\fP,\fB \-\-monitor فعال‌سازی خروجی پایشگر (monitor output) .TP .BI \-t \ seconds\fR,\fB \ \-\-timeout \ seconds مدت زمان انتظار به ثانیه برای حالت غیرتعاملی .TP .B \-v\fP,\fB \-\-version نمایش نسخه .TP .B \-h\fP,\fB \-\-help نمایش راهنما .UNINDENT .SH "فرمان‌ها (COMMANDS)" .SS "list" .sp فهرست کردن کنترل‌کننده‌های در دسترس. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> list\fP .TP .B مثال: نمایش تمام کنترل‌کننده‌های بلوتوث موجود در سامانه .nf \fB> list\fP .fi .sp .UNINDENT .SS "show" .sp اطلاعات کنترل‌کننده. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> show [ctrl]\fP .TP .B کاربردها (Uses) ویژگی‌های \fBorg.bluez.Adapter(5)\fP .TP .B [ctrl] نشانی کنترل‌کننده بلوتوث .TP .B مثال: نمایش اطلاعات کنترل‌کننده فعال کنونی .nf \fB> show\fP .fi .sp .TP .B مثال: نمایش اطلاعات کنترل‌کننده 00:11:22:33:44:55 .nf \fB> show 00:11:22:33:44:55\fP .fi .sp .UNINDENT .SS "select" .sp انتخاب کنترل‌کننده پیش‌فرض. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> select \fP .TP .B نشانی کنترل‌کننده بلوتوث .TP .B مثال: انتخاب کنترل‌کننده 00:11:22:33:44:55 .nf \fB> select 00:11:22:33:44:55\fP .fi .sp .UNINDENT .SS "devices" .sp فهرست کردن دستگاه‌های موجود، به همراه یک ویژگی اختیاری به عنوان پالایه (فیلتر). .INDENT 0.0 .TP .B کاربرد (Usage) \fB> devices [Paired/Bonded/Trusted/Connected]\fP .TP .B [Paired/Bonded/Trusted/Connected] پالایه برای نمایش تنها دستگاه‌های دارای ویژگی خاص (اختیاری) .TP .B مثال: فهرست کردن تمام دستگاه‌های کشف‌شده .nf \fB> devices\fP .fi .sp .TP .B مثال: فهرست کردن تنها دستگاه‌های جفت‌شده (Paired) .nf \fB> devices Paired\fP .fi .sp .TP .B مثال: فهرست کردن تنها دستگاه‌های پیوند‌خورده (Bonded) .nf \fB> devices Bonded\fP .fi .sp .TP .B مثال: فهرست کردن تنها دستگاه‌های مورد اعتماد (Trusted) .nf \fB> devices Trusted\fP .fi .sp .TP .B مثال: فهرست کردن تنها دستگاه‌های متصل کنونی (Connected) .nf \fB> devices Connected\fP .fi .sp .UNINDENT .SS system\-alias .sp تنظیم نام مستعار کنترل‌کننده. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> system\-alias \fP .TP .B استفاده‌ها (Uses) ویژگی \fBAlias\fP در \fBorg.bluez.Adapter(5)\fP .TP .B نام مستعار جدید برای کنترل‌کننده بلوتوث (الزامی) .TP .B مثال تنظیم نام مستعار کنترل‌کننده با فاصله (به نقل‌قول‌ها دقت کنید) (Example Set controller alias with spaces (note quotes)) .nf \fB> system\-alias \(dqMy Desktop Bluetooth\(dq\fP .fi .sp .TP .B مثال تنظیم نام مستعار کنترل‌کننده بدون فاصله (Example Set controller alias without spaces) .nf \fB> system\-alias MyLaptop\fP .fi .sp .TP .B مثال تنظیم نام مستعار کنترل‌کننده با خط تیره (Example Set controller alias with hyphens) .nf \fB> system\-alias \(dqHome\-Office\-PC\(dq\fP .fi .sp .UNINDENT .SS reset\-alias .sp بازنشانی نام مستعار کنترل‌کننده. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> reset\-alias\fP .TP .B استفاده‌ها (Uses) ویژگی \fBAlias\fP در \fBorg.bluez.Adapter(5)\fP .TP .B مثال بازنشانی نام مستعار کنترل‌کننده به مقدار پیش‌فرض (معمولاً نام میزبان) (Example Reset controller alias to default (usually the hostname)) .nf \fB> reset\-alias\fP .fi .sp .UNINDENT .SS power .sp تنظیم وضعیت برق کنترل‌کننده. .sp هنگامی که کنترل‌کننده خاموش می‌شود، درگاه USB که کنترل‌کننده به آن متصل است در وضعیت تعلیق قرار می‌گیرد. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> power \fP .TP .B استفاده‌ها (Uses) ویژگی \fBPowered\fP در \fBorg.bluez.Adapter(5)\fP .TP .B وضعیت برق \- \(dqon\(dq برای فعال‌سازی یا \(dqoff\(dq برای غیرفعال‌سازی کنترل‌کننده (الزامی) .TP .B مثال روشن کردن کنترل‌کننده بلوتوث (Example Turn on the Bluetooth controller) .nf \fB> power on\fP .fi .sp .TP .B مثال خاموش کردن کنترل‌کننده بلوتوث (Example Turn off the Bluetooth controller) .nf \fB> power off\fP .fi .sp .UNINDENT .SS advertise .sp فعال/غیرفعال‌سازی آگهی‌رسانی با نوع داده‌شده. .sp هنگامی که کنترل‌کننده یک دستگاه LE (جانبی) را آگهی‌رسانی می‌کند، در صورتی که کنترل‌کننده توانایی آن را داشته باشد، برای حفظ حریم خصوصی خود یک نشانی تصادفی تولید خواهد کرد؛ در صورتی که از این ویژگی پشتیبانی نکند، از نشانی عمومی خود (نشانی دستگاه) استفاده می‌کند. .sp یک دستگاه می‌تواند آگهی‌رسانی کند چنانچه اتصال به دستگاه آگهی‌رسان دیگری را آغاز کرده باشد. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> advertise \fP .TP .B استفاده‌ها (Uses) متد \fBRegisterAdvertisement\fP در \fBorg.bluez.LEAdvertisingManager(5)\fP .TP .B حالت آگهی‌رسانی \- \(dqon\(dq، \(dqoff\(dq، \(dqperipheral\(dq، یا \(dqbroadcast\(dq (الزامی) .TP .B مثال فعال‌سازی آگهی‌رسانی پایه LE (Example Enable basic LE advertising) .nf \fB> advertise on\fP .fi .sp .TP .B مثال غیرفعال‌سازی آگهی‌رسانی LE (Example Disable LE advertising) .nf \fB> advertise off\fP .fi .sp .TP .B مثال آگهی‌رسانی به عنوان دستگاه جانبی (Example Advertise as peripheral device) .nf \fB> advertise peripheral\fP .fi .sp .TP .B مثال آگهی‌رسانی به عنوان منبع پخش همگانی (Example Advertise as broadcast source) .nf \fB> advertise broadcast\fP .fi .sp .UNINDENT .SS set\-alias .sp تنظیم نام مستعار دستگاه. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> set\-alias \fP .TP .B استفاده‌ها (Uses) ویژگی \fBAlias\fP در \fBorg.bluez.Device(5)\fP .TP .B نام مستعار جدید برای دستگاه (الزامی) .TP .B مثال تنظیم نام مستعار دستگاه با فاصله (به نقل‌قول‌ها دقت کنید) (Example Set device alias with spaces (note quotes)) .nf \fB> set\-alias \(dqMy Headphones\(dq\fP .fi .sp .TP .B مثال تنظیم نام مستعار دستگاه بدون فاصله (Example Set device alias without spaces) .nf \fB> set\-alias MyMouse\fP .fi .sp .TP .B مثال تنظیم نام مستعار دستگاه با خط تیره (Example Set device alias with hyphens) .nf \fB> set\-alias \(dqKitchen\-Speaker\(dq\fP .fi .sp .UNINDENT .SS scan .sp پویش برای یافتن دستگاه‌ها. .sp برای LE، پویش یک پیش‌نیاز مهم پیش از اتصال یا جفت‌سازی است. .sp هدف از پویش، یافتن دستگاه‌هایی است که با پرچم کشف‌پذیری فعال (چه محدود و چه عمومی) در حال انتشار و اعلام حضور هستند. پس از یافتن نشانی، می‌توانید متصل یا جفت شوید. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> scan \fP .TP .B استفاده‌ها (Uses) متدهای \fBStartDiscovery\fP و \fBStopDiscovery\fP در \fBorg.bluez.Adapter(5)\fP .TP .B حالت پویش \- \(dqon\(dq، \(dqoff\(dq، \(dqbredr\(dq برای کلاسیک، یا \(dqle\(dq برای کم‌مصرف (لازم) .TP .B مثال شروع پویش برای همه انواع دستگاه‌ها (LE + Classic) (Example Start scanning for all device types (LE + Classic)) .nf \fB> scan on\fP .fi .sp .TP .B مثال توقف پویش (Example Stop scanning) .nf \fB> scan off\fP .fi .sp .TP .B مثال پویش تنها برای دستگاه‌های کم‌مصرف (Example Scan for Low Energy devices only) .nf \fB> scan le\fP .fi .sp .TP .B مثال پویش تنها برای دستگاه‌های BR/EDR (کلاسیک) (Example Scan for BR/EDR (Classic) devices only) .nf \fB> scan bredr\fP .fi .sp .UNINDENT .SS pair .sp جفت‌سازی با دستگاه. .sp این دستور با یک دستگاه جفت می‌شود و سپس به آن اعتماد کرده و متصل می‌گردد. اگر دستگاه از قبل جفت شده باشد، ابتدا پیوند جفت‌سازی برداشته خواهد شد. .sp این فرمان چه زمانی که کنترل‌کننده در وضعیت متصل باشد و چه در وضعیت غیرمتصل، قابل استفاده است. .sp اگر کنترل‌کننده از پیش متصل باشد، فرمان جفت‌سازی می‌تواند بدون آرگومان به کار رود. اگر کنترل‌کننده متصل نباشد، می‌توان نشانی دستگاهی دارای گزارش پویش فعال را به فرمان pair داد و این دستور پیش از جفت‌سازی، اتصال را برقرار خواهد کرد. .sp پیش از جفت‌سازی باید کارگزار برای انتخاب سازوکار احراز هویت برگزیده شود. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> pair [dev]\fP .TP .B استفاده‌ها (Uses) متد \fBPair\fP در \fBorg.bluez.Device(5)\fP .TP .B [dev] نشانی MAC دستگاه (XX:XX:XX:XX:XX:XX) (اختیاری، در صورت حذف از دستگاه فعلی استفاده می‌شود) .TP .B مثال جفت‌سازی با دستگاه با استفاده از نشانی MAC (Example Pair with device using MAC address) .nf \fB> pair 00:11:22:33:44:55\fP .fi .sp .TP .B مثال جفت‌سازی با دستگاهی دیگر (Example Pair with another device) .nf \fB> pair AA:BB:CC:DD:EE:FF\fP .fi .sp .TP .B مثال جفت‌سازی با استفاده از مسیر شیء دستگاه (Example Pair using device object path) .nf \fB> pair /org/bluez/hci0/dev_00_11_22_33_44_55\fP .fi .sp .UNINDENT .SS pairable .sp تنظیم حالت جفت‌پذیری کنترل‌کننده. .sp این دستور جفت‌سازی را فعال/غیرفعال می‌کند. اگر جفت‌سازی غیرفعال باشد، کنترل‌کننده هیچ درخواست جفت‌سازی را نمی‌پذیرد. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> pairable \fP .TP .B استفاده‌ها (Uses) ویژگی \fBPairable\fP در \fBorg.bluez.Adapter(5)\fP .TP .B حالت جفت‌پذیری \- \(dqon\(dq برای پذیرش یا \(dqoff\(dq برای رد درخواست‌های جفت‌سازی (لازم) .TP .B مثال فعال کردن جفت‌سازی (پذیرش درخواست‌های جفت‌سازی) (Example Enable pairing (accept pairing requests)) .nf \fB> pairable on\fP .fi .sp .TP .B مثال غیرفعال کردن جفت‌سازی (رد درخواست‌های جفت‌سازی) (Example Disable pairing (reject pairing requests)) .nf \fB> pairable off\fP .fi .sp .UNINDENT .SS discoverable .sp تنظیم حالت کشف‌پذیری. .sp این دستور حالت کشف‌پذیری را فعال/غیرفعال می‌کند. اگر کشف‌پذیری غیرفعال باشد، کنترل‌کننده به هیچ درخواست پویشی پاسخ نخواهد داد. .sp در LE، اگر کشف‌پذیری خاموش باشد، کنترل‌کننده صرفاً به‌طور غیرفعال پویش می‌کند و به دستگاه‌های انتشاردهنده درخواستی برای پویش ارسال نمی‌کند. اگر روشن باشد، درخواست‌های تبلیغاتی ارسال خواهد کرد. .sp در صورت پشتیبانی کنترل‌کننده، از یک نشانی تصادفی استفاده خواهد شد. مدت زمانی که \(dqdiscoverable on\(dq معتبر است توسط فرمان discoverable\-timeout مشخص می‌شود. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> discoverable \fP .TP .B استفاده‌ها (Uses) ویژگی \fBDiscoverable\fP در \fBorg.bluez.Adapter(5)\fP .TP .B حالت کشف‌پذیری \- \(dqon\(dq برای کشف‌پذیر بودن یا \(dqoff\(dq برای کشف‌ناپذیر بودن (لازم) .TP .B مثال کشف‌پذیر کردن کنترل‌کننده برای سایر دستگاه‌ها (Example Make controller discoverable to other devices) .nf \fB> discoverable on\fP .fi .sp .TP .B مثال کشف‌ناپذیر کردن کنترل‌کننده (Example Make controller non\-discoverable) .nf \fB> discoverable off\fP .fi .sp .UNINDENT .SS discoverable\-timeout .sp تنظیم مهلت زمان کشف‌پذیری. .sp مدت زمان به ثانیه که \(dqdiscoverable on\(dq معتبر است. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> discoverable\-timeout [value]\fP .TP .B استفاده‌ها (Uses) ویژگی \fBDiscoverableTimeout\fP در \fBorg.bluez.Adapter(5)\fP .TP .B [value] مدت زمان مهلت به ثانیه برای حالت کشف‌پذیری (۰ برای نامحدود، اختیاری) .TP .B مثال نمایش مقدار کنونی مهلت زمان کشف‌پذیری (Example Show current discoverable timeout value) .nf \fB> discoverable\-timeout\fP .fi .sp .TP .B مثال تنظیم مهلت زمان کشف‌پذیری روی ۳۰ ثانیه (Example Set discoverable timeout to 30 seconds) .nf \fB> discoverable\-timeout 30\fP .fi .sp .TP .B مثال تنظیم مهلت زمان کشف‌پذیری روی ۲ دقیقه (Example Set discoverable timeout to 2 minutes) .nf \fB> discoverable\-timeout 120\fP .fi .sp .TP .B مثال تنظیم مهلت زمان کشف‌پذیری روی ۵ دقیقه (Example Set discoverable timeout to 5 minutes) .nf \fB> discoverable\-timeout 300\fP .fi .sp .TP .B مثال تنظیم مهلت زمان نامحدود برای کشف‌پذیری (Example Set unlimited discoverable timeout) .nf \fB> discoverable\-timeout 0\fP .fi .sp .UNINDENT .SS agent .sp فعال/غیرفعال کردن کارگزار با قابلیت داده‌شده. .sp این دستور سازوکار احراز هویت محلی کنترل‌کننده را تعیین می‌کند. این کار برای جفت‌سازی لازم است و به شما امکان می‌دهد قابلیت‌های ورودی/خروجی (IO) کنترل‌کننده را انتخاب کنید. .sp قابلیت‌های معتبر کارگزار عبارت‌اند از: DisplayOnly، DisplayYesNo، KeyboardDisplay، KeyboardOnly، NoInputNoOutput. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> agent \fP .TP .B استفاده‌ها (Uses) روش \fBRegisterAgent\fP در \fBorg.bluez.AgentManager(5)\fP .TP .B حالت کارگزار \- \(dqon\(dq، \(dqoff\(dq، \(dqauto\(dq، یا نوع قابلیت (DisplayOnly، DisplayYesNo، KeyboardDisplay، KeyboardOnly، NoInputNoOutput) (الزامی) .TP .B مثال فعال‌سازی کارگزار با قابلیت پیش‌فرض (Example Enable agent with default capability) .nf \fB> agent on\fP .fi .sp .TP .B مثال غیرفعال‌سازی کارگزار (Example Disable agent) .nf \fB> agent off\fP .fi .sp .TP .B مثال فعال‌سازی کارگزاری با قابلیت صرفاً نمایش کدهای جفت‌سازی (Example Enable agent that can only display pairing codes) .nf \fB> agent DisplayOnly\fP .fi .sp .TP .B مثال فعال‌سازی کارگزاری با قابلیت نمایش کدها و پذیرش/رد (Example Enable agent that can display codes and accept/reject) .nf \fB> agent DisplayYesNo\fP .fi .sp .TP .B مثال فعال‌سازی کارگزاری با قابلیت نمایش و ورود کدهای جفت‌سازی (Example Enable agent that can display and input pairing codes) .nf \fB> agent KeyboardDisplay\fP .fi .sp .TP .B مثال فعال‌سازی کارگزاری که تنها قادر به ورود کدهای جفت‌سازی است (Example Enable agent that can only input pairing codes) .nf \fB> agent KeyboardOnly\fP .fi .sp .TP .B مثال فعال‌سازی کارگزار بدون ورودی/خروجی (JustWorks) (Example Enable agent with no input/output (JustWorks)) .nf \fB> agent NoInputNoOutput\fP .fi .sp .UNINDENT .SS default\-agent .sp تنظیم کارگزار کنونی به عنوان پیش‌فرض. .sp پس از گزینش کارگزار، این دستور آن را به عنوان کارگزار پیش‌فرض تعیین می‌کند. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> default\-agent\fP .TP .B استفاده‌ها (Uses) روش \fBRequestDefaultAgent\fP در \fBorg.bluez.AgentManager(5)\fP .TP .B مثال تنظیم کارگزار کنونی به عنوان پیش‌فرض (Example Set the current agent as default) .nf \fB> default\-agent\fP .fi .sp .UNINDENT .SS trust .sp معتمدسازی دستگاه. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> trust [dev]\fP .TP .B استفاده‌ها (Uses) ویژگی \fBTrusted\fP در \fBorg.bluez.Device(5)\fP .TP .B [dev] نشانی MAC دستگاه (XX:XX:XX:XX:XX:XX) یا مسیر شیء (اختیاری، در صورت عدم ذکر از دستگاه کنونی استفاده می‌شود) .TP .B مثال معتمدسازی دستگاه با استفاده از نشانی MAC (Example Trust device using MAC address) .nf \fB> trust 00:11:22:33:44:55\fP .fi .sp .TP .B مثال معتمدسازی دستگاهی دیگر (Example Trust another device) .nf \fB> trust AA:BB:CC:DD:EE:FF\fP .fi .sp .TP .B مثال معتمدسازی دستگاه با استفاده از مسیر شیء (Example Trust device using object path) .nf \fB> trust /org/bluez/hci0/dev_00_11_22_33_44_55\fP .fi .sp .UNINDENT .SS untrust .sp لغو اعتماد به دستگاه. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> untrust [dev]\fP .TP .B استفاده‌ها (Uses) ویژگی \fBTrusted\fP در \fBorg.bluez.Device(5)\fP .TP .B [dev] نشانی MAC دستگاه (XX:XX:XX:XX:XX:XX) یا مسیر شیء (اختیاری؛ در صورت حذف از دستگاه فعلی استفاده می‌شود) .TP .B مثال لغو اعتماد از دستگاه با استفاده از نشانی MAC (Example Remove trust from device using MAC address) .nf \fB> untrust 00:11:22:33:44:55\fP .fi .sp .TP .B مثال لغو اعتماد از دستگاهی دیگر (Example Remove trust from another device) .nf \fB> untrust AA:BB:CC:DD:EE:FF\fP .fi .sp .TP .B مثال لغو اعتماد با استفاده از مسیر شیء (Example Remove trust using object path) .nf \fB> untrust /org/bluez/hci0/dev_00_11_22_33_44_55\fP .fi .sp .UNINDENT .SS block .sp مسدود کردن دستگاه. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> block [dev]\fP .TP .B استفاده‌ها (Uses) ویژگی \fBBlocked\fP در \fBorg.bluez.Device(5)\fP .TP .B [dev] نشانی MAC دستگاه (XX:XX:XX:XX:XX:XX) یا مسیر شیء (اختیاری؛ در صورت حذف از دستگاه فعلی استفاده می‌شود) .TP .B مثال مسدود کردن دستگاه با استفاده از نشانی MAC (Example Block device using MAC address) .nf \fB> block 00:11:22:33:44:55\fP .fi .sp .TP .B مثال مسدود کردن دستگاهی دیگر (Example Block another device) .nf \fB> block AA:BB:CC:DD:EE:FF\fP .fi .sp .TP .B مثال مسدود کردن دستگاه با استفاده از مسیر شیء (Example Block device using object path) .nf \fB> block /org/bluez/hci0/dev_00_11_22_33_44_55\fP .fi .sp .UNINDENT .SS unblock .sp رفع انسداد دستگاه. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> unblock [dev]\fP .TP .B استفاده‌ها (Uses) ویژگی \fBBlocked\fP در \fBorg.bluez.Device(5)\fP .TP .B [dev] نشانی MAC دستگاه (XX:XX:XX:XX:XX:XX) یا مسیر شیء (اختیاری؛ در صورت حذف از دستگاه فعلی استفاده می‌شود) .TP .B مثال رفع انسداد دستگاه با استفاده از نشانی MAC (Example Unblock device using MAC address) .nf \fB> unblock 00:11:22:33:44:55\fP .fi .sp .TP .B مثال رفع انسداد دستگاهی دیگر (Example Unblock another device) .nf \fB> unblock AA:BB:CC:DD:EE:FF\fP .fi .sp .TP .B مثال رفع انسداد دستگاه با استفاده از مسیر شیء (Example Unblock device using object path) .nf \fB> unblock /org/bluez/hci0/dev_00_11_22_33_44_55\fP .fi .sp .UNINDENT .SS remove .sp حذف دستگاه. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> remove \fP .TP .B استفاده‌ها (Uses) روش \fBRemoveDevice\fP در \fBorg.bluez.Adapter(5)\fP .TP .B نشانی MAC دستگاه (XX:XX:XX:XX:XX:XX) یا مسیر شیء (الزامی) .TP .B مثال حذف دستگاه با استفاده از نشانی MAC (Example Remove device using MAC address) .nf \fB> remove 00:11:22:33:44:55\fP .fi .sp .TP .B مثال حذف دستگاهی دیگر (Example Remove another device) .nf \fB> remove AA:BB:CC:DD:EE:FF\fP .fi .sp .TP .B مثال حذف دستگاه با استفاده از مسیر شیء (Example Remove device using object path) .nf \fB> remove /org/bluez/hci0/dev_00_11_22_33_44_55\fP .fi .sp .UNINDENT .SS connect .sp اتصال به دستگاه. .sp این فرمان برقراری ارتباط با یک دستگاه را آغاز می‌کند. .sp به‌طور پیش‌فرض این فرمان تلاش می‌کند به تمامی نمایه‌هایی که دستگاه دوردست پشتیبانی می‌کند و به عنوان قابل اتصال خودکار علامت‌گذاری شده‌اند متصل شود. در صورتی که UUID خدمت دوردست داده شده باشد، تنها همان خدمت متصل خواهد شد. مقدار UUID می‌تواند به شکل کوتاه (UUID شانزده بیتی) یا به شکل بلند (UUID صد و بیست و هشت بیتی) باشد. همچنین مقادیر ویژه‌ای برای نمایه‌های شناخته‌شده مانند \(dqa2dp\-sink\(dq، \(dqa2dp\-source\(dq، \(dqhfp\-hf\(dq، \(dqhfp\-ag\(dq، \(dqftp\(dq یا \(dqspp\(dq وجود دارد. .sp برای اتصال به دستگاه‌های LE (کم‌مصرف)، کنترل‌کننده باید یک گزارش پویش فعال از دستگاهی که قصد اتصال به آن دارد را در اختیار داشته باشد. .sp اگر هیچ گزارش تبلیغی (advertising report) پیش از سرآمدن مهلت دریافت نشود، خطای le\-connection\-abort\-by\-local صادر خواهد شد. در آن صورت، با فرض اینکه دستگاه در حال تبلیغ است، اتصال مجدد را امتحان کنید. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> connect [uuid]\fP .TP .B استفاده‌ها (Uses) روش‌های \fBConnect\fP و \fBConnectProfile\fP در \fBorg.bluez.Device(5)\fP .TP .B نشانی MAC دستگاه (XX:XX:XX:XX:XX:XX) یا مسیر شیء (الزامی) .TP .B [uuid] شناسه یکتای (UUID) خدمت مشخص برای اتصال (UUID شانزده بیتی، ۱۲۸ بیتی یا نام نمایه مانند \(dqa2dp\-sink\(dq، \(dqhfp\-hf\(dq و غیره) (اختیاری) .TP .B مثال اتصال به دستگاه (تمام نمایه‌های پشتیبانی‌شده) (Example Connect to device (all supported profiles)) .nf \fB> connect 1C:48:F9:9D:81:5C\fP .fi .sp .TP .B مثال اتصال به نمایه هدست HSP (Example Connect to HSP Headset profile) .nf \fB> connect 1C:48:F9:9D:81:5C hsp\-hs\fP .fi .sp .TP .B مثال اتصال به نمایه مقصد صوتی A2DP (Example Connect to A2DP Sink profile) .nf \fB> connect 1C:48:F9:9D:81:5C a2dp\-sink\fP .fi .sp .TP .B مثال اتصال به نمایه منبع صوتی A2DP (Example Connect to A2DP Source profile) .nf \fB> connect 1C:48:F9:9D:81:5C a2dp\-source\fP .fi .sp .TP .B مثال اتصال به نمایه هندزفری HFP (Example Connect to HFP Hands\-Free profile) .nf \fB> connect 1C:48:F9:9D:81:5C hfp\-hf\fP .fi .sp .TP .B مثال اتصال به نمایه درگاه صوتی HFP (Example Connect to HFP Audio Gateway profile) .nf \fB> connect 1C:48:F9:9D:81:5C hfp\-ag\fP .fi .sp .TP .B مثال اتصال به نمایه انتقال پرونده (Example Connect to File Transfer Profile) .nf \fB> connect 1C:48:F9:9D:81:5C ftp\fP .fi .sp .TP .B مثال اتصال به نمایه درگاه سریال (Example Connect to Serial Port Profile) .nf \fB> connect 1C:48:F9:9D:81:5C spp\fP .fi .sp .TP .B مثال اتصال با استفاده از UUID کامل ۱۲۸ بیتی (HSP) (Example Connect using full 128\-bit UUID (HSP)) .nf \fB> connect 1C:48:F9:9D:81:5C 00001108\-0000\-1000\-8000\-00805f9b34fb\fP .fi .sp .TP .B مثال اتصال با استفاده از UUID کوتاه ۱۶ بیتی (HSP) (Example Connect using short 16\-bit UUID (HSP)) .nf \fB> connect 1C:48:F9:9D:81:5C 0x1108\fP .fi .sp .TP .B مثال اتصال به نمایه A2DP با استفاده از UUID کوتاه (Example Connect to A2DP profile using short UUID) .nf \fB> connect 1C:48:F9:9D:81:5C 0x110E\fP .fi .sp .UNINDENT .SS disconnect .sp قطع اتصال دستگاه. .sp به‌طور پیش‌فرض، این دستور همه نمایه‌ها را قطع کرده و سپس اتصال را خاتمه می‌دهد. در صورتی که UUID خدمت دوردست داده شده باشد، تنها همان خدمت قطع خواهد شد. .sp برای LE، هنگام قطع اتصال از یک ارتباط فعال، نیازی به نشانی دستگاه نیست. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> disconnect [dev] [uuid]\fP .TP .B استفاده‌ها (Uses) متدهای \fBDisconnect\fP و \fBDisconnectProfile\fP در \fBorg.bluez.Device(5)\fP .TP .B [dev] نشانی MAC دستگاه (XX:XX:XX:XX:XX:XX) یا مسیر شیء (اختیاری؛ در صورت حذف از دستگاه فعلی استفاده می‌شود) .TP .B [uuid] شناسه یکتای (UUID) خدمت مشخص برای قطع اتصال (UUID شانزده بیتی، ۱۲۸ بیتی یا نام نمایه) (اختیاری) .TP .B مثال قطع تمام نمایه‌ها و خاتمه اتصال (Example Disconnect all profiles and terminate connection) .nf \fB> disconnect 1C:48:F9:9D:81:5C\fP .fi .sp .TP .B مثال قطع تنها نمایه A2DP Sink (Example Disconnect only A2DP Sink profile) .nf \fB> disconnect 1C:48:F9:9D:81:5C a2dp\-sink\fP .fi .sp .TP .B مثال قطع تنها نمایه دست‌آزاد HFP (Example Disconnect only HFP Hands\-Free profile) .nf \fB> disconnect 1C:48:F9:9D:81:5C hfp\-hf\fP .fi .sp .TP .B مثال قطع تنها نمایه درگاه سریال (Example Disconnect only Serial Port Profile) .nf \fB> disconnect 1C:48:F9:9D:81:5C spp\fP .fi .sp .TP .B مثال قطع نمایه A2DP با استفاده از UUID کوتاه (Example Disconnect A2DP profile using short UUID) .nf \fB> disconnect 1C:48:F9:9D:81:5C 0x110E\fP .fi .sp .TP .B مثال قطع نمایه HSP با استفاده از UUID کامل (Example Disconnect HSP profile using full UUID) .nf \fB> disconnect 1C:48:F9:9D:81:5C 00001108\-0000\-1000\-8000\-00805f9b34fb\fP .fi .sp .UNINDENT .SS info .sp اطلاعات دستگاه. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> info [dev/set]\fP .TP .B استفاده‌ها (Uses) ویژگی‌های \fBorg.bluez.Device(5)\fP .TP .B [dev/set] نشانی MAC دستگاه (XX:XX:XX:XX:XX:XX)، مسیر شیء یا DeviceSet (اختیاری؛ در صورت حذف از دستگاه فعلی استفاده می‌شود) .TP .B مثال نمایش اطلاعات تفصیلی دستگاه (Example Show detailed information for device) .nf \fB> info 1C:48:F9:9D:81:5C\fP .fi .sp .TP .B مثال نمایش اطلاعات دستگاهی دیگر (Example Show information for another device) .nf \fB> info 00:11:22:33:44:55\fP .fi .sp .TP .B مثال نمایش اطلاعات دستگاه با استفاده از مسیر شیء (Example Show device info using object path) .nf \fB> info /org/bluez/hci0/dev_1C_48_F9_9D_81_5C\fP .fi .sp .UNINDENT .SS bearer .sp دریافت/تنظیم حامل ترجیحی. .INDENT 0.0 .TP .B کاربرد (Usage) \fB> bearer [last\-seen/bredr/le]\fP .TP .B استفاده‌ها (Uses) ویژگی \fBPreferredBearer\fP در \fBorg.bluez.Device(5)\fP .TP .B نشانی MAC دستگاه (XX:XX:XX:XX:XX:XX) یا مسیر شیء (الزامی) .TP .B [last\-seen/bredr/le] نوع حامل ترجیحی \- \(dqlast\-seen\(dq، \(dqbredr\(dq برای سنتی (Classic) یا \(dqle\(dq برای کم‌مصرف (Low Energy) (اختیاری) .TP .B مثال دریافت حامل ترجیحی (Example get preferred bearer) .nf > bearer .in +2 PreferredBearer: last\-seen .in -2 .fi .sp .TP .B مثال تنظیم حامل ترجیحی روی LE (Example set preferred bearer to LE) .nf > bearer le [CHG] Device PreferredBearer: le Changing le succeeded .fi .sp .TP .B مثال تنظیم حامل ترجیحی روی BREDR (Example set preferred bearer to BREDR) .nf > bearer bredr [CHG] Device PreferredBearer: bredr Changing bredr succeeded .fi .sp .UNINDENT .SH "زیرمنوی اعلان (Advertise Submenu)" .sp به \fBbluetoothctl\-advertise(1)\fP\& مراجعه کنید. .SH "زیرمنوی پایش (Monitor Submenu)" .sp به \fBbluetoothctl\-monitor(1)\fP مراجعه کنید. .SH "زیرمنوی پویش (Scan Submenu)" .sp به \fBbluetoothctl\-scan(1)\fP مراجعه کنید. .SH "زیرمنوی گات (Gatt Submenu)" .sp به \fBbluetoothctl\-gatt(1)\fP مراجعه کنید. .SH "زیرمنوی سرپرستی (Admin Submenu)" .sp به \fBbluetoothctl\-admin(1)\fP مراجعه کنید. .SH "زیرمنوی پخش‌کننده (Player Submenu)" .sp به \fBbluetoothctl\-player(1)\fP مراجعه کنید. .SH "زیرمنوی نقطه پایانی (Endpoint Submenu)" .sp به \fBbluetoothctl\-endpoint(1)\fP مراجعه کنید. .SH "زیرمنوی ترابری (Transport Submenu)" .sp به \fBbluetoothctl\-transport(1)\fP مراجعه کنید. .SH "زیرمنوی مدیریت (Management Submenu)" .sp به \fBbluetoothctl\-mgmt(1)\fP مراجعه کنید. .SH "زیرمنوی دستیار (Assistant Submenu)" .sp به \fBbluetoothctl\-assistant(1)\fP مراجعه کنید. .SH "زیرمنوی کم‌مصرف (LE Submenu)" .sp به \fBbluetoothctl\-le(1)\fP مراجعه کنید. .SH "زیرمنوی نرخ پایه و ارتقایافته (BREDR Submenu)" .sp به \fBbluetoothctl\-bredr(1)\fP مراجعه کنید. .SH "خودکارسازی (AUTOMATION)" .sp دو روش متداول برای خودکارسازی این ابزار، استفاده از اسناد درجا (Here Docs) یا برنامه expect است. استفاده از اسناد درجا برای نمایش اطلاعات کنترل‌کننده بلوتوث: .INDENT 0.0 .INDENT 3.5 .sp .EX bluetoothctl < .SH "گزارش باگ‌ها (REPORTING BUGS)" .sp \% .SH "حق نشر (Copyright)" استفاده آزاد از این نرم‌افزار تحت شرایط مجوز عمومی همگانی کمتر گنو (LGPL) مجاز است. .\" End of generated man page.