3 |
@c See file radius.texi for copying conditions. |
@c See file radius.texi for copying conditions. |
4 |
@comment ******************************************************************* |
@comment ******************************************************************* |
5 |
@node Radzap, Radgrep, Radlast, Utility Programs |
@node Radzap, Radgrep, Radlast, Utility Programs |
6 |
@section Radzap |
@section @command{radzap} |
7 |
@pindex radzap |
@pindex radzap |
8 |
@cindex Deleting hung user sessions |
@cindex Deleting hung user sessions |
9 |
|
|
10 |
@command{radzap} searches the Radius accounting database for matching login |
@command{radzap} searches the Radius accounting database for matching login |
11 |
records and closes them. |
records and closes them. |
12 |
|
|
13 |
At least one of @option{-n}, @option{-p} options or username must be |
At least one of the options @option{-n}, @option{-p}, or the user name must be |
14 |
specified. If they are used in conjunction, they are taken as if |
specified. If they are used in conjunction, they are taken as if |
15 |
joined by logical @sc{and} operation. |
joined by the logical @sc{and} operation. |
16 |
|
|
17 |
@samp{radzap} operates in two modes: silent and confirm. The silent |
@command{radzap} operates in two modes: silent and confirm. The silent |
18 |
mode is enabled by default. When run in this mode, radzap deletes |
mode is enabled by default. When run in this mode, @command{radzap} deletes |
19 |
every record that matched the search conditions given. |
every record that matches the search conditions given. |
20 |
|
|
21 |
In confirm mode @samp{radzap} will ask for a confirmation |
In confirm mode @command{radzap} will ask for a confirmation |
22 |
before zapping each matching record. Every line beginning with a @samp{y} |
before zapping each matching record. Any line beginning with a @samp{y} |
23 |
is taken as positive response, otherwise it is taken as negative |
is taken as a positive response; any other line is taken as a negative |
24 |
response. |
response. |
25 |
|
|
26 |
The confirm mode is toggled by the command line option @option{-c}. |
The confirm mode is toggled by the command line option @option{-c}. |
28 |
@subheading Syntax |
@subheading Syntax |
29 |
|
|
30 |
@example |
@example |
31 |
radzap [options] [username] |
radzap [@var{options}] [@var{username}] |
32 |
@end example |
@end example |
33 |
|
|
34 |
@noindent |
@noindent |
47 |
@file{@var{RADLOG}/radutmp}. |
@file{@var{RADLOG}/radutmp}. |
48 |
@item -l @var{dir} |
@item -l @var{dir} |
49 |
@itemx --log-directory @var{dir} |
@itemx --log-directory @var{dir} |
50 |
Search file @file{radutmp} in the given directory. @emph{Note}, that |
Search the file @file{radutmp} in the given directory. |
51 |
this option is deprecated. It is currently retained for backward |
|
52 |
|
This option is deprecated. It is currently retained for backward |
53 |
compatibility with previous versions. |
compatibility with previous versions. |
54 |
@item -q |
@item -q |
55 |
@itemx --quiet |
@itemx --quiet |
56 |
Disable confirm mode. |
Disable confirm mode. |
57 |
@item -h |
@item -h |
58 |
@itemx --help |
@itemx --help |
59 |
Display short help summary and exit. |
Display a short help summary, and exit. |
60 |
@item -n @var{name} |
@item -n @var{name} |
61 |
@itemx --nas @var{name} |
@itemx --nas @var{name} |
62 |
Specify @NAS{} name to zap user from. |
Specify @NAS{} name to zap user from. |
63 |
@item -p @var{port} |
@item -p @var{port} |
64 |
@itemx --port @var{port} |
@itemx --port @var{port} |
65 |
Specify the port number of the session to be zapped. The port number |
Specify the port number of the session to be zapped. The port number |
66 |
can be specified either in its full form, i.e @code{radzap -p S02} or in |
can be specified either in its full form, e.g. @code{radzap -p S02}, or in |
67 |
its short form, like @code{radzap -p 2}. |
its short form, e.g. @code{radzap -p 2}. |
68 |
|
|
69 |
@end table |
@end table |