NAME
chudRemoteCtrl - start or stop the collection of performance monitor
data in a performance monitor remote server application.
SYNOPSIS
cchhuuddRReemmootteeCCttrrll [ -mm ] [ executable [args... ] ]
cchhuuddRReemmootteeCCttrrll -s label
cchhuuddRReemmootteeCCttrrll -e
cchhuuddRReemmootteeCCttrrll -k PID
DESCRIPTION
chudRemoteCtrl is a command line tool that allows for the collection of
performance data by any active performance monitor remote server appli-
cation. There are currently two CHUD Tools that can be put in remote
performance monitor server mode: MONster, and Shark (as well as their
command line counterparts). Typically, chudRemoteCtrl is invoked on the
command line or in a shell script, followed by the path to an exe-
cutable to be measured and its arguments. chudRemoteCtrl issues a
chudStartRemotePerfMonitor message immediately after launching the
specified target program. When the launched program terminates, chu-
dRemoteCtrl issues a chudStopRemotePerfMonitor message, and then exits.
When the '-s', '-e' or '-k PID' options are used, no program is
launched.
OOPPTTIIOONNSS
-rr seconds: If the 'chudStartRemotePerfMonitor' message fails to
either acquire or start the remote monitoring service, then keep
trying to start again, until the specified number of seconds has
elapsed. The same thing is true of the '-e' option. If there is
a '-r ' argument on the command line, and a failure
occurs trying to stop the remote profiling program, the stop
message will be sent again until the retry time limit is
reached.
-ss label: Issue a chudStartRemotePerfMonitor message with the spec-
ified label and exit. A 'label' is a string of up to 32 charac-
ters.
-ee Issue a chudStopRemotePerfMonitor message and exit.
-qq silence some of the non-essential warning and error output.
-kkPID Send a UNIX signal (SIGUSR1 to start profiling, SIGUSR2 to stop
profiling) to the specified process-id. For example, if a com-
mand-line profiling tool, is running as PID 4267, using ''-kk
44226677'' along with a ''-ss'' will send a SIGUSR1 to the command-line
profiling tool and it will start sampling, while ''-kk 44226677'' along
with a ''-ee'' will send a SIGUSR2 to the command-line profiling
tool and it will stop sampling. A 'start' example: % cchhuuddRReemmoo-
tteeCCttrrll -ss session42 -kk 4267. And a 'stop' example: % cchhuuddRReemmoo-
tteeCCttrrll -ee -kk 4267. The command-line CHUD tool 'shark' responds
to UNIX signals and toggles performance profiling. You can
repeatedly send '-s
gle profiling start or stop. Sending '-e -k ' to shark
will stop sampling (if it's running) and cause shark to EXIT.
-mm Set the performance monitor mark bit in the main thread of the
launched child process.
DIAGNOSTICS chudRemoteCtrl returns a zero (0) upon success and a non-zero value on
failure.
BUGS
Please send your comments, suggestions and bug reports to: perftools-
feedback@group.apple.com
SEE ALSO
monster(1), shark(1)
CHUD 6 October 2003 CHUDREMOTECTRL(1)