This section describes parameters that relate to file systems.
Enables large directory caching
Unsigned integer
1 (enabled)
0 (disabled) or 1 (enabled)
Yes, but do not change this tunable dynamically. You can enable this parameter if it was originally disabled. Or, you can disable this parameter if it was originally enabled. However, enabling, disabling, and then enabling this parameter might lead to stale directory caches.
No
Directory caching has no known problems. However, if problems occur, then set dnlc_dir_enable to 0 to disable caching.
Unstable
Specifies the maximum number of entries cached for one directory.
Unsigned integer
MAXUINT (no maximum)
0 to MAXUINT
Yes, this parameter can be changed at any time.
None
If performance problems occur with large directories, then decrease dnlc_dir_max_size.
Unstable
Specifies the minimum number of entries cached for one directory.
Unsigned integer
40
0 to MAXUINT (no maximum)
Entries
Yes, this parameter can be changed at any time.
None
If performance problems occur with caching small directories, then increase dnlc_dir_min_size. Note that individual file systems might have their own range limits for caching directories.
Unstable
Calculates the maximum percentage of physical memory that the DNLC directory cache can consume.
Integer
100
0 to 100
Percentage
No
At boot time, the value range is checked and default value is enforced.
When the system experiences a memory shortage and high kernel memory consumption, consider lowering this value. If performance issues are seen with the default value, consider increasing the value.
Unstable
Defines the number of entries in the directory name look-up cache (DNLC). This parameter is used by UFS, NFS, and ZFS to cache elements of path names that have been resolved.
The DNLC also caches negative look-up information, which means it caches a name not found in the cache.
Signed integer
(4 x (v.v_proc + maxusers) + 320) + (4 x (v.v_proc + maxusers) + 320) / 100
0 to MAXINT
DNLC entries
No
None. Larger values cause the time it takes to unmount a file system to increase as the cache must be flushed of entries for that file system during the unmount process.
You can use the kstat -n dnlcstats command to view the number of hits and misses in the DNLC. A high ratio of misses to hits might indicate that the DNLC is too small. Increasing the value of ncsize can help improve performance.
Excessive values of ncsize have an immediate impact on the system memory usage. Memory that is used directly by the DNLC increases in proportion to ncsize. In addition, caching more entries in the DNLC might require filesystem context relating to those entries to remain in memory when it would otherwise be freed.
Unstable