ec2d7dfcba3769828a714464a08c6f2790c75d15
[l2tpns.git] / Docs / nsctl.8
1 .\" -*- nroff -*-
2 .de Id
3 .ds Dt \\$4 \\$5
4 ..
5 .Id $Id: nsctl.8,v 1.1 2004-11-17 08:23:35 bodea Exp $
6 .TH NSCTL 8 "\*(Dt" L2TPNS "System Management Commands"
7 .SH NAME
8 nsctl \- Issue commands to l2tpns plugins
9 .SH SYNOPSIS
10 .B nsctl
11 .RB [ \-d ]
12 .RB [ \-h
13 .IR host [: port ]]
14 .RB [ \-t
15 .IR timeout ]
16 .I command
17 .RI [ arg " ...]"
18 .SH DESCRIPTION
19 .B nsctl
20 is part of the
21 .B l2tpns
22 package.  It allows the system administrator to send manage plugin
23 features of a running l2tpns process.
24 .SH OPTIONS
25 .TP
26 .B \-d
27 Enable debugging output.
28 .TP
29 .B \-h \fIhost\fR[:\fIport\fR]
30 The host running
31 .B l2tpns
32 that should receive the message.  By default the message is sent to
33 UDP port 1702 on
34 .BR localhost .
35 .TP
36 .B \-t \fItimeout\fR
37 Timeout in seconds to wait for a response from the server.
38 .SH COMMANDS
39 The first argument specifies the command to send to
40 .B l2tpns .
41 The following commands are as defined:
42 .TP
43 .BI "load_plugin " plugin
44 Load the named
45 .IR plugin .
46 .TP
47 .BI "unload_plugin " plugin
48 Unload the named
49 .IR plugin .
50 .TP
51 .B help
52 Each loaded plugin is queried for what commands it supports and the
53 synopsis for each is output.
54 .PP
55 Any other value of
56 .I command
57 (and
58 .I args
59 if any)
60 are sent to
61 .B l2tpns
62 as-is, to be passed to each plugin in turn (and possibly acted upon).
63 .SH SEE ALSO
64 .BR l2tpns (8)
65 .SH AUTHOR
66 This manual page was written by Jonathan McDowell <noodles@the.earth.li>,
67 for the Debian GNU/Linux system (but may be used by others).