Enum Subject 

pub enum Subject {
    Process(Process),
    Jail(Jail),
    User(User),
    LoginClass(LoginClass),
}

A struct representing an RCTL subject.

From rctl(8):

Subject defines the kind of entity the rule applies to. It can be either process, user, login class, or jail.

Subject ID identifies the subject. It can be user name, numerical user ID login class name, or jail name.

Variants

Process(Process)

Jail(Jail)

User(User)

LoginClass(LoginClass)

Implementations

impl Subject

pub fn process_id(pid: pid_t) -> Self

pub fn user_name(name: &str) -> Result<Self, ParseError>

pub fn user_id(uid: uid_t) -> Self

Examples found in repository

examples/serialize.rs (line 11)

fn main() {
    let uid = unsafe { libc::getuid() };

    let subject = rctl::Subject::user_id(uid);

    let serialized = serde_json::to_string(&subject).expect("Could not serialize RCTL subject.");

    println!("{serialized}");
}

examples/usage.rs (line 9)

fn main() {
    println!("RCTL is {}", rctl::State::check());

    let uid = unsafe { libc::getuid() };

    let subject = rctl::Subject::user_id(uid);

    let usage = subject.usage().expect("Could not get RCTL usage");

    println!("{usage:#?}");
}

pub fn login_class<S: Into<String>>(name: S) -> Self

pub fn jail_name<S: Into<String>>(name: S) -> Self

pub fn usage(&self) -> Result<HashMap<Resource, usize>, Error>

Get the resource usage for a specific Subject.

Example

extern crate libc;

let uid = unsafe { libc::getuid() };
let subject = rctl::Subject::user_id(uid);

let usage = subject.usage()
    .expect("Could not get RCTL usage");

println!("{:#?}", usage);

Examples found in repository

examples/usage.rs (line 11)

fn main() {
    println!("RCTL is {}", rctl::State::check());

    let uid = unsafe { libc::getuid() };

    let subject = rctl::Subject::user_id(uid);

    let usage = subject.usage().expect("Could not get RCTL usage");

    println!("{usage:#?}");
}

pub fn limits(&self) -> Result<RuleParsingIntoIter<String>, Error>

Get an IntoIterator over the rules that apply to this subject.

Trait Implementations

impl Clone for Subject

fn clone(&self) -> Subject

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Subject

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

Formats the value using the given formatter.

impl Display for Subject

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

Formats the value using the given formatter.

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

fn from(subject: &'a Subject) -> Self

Converts to this type from the input type.

impl<'a> From<&'a Subject> for String

fn from(subject: &'a Subject) -> String

Converts to this type from the input type.

impl<'a> From<&'a Subject> for SubjectType

fn from(subject: &'a Subject) -> Self

Converts to this type from the input type.

impl From<Subject> for Filter

fn from(subject: Subject) -> Self

Converts to this type from the input type.

impl FromStr for Subject

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.

impl Hash for Subject

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 Subject

fn eq(&self, other: &Subject) -> 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 Serialize for Subject

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Subject

impl StructuralPartialEq for Subject