l2tpns/docs/manpages/nsctl.8
Samuel Thibault 6be06966e3 Use Makefile rules to generate documentation
And regenerate documentation.
2023-12-24 15:42:03 +01:00

67 lines
1.9 KiB
Groff

.\" Automatically generated by Pandoc 3.0.1
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "NSCTL" "8" "January 31, 2021" "Manage running l2tpns instance" ""
.hy
.SH NAME
.PP
nsctl - manage running l2tpns instance
.SH SYNOPSIS
.PP
\f[B]nsctl\f[R] [\f[B]-d\f[R]] [\f[B]-h\f[R]
\f[I]host\f[R][:\f[I]port\f[R]]] [\f[B]-t\f[R] \f[I]timeout\f[R]]
\f[I]command\f[R] [\f[I]arg\f[R] ...]
.SH DESCRIPTION
.PP
\f[B]nsctl\f[R] sends commands to a running \f[B]l2tpns\f[R] process.
It provides both for the loading or unloading of plugins and also the
management of sessions via functions provided by those plugins.
.SH OPTIONS
.PP
\f[B]-d\f[R] Enable debugging output
.PP
\f[B]-h \f[BI]host\f[B][:\f[BI]port\f[B]]\f[R] The host running
\f[B]l2tpns\f[R] that should receive the message.
By default the message is sent to UDP port 1702 on \f[B]localhost\f[R]
.PP
\f[B]-t \f[BI]timeout\f[B]\f[R] Timeout in seconds to wait for a
response from the server
.SH COMMANDS
.PP
The first argument specifies the command to send to \f[B]l2tpns.\f[R]
The following commands are as defined:
.TP
\f[B]load_plugin \f[R]\f[I]plugin\f[R]
Load the named \f[I]plugin\f[R]
.TP
\f[B]unload_plugin \f[R]\f[I]plugin\f[R]
Unload the named \f[I]plugin\f[R]
.TP
\f[B]help\f[R]
Each loaded plugin is queried for what commands it supports and the
synopsis for each is output
.PP
Any other value of \f[I]command\f[R] (and \f[I]args\f[R] if any) are
sent to \f[B]l2tpns\f[R] as-is, to be passed to each plugin which
registers a \f[B]plugin_control\f[R] function in turn (in which it may
be acted upon).
.SH SEE ALSO
.PP
\f[B]l2tpns\f[R](8)
.SH AUTHORS
This manual page was written by Jonathan McDowell
<noodles@the.earth.li>, for the Debian GNU/Linux system (but may be used
by others).