xref: /aosp_15_r20/external/iptables/extensions/libipt_ULOG.man (revision a71a954618bbadd4a345637e5edcf36eec826889)
1*a71a9546SAutomerger Merge WorkerThis is the deprecated ipv4-only predecessor of the NFLOG target.
2*a71a9546SAutomerger Merge WorkerIt provides userspace logging of matching packets.  When this
3*a71a9546SAutomerger Merge Workertarget is set for a rule, the Linux kernel will multicast this packet
4*a71a9546SAutomerger Merge Workerthrough a
5*a71a9546SAutomerger Merge Worker.IR netlink
6*a71a9546SAutomerger Merge Workersocket. One or more userspace processes may then subscribe to various
7*a71a9546SAutomerger Merge Workermulticast groups and receive the packets.
8*a71a9546SAutomerger Merge WorkerLike LOG, this is a "non-terminating target", i.e. rule traversal
9*a71a9546SAutomerger Merge Workercontinues at the next rule.
10*a71a9546SAutomerger Merge Worker.TP
11*a71a9546SAutomerger Merge Worker\fB\-\-ulog\-nlgroup\fP \fInlgroup\fP
12*a71a9546SAutomerger Merge WorkerThis specifies the netlink group (1-32) to which the packet is sent.
13*a71a9546SAutomerger Merge WorkerDefault value is 1.
14*a71a9546SAutomerger Merge Worker.TP
15*a71a9546SAutomerger Merge Worker\fB\-\-ulog\-prefix\fP \fIprefix\fP
16*a71a9546SAutomerger Merge WorkerPrefix log messages with the specified prefix; up to 32 characters
17*a71a9546SAutomerger Merge Workerlong, and useful for distinguishing messages in the logs.
18*a71a9546SAutomerger Merge Worker.TP
19*a71a9546SAutomerger Merge Worker\fB\-\-ulog\-cprange\fP \fIsize\fP
20*a71a9546SAutomerger Merge WorkerNumber of bytes to be copied to userspace.  A value of 0 always copies
21*a71a9546SAutomerger Merge Workerthe entire packet, regardless of its size.  Default is 0.
22*a71a9546SAutomerger Merge Worker.TP
23*a71a9546SAutomerger Merge Worker\fB\-\-ulog\-qthreshold\fP \fIsize\fP
24*a71a9546SAutomerger Merge WorkerNumber of packet to queue inside kernel.  Setting this value to, e.g. 10
25*a71a9546SAutomerger Merge Workeraccumulates ten packets inside the kernel and transmits them as one
26*a71a9546SAutomerger Merge Workernetlink multipart message to userspace.  Default is 1 (for backwards
27*a71a9546SAutomerger Merge Workercompatibility).
28*a71a9546SAutomerger Merge Worker.br
29