PVRPerfServer Command-Line Options

PVRPerfServer supports several command-line options.

On Android these options are only accessible when running the PVRPerfServer CLI, not when using the Android APK. Most options are also available via the PVRTune GUI, if making a live connection to PVRPerfServer. This means that the APK cannot be used to write directly to a PVRTune file or execute a command.

Option	Effect
-h, --help	Show help text.
--version	Show version text.
--disable-hwperf	Disable the use of PVRScope’s hardware performance functionality.
--group	Expects an integer. On start-up, switch the hardware to the specified counter group number.
--periodic	Expects a 1 or a 0. Default is 1. Enable or disable periodic timing tasks when recording to a file.
--graphics	Expects a 1 or a 0. Default is 1. Enable or disable graphics timing tasks when recording to a file.
--DeviceStateChg	Expects a 1 or a 0. Default is 1. Enable or disable device state events when recording to a file.
--qat	Expects an integer as a time in seconds, after which PVRPerfServer will auto-quit.
--port	Expects an integer. Specify the network port to use. Defaults to 6520.
--sendto	Expects a string as a filename or path. Instead of using the network, record data directly to the specified file.
-t, --sample-time-ms	Expects an integer as a time in milliseconds between counter updates. Defaults to 5. Increase this value to reduce PVRPerfServer CPU usage.
-c, --cpu-load-time-ms	Expects an integer as a time in milliseconds between CPU load updates. Defaults to 200. Increase this value to reduce PVRPerfServer CPU usage.
--perfevents-sample-freq-hz	Expects an integer as a Frequency, in Hertz, to sample CPU HW counters. Defaults to 1000. Decrease this value to reduce PVRPerfServer CPU usage.
--pid	Gather data for CPU usage, memory usage, and PID executable name of relevant programs. Can optionally provide one or more integer parameters to track the specified PIDs.
--nopid	Disable gathering of per-PID data.
--exec	PVRPerfServer will run the specified command and auto-quit when it exits. For example --exec myapp, or --exec "myapp param0". If --qat is also specified, and the timer completes before the specified command does, then PVRPerfServer will attempt to stop the specified command (via SIGTERM or TerminateProcess()). Linux examples: This does not work, because a tilde character inside quotes will not be expanded by the shell: ./PVRPerfServer --exec "~/OGLES3Water -qaf=8" This does not work, because --exec needs the full command in quotes (and PVRPerfServer does not have a -qaf option): ./PVRPerfServer --exec ~/OGLES3Water -qaf=8 This does not work (it runs OGLES3Water but not with the -qaf=8 parameter), because bash -c needs the full command in quotes: ./PVRPerfServer --exec "bash -c ~/OGLES3Water -qaf=8" This works: ./PVRPerfServer --exec "bash -c \"~/OGLES3Water -qaf=8\""