Enum rctl::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)

Methods

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

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);

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

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

Trait Implementations

impl Eq for Subject

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

fn into(self) -> String

Performs the conversion.

impl PartialEq<Subject> for Subject

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

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

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

This method tests for !=.

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

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

Performs the conversion.

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

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

Performs the conversion.

impl From<Subject> for Filter

fn from(subject: Subject) -> Self

Performs the conversion.

impl Clone for Subject

fn clone(&self) -> Subject

Returns a copy of the value.

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

Performs copy-assignment from source.

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,

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

impl Display for Subject

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

Formats the value using the given formatter.

impl Debug for Subject

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

Formats the value using the given formatter.

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.