Mtune(4)                                                    Mtune(4)


       NAME
             Mtune - tunable parameter definitions

       SYNOPSIS
             Mtune

       DESCRIPTION
             One of the Installable Driver/Tunables Parameters kernel
             configuration files, an Mtune file contains definitions of
             tunable parameters, including default values, for a kernel
             module.  System-specific tunable values are stored in stune.
             When the Mtune component of a module's Driver Software Package
             (DSP) is installed, idinstall(1M) stores the module's Mtune
             file information in /etc/conf/mtune.d/module-name, where the
             file module-name is the name of the module being installed.
             Package scripts should never access /etc/conf/mtune.d files
             directly; only the idinstall and idtune commands should be
             used.

             Each integer tunable parameter is specified on a separate line
             of the form:

                   parameter-name   default-value   minimum-value   maximum-value

             Each string tunable parameter is specified on a separate line
             of the form:

                   parameter-name   default-value

             All fields are positional and must be separated by white
             space.  Blank lines and lines beginning with `#' or `*' are
             considered comments and are ignored.

             The Mtune file fields are:

             parameter-name
                       A string (maximum of 20 characters) used to
                       construct the preprocessor #defines that pass the
                       value for this parameter to the system when the
                       system is built [see Space.c(4)].

             default-value
                       Specifies the default value for this tunable
                       parameter.  If the value is not overridden by the
                       stune(4) file, this value will be used when the
                       system is built.


                           Copyright 1994 Novell, Inc.               Page 1

      Mtune(4)                                                    Mtune(4)


            minimum-value
                      Specifies the minimum allowable value for this
                      tunable parameter.  If the parameter is tuned by
                      idtune(1M) command, the command will check that the
                      new value specified is equal to or greater than this
                      value.

            maximum-value
                      Specifies the maximum allowable value for this
                      tunable parameter.  If the parameter is tuned by
                      idtune(1M) command, the command will check that the
                      new value specified is equal to or less than this
                      value.

            For detailed information on Mtune parameters, refer to the
            advanced features sections on tunable parameters in your
            system administration documentation.

      NOTICES
         Compatibility Considerations
            For compatibility with existing add-on DSP packages,
            idbuild(1M) maintains a flat file, /etc/conf/cf.d/mtune, which
            contains all of the tunable parameters.  Existing packages may
            read this file to find existing values, and may add tunables
            to the file.  This mechanism is discouraged for any new add-on
            DSP package, however; new packages should use the idinstall
            and idtune commands.

      REFERENCES
            Autotune(4), Dtune(4), idbuild(1M), idinstall(1M), idtune(1M),
            Space.c(4), stune(4)

















                          Copyright 1994 Novell, Inc.               Page 2