The sxconfig command configures contiguous memory parameters for exclusive use by the SX video system on the Desktop SPARCsystems with graphics option. platform-name can be found using the -i option of uname(1).
After configuring the physically contiguous memory, using the various options described below, the system must be rebooted for the changes to take effect. If this command is being used to configure physically contiguous memory for the first time after the system software has been installed, then the system must be rebooted using the reconfiguration option (-r) of boot(1M).
The amount of memory to be reserved depends upon the type of application. Applications that benefit from the availability of contiguous memory are those that are written to the XGL and XIL graphics and imaging foundation library APIs.
The Platform Notes: SPARCstation 10SX System Configuration Guide provides more detailed information regarding how much memory to reserve for various types of graphics and imaging applications.
sxconfig is supported only on Desktop SPARCsystems with SX graphics option.
The interface, output, and command location are uncommitted and subject to change in future releases.
The following options are supported:
Display the current configuration parameters in the driver configuration file. If the system was not rebooted after previously changing the configuration parameters, then the displayed values do not reflect the actual system setup.
Restore all configuration parameters to the default values. By default, 0 megabytes of physically contiguous memory are reserved, fragmentation is not allowed, and 32 megabytes of memory are reserved for system use.
Allow fragmentation. If no single chunk of memory of at least the requested size is found, allow the request to span multiple chunks. This flag also specifies that less than size megabytes of data may be reserved if there are not enough contiguous chunks available. If this flag is not specified, then the memory reserved must be exactly one chunk of the requested size for the request to succeed.
Specify that fragmentation is not allowed.
Specify that at least limit megabytes of total memory must remain for system use after the contiguous memory has been reserved.
Reserve size megabytes of contiguous memory for exclusive use by the SX video subsystem.
The following example reserves 16 megabytes of contiguous memory without fragmentation and indicates 32 megabytes of memory should remain for system use after reserving the contiguous memory:
example# sxconfig -s 16 -l 32
The following example reserves 16 megabytes of contiguous memory with fragmentation allowed and indicates 32 megabytes of memory should remain for system use after reserving the contiguous memory:
example# sxconfig -s 16 -f -l 32
The following example reports current configuration parameters in the driver configuration file:
example# sxconfig -c
The following example restores all configuration parameters to the default values:
example# sxconfig -d
The following example disables fragmentation:
example# sxconfig -n
sxconfig returns 0 on success, and a positive integer on failure.
Permission denied. Only root can run this command.
Configuration file sx_cmem.conf does not exist.
Illegal combination of options.
Illegal argument for -s option. Should be an integer.
Illegal argument for -l option. Should be an integer.
Contiguous memory device driver
Configuration file for contiguous memory driver
Contiguous memory startup script
See attributes(5) for descriptions of the following attributes:
|ATTRIBUTE TYPE||ATTRIBUTE VALUE|
Platform Notes: SPARCstation 10SX System Configuration Guide