Struct rlimit::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 copy 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<Resource> for Resource

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

This method tests for self and other values to be equal, and is used by ==.

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

This method 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 StructuralEq for Resource

impl StructuralPartialEq for Resource