2021-02-08 20:08:45 +00:00
|
|
|
perf-daemon(1)
|
|
|
|
|
==============
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
NAME
|
|
|
|
|
----
|
|
|
|
|
perf-daemon - Run record sessions on background
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
|
--------
|
|
|
|
|
[verse]
|
|
|
|
|
'perf daemon'
|
|
|
|
|
'perf daemon' [<options>]
|
|
|
|
|
'perf daemon start' [<options>]
|
2021-02-08 20:08:56 +00:00
|
|
|
'perf daemon stop' [<options>]
|
2021-02-08 20:08:55 +00:00
|
|
|
'perf daemon signal' [<options>]
|
2021-02-08 20:08:59 +00:00
|
|
|
'perf daemon ping' [<options>]
|
2021-02-08 20:08:45 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
|
-----------
|
|
|
|
|
This command allows to run simple daemon process that starts and
|
|
|
|
|
monitors configured record sessions.
|
|
|
|
|
|
2021-02-08 20:08:50 +00:00
|
|
|
You can imagine 'perf daemon' of background process with several
|
|
|
|
|
'perf record' child tasks, like:
|
|
|
|
|
|
|
|
|
|
# ps axjf
|
|
|
|
|
...
|
|
|
|
|
1 916507 ... perf daemon start
|
|
|
|
|
916507 916508 ... \_ perf record --control=fifo:control,ack -m 10M -e cycles --overwrite --switch-output -a
|
|
|
|
|
916507 916509 ... \_ perf record --control=fifo:control,ack -m 20M -e sched:* --overwrite --switch-output -a
|
|
|
|
|
|
|
|
|
|
Not every 'perf record' session is suitable for running under daemon.
|
|
|
|
|
User need perf session that either produces data on query, like the
|
|
|
|
|
flight recorder sessions in above example or session that is configured
|
|
|
|
|
to produce data periodically, like with --switch-output configuration
|
|
|
|
|
for time and size.
|
2021-02-08 20:08:45 +00:00
|
|
|
|
2021-02-08 20:08:58 +00:00
|
|
|
Each session is started with control setup (with perf record --control
|
|
|
|
|
options).
|
|
|
|
|
|
2021-02-08 20:08:45 +00:00
|
|
|
OPTIONS
|
|
|
|
|
-------
|
|
|
|
|
-v::
|
|
|
|
|
--verbose::
|
|
|
|
|
Be more verbose.
|
|
|
|
|
|
2021-02-08 20:08:46 +00:00
|
|
|
--config=<PATH>::
|
|
|
|
|
Config file path. If not provided, perf will check system and default
|
|
|
|
|
locations (/etc/perfconfig, $HOME/.perfconfig).
|
|
|
|
|
|
2021-02-08 20:08:47 +00:00
|
|
|
--base=<PATH>::
|
|
|
|
|
Base directory path. Each daemon instance is running on top
|
2021-02-08 20:08:57 +00:00
|
|
|
of base directory. Only one instance of server can run on
|
|
|
|
|
top of one directory at the time.
|
2021-02-08 20:08:47 +00:00
|
|
|
|
2021-02-08 20:08:45 +00:00
|
|
|
All generic options are available also under commands.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
START COMMAND
|
|
|
|
|
-------------
|
|
|
|
|
The start command creates the daemon process.
|
|
|
|
|
|
2021-02-08 20:08:52 +00:00
|
|
|
-f::
|
|
|
|
|
--foreground::
|
|
|
|
|
Do not put the process in background.
|
|
|
|
|
|
2021-02-08 20:08:45 +00:00
|
|
|
|
2021-02-08 20:08:56 +00:00
|
|
|
STOP COMMAND
|
|
|
|
|
------------
|
|
|
|
|
The stop command stops all the session and the daemon process.
|
|
|
|
|
|
|
|
|
|
|
2021-02-08 20:08:55 +00:00
|
|
|
SIGNAL COMMAND
|
|
|
|
|
--------------
|
|
|
|
|
The signal command sends signal to configured sessions.
|
|
|
|
|
|
|
|
|
|
--session::
|
|
|
|
|
Send signal to specific session.
|
|
|
|
|
|
|
|
|
|
|
2021-02-08 20:08:59 +00:00
|
|
|
PING COMMAND
|
|
|
|
|
------------
|
|
|
|
|
The ping command sends control ping to configured sessions.
|
|
|
|
|
|
|
|
|
|
--session::
|
|
|
|
|
Send ping to specific session.
|
|
|
|
|
|
|
|
|
|
|
2021-02-08 20:08:50 +00:00
|
|
|
CONFIG FILE
|
|
|
|
|
-----------
|
|
|
|
|
The daemon is configured within standard perf config file by
|
|
|
|
|
following new variables:
|
|
|
|
|
|
|
|
|
|
daemon.base:
|
|
|
|
|
Base path for daemon data. All sessions data are
|
|
|
|
|
stored under this path.
|
|
|
|
|
|
|
|
|
|
session-<NAME>.run:
|
|
|
|
|
Defines new record session. The value is record's command
|
|
|
|
|
line without the 'record' keyword.
|
|
|
|
|
|
|
|
|
|
Each perf record session is run in daemon.base/<NAME> directory.
|
|
|
|
|
|
|
|
|
|
|
2021-02-08 20:08:45 +00:00
|
|
|
SEE ALSO
|
|
|
|
|
--------
|
|
|
|
|
linkperf:perf-record[1], linkperf:perf-config[1]
|
