sxconfig(1M) manual page
Table of Contents
sxconfig - configure contiguous memory for the SX video subsystem
/usr/platform/platform-name/sbin/sxconfig -c
/usr/platform/platform-name/sbin/sxconfig -d
/usr/platform/platform-name/sbin/sxconfig [ -f|-n ] [ -l limit ] [ -s size
]
SUNWkvm
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:
- -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 are reserved, fragmentation
is not allowed, and 32 megabytes of memory are 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.
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
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 option.
- Illegal combination of options.
- Illegal argument for -s option. Should be an integer.
- Illegal argument for
-l option. Should be an integer.
- /platform/platform-name/kernel/drv/sx_cmem
- contiguous memory device driver
- /platform/platform-name/kernel/drv/sx_cmem.conf
- configuration file for contiguous memory driver
- /etc/init.d/sxcmem
- contiguous
memory startup script
uname(1)
, boot(1M)
, init(1M)
Platform Notes:
SPARCstation 10SX System Configuration Guide
Table of Contents