Module rustix::process

Process-associated operations.

Structs

CpuSet

CpuSet represent a bit-mask of CPUs. CpuSets are used by sched_setaffinity and sched_getaffinity for example.

Cpuid

A Linux CPU ID.

Gid

gid_t—A Unix group ID.

MembarrierQuery

A result from membarrier_query.

Pid

pid_t—A Unix process ID.

Rlimit

struct rlimit—Current and maximum values used in getrlimit.

Uid

uid_t—A Unix user ID.

Uname

struct utsname—Return type for uname.

WaitOptions

Options for modifying the behavior of wait/waitpid

WaitStatus

the status of the child processes the caller waited on

Enums

MembarrierCommand

A command for use with membarrier and membarrier_cpu.

Resource

A resource value for use with getrlimit.

Constants

EXIT_FAILURE

EXIT_FAILURE for use with exit.

EXIT_SIGNALED_SIGABRT

The exit status used by a process terminated with SIGABRT signal.

EXIT_SUCCESS

EXIT_SUCCESS for use with exit.

Functions

chdir

chdir(path)—Change the working directory.

exit_group

Exit all the threads in the current process’ thread group.

fchdir

fchdir(fd)—Change the working directory.

getcwd

getcwd()

getegid

getegid()—Returns the process’ effective group ID.

geteuid

geteuid()—Returns the process’ effective user ID.

getgid

getgid()—Returns the process’ real group ID.

getpid

getpid()—Returns the process’ ID.

getppid

getppid()—Returns the parent process’ ID.

getpriority_pgrp

getpriority(PRIO_PGRP, gid)—Get the scheduling priority of the given process group.

getpriority_process

getpriority(PRIO_PROCESS, pid)—Get the scheduling priority of the given process.

getpriority_user

getpriority(PRIO_USER, uid)—Get the scheduling priority of the given user.

getrlimit

getrlimit(resource)—Get a process resource limit value.

getuid

getuid()—Returns the process’ real user ID.

linux_execfn

getauxval(AT_EXECFN)—Returns the Linux “execfn” string.

linux_hwcap

(getauxval(AT_HWCAP), getauxval(AT_HWCAP2)—Returns the Linux “hwcap” data.

membarrier

membarrier(cmd, 0, 0)—Perform a memory barrier.

membarrier_cpu

membarrier(cmd, MEMBARRIER_CMD_FLAG_CPU, cpu)—Perform a memory barrier with a specific CPU.

membarrier_query

membarrier(MEMBARRIER_CMD_QUERY, 0, 0)—Query the supported membarrier commands.

nice

nice()—Adjust the scheduling priority of the current process.

page_size

getpagesize()—Returns the process’ page size.

sched_getaffinity

sched_getaffinity(pid)—Get a thread’s CPU affinity mask.

sched_setaffinity

sched_setaffinity(pid, cpuset)—Set a thread’s CPU affinity mask.

sched_yield

sched_yield()—Hints to the OS that other processes should run.

setpriority_pgrp

setpriority(PRIO_PGRP, pgid)—Get the scheduling priority of the given process group.

setpriority_process

setpriority(PRIO_PROCESS, pid)—Get the scheduling priority of the given process.

setpriority_user

setpriority(PRIO_USER, uid)—Get the scheduling priority of the given user.

uname

uname()—Returns high-level information about the runtime OS and hardware.

wait

wait—Wait for any of the children of calling process to change state.

waitpid

waitpid—Wait for a specific process to change state.

Type Definitions

RawGid

A group identifier as a raw integer.

RawPid

A process identifier as a raw integer.

RawUid

A user identifier as a raw integer.