General options are described in lttng(1).
Domain
One of:
-j, --jul
Create or enable event rules in the java.util.logging (JUL)
domain.
-k, --kernel
Create or enable event rules in the Linux kernel domain.
-l, --log4j
Create or enable event rules in the Apache log4j domain.
-p, --python
Create or enable event rules in the Python domain.
-u, --userspace
Create or enable event rules in the user space domain.
Target
-c CHANNEL, --channel=CHANNEL
Create or enable event rules in the channel named CHANNEL
instead of the default channel name channel0.
-s SESSION, --session=SESSION
Create or enable event rules in the tracing session named
SESSION instead of the current tracing session.
Event source type
One of:
--function=SOURCE
Linux kernel kretprobe. Only available with the --kernel
domain option. SOURCE is one of:
• Function address (0x prefix supported)
• Function symbol
• Function symbol and offset (SYMBOL+OFFSET format)
--probe=SOURCE
Linux kernel kprobe. Only available with the --kernel domain
option. SOURCE is one of:
• Address (0x prefix supported)
• Symbol
• Symbol and offset (SYMBOL+OFFSET format)
--syscall
Linux kernel system call. Only available with the --kernel
domain option.
--tracepoint
Linux kernel or application tracepoint (default).
Log level
One of:
--loglevel=LOGLEVEL
Add log level condition to the event rule: the event source's
defined log level must be at least as severe as LOGLEVEL. See
the Log levels section above for the available log levels.
Only available with application domains.
--loglevel-only=LOGLEVEL
Add log level condition to the event rule: the event source's
defined log level must match LOGLEVEL. See the Log levels
section above for the available log levels. Only available
with application domains.
Filtering and exclusion
-x EVENT[,EVENT]..., --exclude=EVENT[,EVENT]...
Exclude events named EVENT from the event rule. This option
can be used when the command's EVENT argument contains at
least one wildcard star (*) to exclude specific names. EVENT
can also contain wildcard stars. To use a literal ,
character, use \,. Only available with the --userspace
domain.
-f EXPR, --filter=EXPR
Add filter expression condition to the event rule. Expression
EXPR must evaluate to true when executed against the dynamic
values of event fields. See the Filter expression section
above for more information.
Shortcuts
-a, --all
Equivalent to an EVENT argument named * (wildcard) when also
using the --tracepoint (default) or --syscall option.
Program information
-h, --help
Show command help.
This option, like lttng-help(1), attempts to launch
/usr/bin/man to view the command's man page. The path to the
man pager can be overridden by the LTTNG_MAN_BIN_PATH
environment variable.
--list-options
List available command options.
