---
name: "npppctl"
section: "8"
platform: "openbsd"
package: "man"
version: "8.0-current-20261101"
release: "OpenBSD 8.0-current (2026-11-01)"
platforms: ["openbsd"]
url: "https://new.carta.tech/npppctl"
---

# npppctl(8)

control npppd

## NAME

**npppctl** – control npppd

## SYNOPSIS

**npppctl** \[**-n**\] \[**-s** *socket*\] *command* \[*argument* *...*\]

## DESCRIPTION

The **npppctl** utility controls the [npppd(8)](/npppd/8.md) daemon.

The options are as follows:

- **-n**

  Show IP addresses instead of their hostnames.

- **-s** *socket*

  Use *socket* instead of the default */var/run/npppd.sock* to communicate with [npppd(8)](/npppd/8.md).

The following commands are available:

- **clear** **all** \| *filter* *...*

  Disconnect PPP sessions. If *filter* is specified, only matching PPP sessions are disconnected. If **all** is specified, all PPP sessions are disconnected. See **session** **all** for the types of *filter*.

- **monitor** **all** \| *filter* *...*

  Monitor start and stop of PPP sessions. If *filter* is specified, only matching PPP sessions are monitored. If **all** is specified, all PPP sessions are monitored. See **session** **all** for the types of *filter*.

- **session** **all** \[*filter* *...*\]

  Show detailed information for PPP sessions. If *filter* is specified, only matching PPP sessions are shown; otherwise all PPP sessions are shown. The following filters are available:

  - **address** *ip\_address*

    Show or clear PPP sessions whose IP address match *ip\_address*.

  - **interface** *interface\_name*

    Show or clear PPP sessions that use the interface specified by *interface\_name*.

  - **ppp-id** *id*

    Show or clear PPP sessions whose Ppp-Id match *id*.

  - **protocol** *protocol*

    Show or clear PPP sessions that use the tunneling protocol specified by *protocol*.

  - **realm** *realm\_name*

    Show or clear PPP sessions whose realm match the specified *realm\_name*.

  - **username** *username*

    Show or clear PPP sessions whose username match *username*.

- **session** **brief**

  Show brief information for all PPP sessions.

- **session** **packets**

  Show I/O statistics for all PPP sessions.

## HISTORY

The **npppctl** program first appeared in OpenBSD 5.3.

## AUTHORS

The **npppctl** program was written by Internet Initiative Japan Inc.