mod component_reach¶
- module component_reach¶
Easyconfigs and installed modules that carry a component in one generation.
Names match with ASCII case folded, so
curlhitscURL. A compat-layer file is an input: those rows are not easyconfigs.Variables
- const COMPONENT_REACH_SCHEMA_VERSION: u32¶
Schema of
ReachDocument.Version 2 adds
reach:cross-user,network-facing,local-only,not-reachable, orunclassifiedwhen the built-in names do not include the component.component-reachreads no site file.
Functions
- fn component_reach(query: &ReachQuery<'_>) -> ReachDocument¶
Find carriers in one toolchain generation.
- fn cve_reach(cve: &str, components: &[ResolvedComponent], notes: &[String], unresolved: &[String], scope: &ReachScope<'_>) -> CveReachDocument¶
Reach of every package in one OSV resolution.
- fn cve_to_toml(document: &CveReachDocument) -> Result<String, toml::ser::Error>¶
TOML record for a CVE reach document.
- fn fetch_easystack_urls(urls: &[String], client: &dyn RegistryClient) -> Result<Vec<StackEasystack>, String>¶
Download easystack YAML. Anything other than
https://is refused.
- fn parse_compat_layer(text: &str) -> Vec<(String, String)>¶
name versionorname==version, one per line.#comments are skipped.
- fn purl_carrier_known(kind: &str) -> bool¶
genericandgithubname easyconfigs. The language types name extensions, bundled components, crates, and wheels of that language.
- fn render_cve_markdown(document: &CveReachDocument) -> String¶
Markdown for
CveReachDocument, one section per package.
- fn render_markdown(document: &ReachDocument) -> String¶
Markdown tables of the carriers and the closure, in the pr-overlap shape.
- fn to_toml(document: &ReachDocument) -> Result<String, toml::ser::Error>¶
TOML record with the same generated header as
pr-overlap.
Structs and Unions
- struct Carrier¶
One easyconfig or installed module that carries the component.
- role: String¶
module,dependency,builddependency,extension,component,crate,wheel,source,patch,compat-layer, orinstalled.
- version: String¶
Version that matched.
- easyconfig: String¶
Easyconfig filename, empty for compat-layer and installed-only rows.
- module: String¶
Name/version-toolchain.
- installed: Option<bool>¶
Set when an installed list was passed.
- struct CveReachDocument¶
One CVE, and the reach of every package OSV attached to it.
- schema_version: u32¶
COMPONENT_REACH_SCHEMA_VERSION.
- kind: String¶
cve, so this file is not read as one component document.
- cve: String¶
Id that was resolved.
- generated_at: String¶
When it was computed.
- generation: String¶
Toolchain generation.
- resolved: Vec<ResolvedComponent>¶
Packages the record named.
- results: Vec<ReachDocument>¶
One reach document per resolved package.
- notes: Vec<String>¶
Alias fetches that failed, and closure notes that are not per result.
- unresolved: Vec<String>¶
Ranges and events OSV named that this tool could not parse.
- struct ReachDocument¶
Carriers and, once filled, the rebuild closure.
- schema_version: u32¶
COMPONENT_REACH_SCHEMA_VERSION.
- generated_at: String¶
When it was computed.
- component: String¶
Name that was asked for.
- version_req: String¶
Version requirement that was asked for.
Empty when the match is the exact
Self::versionslist.
- version_reqs: Vec<String>¶
Every requirement, when more than one was OR-ed together.
- versions: Vec<String>¶
Exact versions from a CVE record.
- purl: Option<String>¶
Package URL, when the query was a purl or a resolved CVE.
- ecosystem: Option<String>¶
Ecosystem, when the query named one.
- generation: String¶
Toolchain generation.
- reach: String¶
Reach class of the component name.
cross-userandnetwork-facingjustify a backport.local-onlyandnot-reachabledo not.unclassifiedmeans the built-in names do not include this component.
- changed: Vec<String>¶
Recipes that contain the component, fed to the closure.
- closure_counts: RebuildCounts¶
Closure counts. Zero until the closure is run.
- closure_rows: Vec<RebuildRow>¶
Closure rows.
- missing: Vec<String>¶
Changed filenames missing from the closure graph.
- closure_unresolved: Vec<String>¶
Requirements no recipe in the trees resolves, so the closure has no edge for them.
- notes: Vec<String>¶
Compat-layer hits and closure notes.
- struct ReachQuery<'a>¶
One run.
version_reqis an exact version,*, or a requirement.- component: &'a str¶
Component name.
- version_req: &'a str¶
Version,
*, or a requirement such as >=8,<9.Empty when the match is only
Self::exact_versions.
- also_reqs: &'a [String]¶
Further requirements. A version matches when any requirement matches.
- exact_versions: &'a [String]¶
Exact versions that match even when no requirement does.
- purl: Option<&'a str>¶
Package URL that named this component, when there was one.
- ecosystem: Option<&'a str>¶
Ecosystem from the purl or the OSV record.
- generation: &'a str¶
Toolchain generation, for example
2026.1.
- installed: Option<&'a BTreeSet<String>>¶
Installed
Name/version-toolchainlines.
- easystacks: &'a [StackEasystack]¶
Deployed easystacks. Empty uses the generation as the stack.
- compat: &'a [(String, String)]¶
Compat-layer
name/versionrows.
- filter_deps: &'a FilterDeps¶
--filter-deps, applied when the closure is filled in.
- generated_at: &'a str¶
RFC 3339 timestamp.
- struct ReachScope<'a>¶
Shared inputs of one generation scan.
- generation: &'a str¶
Toolchain generation, for example
2026.1.
- installed: Option<&'a BTreeSet<String>>¶
Installed
Name/version-toolchainlines.
- easystacks: &'a [StackEasystack]¶
Deployed easystacks. Empty uses the generation as the stack.
- compat: &'a [(String, String)]¶
Compat-layer
name/versionrows.
- filter_deps: &'a FilterDeps¶
--filter-deps, applied when the closure is filled in.
- generated_at: &'a str¶
RFC 3339 timestamp.