system(5) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

system(5)

system(5)                        File Formats                        system(5)



NAME
       system - system configuration information file

DESCRIPTION
       The  system file is used for customizing the operation of the operating
       system kernel. The recommended procedure is to  preserve  the  original
       system file before modifying it.


       It is recommended not to edit this file directly but instead to deliver
       fragments into files in /etc/system.d/.


       The recommended naming convention for the files in /etc/system.d/ is to
       use  the  IPS package name with the / (slash) converted to a : (colon).
       For  example,  pkg:/mycompany/db-server/hr-db   delivers   content   as
       /etc/system.d/mycompany:db-server:hr-db. For non packaged files use the
       site reverse DNS domain as a prefix.


       When the system boot archive is generated, the  contents  of  /etc/sys‐
       tem.d are placed into a secondary /etc/system file that the kernel will
       read before it reads /etc/system.


       The system file contains commands which are read by the  kernel  during
       initialization  and  used  to  customize  the operation of your system.
       These commands are useful for modifying the system's treatment  of  its
       loadable kernel modules.


       The syntax of the system file consists of a list of keyword/value pairs
       which are recognized by the system as  valid  commands.  Comment  lines
       must  begin with an asterisk (*) or a hash mark (#) and end with a new‐
       line character. All commands are case-insensitive except where noted.


       Commands that modify the system's operation with  respect  to  loadable
       kernel  modules  require  you to specify the module type by listing the
       module's namespace. The following namespaces are currently supported on
       all platforms:

       drv       Modules in this namespace are device drivers.


       exec      Modules  in  this namespace are execution format modules. The
                 following exec modules are currently provided:

                 Only on SPARC systems:
                                               aoutexec



                 On SPARC and IA systems:
                                               elfexec
                                               intpexec




       fs        These modules are file systems.


       sched     These modules implement a process scheduling algorithm.


       strmod    These modules are STREAMS modules.


       sys       These modules implement loadable system-call modules.


       misc      These modules do not fit into any of the above categories, so
                 are considered "miscellaneous" modules.



       SPARC only:

       dacf    These modules provide rules and actions for device auto-config‐
               uration.


       tod     These modules provide support for the time of day hardware.


       cpu     These modules provide CPU-specific kernel routines.



       A description of each of the supported commands follows:

       exclude: <namespace>/<modulename>

           Do not allow the  listed  loadable  kernel  module  to  be  loaded.
           exclude  commands are cumulative; the list of modules to exclude is
           created by combining every exclude entry in the system file.


       include: <namespace>/<modulename>

           Include the listed loadable kernel module.  This  is  the  system's
           default,  so  using include does not modify the system's operation.
           include commands are cumulative.


       forceload: <namespace>/<modulename>

           Force this kernel module to be loaded during kernel initialization.
           The  default action is to automatically load the kernel module when
           its services are first accessed. forceload commands are cumulative.


       rootdev: <device name>

           Set the root device to  the  listed  value  instead  of  using  the
           default root device as supplied by the boot program.


       rootfs: <root filesystem type>

           Set the root filesystem type to the listed value.


       moddir: <first module path>[[{:, }<second ...>]...]

           Set the search path for loadable kernel modules. This command oper‐
           ates very much like the PATH shell variable.  Multiple  directories
           to  search can be listed together, delimited either by blank spaces
           or colons.


       set [<module>:]<symbol> {=, |, &} [~][-]<value>

           Set an integer or  character  pointer  in  the  kernel  or  in  the
           selected  kernel  module  to  a  new value. This command is used to
           change kernel and module parameters and thus modify  the  operation
           of  your  system. Assignment operations are not cumulative, whereas
           bitwise AND and OR operations are cumulative.

           Operations that are supported for modifying integer variables  are:
           simple assignment, inclusive bitwise OR, bitwise AND, one's comple‐
           ment, and negation. Variables in a specific loadable module can  be
           targeted  for modification by specifying the variable name prefixed
           with the kernel module name and a colon (:) separator.  Values  can
           be specified as hexadecimal (0x10), Octal (046), or Decimal (5).

           The  only  operation  supported for modifying character pointers is
           simple assignment. Static string data such as character arrays can‐
           not be modified using the set command. Use care and ensure that the
           variable you are modifying is in fact a character pointer. The  set
           command  is  very  powerful, and will likely cause problems if used
           carelessly. The following escape sequences are supported within the
           quoted string:

             \n   (newline)
             \t   (tab)
             \b   (backspace)



EXAMPLES
       Example 1 A sample system file.



       The following is a sample system file.


         * Force the ELF exec kernel module to be loaded during kernel
         * initialization. Execution type modules are in the exec namespace.
         forceload: exec/elfexec
         * Change the root device to /pci@400/pci@1/pci@0/pci@4/scsi@0/iport@1/disk@w5000cca0153966b9,0:a.
         * You can derive root device names from /devices.
         * Root device names must be the fully expanded Open Boot Prom
         * device name. This command is platform and configuration specific.
         * This example uses the first partition (a) of a SAS disk
         * attached to the onboard controller on a T3-2 system.
         *
         rootdev: /pci@400/pci@1/pci@0/pci@4/scsi@0/iport@1/disk@w5000cca0153966b9,0:a
         *
         * Set the search path for kernel modules to look first in
         * /usr/phil/mod_test for modules, then in /kernel/modules (the
         * default) if not found. Useful for testing new modules.
         * Note that you can delimit your module pathnames using
         * colons instead of spaces: moddir:/newmodules:/kernel/modules
         moddir:/usr/phil/mod_test /kernel/modules.
         * Set the default soft limit for file descriptors per process.
         set rlim_fd_cur = 1023
         * Turn on debugging messages in the modules mydriver. This is useful
         * during driver development.
         set mydriver:debug = 1
         * Bitwise AND the kernel variable "moddebug" with the
         * one's complement of the hex value 0x880, and set
         * "moddebug" to this new value.
         set moddebug & ~0x880
         * Demonstrate the cumulative effect of the SET
         * bitwise AND/OR operations by further modifying "moddebug"
         * by ORing it with 0x40.
         set moddebug | 0x40


SEE ALSO
       boot(8), bootadm(8), init(8), kernel(8)


       Oracle Solaris 11.4 Tunable Parameters Reference Manual

WARNINGS
       Use  care  when modifying the system file; it modifies the operation of
       the kernel. If you preserved the original system  file,  you  can  boot
       using  boot  -a,  which  will  ask you to specify the path to the saved
       file. This should allow the system to boot  correctly.  If  you  cannot
       locate  a  system  file that will work, you may specify /dev/null. This
       acts as an empty system file, and the system will attempt to boot using
       its default settings.

NOTES
       The /etc/system file is read only once, at boot time.



Oracle Solaris 11.4               3 Nov 2021                         system(5)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3