Solaris Resource Manager 1.3 Reference Manual

liminfo(1SRM)

NAME

liminfo- display password attributes and limits information for one or more users

SYNOPSIS

liminfo

-a

-g

-c

-C

sec

-l

-u

-nrvx

-lname

-uid ...

DESCRIPTION

With no arguments, liminfo outputs a multiline report of the invoker's lnode and password map information. An lnode exists for every user under Solaris Resource Manager; it contains a collection of various types of information on the user. liminfo is designed for the convenience of users who want to view their current usages, limits, privileges, and so on.

If a single user argument is given, then a report is output for that user. If more than one user argument is given, then several reports are generated, separated by newline characters. Each user argument is interpreted as a login name, unless the name is not found in the password map; in this case, if it is numeric, it is interpreted as a UID.

OPTIONS

The following options are supported:

-a: Reports on all currently active lnodes. An active lnode is one to which one or more processes are currently attached, or one that has active child limits entries.
-g: Reports on all currently active limits entries excluding group headers that are active only because they have active members.
-C sec: Continuous output. Outputs all the reports, then a single formfeed character, and then sleeps for the given number of seconds. This entire process is repeated until the command is killed.
-c: Continuous output. Up-to-date reports are output as they are for the -C option until the process is killed.
-n: Output each report on a single line, with tab characters replacing newlines. Each report is terminated with a newline character.
-r: Output all values in raw form. Some values, such as memory usage, are normally output in a scaled format, for example, 102 Mbytes. This option causes all such values to be output in basic units such as bytes, seconds, or byte-seconds, for example, 106954752 bytes. Note that this can result in long numbers that may throw off the columnar layout of the formatted output.
-v: Output in a verbose format. The names and values of all password fields and limits entry attributes are listed.
-x: Output all values and structure field names of all limits entry attributes in hexadecimal. This form of output is intended for diagnostic support only.
-l: Interpret all user arguments as login names only. This option is mutually exclusive with -u.
-u: Interpret all user arguments as numeric UIDs only. This option also allows the use of UIDs that are not listed in the password map. This option is mutually exclusive with -l.

OUTPUT

This is a brief explanation of the fields in the default report. All password fields are determined by finding the password fields of a UID that match the lnode's UID. Fields that correspond directly to lnode attributes are indicated by [attribute-name].

Login name:

The login name, from the password map.

Uid:

The UID of the lnode.

Gid:

The initial GID, from the password map.

R,Euid: R,Egid:

The real and effective UIDs and GIDs of the liminfo process. These fields only appear when no user arguments are given to liminfo, in which case the lnode is the one to which the process is attached.

Sgroup (uid):

The login name and UID of the scheduling group parent of the lnode [sgroup].

Shares:

The number of CPU shares with respect to the lnode's scheduling group parent and peers [cpu.shares].

Myshares:

The number of CPU shares with respect to the lnode's scheduling group children [cpu.myshares].

Share:

The calculated allocated share, which is the lnode's own fraction of the total shares of all currently active lnodes, expressed as a percentage. This percentage figure is the CPU share to which this lnode is entitled.

E-share:

The calculated effective share, which is the lnode's own fraction of the total usage of all currently active lnodes, expressed as a percentage. This percentage figure is the CPU share this lnode is actually getting.

Usage:

The current decayed CPU usage of the lnode [cpu.usage].

Accrued usage:

The accrued CPU usage (that is, never decayed) of the lnode [cpu.accrue].

Term usage:

The current decayed terminal connection time of the lnode.

Term accrued usage:

The accrued terminal connection time (that is, never decayed) of the lnode.

Term limit:

The terminal connection time limit.

Mem usage:

The total virtual memory usage/myusage of all processes currently attached to the lnode [memory.usage] [memory.myusage].

Mem limit:

The hard virtual memory limit [memory.limit].

Proc mem limit:

The hard per-process virtual memory limit [memory.plimit].

Mem accrue:

The accrued virtual memory usage [memory.accrue].

Last used:

The date/time at which the lnode was last active [lastused].

Directory:

The home directory, from the password map.

Name:

The comment, or gecos field, from the password map.

Shell:

The initial shell, from the password map.

Processes:

The number of processes attached to the limits entry/group [process.usage] [process.myusage].

Process limit:

The limit on the number of processes [process.limit].

Current logins:

The number of login header processes currently attached to the limits entry [logins].

Flags:

A list of all flags with names of the form flag.name, that evaluate to set [flag.uselimadm] [flag.nologin] [flag.onelogin] [flag.asynckill], and others. Only the name part of each flag is output, suffixed with one or more of the following symbols:

+: The flag evaluates to set
-: The flag evaluates to clear
*: The flag evaluates to group
^: The value is inherited

EXAMPLES

To display the current resource usages and limits:

liminfo

To have a dynamically updating report of current resource usages and limits:

liminfo -c

To display all the resource usages and limits of user1:

liminfo -v user1

ATTRIBUTES

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Architecture	SPARC
Availability	SUNWsrmb

NOTES

This man page is applicable to SunOS 5.6, SunOS 5.7, and SunOS 5.8.

SunOS 5.8 Last Revised 22 April 1999