Struct fwupd_dbus::DeviceFlags
source · pub struct DeviceFlags { /* private fields */ }
Expand description
Describes attributes of a device.
Implementations§
source§impl DeviceFlags
impl DeviceFlags
sourcepub const ONLY_OFFLINE: Self = _
pub const ONLY_OFFLINE: Self = _
Update can only be done from offline mode
sourcepub const REQUIRE_AC: Self = _
pub const REQUIRE_AC: Self = _
Requires AC power
sourcepub const NEEDS_BOOTLOADER: Self = _
pub const NEEDS_BOOTLOADER: Self = _
Requires a bootloader mode to be manually enabled by the user
sourcepub const REGISTERED: Self = _
pub const REGISTERED: Self = _
Has been registered with other plugins
sourcepub const NEEDS_REBOOT: Self = _
pub const NEEDS_REBOOT: Self = _
Requires a reboot to apply firmware or to reload hardware
sourcepub const USE_RUNTIME_VERSION: Self = _
pub const USE_RUNTIME_VERSION: Self = _
Always use the runtime version rather than the bootloader
sourcepub const INSTALL_PARENT_FIRST: Self = _
pub const INSTALL_PARENT_FIRST: Self = _
Install composite firmware on the parent before the child
sourcepub const IS_BOOTLOADER: Self = _
pub const IS_BOOTLOADER: Self = _
Is currently in bootloader mode
sourcepub const WAIT_FOR_REPLUG: Self = _
pub const WAIT_FOR_REPLUG: Self = _
The hardware is waiting to be replugged
sourcepub const IGNORE_VALIDATION: Self = _
pub const IGNORE_VALIDATION: Self = _
Ignore validation safety checks when flashing this device
sourcepub const NEEDS_SHUTDOWN: Self = _
pub const NEEDS_SHUTDOWN: Self = _
Requires system shutdown to apply firmware
sourcepub const ANOTHER_WRITE_REQUIRED: Self = _
pub const ANOTHER_WRITE_REQUIRED: Self = _
Requires the update to be retried with a new plugin
sourcepub const NO_AUTO_INSTANCE_IDS: Self = _
pub const NO_AUTO_INSTANCE_IDS: Self = _
Do not add instance IDs from the device baseclass
sourcepub const NEEDS_ACTIVATION: Self = _
pub const NEEDS_ACTIVATION: Self = _
Device update needs to be separately activated
sourcepub const ENSURE_SEMVER: Self = _
pub const ENSURE_SEMVER: Self = _
Ensure the version is a valid semantic version, e.g. numbers separated with dots
pub const UNKNOWN: Self = _
sourcepub const fn from_bits(bits: u64) -> Option<Self>
pub const fn from_bits(bits: u64) -> Option<Self>
Convert from underlying bit representation, unless that representation contains bits that do not correspond to a flag.
sourcepub const fn from_bits_truncate(bits: u64) -> Self
pub const fn from_bits_truncate(bits: u64) -> Self
Convert from underlying bit representation, dropping any bits that do not correspond to flags.
sourcepub const unsafe fn from_bits_unchecked(bits: u64) -> Self
pub const unsafe fn from_bits_unchecked(bits: u64) -> Self
Convert from underlying bit representation, preserving all bits (even those not corresponding to a defined flag).
Safety
The caller of the bitflags!
macro can chose to allow or
disallow extra bits for their bitflags type.
The caller of from_bits_unchecked()
has to ensure that
all bits correspond to a defined flag or that extra bits
are valid for this bitflags type.
sourcepub const fn intersects(&self, other: Self) -> bool
pub const fn intersects(&self, other: Self) -> bool
Returns true
if there are flags common to both self
and other
.
sourcepub const fn contains(&self, other: Self) -> bool
pub const fn contains(&self, other: Self) -> bool
Returns true
if all of the flags in other
are contained within self
.
sourcepub fn set(&mut self, other: Self, value: bool)
pub fn set(&mut self, other: Self, value: bool)
Inserts or removes the specified flags depending on the passed value.
sourcepub const fn intersection(self, other: Self) -> Self
pub const fn intersection(self, other: Self) -> Self
Returns the intersection between the flags in self
and
other
.
Specifically, the returned set contains only the flags which are
present in both self
and other
.
This is equivalent to using the &
operator (e.g.
ops::BitAnd
), as in flags & other
.
sourcepub const fn union(self, other: Self) -> Self
pub const fn union(self, other: Self) -> Self
Returns the union of between the flags in self
and other
.
Specifically, the returned set contains all flags which are
present in either self
or other
, including any which are
present in both (see Self::symmetric_difference
if that
is undesirable).
This is equivalent to using the |
operator (e.g.
ops::BitOr
), as in flags | other
.
sourcepub const fn difference(self, other: Self) -> Self
pub const fn difference(self, other: Self) -> Self
Returns the difference between the flags in self
and other
.
Specifically, the returned set contains all flags present in
self
, except for the ones present in other
.
It is also conceptually equivalent to the “bit-clear” operation:
flags & !other
(and this syntax is also supported).
This is equivalent to using the -
operator (e.g.
ops::Sub
), as in flags - other
.
sourcepub const fn symmetric_difference(self, other: Self) -> Self
pub const fn symmetric_difference(self, other: Self) -> Self
Returns the symmetric difference between the flags
in self
and other
.
Specifically, the returned set contains the flags present which
are present in self
or other
, but that are not present in
both. Equivalently, it contains the flags present in exactly
one of the sets self
and other
.
This is equivalent to using the ^
operator (e.g.
ops::BitXor
), as in flags ^ other
.
sourcepub const fn complement(self) -> Self
pub const fn complement(self) -> Self
Returns the complement of this set of flags.
Specifically, the returned set contains all the flags which are
not set in self
, but which are allowed for this type.
Alternatively, it can be thought of as the set difference
between Self::all()
and self
(e.g. Self::all() - self
)
This is equivalent to using the !
operator (e.g.
ops::Not
), as in !flags
.
Trait Implementations§
source§impl Binary for DeviceFlags
impl Binary for DeviceFlags
source§impl BitAnd<DeviceFlags> for DeviceFlags
impl BitAnd<DeviceFlags> for DeviceFlags
source§impl BitAndAssign<DeviceFlags> for DeviceFlags
impl BitAndAssign<DeviceFlags> for DeviceFlags
source§fn bitand_assign(&mut self, other: Self)
fn bitand_assign(&mut self, other: Self)
Disables all flags disabled in the set.
source§impl BitOr<DeviceFlags> for DeviceFlags
impl BitOr<DeviceFlags> for DeviceFlags
source§fn bitor(self, other: DeviceFlags) -> Self
fn bitor(self, other: DeviceFlags) -> Self
Returns the union of the two sets of flags.
§type Output = DeviceFlags
type Output = DeviceFlags
|
operator.source§impl BitOrAssign<DeviceFlags> for DeviceFlags
impl BitOrAssign<DeviceFlags> for DeviceFlags
source§fn bitor_assign(&mut self, other: Self)
fn bitor_assign(&mut self, other: Self)
Adds the set of flags.
source§impl BitXor<DeviceFlags> for DeviceFlags
impl BitXor<DeviceFlags> for DeviceFlags
source§impl BitXorAssign<DeviceFlags> for DeviceFlags
impl BitXorAssign<DeviceFlags> for DeviceFlags
source§fn bitxor_assign(&mut self, other: Self)
fn bitxor_assign(&mut self, other: Self)
Toggles the set of flags.
source§impl Clone for DeviceFlags
impl Clone for DeviceFlags
source§fn clone(&self) -> DeviceFlags
fn clone(&self) -> DeviceFlags
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moresource§impl Debug for DeviceFlags
impl Debug for DeviceFlags
source§impl Default for DeviceFlags
impl Default for DeviceFlags
source§impl Extend<DeviceFlags> for DeviceFlags
impl Extend<DeviceFlags> for DeviceFlags
source§fn extend<T: IntoIterator<Item = Self>>(&mut self, iterator: T)
fn extend<T: IntoIterator<Item = Self>>(&mut self, iterator: T)
source§fn extend_one(&mut self, item: A)
fn extend_one(&mut self, item: A)
extend_one
)source§fn extend_reserve(&mut self, additional: usize)
fn extend_reserve(&mut self, additional: usize)
extend_one
)source§impl FromIterator<DeviceFlags> for DeviceFlags
impl FromIterator<DeviceFlags> for DeviceFlags
source§fn from_iter<T: IntoIterator<Item = Self>>(iterator: T) -> Self
fn from_iter<T: IntoIterator<Item = Self>>(iterator: T) -> Self
source§impl Hash for DeviceFlags
impl Hash for DeviceFlags
source§impl LowerHex for DeviceFlags
impl LowerHex for DeviceFlags
source§impl Not for DeviceFlags
impl Not for DeviceFlags
source§impl Octal for DeviceFlags
impl Octal for DeviceFlags
source§impl Ord for DeviceFlags
impl Ord for DeviceFlags
source§fn cmp(&self, other: &DeviceFlags) -> Ordering
fn cmp(&self, other: &DeviceFlags) -> Ordering
1.21.0 · source§fn max(self, other: Self) -> Selfwhere
Self: Sized,
fn max(self, other: Self) -> Selfwhere Self: Sized,
source§impl PartialEq<DeviceFlags> for DeviceFlags
impl PartialEq<DeviceFlags> for DeviceFlags
source§fn eq(&self, other: &DeviceFlags) -> bool
fn eq(&self, other: &DeviceFlags) -> bool
self
and other
values to be equal, and is used
by ==
.source§impl PartialOrd<DeviceFlags> for DeviceFlags
impl PartialOrd<DeviceFlags> for DeviceFlags
source§fn partial_cmp(&self, other: &DeviceFlags) -> Option<Ordering>
fn partial_cmp(&self, other: &DeviceFlags) -> Option<Ordering>
1.0.0 · source§fn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
self
and other
) and is used by the <=
operator. Read moresource§impl Sub<DeviceFlags> for DeviceFlags
impl Sub<DeviceFlags> for DeviceFlags
source§impl SubAssign<DeviceFlags> for DeviceFlags
impl SubAssign<DeviceFlags> for DeviceFlags
source§fn sub_assign(&mut self, other: Self)
fn sub_assign(&mut self, other: Self)
Disables all flags enabled in the set.