tools/testing/selftests/bpf/prog_tests/lwt_helpers.h
Source file repositories/reference/linux-study-clean/tools/testing/selftests/bpf/prog_tests/lwt_helpers.h
File Facts
- System
- Linux kernel
- Corpus path
tools/testing/selftests/bpf/prog_tests/lwt_helpers.h- Extension
.h- Size
- 2733 bytes
- Lines
- 110
- Domain
- Support Tooling And Documentation
- Bucket
- tools
- Inferred role
- Support Tooling And Documentation: implementation source
- Status
- source implementation candidate
Why This File Exists
Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.
- Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
time.hnet/if.hlinux/icmp.htest_progs.h
Detected Declarations
function netns_createfunction netns_deletefunction __expect_icmp_ipv4function wait_for_packet
Annotated Snippet
if (ASSERT_OK(netns_create(), "netns_create")) { \
struct nstoken *token = open_netns(NETNS); \
if (ASSERT_OK_PTR(token, "setns")) { \
test_ ## name(); \
close_netns(token); \
} \
netns_delete(); \
} \
})
static inline int netns_create(void)
{
return system("ip netns add " NETNS);
}
static inline int netns_delete(void)
{
return system("ip netns del " NETNS ">/dev/null 2>&1");
}
#define ICMP_PAYLOAD_SIZE 100
/* Match an ICMP packet with payload len ICMP_PAYLOAD_SIZE */
static int __expect_icmp_ipv4(char *buf, ssize_t len)
{
struct iphdr *ip = (struct iphdr *)buf;
struct icmphdr *icmp = (struct icmphdr *)(ip + 1);
ssize_t min_header_len = sizeof(*ip) + sizeof(*icmp);
if (len < min_header_len)
return -1;
if (ip->protocol != IPPROTO_ICMP)
return -1;
if (icmp->type != ICMP_ECHO)
return -1;
return len == ICMP_PAYLOAD_SIZE + min_header_len;
}
typedef int (*filter_t) (char *, ssize_t);
/* wait_for_packet - wait for a packet that matches the filter
*
* @fd: tun fd/packet socket to read packet
* @filter: filter function, returning 1 if matches
* @timeout: timeout to wait for the packet
*
* Returns 1 if a matching packet is read, 0 if timeout expired, -1 on error.
*/
static int wait_for_packet(int fd, filter_t filter, struct timeval *timeout)
{
char buf[4096];
int max_retry = 5; /* in case we read some spurious packets */
fd_set fds;
FD_ZERO(&fds);
while (max_retry--) {
/* Linux modifies timeout arg... So make a copy */
struct timeval copied_timeout = *timeout;
ssize_t ret = -1;
FD_SET(fd, &fds);
ret = select(1 + fd, &fds, NULL, NULL, &copied_timeout);
if (ret <= 0) {
if (errno == EINTR)
continue;
else if (errno == EAGAIN || ret == 0)
return 0;
log_err("select failed");
return -1;
}
ret = read(fd, buf, sizeof(buf));
if (ret <= 0) {
log_err("read(dev): %ld", ret);
return -1;
}
if (filter && filter(buf, ret) > 0)
return 1;
}
return 0;
}
Annotation
- Immediate include surface: `time.h`, `net/if.h`, `linux/icmp.h`, `test_progs.h`.
- Detected declarations: `function netns_create`, `function netns_delete`, `function __expect_icmp_ipv4`, `function wait_for_packet`.
- Atlas domain: Support Tooling And Documentation / tools.
- Implementation status: source implementation candidate.
Implementation Notes
- This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
- Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
- Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.