Go to main content

Oracle® Solaris 11.4 Tunable Parameters Reference Manual

Exit Print View

Updated: August 2021
 
 

General I/O Parameters

This section describes parameters in function of input and output processes in the kernel.

maxphys Parameter

Description

Defines the maximum size of physical I/O requests. If a driver encounters a request larger than this size, the driver breaks the request into maxphys sized chunks. File systems can and do impose their own limit.

Data Type

Signed integer

Default

131,072 (sun4v) or 57,344 (x86). The sd driver uses the value of 1,048,576 if the drive supports wide transfers. The ssd driver uses 1,048,576 by default.

Range

stem-specific page size to MAXINT

Units

Bytes

Dynamic?

Yes, but many file systems load this value into a per-mount point data structure when the file system is mounted. A number of drivers load the value at the time a device is attached to a driver-specific data structure.

Validation

None

When to Change

When doing I/O to and from raw devices in large chunks. Note that a DBMS doing OLTP operations issues large numbers of small I/Os. Changing maxphys does not result in any performance improvement in that case.

Commitment Level

Unstable

rlim_fd_cur Parameter

Description

Defines the "soft" limit on file descriptors that a single process can have open. A process might adjust its file descriptor limit to any value up to the "hard" limit defined by rlim_fd_max by using the setrlimit() call or by issuing the limit command in whatever shell it is running. You do not require superuser privilege to adjust the limit to any value less than or equal to the hard limit.

Data Type

Signed integer

Default

256 through Oracle Solaris 11.4 SRU 26

4095 starting with Oracle Solaris 11.4 SRU 27

Range

128 to MAXINT

Units

File descriptors

Dynamic?

No

Validation

Compared to rlim_fd_max. If rlim_fd_cur is greater than rlim_fd_max, rlim_fd_cur is reset to rlim_fd_max.

When to Change

When the default number of open files for a process is not enough. Increasing this value means only that it might not be necessary for a program to use setrlimit to increase the maximum number of file descriptors available to it.

Commitment Level

Unstable

rlim_fd_max Parameter

Description

Specifies the "hard" limit on file descriptors that a single process might have open. Overriding this limit requires superuser privilege.

Data Type

Signed integer

Default

65536 through Oracle Solaris 11.4 SRU 26

65535 starting with Oracle Solaris 11.4 SRU 27

Range

128 to MAXINT

Units

File descriptors

Dynamic?

No

Validation

Compared to rlim_fd_sys. If rlim_fd_max is greater than rlim_fd_sys, rlim_fd_max is reset to rlim_fd_sys

When to Change

When the maximum number of open files for a process is not enough. Other limitations in system facilities can mean that a larger number of file descriptors is not as useful as it might be. For example:

select is by default limited to 1024 descriptors per fd_set in 32-bit applications. For more information, see the select(3C) man page. A 32-bit application code can be recompiled with a larger fd_set size (less than or equal to 65,536). A 64-bit application uses an fd_set size of 65,536, which cannot be changed.

An alternative to changing this on a system wide basis is to use the plimit command. If a parent process has its limits changed by plimit, all children inherit the increased limit. This alternative is useful for daemons such as inetd.

Commitment Level

Unstable

rlim_fd_sys Parameter

Description

Specifies the maximum limit to which a process can raise its hard limit on file descriptors. This parameter specifies the system maximum value for the process.max-file-descriptor resource control.

You cannot override this limit. You can only change this limit if your system runs at least Oracle Solaris 11.4 SRU 27.

Data Type

Unsigned integer

Default

MAXINT through Oracle Solaris 11.4 SRU 26

Starting with Oracle Solaris 11.4 SRU 27, calculated based on physmem to be approximately 65K per gigabyte of memory. The value is rounded up to the nearest value of (2^N)-1.

Range

128 to MAXINT

Dynamic?

No

Validation

Compared to rlim_fd_max. If rlim_fd_sys is less than rlim_fd_max, rlim_fd_sys is reset to rlim_fd_max

When to Change

When the maximum hard limit of open files for a process is insufficient or when a system restricts the maximum hard limit for privileged processes

Commitment Level

Unstable