Struct Resource

pub struct Resource { /* private fields */ }

A kind of resource.

All resource constants are available on all unix platforms. Passing an unsupported resource to [set|get|p]rlimit will result in a custom IO error.

Be careful: The documentation of Resource constants are based on a few systems.

It may be inconsistent with other platforms.

References

Linux: https://man7.org/linux/man-pages/man2/getrlimit.2.html

FreeBSD: https://www.freebsd.org/cgi/man.cgi?query=getrlimit

NetBSD: https://man.netbsd.org/getrlimit.2

AIX: https://www.ibm.com/docs/en/aix/7.3?topic=g-getrlimit-getrlimit64-setrlimit-setrlimit64-vlimit-subroutine

Implementations

impl Resource

pub const AS: Self

The maximum size (in bytes) of the process’s virtual memory (address space).

pub const CORE: Self

The maximum size (in bytes) of a core file that the process may dump.

pub const CPU: Self

A limit (in seconds) on the amount of CPU time that the process can consume.

pub const DATA: Self

The maximum size (in bytes) of the process’s data segment (initialized data, uninitialized data, and heap).

pub const FSIZE: Self

The maximum size (in bytes) of files that the process may create.

pub const KQUEUES: Self

The maximum number of kqueues this user id is allowed to create.

pub const LOCKS: Self

(early Linux 2.4 only)

A limit on the combined number of flock(2) locks and fcntl(2) leases that this process may establish.

pub const MEMLOCK: Self

The maximum number (in bytes) of memory that may be locked into RAM.

pub const MSGQUEUE: Self

A limit on the number of bytes that can be allocated for POSIX message queues for the real user ID of the calling process.

pub const NICE: Self

This specifies a ceiling to which the process’s nice value can be raised using setpriority(2) or nice(2).

pub const NOFILE: Self

This specifies a value one greater than the maximum file descriptor number that can be opened by this process.

pub const NOVMON: Self

The number of open vnode monitors.

pub const NPROC: Self

A limit on the number of extant process (or, more precisely on Linux, threads) for the real user ID of the calling process.

pub const NPTS: Self

The maximum number of pseudo-terminals this user id is allowed to create.

pub const NTHR: Self

The maximum number of simultaneous threads (Lightweight Processes) for this user id. Kernel threads and the first thread of each process are not counted against this limit.

pub const POSIXLOCKS: Self

The maximum number of POSIX-type advisory-mode locks available to this user.

pub const RSS: Self

A limit (in bytes) on the process’s resident set (the number of virtual pages resident in RAM).

pub const RTPRIO: Self

This specifies a ceiling on the real-time priority that may be set for this process using sched_setscheduler(2) and sched_setparam(2).

pub const RTTIME: Self

A limit (in microseconds) on the amount of CPU time that a process scheduled under a real-time scheduling policy may consume without making a blocking system call.

pub const SBSIZE: Self

The maximum size (in bytes) of socket buffer usage for this user. This limits the amount of network memory, and hence the amount of mbufs, that this user may hold at any time.

pub const SIGPENDING: Self

A limit on the number of signals that may be queued for the real user ID ofthe calling process.

pub const STACK: Self

The maximum size (in bytes) of the process stack.

pub const SWAP: Self

The maximum size (in bytes) of the swap space that may be reserved or used by all of this user id’s processes.

pub const THREADS: Self

AIX: The maximum number of threads each process can create. This limit is enforced by the kernel and the pthread debug library.

pub const UMTXP: Self

The number of shared locks a given user may create simultaneously.

pub const VMEM: Self

An alias for RLIMIT_AS. The maximum size of a process’s mapped address space in bytes.

impl Resource

pub fn set(self, soft: u64, hard: u64) -> Result<()>

Set resource limits.

Errors

See setrlimit

pub fn get(self) -> Result<(u64, u64)>

Get resource limits.

Errors

See getrlimit

pub fn get_soft(self) -> Result<u64>

Get soft resource limit (rlim_cur)

Errors

See getrlimit

pub fn get_hard(self) -> Result<u64>

Get hard resource limit (rlim_max)

Errors

See getrlimit

pub fn as_name(self) -> &'static str

Returns the name of the resource.

Example

assert_eq!(Resource::NOFILE.as_name(), "RLIMIT_NOFILE");

pub const fn is_supported(self) -> bool

Returns true if the current platform supports this resource.

Trait Implementations

impl Clone for Resource

fn clone(&self) -> Resource

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Resource

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl FromStr for Resource

type Err = ParseResourceError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for Resource

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Resource

fn eq(&self, other: &Resource) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for Resource

impl Eq for Resource

impl StructuralPartialEq for Resource