npppctl(8)

npppctl8

Control npppd

Usage

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

Overview

The npppctl utility controls the npppd(8) 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).

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.

Releases

29 releases since OpenBSD 5.3; the text changed 1 time.

  1. 5.3–5.5
  2. 5.6–8.0

-r until OpenBSD 5.5; -t until OpenBSD 5.5.

History

The npppctl program first appeared in OpenBSD 5.3.

Authors

The npppctl program was written by Internet Initiative Japan Inc.

From man 8.0-current-20261101 in OpenBSD 8.0-current (2026-11-01). Parsed by carta from the page's mdoc source.