---
name: "lw-ctl"
section: "1"
platform: "linux"
package: "loadwatch"
version: "1.0+1.1alpha1-8"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/lw-ctl"
---

# lw-ctl(1)

send commands to a running loadwatch

## NAME

lw-ctl - send commands to a running **loadwatch**

## SYNOPSIS

**lw-ctl** *file* *command*

## DESCRIPTION

**lw-ctl** sends commands to a running **loadwatch**. You can instruct **loadwatch** to enter one of three states, **RUN**, **STOP**, or **WATCH**.

The parameters are:

- *file*

  The UNIX domain socket that **loadwatch** is listening to.

- *command*

  One of:

  - **RUN**

    Allow the child process to run regardless of system load.

  - **STOP**

    Suspend the child process regardless of system load.

  - **WATCH**

    Return to normal mode, where the system load determines if the program is allowed to run.

## SEE ALSO

[loadwatch(1)](/loadwatch/1.md)

## AUTHOR

This manual page was written by Nicolas Boullis \<nboullis@debian.org\>, for the Debian GNU/Linux system (but may be used by others).