tizen 2.3.1 release
[external/iptables.git] / extensions / libipt_ULOG.man
1 This is the deprecated ipv4-only predecessor of the NFLOG target.
2 It provides userspace logging of matching packets.  When this
3 target is set for a rule, the Linux kernel will multicast this packet
4 through a
5 .IR netlink 
6 socket. One or more userspace processes may then subscribe to various 
7 multicast groups and receive the packets.
8 Like LOG, this is a "non-terminating target", i.e. rule traversal
9 continues at the next rule.
10 .TP
11 \fB\-\-ulog\-nlgroup\fP \fInlgroup\fP
12 This specifies the netlink group (1-32) to which the packet is sent.
13 Default value is 1.
14 .TP
15 \fB\-\-ulog\-prefix\fP \fIprefix\fP
16 Prefix log messages with the specified prefix; up to 32 characters
17 long, and useful for distinguishing messages in the logs.
18 .TP
19 \fB\-\-ulog\-cprange\fP \fIsize\fP
20 Number of bytes to be copied to userspace.  A value of 0 always copies
21 the entire packet, regardless of its size.  Default is 0.
22 .TP
23 \fB\-\-ulog\-qthreshold\fP \fIsize\fP
24 Number of packet to queue inside kernel.  Setting this value to, e.g. 10
25 accumulates ten packets inside the kernel and transmits them as one
26 netlink multipart message to userspace.  Default is 1 (for backwards
27 compatibility).
28 .br