| lh | 9ed821d | 2023-04-07 01:36:19 -0700 | [diff] [blame^] | 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. |