rcapd(1MSRM)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | RETURN VALUES | FILES | ATTRIBUTES | SEE ALSO | NOTES

NAME

rcapd- resource cap enforcement daemon

SYNOPSIS

rcapd [-d]

DESCRIPTION

The rcapd daemon enforces resource caps on collections of processes. Per-lnode or per-project physical memory caps are supported. For information about projects, see project(4).

Collections of processes can be defined as members of particular lnodes or as members of particular projects. When the resident set size (RSS) of a collection of processes exceeds its cap, the daemon takes action and reduces the RSS of the collection.

The virtual memory system divides physical memory into segments known as pages. To read data from a file into memory, the virtual memory system reads in one page at a time, or pages in a file. To reduce resource consumption, the daemon can page out, or relocate, infrequently used pages to an area outside of physical memory.

The way in which a cap is specified is determined by rcapd's configured operating mode.

If rcapd is in lnode mode, caps are defined for lnodes that have positive values for the following limit attribute:

rss.limit

The amount of physical memory, in specified units, that is available for the lnode's member processes

Use limadm(1MSRM) to set the rss.limit attribute for lnodes.

If rcapd is in project mode, caps are defined for projects that have positive values for the following attribute:

rcap.max-rss

The total amount of physical memory, in bytes, that is available to the project's member processes

See project(4) for a description of project attributes.

The rcapd daemon can be configured by using rcapadm(1MSRM). The rcapd daemon can be monitored with rcapstat(1SRM). Configuration changes can be incorporated into rcapd by sending it SIGHUP (see kill(1)), or according to the configuration interval (see rcapadm(1MSRM)).

OPTIONS

The following option is supported:

-d

Enable debug mode. Messages are displayed on the user's invoking terminal.

RETURN VALUES

The following exit values are returned:

0

Successful completion.

1

An error occurred.

2

Invalid command-line options were specified.

FILES

/etc/project

Project database.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Architecture	SPARC
Availability	SUNWrcapu (32-bit)
	SUNWrcapx (64-bit)

SEE ALSO

project(4), liminfo(1SRM), rcapstat(1SRM), limadm(1MSRM), rcapadm(1MSRM)

Solaris Resource Manager 1.3 System Administration Guide

NOTES

If killed, rcapd can leave processes in a stopped state. Use SIGTERM to cause rcapd to terminate properly.

A collection's RSS can exceed its cap for some time before the cap is enforced, even if sufficient pageable memory is available. This period of time can be reduced by decreasing the RSS sampling interval with rcapadm.

Only one instance of rcapd can run at any given time.

The command described in this man page is only available on SunOS 5.8.

SunOS 5.8  Last Revised 1 Nov 2002

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | RETURN VALUES | FILES | ATTRIBUTES | SEE ALSO | NOTES