Adam Nielsen | 7cd3c2e | 2010-04-04 12:59:00 +0200 | [diff] [blame] | 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 |
Jan Engelhardt | fdc19be | 2010-06-04 14:08:58 +0200 | [diff] [blame] | 7 | \fB\-\-led\-trigger\-id\fP \fIname\fP |
Adam Nielsen | 7cd3c2e | 2010-04-04 12:59:00 +0200 | [diff] [blame] | 8 | This is the name given to the LED trigger. The actual name of the trigger |
| 9 | will be prefixed with "netfilter-". |
| 10 | .TP |
Jan Engelhardt | fdc19be | 2010-06-04 14:08:58 +0200 | [diff] [blame] | 11 | \fB\-\-led-delay\fP \fIms\fP |
Adam Nielsen | 7cd3c2e | 2010-04-04 12:59:00 +0200 | [diff] [blame] | 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 |
Jan Engelhardt | fdc19be | 2010-06-04 14:08:58 +0200 | [diff] [blame] | 19 | \fB\-\-led\-always\-blink\fP |
Adam Nielsen | 7cd3c2e | 2010-04-04 12:59:00 +0200 | [diff] [blame] | 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: |
Jan Engelhardt | fdc19be | 2010-06-04 14:08:58 +0200 | [diff] [blame] | 27 | iptables \-A INPUT \-p tcp \-\-dport 22 \-j LED \-\-led\-trigger\-id ssh |
Adam Nielsen | 7cd3c2e | 2010-04-04 12:59:00 +0200 | [diff] [blame] | 28 | .TP |
| 29 | Then attach the new trigger to an LED: |
Jan Engelhardt | fdc19be | 2010-06-04 14:08:58 +0200 | [diff] [blame] | 30 | echo netfilter\-ssh >/sys/class/leds/\fIledname\fP/trigger |