kcusage.1m (2012 03)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

kcusage(1M) kcusage(1M)

NAME

kcusage - query the usage of kernel resources

SYNOPSIS

kcusage [

-l ][-t ][(

-h | -d | -m | -y )] [tunable... ]

DESCRIPTION

kcusage is used to query the usage of kernel resources controlled by various kernel tunables. The full list

of tunables are given below, along with some indication on how to interpret the data on each tunable.

When none of the options h, d, m,ory are given, data is displayed that reﬂects the currently running

system. When any of these options are given, then historical data is displayed.

When tunables are speciﬁed, then information is displayed for those tunables. When no tunables are

listed, then data is displayed for all kernel tunables for which kcusage has information.

kcusage displays data recorded in the following 4 ﬁles:

• /var/adm/kcmond/hour

• /var/adm/kcmond/day

• /var/adm/kcmond/month

• /var/adm/kcmond/year

Each of these ﬁles contains the usage data for each monitored parameter for different time periods, in the

form of records.

Every time the history is updated, the current usage value is compared with the usage value recorded for

the last 5 minute interval in the hour ﬁle, for the last one hour interval in the day ﬁle, for the last one

day interval in the month ﬁle and for the last one week interval in the year ﬁle.

If the current value exceeds the recorded value then the recorded value is replaced with the current

value. Thus in the historical output the maximum usage value will be recorded, when the history was

updated in that time interval.

These records are updated when kcusage is executed with super user privileges. These records are also

updated periodically if there is an ems request to monitor the resource

/system/kernel_parameters/history.

Operands

kcusage recognizes the following operands

tunable Name of a monitorable tunable (see Monitored Tunables, below).

Options

kcusage recognizes the following options

-h Print ﬁve minute data for the past hour.

-d Print hourly data for the past 24 hours.

-m Print daily data for the past 31 days.

-y Print weekly data for the past 52 weeks.

-l Print the listing in a long format that is easier to parse by another program.

-t Print a listing that include the top 5 processes or users of the given resource.

By default kcusage lists each of the monitorable tunables with the current usage of each of those tun-

ables, no information on the top 5 users, and not in an easily machine parseable form.

The start of an hour, day or week is determined by the timezone kernel tunable and is independent of

the TZ environment variable.

There is no need to trim the data ﬁles as they are of ﬁxed size.

MONITORED TUNABLES

The following kernel tunables are monitorable.

• nflocks

HP-UX 11i Version 3: March 2012 − 1 − Hewlett-Packard Company 1

Summary of content (8 pages)

PAGE 1
kcusage(1M) kcusage(1M) NAME kcusage - query the usage of kernel resources SYNOPSIS kcusage [-l ] [-t ] [( -h | -d | -m | -y )] [tunable... ] DESCRIPTION kcusage is used to query the usage of kernel resources controlled by various kernel tunables. The full list of tunables are given below, along with some indication on how to interpret the data on each tunable. When none of the options h, d, m, or y are given, data is displayed that reflects the currently running system.
PAGE 2
kcusage(1M) A kA • • • • • • • • • • • • • • • • • • • • • • • • • • kcusage(1M) npty nstrpty nkthread nproc ninode nstrtel max_thread_proc maxfiles_lim maxdsiz maxdsiz_64bit maxssiz maxssiz_64bit maxtsiz maxtsiz_64bit maxuprc shmmax shmmni semmns semmni msgtql msgmni msgmbs filecache_max nswapdev nswapfs shmseg KERNEL TUNABLES Kernel tunables allow the system administrator to control the size of various resources within the kernel.
PAGE 3
kcusage(1M) kcusage(1M) running even when the demands on the system change dramatically. Many of these system limits can be set quite high without increasing the size of the kernel. Previously, nproc and nkthread allocated static tables in the kernel. Since HP-UX 11.22, both are limits on how big the dynamic tables are allowed to grow. See the man page for each of these kernel tunables to learn what memory penalty, if any, each has when it is raised.
PAGE 4
kcusage(1M) kcusage(1M) The kcusage data for filecache_max and filecache_min can be somewhat confusing because it is a percent, and kcusage reports usage as a percent of the limit. The percent of a percent is kind of confusing. If filecache_max is set to 50% and 40% of the system memory is used as the file cache, then the file cache will be reported as 80% of its limit. Since the usage data for filecache_max is simply the size of the file cache, this data can also be useful when setting filecache_min.
PAGE 5
kcusage(1M) kcusage(1M) max_thread_proc kcusage shows the maximum number of kernel threads in use by any process on the system. max_thread_proc should be set high enough that well behaved applications can get their work done, but low enough that a new process that allocates its limit of threads cannot take all of the threads on the system. Check the usage data for nkthread to know how many threads are usually free. kcusage shows the number of threads allocated by the top five processes on the system.
PAGE 6
kcusage(1M) kcusage(1M) shmmni The usage data for shmmni shows the number of shared memory segments in use. A shared memory segment is used to map each shared library in use on the system, but a segment can also be allocated programmatically to allow data to be shared between two processes. nswapdev The usage data for nswapdev in the number of devices that have been enabled on the system for swap.
PAGE 7
kcusage(1M) kcusage(1M) DEPENDENCIES kcusage displays data read from files in /var/adm/kcmond. These files are updated by the kcmond(1M) daemon. This daemon is started using the kcalarm(1M) command. The data files are also updated whenever kcusage is run by a privileged user. AUTHORS kcusage was developed by Hewlett-Packard. SEE ALSO kcalarm(1M), kcmond(1M), kcweb(1M).
PAGE 8
(Notes) A (Notes) kA 8 Hewlett-Packard Company −1− HP-UX 11i Version 3: March 2012