cfgadm_sdcard - cfgadm の SD/MMC ハードウェア固有のコマンド
/usr/sbin/cfgadm [-f] [-y | -n] [-o hardware_options] -c function ap_id[...]
/usr/sbin/cfgadm [-f] [-y | -n] [-o hardware_options] -c hardware_function ap_id[...]
/usr/sbin/cfgadm [-v] [-a] [-s listing_options] [-o hardware_options] [-l [ap_id | ap_type[...]]]
/usr/sbin/cfgadm [-v] [-o hardware_options] -h [ap_id[...]]
Secure Digital (SD) および MultiMediaCard (MMC) ハードウェア固有ライブラリ /usr/lib/cfgadm/sdcard.so.1 は、cfgadm(1M) コマンドによる SD/MMC ホットプラグ操作のための機能を提供します。cfgadm コマンドは、接続点で実行されます。接続点とは、ハードウェアリソースを動的に再構成できるシステム上の場所です。接続点については、cfgadm(1M) を参照してください。
各 SD/MMC スロットは、デバイスツリー上で接続点によって表されます。システム上で接続および構成されているカードデバイスは、接続点の名前の拡張として表されます。このマニュアルページでは、「接続点」および「SD/MMC スロット」という用語は同じ意味で使用されます。
接続点には、ap_id を通じて名前が付けられます。すべての SD/MMC 接続点は、次の形式の文字列で構成されます。
sdcardX/[S][::dsk/cXtYd0]
各表記の意味は次のとおりです。
X は、SD/MMC コントローラの番号です。
S は、コントローラのスロット番号です (0 - 8)。
dev/cXtYd0 は、挿入されているメモリーカードを識別します。
Y は、ターゲットの番号です。
一般的に、デバイスの識別子は、/dev 内のデバイスの対応する論理リンクから生成されます。SD/MMC デバイスでは 1 つの LUN (LUN 0) しかサポートされないため、デバイス文字列の「d」コンポーネントは常に数値 0 (ゼロ) になります。たとえば、SD/MMC コントローラ 2 のスロット 4 の論理 ap_id は、sdcard2/4 になります。SD/MMC メディアカードがこの接続点に挿入されていて、デバイスが構成されている場合、ap_id は sdcard2/4::dsk/c2t0d0 になります。
デバイスを識別する cXtYd0 文字列は、デバイスの接続点と 1 対 1 で対応します。
システム上の接続点の単純な一覧には、すべての SD/MMC デバイスのスロットと、接続されているデバイスが含まれます。例:
#cfgadm -l Ap_Id Type Receptacle Occupant Condition sdcard0/0::dev/c2t0d0 sdcard connected configured ok sata0/1::dev/c0t1d0 disk connected configured ok sata0/2::dev/c0t2d0 cd-dvd connected configured ok sata0/3 sata-port empty unconfigured ok usb0/1 unknown empty unconfigured ok usb0/2 unknown empty unconfigured ok
接続点の一覧表示については、cfgadm(1M) を参照してください。
SD/MMC スロット上の接続点における受容体の状態は、次の意味を持ちます。
SD/MMC スロットは電源が投入されており、有効になっています。このスロットではデバイスの存在が検出されませんでした。
SD/MMC スロットが有効になっていない、SD/MMC デバイスの存在は検出されたがデバイスとの通信が確立されてない、またはスロットで障害が発生している、のいずれかです。
スロットで SD/MMC デバイスが検出され、デバイスの通信が確立されています。
占有装置 (SD/MMC スロットに挿入されているデバイス) の状態は、次の意味を持ちます。
接続されている SD/MMC デバイスは構成されており、オペレーティングシステムが使用できる状態です。
デバイスが接続されていないか、SD/MMC スロットに挿入されている SD/MMC デバイスがまだ構成されていません。構成するには、コマンド cfgadm -c configure ap_id を実行します。
接続点 (SD/MMC スロット) の条件は、次の意味を持ちます。
SD/MMC スロットは、電源が投入され、有効になっており、使用できる状態です。
SD/MMC スロットで障害が発生しています。システムにより無効になっているか電源が切断されている可能性があります。使用不可能であり、その状況は不明です。障害の原因は、スロットに挿入されているデバイスである可能性があります。
SD/MMC スロットは無効になっており、その条件は不明です。
cfgadm コマンドでは、一覧表示 (–l) のほかに数種類の操作が定義されています。これらの操作には、構成状態の変更の開始 (–c)、ハードウェア固有の機能の実行 (–x)、および構成管理のヘルプ情報の表示 (–h) が含まれます。
–c: SD/MMC スロットの接続点では、次の構成状態の変更操作がサポートされています。
SD/MMC スロットを有効化 (アクティブ化) して、接続されているデバイスとの通信を確立します。この操作は、必要に応じてスロットに電源を投入することを意味しています。
挿入されているデバイスがまだ構成解除されていない場合は構成解除し、SD/MMC スロットを無効化 (非アクティブ化) します。その後に「connect」コマンドを使用した場合、SD/MMC スロット操作は有効になりますが、デバイスは「configured」状態にはなりません。
SD/MMC スロットに挿入された SD/MMC カードでは、次の状態の変更操作がサポートされています。
新しいデバイスがまだ構成されていない場合に、オペレーティングシステムが使用できるように構成します。このコマンドは、必要に応じて接続操作も実行することを意味しています。
SD/MMC スロットに挿入されているデバイスがまだ構成解除されていない場合は、構成解除します。
–f: サポートされていません。
–h ap_id: ヘルプオプションと任意の SD/MMC 接続点を組み合わせて使用して、SD/MMC 固有のヘルプを表示できます。
–l [-v]: -l オプションは、cfgadm(1M) で説明されているように機能します。-v オプションと組み合わせて使用した場合、「Information」フィールドには次の SD/MMC 固有の情報が含まれます。
|
–o hardware_options - 現在定義されているハードウェア固有のオプションはありません。
–s listing_options: select サブオプションを使用すると、クラス SD/MMC の接続点を一覧表示できます。cfgadm(1M) を参照してください。
–t ap_id: セルフテスト機能。SD/MMC スロットではサポートされていません。
–x hardware_function: ハードウェア固有の機能を実行します。sdcard_reset_slot ap_id は、ap_id によって指定された SD/MMC スロットのリセットを示します。スロットに SD/MMC デバイスが挿入されている場合は、そのデバイスもリセットされます。
–v: 詳細モードで実行します。
例 1 - SD/MMC カードの構成:
次のコマンドは、SD/MMC コントローラ 0、スロット 0 に接続されているカードを構成します。このコマンドは、SD/MMC スロットにデバイスが挿入されている場合にのみ発行してください。
# cfgadm -c configure sdcard0/0
例 2 - SD/MMC カードの構成解除:
次のコマンドは、SD/MMC コントローラ 0、スロット 3 に挿入されているカードを構成解除します。
# cfgadm -c unconfigure sdcard0/3
例 3 - マウントされたファイルシステムがディスクの構成解除中に検出された場合:
次のコマンドは、マウントされたファイルシステムがディスクの構成解除中に検出された場合を示しています。
# cfgadm -c unconfigure sdcard1/5::dsk/c01t35d0
システムは次のように応答します。
cfgadm: Component system is busy, try again: failed to offline: /devices/pci@0,0/pci8086,244e@1e/pci1095,3124@1/sd@5,0 Resource Information ------------------ -------------------------- /dev/dsk/c1t5d0s0 mounted filesystem "/mnt"
汎用的な SD/MMC ホットプラグ操作のためのハードウェア固有ライブラリです。
属性についての詳細は、マニュアルページの attributes(5) を参照してください。
|
cfgadm(1M), config_admin(3CFGADM), libcfgadm(3LIB), attributes(5), sda(7D), sdcard(7D), sdhost(7D)
通常の操作では、SD/MMC メディアカードは、挿入すると自動的に構成されます。ほとんどの管理者は、通常の使用で、このコマンドを使用する必要はありません。
SD/MMC カードを、最初に構成解除せずに取り外した場合、取り外す際にデバイスに書き込みが行われていたときは、データが失われる可能性があります。読み取り専用でマウントされているデバイスは、いつでも安全に取り外すことができます。
pcfs(7FS) 以外のファイルシステムがマウントされているデバイスは、取り外す前に必ず明示的に構成解除するようにしてください。