svcadm(8)을 검색하려면 섹션에서 8 을 선택하고, 맨 페이지 이름에 svcadm을 입력하고 검색을 누른다.
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. ex‐
clude 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 de‐
fault, so using include does not modify the system's operation. in‐
clude 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 de‐
fault 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 se‐
lected 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 us‐
ing 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 de‐
fault settings.
NOTES
The /etc/system file is read only once, at boot time.
Oracle Solaris 11.4 3 Nov 2021 system(5)