manpages.info - online man pages   

SunOS man pages : sxconfig (1)

Maintenance Commands                                 sxconfig(1M)

NAME

sxconfig - configure contiguous memory for the SX video sub- system

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 ]

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 SunOS 5.8 Last change: 8 Apr 1996 1 Maintenance Commands sxconfig(1M) values. By default, 0 megabytes of physically contigu- ous 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

Example 1: A sample display of using sxconfig command. 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 con- tiguous 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 parame- ters 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: SunOS 5.8 Last change: 8 Apr 1996 2 Maintenance Commands sxconfig(1M) 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

ATTRIBUTES

See attributes(5) for descriptions of the following attri- butes: ____________________________________________________________ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | |_____________________________|_____________________________| | Availability | SUNWkvm | |_____________________________|_____________________________|

SEE ALSO

uname(1), boot(1M), init(1M), attributes(5) Platform Notes: SPARCstation 10SX System Configuration Guide SunOS 5.8 Last change: 8 Apr 1996 3