[Go to CFHT Home Page] Man Pages
Back to Software Index  BORDER=0Manpage Top Level
    sxconfig(1M) manual page Table of Contents

Name

sxconfig - configure contiguous memory for the SX video subsystem

Synopsis

/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 ]

Availability

SUNWkvm

Description

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.

Options

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.

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 Status

sxconfig returns 0 on success, and a positive integer on failure.

  1. Permission denied. Only root can run this command.
  2. Configuration file 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

/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

See Also

uname(1) , boot(1M) , init(1M)

Platform Notes: SPARCstation 10SX System Configuration Guide


Table of Contents