Struct OsRelease

Source

pub struct OsRelease { /* private fields */ }

Expand description

The parsed contents of the os-release file.

This structure is a map of the fields in the os-release file.

For more information, see os-release(5).

§Notes

If you are using this crate to determine the OS or a specific version of it, use the Self::id() and Self::version_id() methods, possibly with Self::id_like() as fallback for Self::id(). When looking for an OS identification string for presentation to the user, use the Self::pretty_name() method.

Note that operating system vendors may choose not to provide version information, for example to accommodate for rolling releases. In this case, Self::version() and Self::version_id() may be None. Application should not rely on these fields to be set.

§Examples

Open the os-release file and print the OS name and version:

use etc_os_release::OsRelease;

let os_release = OsRelease::open()?;
println!("{}-{}", os_release.id(), os_release.version_id().unwrap_or_default());

Parse a string containing the contents of the os-release file:

use std::str::FromStr;

use etc_os_release::OsRelease;

let os_release = OsRelease::from_str(r#"
NAME=Fedora
VERSION="32 (Workstation Edition)"
ID=fedora
VERSION_ID=32
PRETTY_NAME="Fedora 32 (Workstation Edition)"
ANSI_COLOR="0;38;2;60;110;180"
LOGO=fedora-logo-icon
CPE_NAME="cpe:/o:fedoraproject:fedora:32"
HOME_URL="https://fedoraproject.org/"
DOCUMENTATION_URL="https://docs.fedoraproject.org/en-US/fedora/f32/system-administrators-guide/"
SUPPORT_URL="https://fedoraproject.org/wiki/Communicating_and_getting_help"
BUG_REPORT_URL="https://bugzilla.redhat.com/"
REDHAT_BUGZILLA_PRODUCT="Fedora"
REDHAT_BUGZILLA_PRODUCT_VERSION=32
REDHAT_SUPPORT_PRODUCT="Fedora"
REDHAT_SUPPORT_PRODUCT_VERSION=32
PRIVACY_POLICY_URL="https://fedoraproject.org/wiki/Legal:PrivacyPolicy"
VARIANT="Workstation Edition"
VARIANT_ID=workstation
"#).unwrap();

assert_eq!(os_release.id(), "fedora");
assert_eq!(os_release.version_id(), Some("32"));

Struct OsReleaseCopy item path

§Notes

§Examples

Implementations§

impl OsRelease

pub fn open() -> Result<Self, Error>

pub fn from_reader(reader: impl Read) -> Result<Self, Error>

impl OsRelease

pub fn entries(&self) -> impl Iterator<Item = OsReleaseEntry<'_>>

pub fn get_value(&self, key: &str) -> Option<&str>

pub fn get_value_as_list(&self, key: &str) -> Option<impl Iterator<Item = &str>>

pub fn get_value_as_url(&self, key: &str) -> Result<Option<Url>, ParseError>

pub fn get_value_as_date( &self, key: &str, ) -> Result<Option<NaiveDate>, ParseError>

impl OsRelease

pub fn name(&self) -> &str

pub fn id(&self) -> &str

pub fn id_like(&self) -> Option<impl Iterator<Item = &str>>

pub fn pretty_name(&self) -> &str

pub fn cpe_name(&self) -> Option<&str>

pub fn variant(&self) -> Option<&str>

§Note

pub fn variant_id(&self) -> Option<&str>

impl OsRelease

pub fn version(&self) -> Option<&str>

pub fn version_id(&self) -> Option<&str>

pub fn version_codename(&self) -> Option<&str>

pub fn build_id(&self) -> Option<&str>

pub fn image_id(&self) -> Option<&str>

pub fn image_version(&self) -> Option<&str>

impl OsRelease

pub fn home_url(&self) -> Result<Option<Url>, ParseError>

pub fn documentation_url(&self) -> Result<Option<Url>, ParseError>

pub fn support_url(&self) -> Result<Option<Url>, ParseError>

pub fn bug_report_url(&self) -> Result<Option<Url>, ParseError>

pub fn privacy_policy_url(&self) -> Result<Option<Url>, ParseError>

pub fn support_end(&self) -> Result<Option<NaiveDate>, ParseError>

pub fn logo(&self) -> Option<&str>

pub fn ansi_color(&self) -> Option<&str>

pub fn vendor_name(&self) -> Option<&str>

pub fn vendor_url(&self) -> Result<Option<Url>, ParseError>

impl OsRelease

pub fn default_hostname(&self) -> Option<&str>

pub fn architecture(&self) -> Option<&str>

pub fn sysext_level(&self) -> Option<&str>

pub fn confext_level(&self) -> Option<&str>

pub fn sysext_scope(&self) -> Option<impl Iterator<Item = &str>>

pub fn confext_scope(&self) -> Option<impl Iterator<Item = &str>>

pub fn portable_prefixes(&self) -> Option<impl Iterator<Item = &str>>

Trait Implementations§

impl Clone for OsRelease

fn clone(&self) -> OsRelease

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

impl Debug for OsRelease

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

impl<'a> FromIterator<&'a str> for OsRelease

fn from_iter<T>(iter: T) -> Selfwhere T: IntoIterator<Item = &'a str>,

impl<'a> FromIterator<OsReleaseEntry<'a>> for OsRelease

fn from_iter<T>(iter: T) -> Selfwhere T: IntoIterator<Item = OsReleaseEntry<'a>>,

impl FromIterator<String> for OsRelease

fn from_iter<T>(iter: T) -> Selfwhere T: IntoIterator<Item = String>,

impl FromStr for OsRelease

type Err = Infallible

fn from_str(s: &str) -> Result<Self, Self::Err>

Auto Trait Implementations§

impl Freeze for OsRelease

impl RefUnwindSafe for OsRelease

impl Send for OsRelease

impl Sync for OsRelease

impl Unpin for OsRelease

impl UnwindSafe for OsRelease

Blanket Implementations§

impl<T> Any for Twhere T: 'static + ?Sized,

fn type_id(&self) -> TypeId

impl<T> Borrow<T> for Twhere T: ?Sized,

fn borrow(&self) -> &T

impl<T> BorrowMut<T> for Twhere T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

impl<T> CloneToUninit for Twhere T: Clone,

unsafe fn clone_to_uninit(&self, dest: *mut u8)

impl<T> From<T> for T

Struct OsRelease

fn from_iter<T>(iter: T) -> Self
where T: IntoIterator<Item = &'a str>,

fn from_iter<T>(iter: T) -> Self
where T: IntoIterator<Item = OsReleaseEntry<'a>>,

fn from_iter<T>(iter: T) -> Self
where T: IntoIterator<Item = String>,

impl<T> Any for T
where T: 'static + ?Sized,

impl<T> Borrow<T> for T
where T: ?Sized,

impl<T> BorrowMut<T> for T
where T: ?Sized,

impl<T> CloneToUninit for T
where T: Clone,

impl<T, U> Into<U> for T
where U: From<T>,

impl<T> ToOwned for T
where T: Clone,

impl<T, U> TryFrom<U> for T
where U: Into<T>,

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

impl<T> ErasedDestructor for T
where T: 'static,