tuncheck Command

Purpose

Validates a tunable file.

Syntax

tuncheck [ -r | -p ] -f Filename

Description

The tuncheck command validates a tunable file. All tunables listed in the specified file are checked for range and dependencies. If a problem is detected, a warning is issued.

There are two types of validation:
against the current context
Checks to see if Filename could be applied immediately. Tunables not listed in Filename are interpreted as current values. The checking fails if a tunable of type Incremental is listed with a smaller value than its current value; it also fails if a tunable of type Bosboot or Reboot is listed with a different value than its current value.
against the next boot context
Checks to see if Filename could be applied during a reboot, that is, if it could be a valid nextboot file. Decreasing a tunable of type Incremental is allowed. If a tunable of type Bosboot or Reboot is listed with a different value than its current value, a warning is issued but the checking does not fail.

Additionally, warnings are issued if Filename contains unknown stanzas, or unknown tunables in a known stanza. However, that does not make the checking fail.

Upon success, the AIX_level, Kernel_type and Last_validation fields in the info stanza of the checked file are updated.

Flags

Item Description
-f Filename Specifies the name of the tunable file to be checked. If it does not contain the '/' (forward slash) character, the name is relative to /etc/tunables.
-p Checks Filename in both current and boot contexts. This is equivalent to running tuncheck twice, one time without any flag and one time with the -r flag.
-r Checks Filename in a boot context.

If -p or -r are not specified, Filename is checked according to the current context.

Tuning Parameter Types

Item Description
Dynamic Can be changed at any time.
Static Can never be changed
Reboot Can only be changed during the reboot sequence
Bosboot Can only be changed by running bosboot and rebooting the machine
Mount Changes made are only effective for future filesystems or directory mountings
Incremental Can only be incremented, except at boot time.
Connect Changes are only effective for future socket connections.

Exit Status

0
Filename is valid.
>0
Filename is invalid, message have been provided.

Examples

  1. To check whether mytunable can be applied immediately, type:
     tuncheck -f ./mytunable
  2. To check whether /etc/tunables/nextboot can be applied during a reboot, type:
     tuncheck -r -f nextboot 
  3. To check whether /etc/tunables/nextboot can be applied immediately and after a reboot, type:
    tuncheck -p -f nextboot

Files

Item Description
/usr/sbin/tuncheck Contains the tuncheck command.
/etc/tunables Contains all the tunable files.