Struct Lamb 

#[non_exhaustive]
pub struct Lamb {
    pub pid: u32,
    pub name: String,
}

One process the OS reports as a descendant of a sheep.

What this is not

It is not the set of processes that die with the sheep, and nothing here should be read as promising that. The list is built by walking the OS’s parent-pid links; the stop ladder acts on the process GROUP, and the two units diverge in both directions — a lamb that forks and exits leaves its own children re-parented to init, out of this list and still in the group, while a setsid() grandchild stays in this list and leaves the group. shep-daemon’s limits module doc has the full account, and it is the authority; this is a pointer to it, not a second copy free to drift.

Why a name and not a command line

name is the executable’s name as the OS reports it (node, sh, python3), never its argument vector. A process’s argv routinely carries credentials — a --password= flag, a URL with a token in the query string — and this field rides in shep describe --format json, which is output people paste into bug reports. A pid alone would be safe too, and was considered; it was rejected because a tree of bare integers sends the operator to ps, which is the work the tree exists to save.

Why no memory figure

The sheep’s own row already reports its whole tree’s resident size (ProcessInfo::memory_bytes), and a per-lamb breakdown is a profiler’s job. deferred.md’s note on this struct’s growth asks for exactly this restraint.

#[non_exhaustive]: shep-core is a published library, this type is new, and the two obvious next fields (a parent pid, so a deep tree can be nested rather than flattened; a start time) would otherwise be breaking additions (IR-20). Build one with Self::new.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

pid: u32

The lamb’s own pid.

name: String

The executable’s name, as the OS reports it. Never its command line.

Implementations

impl Lamb

pub fn new(pid: u32, name: impl Into<String>) -> Self

One lamb.

A plain constructor rather than a builder, unlike ProcessInfo: both fields are required and neither is optional or derived, which is the case a builder buys nothing for.

Trait Implementations

impl Clone for Lamb

fn clone(&self) -> Lamb

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Lamb

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Lamb

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Lamb

impl PartialEq for Lamb

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Lamb

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Lamb