| 1 |
.TH nl\-pktloc-lookup 8 "27 October 2010" "libnl" |
| 2 |
.SH NAME |
| 3 |
nl\-pktloc\-lookup - Lookup packet location definitions |
| 4 |
.SH SYNOPSIS |
| 5 |
.B nl\-pktloc\-lookup |
| 6 |
.I name |
| 7 |
.br |
| 8 |
.B nl\-pktloc\-lookup \-\-list |
| 9 |
|
| 10 |
.SH DESCRIPTION |
| 11 |
.PP |
| 12 |
nl\-pktloc\-lookup searches the packet location database for a matching |
| 13 |
entry. It is used to resolve packet location aliases to their definition, |
| 14 |
i.e. alignment, layer, offset, and mask. |
| 15 |
|
| 16 |
.SH OPTIONS |
| 17 |
.TP |
| 18 |
.BR \-\^h " or " \-\-help |
| 19 |
Print help text to console and exit. |
| 20 |
.TP |
| 21 |
.BR \-\^v " or " \-\-version |
| 22 |
Print versioning information to console and exit. |
| 23 |
.TP |
| 24 |
.BR \-\^l " or " \-\-list |
| 25 |
List all packet location definitions. |
| 26 |
.TP |
| 27 |
.BR \-\-u32=VALUE |
| 28 |
Prints the packet location definition in a special format that is |
| 29 |
understood by iproute2's u32 selector parser. It will output a |
| 30 |
u32 selector which will compare the provided value with the value |
| 31 |
specified by the packet location. |
| 32 |
|
| 33 |
Please note that due to the limitation of u32, it is not possible |
| 34 |
to use packet locations based on the link layer. nl-pktloc-lookup |
| 35 |
will print an error message in this case. |
| 36 |
|
| 37 |
Example: |
| 38 |
selector=$(nl-pktloc-lookup --u32 22 tcp.sport) |
| 39 |
tc filter add [...] u32 match $(selector) flowid 1:2 |
| 40 |
|
| 41 |
.SH FILES |
| 42 |
.PP |
| 43 |
/etc/libnl/pktloc |
| 44 |
|
| 45 |
.SH AUTHOR |
| 46 |
.PP |
| 47 |
Thomas Graf is the original author and current maintainer of libnl and |
| 48 |
libnl tools. Many people have contributed to it since. |