tools/testing/selftests/timens/futex.c
Source file repositories/reference/linux-study-clean/tools/testing/selftests/timens/futex.c
File Facts
- System
- Linux kernel
- Corpus path
tools/testing/selftests/timens/futex.c- Extension
.c- Size
- 2258 bytes
- Lines
- 113
- 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
sched.hlinux/unistd.hlinux/futex.hstdio.hstring.hsys/syscall.hsys/types.hsys/wait.htime.hunistd.hlog.htimens.h
Detected Declarations
function run_testfunction main
Annotated Snippet
// SPDX-License-Identifier: GPL-2.0
#define _GNU_SOURCE
#include <sched.h>
#include <linux/unistd.h>
#include <linux/futex.h>
#include <stdio.h>
#include <string.h>
#include <sys/syscall.h>
#include <sys/types.h>
#include <sys/wait.h>
#include <time.h>
#include <unistd.h>
#include "log.h"
#include "timens.h"
#define NSEC_PER_SEC 1000000000ULL
static int run_test(int clockid)
{
int futex_op = FUTEX_WAIT_BITSET;
struct timespec timeout, end;
int val = 0;
if (clockid == CLOCK_REALTIME)
futex_op |= FUTEX_CLOCK_REALTIME;
clock_gettime(clockid, &timeout);
timeout.tv_nsec += NSEC_PER_SEC / 10; // 100ms
if (timeout.tv_nsec > NSEC_PER_SEC) {
timeout.tv_sec++;
timeout.tv_nsec -= NSEC_PER_SEC;
}
if (syscall(__NR_futex, &val, futex_op, 0,
&timeout, 0, FUTEX_BITSET_MATCH_ANY) >= 0) {
ksft_test_result_fail("futex didn't return ETIMEDOUT\n");
return 1;
}
if (errno != ETIMEDOUT) {
ksft_test_result_fail("futex didn't return ETIMEDOUT: %s\n",
strerror(errno));
return 1;
}
clock_gettime(clockid, &end);
if (end.tv_sec < timeout.tv_sec ||
(end.tv_sec == timeout.tv_sec && end.tv_nsec < timeout.tv_nsec)) {
ksft_test_result_fail("futex slept less than 100ms\n");
return 1;
}
ksft_test_result_pass("futex with the %d clockid\n", clockid);
return 0;
}
int main(int argc, char *argv[])
{
int status, len, fd;
char buf[4096];
pid_t pid;
struct timespec mtime_now;
ksft_print_header();
nscheck();
ksft_set_plan(2);
clock_gettime(CLOCK_MONOTONIC, &mtime_now);
if (unshare_timens())
return 1;
len = snprintf(buf, sizeof(buf), "%d %d 0",
CLOCK_MONOTONIC, 70 * 24 * 3600);
fd = open("/proc/self/timens_offsets", O_WRONLY);
if (fd < 0)
return pr_perror("/proc/self/timens_offsets");
if (write(fd, buf, len) != len)
return pr_perror("/proc/self/timens_offsets");
close(fd);
Annotation
- Immediate include surface: `sched.h`, `linux/unistd.h`, `linux/futex.h`, `stdio.h`, `string.h`, `sys/syscall.h`, `sys/types.h`, `sys/wait.h`.
- Detected declarations: `function run_test`, `function main`.
- 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.