extensions/libxt_LED.man

   1 This creates an LED-trigger that can then be attached to system indicator
   2 lights, to blink or illuminate them when certain packets pass through the
   3 system. One example might be to light up an LED for a few minutes every time
   4 an SSH connection is made to the local machine. The following options control
   5 the trigger behavior:
   6 .TP
   7 \fB\-\-led\-trigger\-id\fP \fIname\fP
   8 This is the name given to the LED trigger. The actual name of the trigger
   9 will be prefixed with "netfilter-".
  10 .TP
  11 \fB\-\-led-delay\fP \fIms\fP
  12 This indicates how long (in milliseconds) the LED should be left illuminated
  13 when a packet arrives before being switched off again. The default is 0
  14 (blink as fast as possible.) The special value \fIinf\fP can be given to
  15 leave the LED on permanently once activated. (In this case the trigger will
  16 need to be manually detached and reattached to the LED device to switch it
  17 off again.)
  18 .TP
  19 \fB\-\-led\-always\-blink\fP
  20 Always make the LED blink on packet arrival, even if the LED is already on.
  21 This allows notification of new packets even with long delay values (which
  22 otherwise would result in a silent prolonging of the delay time.)
  23 .TP
  24 Example:
  25 .TP
  26 Create an LED trigger for incoming SSH traffic:
  27 iptables \-A INPUT \-p tcp \-\-dport 22 \-j LED \-\-led\-trigger\-id ssh
  28 .TP
  29 Then attach the new trigger to an LED:
  30 echo netfilter\-ssh >/sys/class/leds/\fIledname\fP/trigger