| ナビゲーションリンクをスキップ | |
| 印刷ビューの終了 | |
|
マニュアルページセクション 1M: システム管理コマンド Oracle Solaris 11 Information Library (日本語) |
| ナビゲーションリンクをスキップ | |
| 印刷ビューの終了 | |
|
|
マニュアルページセクション 1M: システム管理コマンド Oracle Solaris 11 Information Library (日本語) |
- ワイヤレス USB ホストおよびデバイスの管理
wusbadm list [-h | -d] [-o field[,...]]
wusbadm associate [-h host-id] [[-c [-f]] | -n] [-o]
wusbadm remove-dev [[-d dev-id] | [-h host-id]] [-f]
wusbadm remove-host [-h host-id] [-f]
wusbadm enable-host [-h host-id]
wusbadm disable-host [-h host-id]
wusbadm コマンドは、ホストとデバイスの情報の一覧表示、ホストとデバイスの関連付け、ホストまたはデバイスの情報のシステムからの削除、ホストの有効化または無効化など、ワイヤレス USB ホストおよびデバイスの管理作業を行うためのコマンド行インタフェースを提供します。
ワイヤレス USB デバイスをホストにはじめて接続する前に、wusbadm の associate サブコマンドを実行してそれらの間の関連付け情報を設定する必要があります。その後、デバイスの無線を単純にオン/オフすることでデバイスの接続/切断を行えます。メーカーによって、デバイスにボタンが付いている場合があります。デバイスの無線のオン/オフは、有線 USB デバイスのホットプラグに似ています。
associate サブコマンドによって作成された関連付け情報は、デバイスとホストの非揮発性メモリー内に保持されます。remove-dev または remove-host サブコマンドを使用すると、ホストからこの情報を削除できます。デバイス上の情報は、別の関連付けで上書きできます。複数のホストに関連付けられたデバイスで複数の関連付けレコードの優先順位を決定したりそれらのレコードを更新したりする方法は、メーカーごとに異なります。
各 wusbadm サブコマンドは、次のいずれかのオブジェクトに対して動作します。
システム上のワイヤレス USB ホストを一意に識別する 2 桁の数字 (01 から 99 の範囲)。この数字は、wusb サービス (「注意事項」節を参照) が正常に有効化され、このサービスがホストインスタンスをはじめて検出したときに生成されます。この数字は、remove-host サブコマンドで削除されるまで維持されます。
ワイヤレス USB ホストに関連付けられたワイヤレス USB デバイスを一意に識別する 5 桁の数字。先頭の 2 桁は、デバイスが関連付けられたワイヤレス USB ホストのホスト ID です。末尾の 3 桁の数字 (001 から 999 の範囲) は、同じホストに関連付けられたデバイスを区別するために使用されます。この 5 桁の数字の先頭 2 桁と末尾 3 桁はドットで区切られます。
dev-id は、デバイス関連付け処理中に生成されます。この値は、remove-dev サブコマンドによって削除されるか、同じホストとデバイスの間の別の関連付けによって更新されるまで、デバイスに対して維持されます。
次のサブコマンドがサポートされています。list 以外のすべてのサブコマンドは、実行時にオプションやオペランドが指定されなかった場合に、サブコマンド固有の使用法に関する情報を表示します。
システム上のワイヤレス USB のホストとデバイスを一覧表示し、すべてのホストとデバイスについて ID、状態、およびタイプを表示します。list はデフォルトで、すべてのホストとデバイス、およびすべてのフィールドを一覧表示します。各ホストとそのデバイスが 1 つのグループとして表示されます。このサブコマンドは、次のオプションをサポートします。
表示する出力フィールドのコンマ区切りのリスト (大文字と小文字は区別されません)。フィールド名は、次に示すフィールドのいずれか、またはすべてのフィールドを表示するための特殊な値 all にする必要があります。デフォルトでは (-o の指定なし)、list はすべてのフィールドを表示します。
host-id または dev-id。
host タイプまたは device タイプ。
host のタイプとしては、whci (オンボードのホスト) と hwa (ホットプラグ対応ホスト) があります。
device のタイプとしては、kbd、mouse、storage、printer、dwa (ワイヤレス USB ハブ)、audio、video などがあります。
ホストには次の状態が存在します。
ホストは、関連付けの実行、デバイスの接続、データ通信の実行などの処理を行う準備が整っているか、またはすでに処理中です。
ホストはデバイスを処理する準備が整っておらず、ホストに接続されているデバイスは存在しません。disable-host サブコマンドによってホストが停止された可能性があります。または、ホストが物理的に取り外されたかドライバが切り離されたためにホストが使用不可能になった可能性があります。
ホストがシステムに接続されていません。hwa デバイスは、システム上の USB ポートから取り外されると、この状態になります。
デバイスには次の状態が存在します。
デバイスは、ホストに接続されていて開かれる準備ができているか、またはすでに開かれていて動作中です。デフォルトでは、デバイスの関連付けが完了してその無線がオンになると、デバイスはこの状態に遷移しようとします。
デバイスは、まだホストに接続されていないか、または開かれていません。デバイスがこの状態になった理由としては、無線が範囲外になった、電源が切れている、ハードウェアの問題が発生した、などが考えられます。
ワイヤレス USB ホストのみを一覧表示します。
ワイヤレス USB デバイスのみを一覧表示します。
関連付け処理を開始するホストを指定します。関連付けは、ワイヤレス USB デバイスとワイヤレス USB ホストとの接続が可能になるための最初の手順です。
関連付けには次の 2 つのモデルが存在します。
まずデバイスとホストを USB ケーブルで接続し、その後、このサブコマンドを実行することで、ホストはデバイスとの関連付け情報を設定します。関連付けが有効になると、同じホストとデバイスとの間の以降の接続でケーブルが不要になります。
デバイスの無線をオンにしたあと、このサブコマンドを実行してホストにデバイスの通信先を指定します。その後、ホストとデバイスの両方で短い数字が表示されます。数字の値を比較し、ホストとデバイスの両方で確認します。
関連付けが成功したら、関連付けられた USB ホストと USB デバイスのワイヤレス接続処理に進むことができます。デフォルトでは、関連付け情報は、削除または上書きされるまでホストとデバイスの両方で保持されます。
関連付けの対象となるデバイスが複数存在する場合、このサブコマンドはそのすべてを一覧表示し、ユーザーがそれらの中から選択できるようにします。このサブコマンドには、次のオプションがあります。
関連付けの対象となるホストを指定します。このオプションが指定されなかった場合、このサブコマンドは、選択可能な有効化されたホストをすべて一覧表示します。
ケーブルによる関連付け処理を開始します。ワイヤレス USB デバイスをホストに接続したあと、このオプションを指定して associate サブコマンドを実行します。
数字による関連付け処理を開始します。このサブコマンドは、ホスト上とデバイス上に表示された数字を比較するようユーザーに求めます。
前述の 2 つの関連付けモデルオプション (-n または -c) のどちらも指定されなかった場合、このサブコマンドは、いずれかの関連付けモデルオプションを指定するようユーザーに求めます。
ケーブルによる関連付け処理を開始します。ワイヤレス USB デバイスをホストに接続したあと、このオプションを指定して associate サブコマンドを実行します。
この関連付けが 1 回かぎりの接続用であることを示します。つまり、関連付けの実行後、このデバイスが接続されたあと切断されると、その関連付け情報がホストシステムから削除されます。次回接続時には関連付けを再度実行する必要があります。
ワイヤレス USB デバイスの関連付け情報をシステムから削除します。削除後は、そのホストとデバイスに対して associate サブコマンドが再度実行されるまで、そのデバイスとホストは接続できません。このサブコマンドには、次のオプションがあります。
dev-id で指定されたワイヤレス USB デバイスの関連付け情報を削除します。
host-id で指定されたホストに関連付けられたすべてのワイヤレス USB デバイスの関連付け情報を削除します。
確認プロンプトを表示せずに削除を実行します。デバイスがホストに接続されていた場合、このサブコマンドはその接続を強制的に切断します。
host-id やこのホストに関連付けられたすべてのデバイスの関連付け情報などのホスト情報を、システムから削除します。このサブコマンドは通常、hwa ドングルのような、一時的に使用されるホットプラグ対応ワイヤレス USB ホストを削除するために使用されます。このホストを再度使用可能な状態にするには、hwa ドングルの物理的なホットプラグを行うなどして、このホストが再度列挙されるようにします。その後、ホスト ID が更新されます。ただし、デバイスの関連付け情報は回復しません。オンボードのホストを削除することはお勧めしません。このサブコマンドには、次のオプションがあります。
削除する host-id を指定します。
確認プロンプトを表示せずに削除を実行します。このホストに接続されているデバイスが 1 つ以上存在する場合には、それらの接続を強制的に切断します。
ホストを有効状態に遷移させます。ホストはデフォルトで有効状態になります。このサブコマンドには、次のオプションがあります。
有効化する host-id を指定します。
ホストを無効状態に遷移させます。host-id とこのホストのすべての関連付け情報が維持されます。enable-host サブコマンドを発行すると、このホストは有効状態に戻ります。このサブコマンドには、次のオプションがあります。
無効化する host-id を指定します。
確認プロンプトを表示せずに無効化処理を実行します。このホストに接続されているデバイスが 1 つ以上存在する場合、このオプションはそれらの接続を強制的に切断します。
例 1 すべてのホストとデバイスの一覧表示
次のコマンドは、ワイヤレス USB のすべてのホストとデバイスを一覧表示します。
# wusbadm list 01 enabled hwa 01.001 connected mouse 01.002 connected kbd 02 enabled whci 02.001 connected printer 02.002 disconnected storage 03 disabled hwa 03.001 disconnected storage 03.002 disconnected dwa
例 2 ケーブルによるデバイスへの関連付け
次のコマンドは、ケーブルによる関連付けのアプローチを使用して、特定のホスト (ホスト ID 01) にデバイスを関連付けます。
# wusbadm associate -h 01 -c Associate a device with host (01) via cable. Continue (yes/no)?
例 3 デバイスの関連付けの削除
次のコマンドは、デバイスの関連付け情報をホストシステムから削除します。
# wusbadm remove-dev -d 01.002 Remove the information of device (01.002) from system. This device can not be connected with the host until it is associated again. Continue (yes/no)?
例 4 すべてのデバイスの関連付けの削除
次のコマンドは、特定のホストに関連付けられたすべてのデバイスの関連付け情報を削除します。
# wusbadm remove-dev -h 02 Remove the information of all the devices associated with host (02) from the system. All the devices associated with the host cannot be connected with it until they are associated again. Continue (yes/no)?
次の終了値が返されます。
正常終了。
エラー。処理が失敗しました。たとえば、デバイスとホストの関連付けが失敗しました。
使用方法のエラー。
属性についての詳細は、attributes(5) を参照してください。
/usr/sbin
|
attributes(5), hwahc(7D), usba(7D)
wusb (ワイヤレス USB の管理) サービスは、サービス管理機能 smf(5) によって、次のサービス識別子として管理されます。
svc:/system/wusb:default
有効化、無効化、または再起動要求など、このサービスに関する管理操作は、svcadm(1M) を使用して実行できます。サービスのステータスを照会するには、svcs(1) コマンドを使用します。
wusb サービスは、非公開インタフェースの wusbd デーモンによって実装されています。このデーモンは wusb サービスと同様に、SMF によって起動されます。このデーモンを指定するには、次のサービスインスタンスを使用します。
svc:/system/wusbd:default
wusbd デーモンを直接呼び出さないようにしてください。
|