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
           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    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 con-
     tiguous 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  parame-
     ters 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  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