Struct rctl::Limit

pub struct Limit { /* fields omitted */ }

Defines how much of a [Resource] a process can use beofore the defined [Action] triggers.

Methods

impl Limit

pub fn amount(amount: usize) -> Limit

Construct a limit representing the amount used before an [Action] triggers.

The entity the amount gets accounted for defaults to the type of the [Subject] of the respective [Rule].

pub fn amount_per(amount: usize, per: SubjectType) -> Limit

Limit the amount per [SubjectType].

This defines what entity the amount gets accounted for.

Examples

For example the following [Rule] means that each process of any user belonging to the login class "users" may allocate up to 100 MiB of virtual memory:

Rule {
    subject: Subject::login_class("users"),
    resource: Resource::VMemoryUse,
    action: Action::Deny,
    limit: Limit::amount_per(100*1024*1024, SubjectType::Process),
}

Setting per: Some(SubjectType::User) on the above [Rule] would mean that for each user belonging to the login class "users", the sum of virtual memory allocated by all the processes of that user will not exceed 100 MiB.

Setting per: Some(SubjectType::LoginClass) on the above [Rule] would mean that the sum of virtual memory allocated by all processes of all users belonging to that login class will not exceed 100 MiB.

pub fn to_string(&self) -> String

Return the String representation of the Limit.

Trait Implementations

impl Eq for Limit

impl<'a> Into<String> for &'a Limit

fn into(self) -> String

Performs the conversion.

impl PartialEq<Limit> for Limit

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

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

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

This method tests for !=.

impl<'a> From<&'a Limit> for Filter

fn from(limit: &'a Limit) -> Self

Performs the conversion.

impl From<Limit> for Filter

fn from(limit: Limit) -> Self

Performs the conversion.

impl Clone for Limit

fn clone(&self) -> Limit

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Hash for Limit

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,

Feeds a slice of this type into the given [Hasher].

impl Display for Limit

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

Formats the value using the given formatter.

impl Debug for Limit

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

Formats the value using the given formatter.

impl FromStr for Limit

type Err = ParseError

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.