JavaScript is required to for searching.
ナビゲーションリンクをスキップ
印刷ビューの終了
マニュアルページセクション 1M: システム管理コマンド     Oracle Solaris 11 Information Library (日本語)
search filter icon
search icon

ドキュメントの情報

はじめに

紹介

システム管理コマンド - パート 1

6to4relay(1M)

acct(1M)

acctadm(1M)

acctcms(1M)

acctcon1(1M)

acctcon(1M)

acctcon2(1M)

acctdisk(1M)

acctdusg(1M)

acctmerg(1M)

accton(1M)

acctprc1(1M)

acctprc(1M)

acctprc2(1M)

acctsh(1M)

acctwtmp(1M)

acpihpd(1M)

adbgen(1M)

add_allocatable(1M)

addbadsec(1M)

add_drv(1M)

arp(1M)

asradm(1M)

asr-notify(1M)

atohexlabel(1M)

audit(1M)

auditconfig(1M)

auditd(1M)

auditrecord(1M)

auditreduce(1M)

auditstat(1M)

audit_warn(1M)

automount(1M)

automountd(1M)

autopush(1M)

bart(1M)

beadm(1M)

boot(1M)

bootadm(1M)

bootconfchk(1M)

bootparamd(1M)

busstat(1M)

captoinfo(1M)

catman(1M)

cfgadm(1M)

cfgadm_ac(1M)

cfgadm_cardbus(1M)

cfgadm_fp(1M)

cfgadm_ib(1M)

cfgadm_pci(1M)

cfgadm_sata(1M)

cfgadm_sbd(1M)

cfgadm_scsi(1M)

cfgadm_sdcard(1M)

cfgadm_shp(1M)

cfgadm_sysctrl(1M)

cfgadm_usb(1M)

chargefee(1M)

chat(1M)

check-hostname(1M)

check-permissions(1M)

chk_encodings(1M)

chroot(1M)

cimworkshop(1M)

ckpacct(1M)

clear_locks(1M)

clinfo(1M)

closewtmp(1M)

clri(1M)

comsat(1M)

consadm(1m)

console-reset(1M)

conv_lp(1M)

conv_lpd(1M)

coreadm(1M)

cpustat(1M)

croinfo(1M)

cron(1M)

cryptoadm(1M)

cvcd(1M)

datadm(1M)

dcopy(1M)

dcs(1M)

dd(1M)

ddu(1M)

ddu-text(1M)

devchassisd(1M)

devfsadm(1M)

devfsadmd(1M)

device_allocate(1M)

device_remap(1M)

devinfo(1M)

devlinks(1M)

devnm(1M)

devprop(1M)

df(1M)

dfmounts(1M)

dfmounts_nfs(1M)

dfshares(1M)

dfshares_nfs(1M)

df_ufs(1M)

dhcpagent(1M)

dhcpconfig(1M)

dhcpmgr(1M)

dhtadm(1M)

dig(1M)

directoryserver(1M)

diskinfo(1M)

disks(1M)

diskscan(1M)

dispadmin(1M)

dladm(1M)

dlmgmtd(1M)

dlstat(1M)

dmesg(1M)

dminfo(1M)

dns-sd(1M)

dnssec-dsfromkey(1M)

dnssec-keyfromlabel(1M)

dnssec-keygen(1M)

dnssec-makekeyset(1M)

dnssec-signkey(1M)

dnssec-signzone(1M)

dodisk(1M)

domainname(1M)

drd(1M)

drvconfig(1M)

dsbitmap(1M)

dscfg(1M)

dscfgadm(1M)

dscfglockd(1M)

dsstat(1M)

dsvclockd(1M)

dtrace(1M)

dumpadm(1M)

editmap(1M)

edquota(1M)

eeprom(1M)

efdaemon(1M)

embedded_su(1M)

etrn(1M)

fbconfig(1M)

fbconf_xorg(1M)

fcadm(1M)

fcinfo(1M)

fdetach(1M)

fdisk(1M)

ff(1M)

ff_ufs(1M)

fingerd(1M)

fiocompress(1M)

flowadm(1M)

flowstat(1M)

fmadm(1M)

fmd(1M)

fmdump(1M)

fmstat(1M)

fmthard(1M)

format(1M)

fpsd(1M)

fruadm(1M)

fsck(1M)

fsck_pcfs(1M)

fsck_udfs(1M)

fsck_ufs(1M)

fsdb(1M)

fsdb_udfs(1M)

fsdb_ufs(1M)

fsirand(1M)

fssnap(1M)

fssnap_ufs(1M)

fsstat(1M)

fstyp(1M)

fuser(1M)

fwflash(1M)

fwtmp(1M)

getdevpolicy(1M)

getent(1M)

gettable(1M)

getty(1M)

gkadmin(1M)

groupadd(1M)

groupdel(1M)

groupmod(1M)

growfs(1M)

grpck(1M)

gsscred(1M)

gssd(1M)

hald(1M)

hal-device(1M)

hal-fdi-validate(1M)

hal-find(1M)

hal-find-by-capability(1M)

hal-find-by-property(1M)

hal-get-property(1M)

hal-set-property(1M)

halt(1M)

hextoalabel(1M)

host(1M)

hostconfig(1M)

hotplug(1M)

hotplugd(1M)

htable(1M)

ickey(1M)

id(1M)

idmap(1M)

idmapd(1M)

idsconfig(1M)

ifconfig(1M)

if_mpadm(1M)

ifparse(1M)

iiadm(1M)

iicpbmp(1M)

iicpshd(1M)

ikeadm(1M)

ikecert(1M)

ilbadm(1M)

ilbd(1M)

ilomconfig(1M)

imqadmin(1M)

imqbrokerd(1M)

imqcmd(1M)

imqdbmgr(1M)

imqkeytool(1M)

imqobjmgr(1M)

imqusermgr(1M)

in.chargend(1M)

in.comsat(1M)

in.daytimed(1M)

in.dhcpd(1M)

in.discardd(1M)

in.echod(1M)

inetadm(1M)

inetconv(1M)

inetd(1M)

in.fingerd(1M)

infocmp(1M)

in.iked(1M)

init(1M)

init.sma(1M)

init.wbem(1M)

inityp2l(1M)

in.lpd(1M)

in.mpathd(1M)

in.named(1M)

in.ndpd(1M)

in.rarpd(1M)

in.rdisc(1M)

in.rexecd(1M)

in.ripngd(1M)

in.rlogind(1M)

in.routed(1M)

in.rshd(1M)

in.rwhod(1M)

install(1M)

installboot(1M)

installf(1M)

installgrub(1M)

in.stdiscover(1M)

in.stlisten(1M)

in.talkd(1M)

in.telnetd(1M)

in.tftpd(1M)

in.timed(1M)

intrd(1M)

intrstat(1M)

in.uucpd(1M)

iostat(1M)

ipaddrsel(1M)

ipadm(1M)

ipf(1M)

ipfs(1M)

ipfstat(1M)

ipmgmtd(1M)

ipmon(1M)

ipmpstat(1M)

ipnat(1M)

ippool(1M)

ipqosconf(1M)

ipsecalgs(1M)

ipsecconf(1M)

ipseckey(1M)

iscsiadm(1M)

isns(1M)

isnsadm(1M)

itadm(1M)

itu(1M)

k5srvutil(1M)

kadb(1M)

kadmin(1M)

kadmind(1M)

kadmin.local(1M)

kcfd(1M)

kclient(1M)

kdb5_ldap_util(1M)

kdb5_util(1M)

kdcmgr(1M)

kernel(1M)

keyserv(1M)

killall(1M)

kmscfg(1M)

kprop(1M)

kpropd(1M)

kproplog(1M)

krb5kdc(1M)

ksslcfg(1M)

kstat(1M)

ktkt_warnd(1M)

labeld(1M)

labelit(1M)

labelit_hsfs(1M)

labelit_udfs(1M)

labelit_ufs(1M)

lastlogin(1M)

latencytop(1M)

ldapaddent(1M)

ldap_cachemgr(1M)

ldapclient(1M)

ldmad(1M)

link(1M)

llc2_loop(1M)

lldpadm(1M)

lldpd(1M)

lms(1M)

localectr(1M)

locator(1M)

lockd(1M)

lockfs(1M)

lockstat(1M)

lofiadm(1M)

logadm(1M)

logins(1M)

lpget(1M)

lpset(1M)

luxadm(1M)

システム管理コマンド - パート 2

システム管理コマンド - パート 3

cfgadm_usb

- cfgadm の USB ハードウェア固有のコマンド

形式

/usr/sbin/cfgadm [-f] [-y | -n] [-v] -c function ap_id...
/usr/sbin/cfgadm -f [-y | -n] [-v] [-o hardware_options]
     -x hardware_function ap_id...
/usr/sbin/cfgadm -v [-a] [-s listing_option] 
     [-l [ap_id | ap_type...]]
/usr/sbin/cfgadm -v -h [ap_id]...

機能説明

ユニバーサルシリアルバス (USB) ハードウェア固有ライブラリ /usr/lib/cfgadm/usb.so.1 は、cfgadm(1M) コマンドを介して USB デバイスを管理するための機能を提供します。cfgadm は、接続点で実行されます。接続点の詳細は、cfgadm(1M) を参照してください。

USB の管理では、サポートされる接続点は、USB バスに接続されたハブのポートのみです。

接続点には、接続点 ID (ap_id) を通じて名前が付けられます。USB バスは階層構造であるため、ap_id も同様です。USB ハブには、1 から n までの番号が付けられたポートがあります。すべての USB の ap_id は、次の形式の文字列で構成されます。

usbN/A[.B[.C[...]]]

各情報の意味は次のとおりです。

N は、システム上の N 番目の USB ホストコントローラを示し、
A は、ルート (最上位) ハブのポート #A を示します。
B は、上位のハブのポート #A に接続されたハブのポート #B を示します。
C は、上位のハブのポート #B に接続されたハブのポート #C を示します。以降も同様に続きます。

たとえば、USB コントローラ 0 (唯一のコントローラ) のルートハブの 1 番目のポートは、次のような論理 ap_id を持ちます。

usb0/1

同様に、1 番目の USB コントローラのルートハブの 1 番目のポートに接続された 1 番目の外部ハブの 2 番目のポートは、次のような論理 ap_id を持ちます。

usb0/1.2

たとえば、ap_idusb0/1.4.3.4 である場合は、システム上の 1 番目の USB ホストコントローラのルートハブのポート 1 に接続されたハブのポート 4 に接続されたハブのポート 3 に接続されたハブのポート 4 を表しています。

example# cfgadm -l
Ap_Id                Type         Receptacle   Occupant     Condition
usb0/1               USB-hub      connected    configured   ok
usb0/2               unknown      empty        unconfigured ok
usb0/1.1             USB-storage  connected    configured   ok
usb0/1.2             unknown      empty        unconfigured ok
usb0/1.3             unknown      empty        unconfigured ok
usb0/1.4             USB-device   connected    configured   ok

USB2.0 チップには、EHCI ホスト USB2.0 ホストコントローラが 1 つと、いくつかのコンパニオン USB 1.x ホストコントローラ (OHCI または UHCI ホストコントローラ) が搭載されています。

USB2.0 デバイスは、接続されると、EHCI 論理ポートに接続されます。これらの論理ポートは、システム上の外部の物理ポート番号に対して 11 のマッピングになっていない場合があります。USB1.x デバイスを接続すると、EHCI ホストコントローラは、デバイスにコンパニオンホストコントローラの別の経路を指定し、デバイスはコンパニオンの論理ポート番号に接続されます。

論理ポート番号と物理ポート番号のマッピングは非常に複雑になる場合があります。例:

% cfgadm
Ap_Id                Type         Receptacle   Occupant     Condition
c0                   scsi-bus     connected    configured   unknown
usb0/1               usb-mouse    connected    configured   ok
usb0/2               usb-kbd      connected    configured   ok
usb0/3               unknown      empty        unconfigured ok
usb0/4               usb-hub      connected    configured   ok
usb0/4.1             unknown      empty        unconfigured ok
usb0/4.2             unknown      empty        unconfigured ok
usb0/4.3             unknown      empty        unconfigured ok
usb0/4.4             usb-storage  connected    configured   ok
usb1/1               unknown      empty        unconfigured ok
usb1/2               unknown      empty        unconfigured ok
usb1/3               unknown      empty        unconfigured ok
usb2/1               unknown      empty        unconfigured ok
usb2/2               usb-device   connected    configured   ok
usb3/1               unknown      empty        unconfigured ok
usb3/2               unknown      empty        unconfigured ok
usb3/3               unknown      empty        unconfigured ok
usb3/4               unknown      empty        unconfigured ok
usb3/5               unknown      empty        unconfigured ok

この例では、usb0 はオンボード USB 1.x ホストコントローラです。usb1usb2 は、コンパニオン OHCI USB1.x ホストコントローラであり、usb3EHCI USB2.0 ホストコントローラです。

次の表は、この USB2.0 チップのややわかりにくい経路指定を示しています。

logical port number        physical port number
-------------------        --------------------
    usb1/1            internal port 1    
    usb1/2            external port 1
    usb1/3            external port 3
    
    usb2/1            internal port 2
    usb2/2            external port 2
    
    usb3/1            internal port 1
    usb3/2            internal port 2
    usb3/3            external port 1
    usb3/4            external port 2
    usb3/5            external port 3

残念ながら、多くの場合、正確な経路指定は実験によってしかわかりません。

USB ポートにおける接続点の受容体の状態は、次の意味を持ちます。

connected

USB は、電源が投入され、有効になっています。USB デバイスがポートに接続されています。デバイスが USB バスに論理的に接続されています。

disconnected

USB は、電源が投入され、有効になっています。USB デバイスがポートに接続されています。(cfgadm -c disconnect コマンドを使用して) デバイスが USB バスから論理的に切断されています。

empty

USB ポートは電源が投入されていますが、デバイスが接続されていません。

USB ポートにおける USB ポートの接続点でのデバイスの占有装置の状態は、次の意味を持ちます。

configured

USB ポートの USB デバイスは構成されており、Solaris で使用できます。

unconfigured

USB ポートの USB デバイスは、cfgadm -c unconfigure を使用して明示的にオフラインにされているか、ドライバがない、またはデバイスに問題があるなど、Solaris で使用できるように正常に構成されていません。

接続点の条件は次のとおりです。

ok

通常の状態 - 使用できます。

failing

使用されていません。

failed

使用されていません。

unusable

アプリケーションによってデバイスが開かれているときに、ユーザーによりデバイスが物理的に取り外されました (未処理の I/O がある場合があります)。ユーザーは、同じ物理デバイスを再度挿入し、アプリケーションを適切に終了してから、デバイスをあらためて取り外す必要があります。この処理が完了するまで、ほかの挿入されたデバイスをポートで構成することはできません。

元のデバイスをポートに再度挿入できない場合は、『Oracle Solaris の管理: 一般的なタスク』に記載されている、この接続点の条件をクリアする手順を参照してください。

unknown

使用されていません。

USB デバイスは、いつでもホットプラグで接続または取り外しでき、システムによってイベントが検出され、適切に処理されます。

デバイスを USB から取り外す前に、受容体を disconnected 状態に移行する必要はありません。ただし、使用中のデバイス (ボリュームマネージャーまたはその他のアプリケーションによって現在開かれているリムーバブルディスクなど) をホットリムーブすることはお勧めしません。

オプション

cfgadm では、数種類の操作が定義されています。これらの操作には、構成状態の変更の開始 (-c)、ハードウェア固有の機能の実行 (-x)、および構成管理のヘルプ情報の表示 (-h) が含まれます。

いずれかの操作が失敗した場合、デバイスおよび接続点が想定した状態にならない場合があります。デバイスの現在のステータスを表示するには、cfgadm -l コマンドを使用します。

その他のすべてのオプションは、cfgadm(1M) での定義と同じ意味を持ちます。

次のオプションがサポートされています。

-c function

USB ハードウェア固有ライブラリでは、次の汎用コマンドが定義されています。次の構成状態の変更操作がサポートされています。

configure

ポートに接続されている USB デバイスがある場合、このコマンドにより、Solaris で使用できるようにそのデバイスの構成とすべての設定が試みられます。このコマンドでは、必要に応じて暗黙的に、connect (disconnect の逆) が実行されます。このポートのデバイスがすでに構成されている場合、このコマンドは何も実行せず、エラーメッセージを返します。このコマンドが正常に実行されると、デバイスを Solaris で使用できるようになります。

disconnect

ap_idunconfigure を実行し (まだ unconfigured になっていない場合)、受容体を disconnected 状態に移行します。これは、デバイスがまだポートに接続されていても実行されます。ドライバを見つけることができ、デバイスの列挙と構成に問題がないと仮定して、cfgadm -c configure を発行するか、デバイスを物理的にホットプラグ接続すると、デバイスでは、受容体の状態が connected に、占有装置の状態が configured に戻ります。

unconfigure

ポートに接続されているデバイスを Solaris で使用できないようにします (オフラインにします)。成功した場合、cfgadm により、この ap_id の占有装置の状態は unconfigured と報告されます。configureap_id に発行すると (成功した場合)、デバイスをポートに物理的にホットプラグ接続した場合と同様に、その占有装置の条件は configured (オンライン) に戻ります。

-f

サポートされていません。

-h ap_id

ヘルプオプションと任意の USB 接続点を組み合わせて使用して、USB 固有のヘルプを表示できます。

-l[v]

-l オプションは、cfgadm(1M) で説明されているように機能します。-v オプションと組み合わせて使用すると、Information フィールドに次の USB 固有の情報が表示されます。

  • Mfg: 製造元文字列 (iManufacturer)

  • Product: 製品文字列 (iProduct)

  • NConfigs: デバイスでサポートされる構成の合計数 (bNumConfigurations)

  • Config: 10 進数の現在の構成設定 (構成値ではなく、構成インデックス)

  • 現在の構成の構成文字列記述子 (iConfiguration)

これらのフィールドの説明については、USB の仕様を参照してください。

-ohardware_options

ハードウェアオプションは、ハードウェア固有のコマンド -x usb_config でのみサポートされます。使用できるオプションの説明については、下記のそのコマンドの説明を参照してください。

-slisting_options

select サブオプションを使用すると、クラス USB の接続点を一覧表示できます。cfgadm(1M) を参照してください。

-xhardware_function

次のハードウェア固有の機能が定義されています。

usb_config -o config=n

このコマンドでは、-o オプションを使用して必須の config 値を指定する必要があります。

ap_id の複数構成 USB デバイスの USB 構成を、構成インデックス n に設定します。これ以降、デバイスはこの構成に設定され、この設定は、デバイスのリブート、ホットリムーブ、および構成解除/構成の後も保持されます。

n の有効な値の範囲は、0 から (Nconfigs -1) までです。disconnect に続けて configure を実行すると、デバイスはリセットされます。configure により、デバイスは新しい構成設定に構成されます。

いずれかの手順が失敗した場合、構成ファイルとデバイスが以前の状態に復元され、エラーメッセージが発行されます。

usb_reset

デバイスのソフトウェアリセット (再列挙) を実行します。これは、デバイスを取り外して再度挿入するのと同等の意味を持ちます。ハブで個々のポートの電源再投入がサポートされている場合、ハブのポートで電源が一度切断され、再度投入されます。

接続されているデバイスがハブである場合、この機能には、そのハブと、そのハブをルートとするツリーの下位のデバイスをリセットするという効果があります。

いずれかの手順が失敗した場合、デバイスが以前の状態に復元され、エラーメッセージが発行されます。

状態の表: 接続点の状態とコマンド:

Valid states:
    empty/unconfigured         -> no device connected

    disconnected/unconfigured  -> logically disconnected,
                                  unavailable,
                                  devinfo node removed,
                                  device physically connected

    connected/unconfigured     -> logically connected,
                                  unavailable,
                                  devinfo node present

    connected/configured       -> connected, available

次の表は、操作またはコマンドの実行による状態の移行を示しています。

current state      operation           new state
-------------      ---------           ---------
empty/
unconfigured:
              device plugged in:     connected/configured or
                                     connected/unconfigured
                                     (if enumeration failed)
              device removed:        n/a
              cfgadm -c unconfigure: empty/unconfigured
              cfgadm -c configure:   empty/unconfigured
              cfgadm -c disconnect:  empty/unconfigured
                                     (no-op and error)

disconnected/
unconfigured:
              device plugged in:     n/a
              device removed:        empty/unconfigured
              cfgadm -c unconfigure: disconnected/unconfigured
              cfgadm -c configure:   connected/configured, or
                                     connected/unconfigured
                                     (if reenumeration failed)
             cfgadm -c disconnect:   disconnected/unconfigured

connected/unconfigured:
             device plugged in:      n/a
             device removed:         empty/unconfigured
             cfgadm -c unconfigure:  connected/unconfigured
             cfgadm -c configure:    connected/configured, or
                                     connected/unconfigured
                                     (if reenumeration failed)
             cfgadm -c disconnect:   disconnected/unconfigured

connected/configured:
             device plugged in:      n/a
             device removed:         empty/unconfigured or
                                     connected/configured,
                                     but with ap condition
                                     'unusable' if device
                                     was open when removed
             cfgadm -c unconfigure:  connected/unconfigured
             cfgadm -c configure:    connected/configured
             cfgadm -c disconnect:   disconnected/unconfigured

使用例

例 1 すべての USB デバイスのステータスの一覧表示

次のコマンドは、システム上のすべての USB デバイスのステータスを一覧表示します。

# cfgadm
Ap_Id           Type         Receptacle   Occupant     Condition
usb0/1          USB-hub      connected    configured   ok
usb0/2          unknown      empty        unconfigured ok
usb0/1.1        USB-storage  connected    configured   ok
usb0/1.2        unknown      empty        unconfigured ok
usb0/1.3        unknown      empty        unconfigured ok
usb0/1.4        USB-device connected    configured   ok

cfgadm では、現時点では個々のインタフェースを制御できないため、ap_id usb0/1.4USB-device デバイスが単一のユニットとして処理されています。

例 2 デバイスが接続されていないポートのステータスの一覧表示

次のコマンドは、デバイスが接続されていないポートのステータスを一覧表示します。

example# cfgadm -l usb0/1.3
Ap_Id           Type         Receptacle   Occupant     Condition
usb0/1.3        unknown      empty        unconfigured ok       

例 3 デバイスが接続されている同じポートのステータスの一覧表示

次のコマンドは、デバイスが物理的に接続され、問題なく構成されたあとの、同じポートのステータスを一覧表示します。

example# cfgadm -l usb0/1.3
Ap_Id           Type         Receptacle   Occupant     Condition
usb0/1.3        USB-hub      connected    configured   ok

例 4 既存の USB デバイスの構成解除

次のコマンドは、usb0/1.3 に接続された USB デバイスを構成解除し、ap_id のステータスを表示します。

example# cfgadm -c unconfigure usb0/1.3
Unconfigure the device: /devices/pci@0,0/pci8086,7112@7,2/hub@2:2.3
This operation suspends activity on the USB device
Continue (yes/no)?

Enter:

y

example# cfgadm -l usb0/1.3
Ap_Id           Type         Receptacle   Occupant     Condition
usb0/1.3        unknown      connected    unconfigured ok

例 5 既存の USB デバイスの構成解除と論理的な切断

次のコマンドは、usb0/1.3 に接続された USB デバイスを構成解除し、論理的に切断します。

example# cfgadm -c disconnect usb0/1.3
Disconnect the device: /devices/pci@0,0/pci8086,7112@7,2/hub@2:2.3
This operation suspends activity on the USB device 
Continue (yes/no)?

Enter:

y

example# cfgadm -l usb0/1.3
Ap_Id         Type         Receptacle     Occupant        Condition
usb0/1.3      unknown      disconnected   unconfigured    ok    

disconnect の実行は、cfgadm によって最初に unconfigure が実行されることを暗黙的に意味します。デバイスがまだ物理的に接続されていても、受容体のステータスは disconnected と示されています。この場合、物理的なホットプラグ接続を行うか、または ap_idcfgadm -c configure を使用すると、オンラインに戻ります。

例 6 以前に構成解除した USB デバイスの構成

次のコマンドは、以前に usb0/1.3 に接続されていた USB デバイスを構成します。

example # cfgadm -yc configure usb0/1.3
example# cfgadm -l usb0/1.3
Ap_Id           Type         Receptacle   Occupant     Condition
usb0/1.3        unknown      connected    configured   ok

例 7 USB デバイスのリセット

次のコマンドは、USB デバイスをリセットします。

example# cfgadm -x usb_reset usb0/1.3
Reset the device: /devices/pci@0,0/pci8086,7112@7,2/hub@2:2.3
This operation suspends activity on the USB device 
Continue (yes/no)?

Enter:

y

例 8 単一の USB デバイスに関する詳細情報の表示

次のコマンドは、単一の USB デバイスに関する詳細情報を表示します。このデバイスでは、次の USB 固有の情報が「Information」フィールドに示されています。

example# cfgadm -lv usb0/1.5
Ap_Id                 Receptacle   Occupant     Condition  Information
When         Type         Busy         Phys_Id
usb0/1.5     connected    configured   ok         Mfg:"Io
mega"  Product:"USB Zip 250"  NConfigs:1  Config:0 : Default
example# cfgadm -l -s "cols=ap_id:info" usb0/1.5
Ap_Id                         Information
usb0/1.5                      Mfg:"Iomega"  Product:"USB Zip 250"  
NConfigs:1  Config:0 : Default

例 9 すべての USB デバイスに関する詳細情報の表示

次のコマンドは、システム上のすべての USB デバイスに関する詳細情報を表示します。

example# cfgadm -l -s "select=class(usb),cols=ap_id:info"
Ap_Id                         Information 
usb0/1                        Mfg:<undefined>  Product:<undefined>  
NConfigs:1  Config:0 <no cfg str descr>
usb0/2             
usb0/1.1                      Mfg:<undefined>  Product:<undefined>  
NConfigs:1  Config:0 <no cfg str descr>
usb0/1.2         
usb0/1.3         
usb0/1.4                      Mfg:"Wizard"  Product:"Modem/ISDN"  
NConfigs:3  Config:1 : V.90 Analog Modem
usb0/1.5                      Mfg:"Iomega"  Product:"USB Zip 250"  
NConfigs:1  Config:0 : Default
usb0/1.6                      Mfg:"SOLID YEAR"  Product:"SOLID YEAR 
USB"NConfigs:1  Config:0 <no cfg str descr>
usb0/1.7

ap_id のみが含まれている行は、空のポートです。これらは、フィルタ処理によって除外できます。次の例では、接続されたデバイスがある USB ap_id と、それらのデバイスの情報のみが示されます。

example# cfgadm -l -s "select=class(usb),cols=ap_id:info" | grep Mfg
usb0/1                        Mfg:<undefined>  Product:<undefined>  
NConfigs:1  Config:0 <no cfg str descr>
usb0/1.1                      Mfg:<undefined>  Product:<undefined>  
NConfigs:1  Config:0 <no cfg str descr>
usb0/1.4                      Mfg:"Wizard"  Product:"Modem/ISDN"  
NConfigs:3  Config:1 : V.90 Analog Modem
usb0/1.5                      Mfg:"Iomega"  Product:"USB Zip 250"  
NConfigs:1  Config:0 : Default
usb0/1.6                      Mfg:"SOLID YEAR"  Product:"SOLID YEAR USB" 
Config:0 <no cfg str descr>

例 10 複数構成 USB デバイスに関する情報の一覧表示

次の例では、複数構成 USB デバイスに関する情報が一覧表示されます。

NConfigs フィールドに注目してください。このデバイスで使用できる構成数は、01、および 2 (0 - (NConfigs-1)) です。

example# cfgadm -l -s "cols=ap_id:info" usb0/1.4
Ap_Id                         Information
usb0/1.4                      Mfg:"Wizard"  Product:"Modem/ISDN"  
NConfigs:3  Config:1 V.90 Analog Modem"

例 11 複数構成 USB デバイスの現在の構成の設定

次の例では、複数構成 USB デバイスの現在の構成が設定されます。

example# cfgadm -o config=2 -x usb_config usb0/1.4
Setting the device: /devices/pci@1f,2000/usb@1/device@3
to USB configuration 2
This operation suspends activity on the USB device
Continue (yes/no)? 

Enter:

y

USB configuration changed successfully.

まったく同じタイプの複数のデバイスが同じバス上にある場合は、デバイスのパスを確認して、デバイスの正しいインスタンスが参照されていることを確認するようにしてください。この情報は、「Information」フィールドに示されています。

ファイル

/usr/lib/cfgadm/usb.so.1

汎用的な USB デバイス管理のためのハードウェア固有ライブラリ

属性

属性についての詳細は、attributes(5) を参照してください。

属性タイプ
属性値
使用条件
system/library

関連項目

cfgadm(1M), config_admin(3CFGADM), attributes(5), scsa2usb(7D), usba(7D)

USB 1.1 の仕様 (www.usb.org)

『Oracle Solaris の管理: 一般的なタスク』

注意事項

cfgadm(1M) では、現在アプリケーションによって開かれている USB デバイスの構成解除、切断、リセット、または構成の変更を行うことはできません。また、ハブの階層内のデバイスがアプリケーションによって開かれている場合、そのハブでこれらの操作を実行すると失敗します。現在使用中の USB 外部ストレージデバイスの構成解除については、scsa2usb(7D) を参照してください。

スーパーユーザーのみが、接続点で機能を実行できます。ただし、接続点の一覧表示については、スーパーユーザーである必要はありません。