System Administration Commands                         scmadm(1M)



NAME
     scmadm - storage cache manager administration utility

SYNOPSIS
     scmadm


     scmadm -h


     scmadm -e


     scmadm -d


     scmadm -v


     scmadm -C [parameter [= [value]...]


     scmadm -o {system  cd  device} [option]


     scmadm -m {cd   diskname   all}


DESCRIPTION
     The scmadm command provides various options for  controlling
     and gathering information about a storage device cache.

OPTIONS
     If no options are specified, scmadm displays a list of  con-
     figured  cache descriptors with disknames, options, and glo-
     bal options.  The  scmadm  command  supports  the  following
     options:

     -h

         Displays usage information for the scmadm command.


     -e

         Reads the configuration and enables the  storage  device
         cache with those parameters. See dscfg(1M).


     -d

         Shuts down the storage device cache.



SunOS 5.11         Last change: 3 August 2006                   1






System Administration Commands                         scmadm(1M)



     -v

         Displays the cache version number.


     -C [parameter[=[value] ...]

         Sets or displays the configuration parameters. If the -C
         option  is specified with no arguments the current cache
         configuration parameters are displayed. If parameter  is
         specified,  the current value of parameter is displayed.
         If parameter=value is specified, the  current  value  of
         parameter  is  displayed and the parameter is changed to
         value.  If value is omitted, or if value is specified as
         the  null  string,  "  ",  or  as  "-", the parameter is
         deleted from the configuration and the system  uses  the
         default value. Multiple parameters can be specified in a
         single invocation of the scmadm command. A change  in  a
         configuration parameter takes effect only when the cache
         is next restarted.


     -o { system  cd  diskname } [option]

         Sets or displays the options for the system or  for  the
         cache  device specified by cd or diskname. If the option
         rdcache or nordcache is specified, the system or  speci-
         fied  cache  device is set to that option. The option is
         saved as part of the configuration so  that  the  option
         persists.  See  dscfg(1M). To notify the system to "for-
         get" about a saved option, use the forget  option.  This
         does  not  change the option; it just removes the option
         from the saved configuration. If no option is specified,
         current options are displayed. The rdcache option is set
         as the default. The options are defined as follows:

         rdcache

             Data blocks are likely to be  referenced  again  and
             should remain in cache.


         nordcache

             Data blocks are unlikely to be referenced again  and
             should  be  treated  as least recently used, so that
             other blocks can remain in the cache longer.



     -m { cd  diskname  all }




SunOS 5.11         Last change: 3 August 2006                   2






System Administration Commands                         scmadm(1M)



         Displays the cache descriptor and diskname map  for  the
         device  specified  by  cd or diskname or, if you specify
         all, displays the cache descriptors and diskname map for
         all storage devices on the system.


EXIT STATUS
     The scmadm command  returns  0  for  success,  non-zero  for
     error.

FILES
     /dev/sdbc

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWscmr, SUNWscmu          
    
     Interface Stability          Evolving                    
    


SEE ALSO
     dscfg(1M), attributes(5)

DIAGNOSTICS
     scmadm fails if there is insufficient contiguous memory.






















SunOS 5.11         Last change: 3 August 2006                   3