profctl(1CC)

NAME | SYNOPSIS | DESCRIPTION | RESTRICTIONS | ATTRIBUTES | SEE ALSO

NAME

profctl- ChorusOS profiling control tool

SYNOPSIS

profctl -start [-oneshot] [-raten] [-ccact_namecact_id...] [-b[bact_name...]]
profctl -stop

DESCRIPTION

profctl is a target utility.

The profctl utility is a ChorusOS tool that controls the profiling of the CHORUS kernel and supervisor actors. It must be run as a Supervisor c_actor (see -S option of the arun C_INIT(1M) command).

The PROF(1CC) supervisor actor must be active on each site where profiling is needed.

The symbol table supervisor actor N_sym must be loaded and provide access to the symbol table of the specified components (the profiled components must either be using with the -k option of the arun C_INIT(1M) command, or they must be boot actors).

The options are:

-start

Start profiling. The options -start and -stop are mutually exclusive.

-c

Gives the list of profiled c_actors. The c_actor id of the c_actor is called cact_id. The c_actor is called cact_name

-b

Gives the list of profiled boot actors. The boot actor is called bact_name. The special keyword kern may be used to profile the CHORUS kernel.

At a minimum, the CHORUS kernel or one supervisor actor must be specified in the -start command.

-rate n

Sets the sampling period in microseconds. The profiler selects the closest sampling period permitted by the hardware. The selected sampling will be shownin the profiling report. The default sampling period is 1000 microseconds.

-oneshot

Sets the one shot sampling mode. If tise option is omitted, the default is the square mode.

-stop

Stop profiling. For each component currently being profiled, profctl creates a file of raw data results. The name of the file is the name of the profiled actor with a .prof suffix added. The raw file is created in the target's tmp directory. The raw data results file is a binary file that is designed to be processed by the profile report generator profrpg(1CC).

RESTRICTIONS

Results are unpredictable when several users create simultaneous profiling sessions on a CHORUS site.

ATTRIBUTES

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving

SEE ALSO

C_INIT(1M), PROF(1CC), profrpg(1CC)

NAME | SYNOPSIS | DESCRIPTION | RESTRICTIONS | ATTRIBUTES | SEE ALSO