contrib/blacklist/bin/blacklistctl.8

   1 .\" $NetBSD: blacklistctl.8,v 1.7 2015/04/30 06:20:43 riz Exp $
   2 .\"
   3 .\" Copyright (c) 2015 The NetBSD Foundation, Inc.
   4 .\" All rights reserved.
   5 .\"
   6 .\" This code is derived from software contributed to The NetBSD Foundation
   7 .\" by Christos Zoulas.
   8 .\"
   9 .\" Redistribution and use in source and binary forms, with or without
  10 .\" modification, are permitted provided that the following conditions
  11 .\" are met:
  12 .\" 1. Redistributions of source code must retain the above copyright
  13 .\"    notice, this list of conditions and the following disclaimer.
  14 .\" 2. Redistributions in binary form must reproduce the above copyright
  15 .\"    notice, this list of conditions and the following disclaimer in the
  16 .\"    documentation and/or other materials provided with the distribution.
  17 .\"
  18 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
  19 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
  20 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  21 .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
  22 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  23 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  24 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  25 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  26 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  27 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  28 .\" POSSIBILITY OF SUCH DAMAGE.
  29 .\"
  30 .Dd April 29, 2015
  31 .Dt BLACKLISTCTL 8
  32 .Os
  33 .Sh NAME
  34 .Nm blacklistctl
  35 .Nd display and change the state of blacklistd
  36 .Sh SYNOPSIS
  37 .Nm
  38 .Cm dump
  39 .Op Fl abdnrw
  40 .Sh DESCRIPTION
  41 .Nm
  42 is a program used to display the state of
  43 .Xr blacklistd 8
  44 .Pp
  45 The following options are available:
  46 .Bl -tag -width indent
  47 .It Fl a
  48 Show all database entries, by default it shows only the embryonic ones.
  49 .It Fl b
  50 Show only the blocked entries.
  51 .It Fl d
  52 Increase debugging level.
  53 .It Fl n
  54 Don't display a header.
  55 .It Fl r
  56 Show the remaining blocked time instead of the last activity time.
  57 .It Fl w
  58 Normally the width of addresses is good for IPv4, the
  59 .Fl w
  60 flag, makes the display wide enough for IPv6 addresses.
  61 .El
  62 .Sh SEE ALSO
  63 .Xr blacklistd 8
  64 .Sh NOTES
  65 Sometimes the reported number of failed attempts can exceed the number
  66 of attempts that
  67 .Xr blacklistd 8
  68 is configured to block.
  69 This can happen either because the rule has been removed manually, or
  70 because there were more attempts in flight while the rule block was being
  71 added.
  72 This condition is normal; in that case
  73 .Xr blacklistd 8
  74 will first attempt to remove the existing rule, and then it will re-add
  75 it to make sure that there is only one rule active.
  76 .Sh HISTORY
  77 .Nm
  78 appeared in
  79 .Nx 7 .
  80 .Sh AUTHORS
  81 .An Christos Zoulas