sxconfig(1M)
NAME
sxconfig − configure contiguous memory for the SX video subsystem
SYNOPSIS
/usr/kvm/sxconfig −c
/usr/kvm/sxconfig −d
/usr/kvm/sxconfig [ −f|−n ] [ −l limit ] [ −s size ]
AVAILABILITY
SUNWkvm
DESCRIPTION
sxconfig command configures contiguous memory parameters for exclusive use by the SX video system on the SPARCstation 10SX system. 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 SPARCstation 10SX machines.
The interface, output, and command location are uncommitted and subject to change in future releases.
OPTIONS
−c 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.
−d Restore all configuration parameters to the default values. By default 0 megabytes of physically contiguous memory is reserved, fragmentation is not allowed and 32 megabytes of memory is reserved for system use.
−f 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.
−n Fragmentation not allowed.
−l limit
Specify that at least limit megabytes of total memory must remain for system use after the contiguous memory has been reserved.
−s size
Reserve size megabytes of contiguous memory for exclusive use by the SX video subsystem.
EXAMPLES
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 is identical to the one described above except that fragmentation is allowed:
example# sxconfig −s 16 −f −l 32
The following example reports current configuration parameters in the driver configuration file:
example# sxconfig −c
This example restores all configuration parameters to the default values:
example# sxconfig −d
The following example disables fragmentation:
example# sxconfig −n
EXIT CODES
sxconfig returns 0 on success, and a positive integer on failure.
1 Permission denied. Only root can run this command.
2 Configuration file /kernel/drv/sx_cmem.conf does not exist.
3 Illegal option.
4 Illegal combination of options.
5 Illegal argument for −s option. Should be an integer.
6 Illegal argument for −l option. Should be an integer.
FILES
/kernel/drv/sx_cmem Contiguous memory device driver
/kernel/drv/sx_cmem.conf
Configuration file for contiguous memory driver
/etc/init.d/sxcmem Contiguous memory startup script
SEE ALSO
Platform Notes: SPARCstation 10SX System Configuration Guide
Sun Microsystems — Last change: 3 May 1993