Displays bus resources for available devices in the system and recommends attribute values for bus resource resolution.
lsresource [ -a | -r ] [ -d ] -l Name
The lsresource command writes a list of assigned bus resources to standard out, or determines if the bus resources for devices resolve.
The lsresource command lets you display the currently assigned values for the bus resource attributes for the device specified by the given device logical name (-l Name). Use the -a flag to display the currently assigned values for all bus resource attributes for all devices under the same parent bus as the specified device.
Use the -r flag to determine if the bus resources for the specified device are resolvable. In this case, the lsresource command checks all devices under the same parent bus as the specified device, including defined but not available devices, to see if their bus resource attributes are resolvable. The lsresource command produces no output if all attributes resolve. The lsresource command provides information depending on the type of conflict detected if any device's bus resources are unresolvable. In some cases, the lsresource command can provide you with information that leads to the resolution of the conflict.
The lsresource command identifies the device name, attribute name, and a suggested value for the attribute if a conflict results from an attribute that only a user can change. Setting the attribute to the suggested value should resolve the conflict. This may aid in the configuration of devices with attributes that can only a user can change. Such devices include adapter cards which use jumpers or switches on the card to select values.
In some cases, a conflict may be due to an attribute which the system can normally adjust at boot time but is prevented from doing so at run time because the device is in the Available state. In these situations, the lsresource command will indicate that the configuration will be resolved by rebooting the system.
It is possible that multiple user changeable attributes will be identified when unresolvable conflicts occur. These may be for the device specified by the given device logical name (-l Name) or for other devices in the system. All of the identified attributes will need to be changed to resolve the conflict. It may even be the case where user changeable attributes are identified and a reboot is indicated. In this case, all of the identified attributes will need to be changed and the system rebooted to resolve the conflicts.
Finally, lsresource may determine that the set of devices currently defined in the devices configuration database can not be resolved regardless of attributes being changed or the system rebooted. In this case, a list of the devices which could not be resolved is written to standard out. If the problem has resulted from a new device just being defined, that device should be removed, or the devices listed by lsresource should be removed. If the problem is not resolved by removing devices, there could be additional problems on the next reboot. This is because the order in which devices are resolved at boot time may differ from the order they are resolved by lsresource, resulting in a different set of unresolvable devices at boot time. If the set of unresolvable devices at boot time should now include a device needed for booting, problems such as no console being configured or the system failing to boot could occur.
The following applies when lsresource is used to list currently assigned bus resource values (the -r flag is not specified).
The TYPE field in the
output listing contains the following symbols:
|B||Bus Memory Address Values|
|M||Bus Memory Address Values|
|O||I/O Address Values|
|I||Bus Interrupt Levels|
|N||Non-sharable Bus Interrupt Levels|
|A||DMA Arbitration Level|
The S column denotes shared attributes. These are attributes which are required to be set to the same value. They are grouped by the number specified in the column. All attributes with a 1 by them must be set to the same value, all attributes with a 2 by them must be set to the same value, and so on. In some cases, two or more interrupt attributes may be set to the same value but have no numbers in the S column indicating that they are shared. This is because the values are not required to be the same but just happen to be set to the same value because they could not be assigned their own unique values.
The G column denotes attributes in a group. These are a set of attributes whose values depend on each other. If one is changed to the next possible value, the rest of the attributes in the group must also be changed to the next possible value. Their groupings are indicated by the number specified in the column. All attributes with a 1 by them are in the same group, all attributes with a 2 by them are same group, and so on.
On some models, the interrupt
value displayed may be followed by a value enclosed in parenthesis.
This is not part of the interrupt value but serves to identify the interrupt
controller to which the interrupt is associated. The identifier
consists of a letter followed by a number, such as A0. The
letter indicates the type of interrupt controller and the number distinguishes
between multiple instances of that type of controller. There are two
types of interrupt controllers that may be identified:
|A||Indicates an AT interrupt controller.|
|B||Indicates a non-AT interrupt controller.|
|-a||Specifies that all allocated bus resource attributes for all devices connected to the same top parent bus as the device specified with the -l flag are to be displayed. This flag cannot be used with the -r flag.|
|-d||Specifies that the attribute text descriptions are to be included in the output.|
|-l Name||(Lowercase L) Specifies the logical name of the device attributes to display.|
|-r||Specifies to attempt to resolve all bus resources of all devices connected to the same top parent bus as the device specified with the -l flag. This will include all devices that are in the DEFINED state. The lsresource command will display any conflicts and advise the user on changeable values. No changes to the ODM database are made. This flag cannot be used with the -a flag.|
Access Control: Any User
Auditing Events: N/A
lsresource -l tok0
The system displays a message similar to the following:
TYPE DEVICE ATTRIBUTE S G CURRENT VALUE ----- -------------- --------------- - - ---------------------- M tok0 dma_bus_mem 0x003b2000 - 0x003f1fff O tok0 bus_io_addr 0x000086a0 - 0x000086af N tok0 bus_intr_lvl 3 A tok0 dma_lvl 7
lsresource -a -l tok0
The system displays a message similar to the following:
TYPE DEVICE ATTRIBUTE S G CURRENT VALUE ----- -------------- --------------- - - ----------------------- M bus0 bus_iocc_mem 0x00fffff0 - 0x00ffffff M gda0 vram_start 1 0x00400000 - 0x007fffff M gda0 bus_mem_start 0x000c0000 - 0x000c1fff M gda0 dma1_start 0x00800000 - 0x009fffff M gda0 dma2_start 0x00a00000 - 0x00bfffff M gda0 dma3_start 0x00c00000 - 0x00dfffff M gda0 dma4_start 0x01000000 - 0x011fffff M scsi0 bus_mem_addr 0x000e0000 - 0x000e0fff M scsi0 dma_bus_mem 0x00100000 - 0x00301fff M tok0 dma_bus_mem 0x003b2000 - 0x003f1fff O da0 bus_io_addr 0x00000060 - 0x0000006f O siokta0 bus_io_addr 0x00000050 - 0x00000051 O sioma0 bus_io_addr 0x00000048 - 0x00000049 O ppa0 bus_io_addr 0x00000078 - 0x0000007a O gda0 bus_addr_start 1 0x00002110 - 0x0000211f O tok0 bus_io_addr 0x000086a0 - 0x000086af I siokta0 bus_intr_lvl 1 (A0) I sioma0 bus_intr_lvl 1 (A0) I ppa0 bus_intr_lvl 13 (A0) I gda0 int_level 9 (A0) I scsi0 bus_intr_lvl 14 (A0) N fda0 bus_intr_lvl 6 (A0) N tok0 bus_intr_lvl 3 (A0) A fda0 dma_lvl 0 A gda0 dma_channel 3 A scsi0 dma_lvl 4 A tok0 dma_lvl 7
lsresource -r - d -l tok0
Depending on the outcome of the resolution, different messages may be displayed. The output below signifies to a user that the resolution can be successful if changes are made, i.e., the attributes are changed to the suggested values.
lsresource: The attribute(s) for some device(s) in the system could not be resolved. To resolve conflicts, attribute(s) need to be modified. A suggested value for each attribute is provided. DEVICE ATTRIBUTE CURRENT SUGGESTED DESCRIPTION -------------- --------------- ------- --------- ----------- ent1 bus_intr_lvl 11 5 Bus interrupt level ent1 bus_mem_addr 0xc0000 0xc4000 Bus memory address ent1 bus_io_addr 0x300 0x320 Bus I/O address ent2 bus_intr_lvl 11 7 Bus interrupt level ent2 bus_mem_addr 0xc0000 0xc8000 Bus memory address
|/usr/sbin/lsresource||Contains the lsresource command.|