Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
System Administration Commandssxconfig(1M)


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]

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
Specify that fragmentation is 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. Using sxconfig
 

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

Example 2. Using sxconfig with Fragmentation
 

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
Example 3. Reporting Current Configuration Parameters
 

The following example reports current configuration parameters in the driver configuration file:

 
example# sxconfig -c
Example 4. Restoring Configuration Parameters to Default Values
 

The following example restores all configuration parameters to the default values:

 
example# sxconfig -d
Example 5. Disabling Fragmentation
 

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

ATTRIBUTES

 

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
AvailabilitySUNWkvm

SEE ALSO

 

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

Platform Notes: SPARCstation 10SX System Configuration Guide


SunOS 5.9Go To TopLast Changed 8 Apr 1996

 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.