Manpage of SESSIONS

SESSIONS

Section: User Commands (1) Updated: Feb 10, 1992 Return to Library's README

NAME

sessions -- print active sessions in a trace

SYNOPSIS

sessions [ -v ] [ -d ] [ -f filterfile ] [ -i interval ] [ -s session ]
         [ -g gap ] [ -a activity ] file

DESCRIPTION

sessions locates active periods in the trace file. A session is composed of intervals of time of a specified activity level (measured by number of operations in the interval), possibly including a number of intervals below that activity level, or gaps. By default, the length of an interval is 900 seconds (15 minutes), and a session in composed of 16 intervals (4 hours). An active session has at least 16 operations per interval, but it may have gaps of up to 4 intervals that fall under that level. These settings will locate long stretches of fairly low activity. All are parameters, and are listed in the options below.

The set of operations used to determine activity is a subset of the opcodes in a trace. That subset is open, close, unlink, creat, chmod, rename, rmdir, link, chown, mkdir, symlink, truncate, utimes, stat, lstat, access, readlink, lookup, getsymlink, and root. These are further divided into mutations and nonmutations for the purposes of reporting.

OPTIONS

: -a activity The desired activity level, in operations per interval. The set of operations is defined above. This is a thresholding parameter. The default is 16.
: -d Prints library debugging information. Lots of it.
: -f filterfile Apply the filter in filterfile to the trace.
: -g gap Maximum length of a gap allowable in an active session, in intervals. Default is 4.
: -i interval Length of an interval, in seconds. Default is 900.
: -s session Length of a session, in intervals. Default is 16.
: -v Verbose mode. Prints information on what the library is doing.

DIAGNOSTICS

The following are frequently encountered errors:

can't process file file -- the file wasn't there or if a filter file was specified, it couldn't be applied.

AUTHOR

Initial version by James Jay Kistler. Updated by Lily B. Mummert.

This document was created on Time: 05:25:52 GMT, October 10, 1998