.\"	$OpenBSD: npppctl.8,v 1.6 2014/04/04 02:49:46 schwarze Exp $
.\"
.\" Copyright (c) 2012 Internet Initiative Japan Inc.
.\"
.\" Permission to use, copy, modify, and distribute this software for any
.\" purpose with or without fee is hereby granted, provided that the above
.\" copyright notice and this permission notice appear in all copies.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.Dd $Mdocdate: April 4 2014 $
.Dt NPPPCTL 8
.Os
.Sh NAME
.Nm npppctl
.Nd control npppd
.Sh SYNOPSIS
.Nm
.Op Fl n
.Op Fl s Ar socket
.Ar command
.Op Ar argument ...
.Sh DESCRIPTION
The
.Nm
utility controls
the
.Xr npppd 8
daemon.
.Pp
The options are as follows:
.Bl -tag -width Ds
.It Fl n
Show IP addresses instead of their hostnames.
.It Fl s Ar socket
Use
.Ar socket
instead of the default
.Pa /var/run/npppd.sock
to communicate with
.Xr npppd 8 .
.El
.Pp
The following commands are available:
.Bl -tag -width Ds
.It Cm clear all | Ar filter ...
Disconnect PPP sessions.
If
.Ar filter
is specified, only matching PPP sessions are disconnected.
If
.Cm all
is specified, all PPP sessions are disconnected.
See
.Cm session all
for the types of
.Ar filter .
.It Cm monitor all | Ar filter ...
Monitor start and stop of PPP sessions.
If
.Ar filter
is specified, only matching PPP sessions are monitored.
If
.Cm all
is specified, all PPP sessions are monitored.
See
.Cm session all
for the types of
.Ar filter .
.It Cm session all Op Ar filter ...
Show detailed information for PPP sessions.
If
.Ar filter
is specified, only matching PPP sessions are shown;
otherwise all PPP sessions are shown.
The following filters are available:
.Bl -tag -width Ds
.It Cm address Ar ip_address
Show or clear PPP sessions whose IP address match
.Ar ip_address .
.It Cm interface Ar interface_name
Show or clear PPP sessions that use the interface specified by
.Ar interface_name .
.It Cm ppp-id Ar id
Show or clear PPP sessions whose Ppp-Id match
.Ar id .
.It Cm protocol Ar protocol
Show or clear PPP sessions that use the tunneling protocol specified by
.Ar protocol .
.It Cm realm Ar realm_name
Show or clear PPP sessions whose realm match the specified
.Ar realm_name .
.It Cm username  Ar username
Show or clear PPP sessions whose username match
.Ar username .
.El
.It Cm session brief
Show brief information for all PPP sessions.
.It Cm session packets
Show I/O statistics for all PPP sessions.
.El
.\" .Sh ENVIRONMENT
.\" .Sh FILES
.\" .Sh EXAMPLES
.\" .Sh DIAGNOSTICS
.\" .Sh SEE ALSO
.\" .Xr npppd 8
.\" .Sh STANDARDS
.Sh HISTORY
The
.Nm
program first appeared in
.Ox
5.3.
.Sh AUTHORS
The
.Nm
program was written by Internet Initiative Japan Inc.
.\" .Sh CAVEATS
.\" .Sh BUGS