tools/testing/selftests/proc/proc-pidns.c
Source file repositories/reference/linux-study-clean/tools/testing/selftests/proc/proc-pidns.c
File Facts
- System
- Linux kernel
- Corpus path
tools/testing/selftests/proc/proc-pidns.c- Extension
.c- Size
- 6050 bytes
- Lines
- 212
- 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.
Dependency Surface
assert.herrno.hsched.hstdbool.hstdlib.hstring.hunistd.hstdio.hsys/mount.hsys/stat.hsys/prctl.hkselftest_harness.h
Detected Declarations
function touch
Annotated Snippet
// SPDX-License-Identifier: GPL-2.0-or-later
/*
* Author: Aleksa Sarai <cyphar@cyphar.com>
* Copyright (C) 2025 SUSE LLC.
*/
#include <assert.h>
#include <errno.h>
#include <sched.h>
#include <stdbool.h>
#include <stdlib.h>
#include <string.h>
#include <unistd.h>
#include <stdio.h>
#include <sys/mount.h>
#include <sys/stat.h>
#include <sys/prctl.h>
#include "kselftest_harness.h"
#define ASSERT_ERRNO(expected, _t, seen) \
__EXPECT(expected, #expected, \
({__typeof__(seen) _tmp_seen = (seen); \
_tmp_seen >= 0 ? _tmp_seen : -errno; }), #seen, _t, 1)
#define ASSERT_ERRNO_EQ(expected, seen) \
ASSERT_ERRNO(expected, ==, seen)
#define ASSERT_SUCCESS(seen) \
ASSERT_ERRNO(0, <=, seen)
static int touch(char *path)
{
int fd = open(path, O_WRONLY|O_CREAT|O_CLOEXEC, 0644);
if (fd < 0)
return -1;
return close(fd);
}
FIXTURE(ns)
{
int host_mntns, host_pidns;
int dummy_pidns;
};
FIXTURE_SETUP(ns)
{
/* Stash the old mntns. */
self->host_mntns = open("/proc/self/ns/mnt", O_RDONLY|O_CLOEXEC);
ASSERT_SUCCESS(self->host_mntns);
/* Create a new mount namespace and make it private. */
ASSERT_SUCCESS(unshare(CLONE_NEWNS));
ASSERT_SUCCESS(mount(NULL, "/", NULL, MS_PRIVATE|MS_REC, NULL));
/*
* Create a proper tmpfs that we can use and will disappear once we
* leave this mntns.
*/
ASSERT_SUCCESS(mount("tmpfs", "/tmp", "tmpfs", 0, NULL));
/*
* Create a pidns we can use for later tests. We need to fork off a
* child so that we get a usable nsfd that we can bind-mount and open.
*/
ASSERT_SUCCESS(mkdir("/tmp/dummy", 0755));
ASSERT_SUCCESS(touch("/tmp/dummy/pidns"));
ASSERT_SUCCESS(mkdir("/tmp/dummy/proc", 0755));
self->host_pidns = open("/proc/self/ns/pid", O_RDONLY|O_CLOEXEC);
ASSERT_SUCCESS(self->host_pidns);
ASSERT_SUCCESS(unshare(CLONE_NEWPID));
pid_t pid = fork();
ASSERT_SUCCESS(pid);
if (!pid) {
prctl(PR_SET_PDEATHSIG, SIGKILL);
ASSERT_SUCCESS(mount("/proc/self/ns/pid", "/tmp/dummy/pidns", NULL, MS_BIND, NULL));
ASSERT_SUCCESS(mount("proc", "/tmp/dummy/proc", "proc", 0, NULL));
exit(0);
}
int wstatus;
ASSERT_EQ(waitpid(pid, &wstatus, 0), pid);
ASSERT_TRUE(WIFEXITED(wstatus));
ASSERT_EQ(WEXITSTATUS(wstatus), 0);
ASSERT_SUCCESS(setns(self->host_pidns, CLONE_NEWPID));
self->dummy_pidns = open("/tmp/dummy/pidns", O_RDONLY|O_CLOEXEC);
Annotation
- Immediate include surface: `assert.h`, `errno.h`, `sched.h`, `stdbool.h`, `stdlib.h`, `string.h`, `unistd.h`, `stdio.h`.
- Detected declarations: `function touch`.
- 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.