/usr/sbin/cfgadm [-c configure] [-f]
[-o disable-at-boot | enable-at-boot ] ac#:bank# ...
/usr/sbin/cfgadm [-c unconfigure]
[-o disable-at-bootp | enable-at-boot ] ac#:bank# ...
/usr/sbin/cfgadm [-v]
[-o quick | normal | extended, [max_errors=#] ] -t ac#:bank#...
/usr/sbin/cfgadm -x relocate-test ac#:bank# ...
/usr/sbin/cfgadm [-l] -o disable-at-boot | enable-at-boot ac#:bank# ...
特定于 ac 硬件的库 /usr/platform/sun4u/lib/cfgadm/cfgadm_ac.so.1 通过 cfgadm_sysctrl(1M) 提供在 E6X00、E5X00、E4X00 以及 E3X00 系统中配置和取消配置内存区的功能。该功能是 CPU/内存板动态重新配置的一部分。
内存区显示为设备树中的连接点。对于每个 CPU/内存板，发布两个连接点（为板上的每个内存区提供一个）：bank0 和 bank1。如果内存区未存储任何内容，则插口状态为 empty（空）。如果内存区存储了内容，则插口状态为 connected（已连接）。内存区的插口状态永远不会为 disconnected（断开）。已连接的内存区的插卡状态可以为 configured（已配置）或 unconfigured（未配置）。如果插卡状态为 configured（已配置），表明 Solaris 正在使用内存；如果插卡状态为 unconfigured（未配置），表明 Solaris 没有使用内存。
有关命令选项的完整说明，请参见 cfgadm(1M)。
支持以下选项：
更改插卡状态。configure 参数确保内存已经初始化并将内存添加到 Solaris 内存池中。unconfigure 参数取消 Solaris 对内存的使用。如果 CPU/内存板从系统中移除，内存的两个区必须为未配置状态。
如果板上的内存标记为 disabled-at-boot（请参见 info 字段），cfgadm 将拒绝 configure 操作，除非指定 –f（强制）选项或“引导时启用”标志 (–o enable-at-boot)。配置操作在很短的时间内完成并且执行时间与需初始化的内存大小成正比。
如果系统中没有足够的未确定内存（VM viability（VM 可行性）错误）或未配置的内存区中仍存在不能删除的内存（non-relocatable pages 错误），cfgadm 将拒绝 unconfigure 操作。不可重定位的页面存在与否由 info 列表字段中的词 permanent 指示。由于各种因素（如系统负荷以及辅助存储器所需分页的数量），取消 Solaris 对内存的使用可能需要大量时间。unconfigure 操作可随时取消并且可通过发出信号中断该命令的调用使内存恢复满配置状态。如果在超时期限内未能删除内存，unconfigure 操作会自行取消。缺省的超时期限为 60 秒，可通过 –o timeout=# 选项更改。如果值设置为 0，将禁止超时。
强制选项。在非易失的 disabled-memory-list 变量中配置标记为“引导时禁用”的内存区时，使用该选项覆盖数据块。请参见《Platform Notes: Sun Enterprise 6x00/5x00/4x00/3x00 Systems》。
列表选项。支持此选项，如 cfgadm(1M) 中所述。
type（类型）字段始终为 memory（内存）。
对于空的内存区，info（信息）字段包含以下信息：
slot# empty
slot# 表示 CPU/内存板所插入的系统插槽。例如，如果为 slot11，则与 cfgadm 一起用于处理相关板的连接点为 sysctrl0:slot11。对于连接的内存区，info（信息）字段包含以下信息：
slot# sizeMb|sizeGb [(sizeMb|sizeGb used)] base 0x###
[interleaved #-way] [disabled at boot] [permanent]根据实际需要，内存区大小可以 Mb 或 Gb 为单位表示。如果内存没有完全使用，将报告所使用的内存大小。物理基址可用十六进制表示。如果该内存区与其他某个内存区相互交错，将报告交错因子。如果板上的内存通过非易失 disabled-memory-list 变量在引导时禁用，将报告这种情况。如果内存区中存在无法删除的内存，将报告该内存为永驻内存。
这些选项用于修改非易失的 disabled-memory-list 变量的状态。如果不需要执行命令，这些选项可以与 –c 选项或显式或隐式列表命令 -l 一起使用。使用 –o enable-at-boot 与 configure 命令通过在禁用内存列表中配置板上的内存来覆盖数据块。
该选项与 –t 选项一起指定测试级别。
normal 测试级别确保每个内存单元存储 0 和 1 并且检查所有单元是否可单独寻址。quick 测试级别只进行 0 与 1 的测试，通常会跳过地址线问题。extended 测试使用模式来检测相邻单元干扰问题。缺省的测试级别为 normal。请参见 –t 选项。
该选项与 –t 选项一起使用指定所允许的错误的最大数量。如果不指定该选项，则采用缺省值 32。
该选项与 unconfigure 命令一起使用来设置自取消超时。缺省值为 60，并且单位为秒。如果该选项的值为 0，表明无超时。
测试未配置的内存区。使用 –o quick | normal | extended 选项指定测试级别。
如果该测试能够在内存区上运行，cfgadm 命令返回 0（表明运行成功）并退出。如果连接点存在，可获取测试结果。
详细选项。将该选项与 –t 选项一起使用来显示详细的测试进度和结果。
对于指定的内存区中使用的所有内存页，尝试执行 unconfigure 命令中所使用的重定位操作。该操作的成功并不能保证内存区为未配置的。如果该操作失败，表明内存区可能不是未配置的。该选项只用于测试目的。
支持下列操作数：
内存区连接点由地址控制器 (ac) 驱动程序 (ac#) 的实例发布。将会为每个系统板创建一个 ac 驱动程序实例，但只有与 CPU/内存板关联的实例会发布两个内存区连接点：bank0 和 bank1。
这种形式符合 cfgadm(1M) 中给出的逻辑 ap_id 规范。对应的物理 ap_id 已在“文件”部分中列出。
ac 驱动程序实例编号与对应的板的槽号无关。完整的物理连接点标识符中所包含的槽号是紧跟在 fhc@ 部分后面的十六进制槽号的两倍。
连接点
特定于硬件的库文件
有关下列属性的说明，请参见 attributes(5)：
|
cfgadm(1M)、cfgadm_sysctrl(1M)、config_admin(3CFGADM)、attributes(5)
《Sun Enterprise 6x00, 5x00, 4x00 and 3x00 Systems Dynamic Reconfiguration User's Guide》
《Platform Notes: Sun Enterprise 6x00/5x00/4x00/3x00 Systems》
有关 EXX00 系统 CPU/内存板动态重新配置的更多详细信息，请参见《Sun Enterprise 6x00, 5x00, 4x00 and 3x00 Systems Dynamic Reconfiguration User's Guide》。