---
name: "lttng-disable-event"
section: "1"
platform: "linux"
package: "lttng-tools"
version: "2.13.15-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/lttng-disable-event"
---

# lttng-disable-event(1)

Disable LTTng recording event rules

## NAME

lttng-disable-event - Disable LTTng recording event rules

## SYNOPSIS

Disable one or more recording event rules matching Linux kernel events:

```
lttng [GENERAL OPTIONS] disable-event --kernel
      [--tracepoint | --syscall | --probe | --function]
      (--all-events | NAME[,NAME]...)
      [--session=SESSION] [--channel=CHANNEL]
```

Disable one or more recording event rules matching user space tracepoint or Java/Python logging events:

```
lttng [GENERAL OPTIONS] disable-event
      (--userspace | --jul | --log4j | --python) [--tracepoint]
      (--all-events | NAME[,NAME]...)
      [--session=SESSION] [--channel=CHANNEL]
```

## DESCRIPTION

The **lttng disable-event** command disables one or more enabled recording event rules previously created with the [**lttng-enable-event**(1)](/lttng-enable-event/1.md) command which belong to:

With the **--session**=*SESSION* option

The recording session named *SESSION*.

Without the **--session** option

The current recording session (see [**lttng-concepts**(7)](/lttng-concepts/7.md) to learn more about the current recording session).

With the **--channel**=*CHANNEL* option

The channel named *CHANNEL*.

Without the **--channel** option

The channel named **channel0**.

If there’s more than one channel for the selected recording session and domain, the **disable-event** command fails.

See [**lttng-concepts**(7)](/lttng-concepts/7.md) to learn more about recording event rules.

As of LTTng 2.13.15, the **disable-event** command can only find recording event rules to disable by their instrumentation point type and event name conditions. Therefore, you cannot disable recording event rules having a specific instrumentation point log level condition, for example.

With the **--kernel** option and no instrumentation point type condition option, the **disable-event** command disables one or more Linux kernel recording event rules regardless of their instrumentation point type.

List the recording event rules of a given recording session and/or channel with the [**lttng-list**(1)](/lttng-list/1.md) command.

Without the **--all-events** option, the **disable-event** command disables one recording event rule per *NAME* argument. *NAME* is the exact event name condition pattern of the recording event rule to disable, as listed in the output of **lttng list** (see [**lttng-list**(1)](/lttng-list/1.md)).

You may disable an enabled recording event rule regardless of the activity (started or stopped) of its recording session (see [**lttng-start**(1)](/lttng-start/1.md) and [**lttng-stop**(1)](/lttng-stop/1.md)).

See the “EXAMPLES” section below for usage examples.

## OPTIONS

See [**lttng**(1)](/lttng/1.md) for *GENERAL OPTIONS*.

### Tracing domain

One of:

- **-j**, **--jul**

  Disable recording event rules in the **java.util.logging** (JUL) domain.

- **-k**, **--kernel**

  Disable recording event rules in the Linux kernel domain.

- **-l**, **--log4j**

  Disable recording event rules in the Apache log4j domain.

- **-p**, **--python**

  Disable recording event rules in the Python domain.

- **-u**, **--userspace**

  Disable recording event rules in the user space tracing domain.

### Recording target

- **-c** *CHANNEL*, **--channel**=*CHANNEL*

  Disable recording event rules attached to the channel named *CHANNEL* instead of **channel0**.

- **-s** *SESSION*, **--session**=*SESSION*

  Disable recording event rules in the recording session named *SESSION* instead of the current recording session.

### Instrumentation point type condition

At most one of:

- **--function**

  Only disable recording event rules which match Linux kretprobe events.

  Only available with the **--kernel** option.

- **--probe**

  Only disable recording event rules which match Linux kprobe events.

  Only available with the **--kernel** option.

- **--syscall**

  Only disable recording event rules which match Linux system call events.

  Only available with the **--kernel** option.

- **--tracepoint**

  Only disable recording event rules which match:

  With the **--kernel** or **--userspace** option

  LTTng tracepoint events.

  With the **--jul**, **--log4j**, or **--python** option

  Logging events.

### Event name condition

- **-a**, **--all-events**

  Disable recording event rules regardless of their event name condition.

### Program information

- **-h**, **--help**

  Show help.

  This option attempts to launch **/usr/bin/man** to view this manual page. Override the manual pager path with the **LTTNG\_MAN\_BIN\_PATH** environment variable.

- **--list-options**

  List available command options and quit.

## EXIT STATUS

**0**

Success

**1**

Command error

**2**

Undefined command

**3**

Fatal error

**4**

Command warning (something went wrong during the command)

## ENVIRONMENT

**LTTNG\_ABORT\_ON\_ERROR**

Set to **1** to abort the process after the first error is encountered.

**LTTNG\_HOME**

Path to the LTTng home directory.

Defaults to **$HOME**.

Useful when the Unix user running the commands has a non-writable home directory.

**LTTNG\_MAN\_BIN\_PATH**

Absolute path to the manual pager to use to read the LTTng command-line help (with [**lttng-help**(1)](/lttng-help/1.md) or with the **--help** option) instead of **/usr/bin/man**.

**LTTNG\_SESSION\_CONFIG\_XSD\_PATH**

Path to the directory containing the **session.xsd** recording session configuration XML schema.

**LTTNG\_SESSIOND\_PATH**

Absolute path to the LTTng session daemon binary (see [**lttng-sessiond**(8)](/lttng-sessiond/8.md)) to spawn from the [**lttng-create**(1)](/lttng-create/1.md) command.

The **--sessiond-path** general option overrides this environment variable.

## FILES

**$LTTNG\_HOME/.lttngrc**

Unix user’s LTTng runtime configuration.

This is where LTTng stores the name of the Unix user’s current recording session between executions of [**lttng**(1)](/lttng/1.md). [**lttng-create**(1)](/lttng-create/1.md) and [**lttng-set-session**(1)](/lttng-set-session/1.md) set the current recording session.

**$LTTNG\_HOME/lttng-traces**

Default output directory of LTTng traces in local and snapshot modes.

Override this path with the **--output** option of the [**lttng-create**(1)](/lttng-create/1.md) command.

**$LTTNG\_HOME/.lttng**

Unix user’s LTTng runtime and configuration directory.

**$LTTNG\_HOME/.lttng/sessions**

Default directory containing the Unix user’s saved recording session configurations (see [**lttng-save**(1)](/lttng-save/1.md) and [**lttng-load**(1)](/lttng-load/1.md)).

**/etc/lttng/sessions**

Directory containing the system-wide saved recording session configurations (see [**lttng-save**(1)](/lttng-save/1.md) and [**lttng-load**(1)](/lttng-load/1.md)).

**Note**\

**$LTTNG\_HOME** defaults to the value of the **HOME** environment variable.

## EXAMPLES

**Example 1. Disable all Linux kernel tracepoint recording event rules in the default channel of the current recording session.**

See the **--all-events** option.

```
$ lttng disable-event --kernel --tracepoint --all-events
```

**Example 2. Disable specific Apache log4j recording event rules in the default channel of a specific recording session.**

See the **--session** option.

```
$ lttng disable-event --session=my-session --log4j \
                      MySingleton,MyProxy,MyFacade
```

**Example 3. Disable all user space recording event rules in a specific channel of the current recording session.**

See the **--channel** option.

```
$ lttng disable-event --channel=my-channel --userspace \
                      --all-events
```

**Example 4. Disable specific Linux kernel system call recording event rules in the default channel of the current recording session.**

```
$ lttng disable-event --kernel --syscall pipe2,eventfd
```

## RESOURCES

• LTTng project website \<https://lttng.org\>

• LTTng documentation \<https://lttng.org/docs\>

• LTTng bug tracker \<https://bugs.lttng.org\>

• Git repositories \<https://git.lttng.org\>

• GitHub organization \<https://github.com/lttng\>

• Continuous integration \<https://ci.lttng.org/\>

• Mailing list \<https://lists.lttng.org/\> for support and development: **lttng-dev@lists.lttng.org**

• IRC channel \<irc://irc.oftc.net/lttng\>: **#lttng** on **irc.oftc.net**

## COPYRIGHT

This program is part of the LTTng-tools project.

LTTng-tools is distributed under the GNU General Public License version 2 \<http://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html\>. See the **LICENSE** \<https://github.com/lttng/lttng-tools/blob/master/LICENSE\> file for details.

## THANKS

Special thanks to Michel Dagenais and the DORSAL laboratory \<http://www.dorsal.polymtl.ca/\> at École Polytechnique de Montréal for the LTTng journey.

Also thanks to the Ericsson teams working on tracing which helped us greatly with detailed bug reports and unusual test cases.

## SEE ALSO

[**lttng**(1)](/lttng/1.md), [**lttng-enable-event**(1)](/lttng-enable-event/1.md), [**lttng-list**(1)](/lttng-list/1.md), [**lttng-concepts**(7)](/lttng-concepts/7.md)