---
name: "dlm_tool"
section: "8"
platform: "linux"
package: "dlm-controld"
version: "4.3.0-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/dlm_tool"
---

# dlm\_tool(8)

a utility for the dlm and dlm\_controld daemon

## NAME

dlm\_tool - a utility for the dlm and dlm\_controld daemon

## SYNOPSIS

**dlm\_tool** \[COMMAND\] \[OPTIONS\] \[ *name* \]

## COMMANDS

**ls**\
\
 	Display dlm\_controld internal lockspace state.

**status**\
\
 	Dump dlm\_controld daemon state.

**dump**\
\
 	Dump dlm\_controld debug buffer.

**dump\_config**\
\
 	Dump dlm\_controld config settings.

**reload\_config**\
\
 	Reload dlm\_controld config settings from dlm.conf.

**set\_config** *setting***=***value*\
\
 	Set dlm\_controld config settings in the currently running daemon.

**fence\_ack** *nodeid*\
\
 	Cancel a waiting fencing operation and consider it successful.

**log\_plock**\
\
 	Dump dlm\_controld plock debug buffer.

**plocks** *lockspace\_name*\
\
 	Dump posix locks from dlm\_controld for the lockspace.

**join** *lockspace\_name*\
\
 	Join a lockspace.

**leave** *lockspace\_name*\
\
 	Leave a lockspace.

**joinleave** *lockspace\_name*\
\
 	Join then immediately leave a lockspace (for testing only.)

**lockdebug** *lockspace\_name*\
\
 	Complete display of locks from the lockspace.

**lockdump** *lockspace\_name*\
\
 	Minimal display of locks from the lockspace (deprecated).

**run** *command*\
\
 	Run command and check for result (for lvmlockd only.)

**run\_start** *command*\
\
 	Run command and don't check for result.

**run\_check** *uuid*\
\
 	Check status of a command that was run.

**run\_cancel** *uuid*\
\
 	Cancel a command that was run and is not yet done.

**run\_list**\
\
 	Dump a list of running commands.

## OPTIONS

**-n** Show all node information from dlm\_tool ls.

**-d** 0\|1 Resource directory off/on in join, default 0

**-e** 0\|1 Exclusive create off/on in join, default 0

**-f** 0\|1 FS (filesystem) flag off/on in join, default 0

**-i** *sec* Seconds to wait in run\_check.

**-m** *mode* Permission mode for lockspace device (octal), default 0600

**-s** Summary following lockdebug output (experiemental)

**-v** Verbose lockdebug or status output

**-w** Wide lockdebug output

**-M** Include MSTCPY locks in lockdump output

**-h** Print help, then exit

**-V** Print program version information, then exit

## USAGE

### fence\_ack

See dlm\_tool status for information about waiting fencing operations for specific nodeid's.

### set\_config

dlm\_tool set\_config can change certain config settings in the currently running dlm\_controld.  Supported options:

```
daemon_debug
log_debug
debug_logfile
plock_debug
plock_rate_limit
drop_resources_time
drop_resources_count
drop_resources_age
post_join_delay
enable_quorum_fencing
enable_quorum_lockspace
repeat_failed_fencing
```

Special cases to revert a previous set\_config and restore the previous value (from default or dlm.conf):

**dlm\_tool set\_config** *setting*=**restore**\
 restores a single setting.

**dlm\_tool set\_config restore\_all**\
 restores all settings.

### dump\_config

A config setting may have been set from: the default, the dlm\_controld command line, dlm.conf at startup, dlm.conf from reload\_config, dlm\_tool set\_config.  The dump\_config output indicates how values were set:

- setting=value

  default value.

- setting=value (cli option)

  Set from a dlm\_controld command line option.

- setting=value (dlm.conf)

  Set from dlm.conf (at startup or reload.)

- setting=value (set\_config)

  Set from dlm\_tool set\_config.

## EXAMPLES

### dump\_config

```
$ dlm_tool dump_config | head -n 5
daemon_debug=1 (set_config)
foreground=0
log_debug=1 (dlm.conf)
protocol=detect
```

In this case, daemon\_debug is set by set\_config, log\_debug is set from dlm.conf, foreground and protocol are using default values.

### set\_config

```
$ dlm_tool dump_config | grep log_debug
log_debug=1 (dlm.conf)
$ dlm_tool set_config "log_debug=0"
set_config done
$ dlm_tool dump_config | grep log_debug
log_debug=0 (set_config)
$ dlm_tool set_config "log_debug=restore"
set_config done
$ dlm_tool dump_config | grep log_debug
log_debug=1 (dlm.conf)
```

log\_debug is set by dlm.conf (value is 1), then run set\_config to change to 0, then use restore to restore to dlm.conf setting.

### set\_config

```
$ dlm_tool dump_config | grep _debug
daemon_debug=0
log_debug=1 (dlm.conf)
plock_debug=0
$ dlm_tool set_config "daemon_debug=1 log_debug=1 plock_debug=1"
set_config done
$ dlm_tool dump_config | grep _debug
daemon_debug=1 (set_config)
log_debug=1 (set_config)
plock_debug=1 (set_config)
$ dlm_tool set_config "restore_all"
set_config done
$ dlm_tool dump_config | grep _debug
daemon_debug=0
log_debug=1 (dlm.conf)
plock_debug=0
```

## SEE ALSO

[**dlm\_controld**(8)](/dlm_controld/8.md), [**dlm.conf**(5)](/dlm.conf/5.md)