blob: 66f0b973960ac9c5b223d0ec4be38c7b7c1b4b30 [file] [log] [blame]
Patrick McHardye29da4e2007-11-26 06:49:08 +00001This target provides logging of matching packets. When this target is
2set for a rule, the Linux kernel will pass the packet to the loaded
3logging backend to log the packet. This is usually used in combination
4with nfnetlink_log as logging backend, which will multicast the packet
5through a
6.IR netlink
7socket to the specified multicast group. One or more userspace processes
8may subscribe to the group to receive the packets. Like LOG, this is a
9non-terminating target, i.e. rule traversal continues at the next rule.
10.TP
Jan Engelhardtfea74bf2009-01-12 04:53:18 +010011\fB\-\-nflog\-group\fP \fInlgroup\fP
Jan Engelhardt352ccfb2009-08-20 17:15:22 +020012The netlink group (1 \- 2^32\-1) to which packets are (only applicable for
Patrick McHardye29da4e2007-11-26 06:49:08 +000013nfnetlink_log). The default value is 0.
14.TP
Jan Engelhardtfea74bf2009-01-12 04:53:18 +010015\fB\-\-nflog\-prefix\fP \fIprefix\fP
Patrick McHardye29da4e2007-11-26 06:49:08 +000016A prefix string to include in the log message, up to 64 characters
17long, useful for distinguishing messages in the logs.
18.TP
Jan Engelhardtfea74bf2009-01-12 04:53:18 +010019\fB\-\-nflog\-range\fP \fIsize\fP
Patrick McHardye29da4e2007-11-26 06:49:08 +000020The number of bytes to be copied to userspace (only applicable for
21nfnetlink_log). nfnetlink_log instances may specify their own
22range, this option overrides it.
23.TP
Jan Engelhardtfea74bf2009-01-12 04:53:18 +010024\fB\-\-nflog\-threshold\fP \fIsize\fP
Patrick McHardye29da4e2007-11-26 06:49:08 +000025Number of packets to queue inside the kernel before sending them
26to userspace (only applicable for nfnetlink_log). Higher values
27result in less overhead per packet, but increase delay until the
28packets reach userspace. The default value is 1.
29.BR