Trait BootManagerServerHandler 

pub trait BootManagerServerHandler<___T = Channel>
where
    ___T: Transport,
{
    // Required methods
    fn query_current_configuration(
        &mut self,
        responder: Responder<QueryCurrentConfiguration, ___T>,
    ) -> impl Future<Output = ()> + Send;
    fn query_active_configuration(
        &mut self,
        responder: Responder<QueryActiveConfiguration, ___T>,
    ) -> impl Future<Output = ()> + Send;
    fn query_configuration_last_set_active(
        &mut self,
        responder: Responder<QueryConfigurationLastSetActive, ___T>,
    ) -> impl Future<Output = ()> + Send;
    fn query_configuration_status(
        &mut self,
        request: Request<QueryConfigurationStatus, ___T>,
        responder: Responder<QueryConfigurationStatus, ___T>,
    ) -> impl Future<Output = ()> + Send;
    fn query_configuration_status_and_boot_attempts(
        &mut self,
        request: Request<QueryConfigurationStatusAndBootAttempts, ___T>,
        responder: Responder<QueryConfigurationStatusAndBootAttempts, ___T>,
    ) -> impl Future<Output = ()> + Send;
    fn set_configuration_active(
        &mut self,
        request: Request<SetConfigurationActive, ___T>,
        responder: Responder<SetConfigurationActive, ___T>,
    ) -> impl Future<Output = ()> + Send;
    fn set_configuration_unbootable(
        &mut self,
        request: Request<SetConfigurationUnbootable, ___T>,
        responder: Responder<SetConfigurationUnbootable, ___T>,
    ) -> impl Future<Output = ()> + Send;
    fn set_configuration_healthy(
        &mut self,
        request: Request<SetConfigurationHealthy, ___T>,
        responder: Responder<SetConfigurationHealthy, ___T>,
    ) -> impl Future<Output = ()> + Send;
    fn set_one_shot_recovery(
        &mut self,
        responder: Responder<SetOneShotRecovery, ___T>,
    ) -> impl Future<Output = ()> + Send;
    fn flush(
        &mut self,
        responder: Responder<Flush, ___T>,
    ) -> impl Future<Output = ()> + Send;
}

A server handler for the BootManager protocol.

See BootManager for more details.

Required Methods

fn query_current_configuration( &mut self, responder: Responder<QueryCurrentConfiguration, ___T>, ) -> impl Future<Output = ()> + Send

Queries the configuration the system is currently running.

Returns ZX_ERR_NOT_SUPPORTED if the zvb.current_slot boot argument cannot be read or is an unexpected value.

fn query_active_configuration( &mut self, responder: Responder<QueryActiveConfiguration, ___T>, ) -> impl Future<Output = ()> + Send

Queries the configuration which will be used as the default boot choice on a normal cold boot, which may differ from the currently running configuration. Configuration::RECOVERY should never be active.

Returns ZX_ERR_NOT_SUPPORTED if Configuration.RECOVERY is active.

fn query_configuration_last_set_active( &mut self, responder: Responder<QueryConfigurationLastSetActive, ___T>, ) -> impl Future<Output = ()> + Send

Queries the configuration that was last explicitly marked as active by SetConfigurationActive(). The result is not affected by the current status of the slot.

A newly updated slot is typically marked as active immediately. Therefore this interface can be used as a way to identify the newest slot.

Returns ZX_ERR_IO if fail to load abr metadata. Returns ZX_ERR_INTERNAL if invalid slot index is returned by libabr routine.

fn query_configuration_status( &mut self, request: Request<QueryConfigurationStatus, ___T>, responder: Responder<QueryConfigurationStatus, ___T>, ) -> impl Future<Output = ()> + Send

Queries status of configuration.

Returns ZX_ERR_INVALID_ARGS if Configuration.RECOVERY is passed in via configuration.

fn query_configuration_status_and_boot_attempts( &mut self, request: Request<QueryConfigurationStatusAndBootAttempts, ___T>, responder: Responder<QueryConfigurationStatusAndBootAttempts, ___T>, ) -> impl Future<Output = ()> + Send

Queries status of configuration.

The returned table contains:

• status: the current ConfigurationStatus

• boot_attempts: if status is ConfigurationStatus::PENDING, this will be the number of times this configuration has attempted to boot, including the current attempt. For any other status this value will not be provided.

  If provided, this value will be in the range [0, MAX_PENDING_BOOT_ATTEMPTS]. 0 indicates the configuration was just set active and has not attempted any boots yet, and MAX_PENDING_BOOT_ATTEMPTS indicates that all attempts have been used.

• unbootable_reason: if status is ConfigurationStatus::UNBOOTABLE, this will be the reported reason for why the configuration is unbootable. For any other status this value will not be provided.

Returns ZX_ERR_INVALID_ARGS if Configuration.RECOVERY is passed in via configuration.

fn set_configuration_active( &mut self, request: Request<SetConfigurationActive, ___T>, responder: Responder<SetConfigurationActive, ___T>, ) -> impl Future<Output = ()> + Send

Updates persistent metadata identifying which configuration should be selected as ‘primary’ for booting purposes. Should only be called after KERNEL as well as optional VERIFIED_BOOT_METADATA assets for specified configuration were written successfully.

Also resets the boot attempts count for the given Configuration.

Returns ZX_ERR_INVALID_ARGS if Configuration.RECOVERY is passed in via configuration.

fn set_configuration_unbootable( &mut self, request: Request<SetConfigurationUnbootable, ___T>, responder: Responder<SetConfigurationUnbootable, ___T>, ) -> impl Future<Output = ()> + Send

Updates persistent metadata identifying whether configuration is bootable. Should only be called in the following situations:

• Before KERNEL as well as optional VERIFIED_BOOT_METADATA assets for specified configuration are written.
• After successfully booting from a new configuration and marking it healthy. This method would be then called on the old configuration.
• After “successfully” booting from a new configuration, but encountering an unrecoverable error during health check. This method would be then called on the new configuration.

If the configuration is unbootable, no action is taken.

Returns ZX_ERR_INVALID_ARGS if Configuration.RECOVERY is passed in via configuration.

fn set_configuration_healthy( &mut self, request: Request<SetConfigurationHealthy, ___T>, responder: Responder<SetConfigurationHealthy, ___T>, ) -> impl Future<Output = ()> + Send

Updates persistent metadata to mark a [fuchsia.paver/Configuration] as successful.

This function is typically used by the OS update system after having confirmed that the configuration works as intended and the “rollback to previous slot” logic is not needed anymore.

Compatibility between the newly successful configuration and the other configuration is unknown. Even if the other configuration was successful at one point, it may no longer be. This function adds a success mark to the given configuration but also removes any success mark on the other.

If configuration is unbootable or is [fuchsia.paver/Configuration.RECOVERY], response will be ZX_ERR_INVALID_ARGS.

• request configuration the Configuration to mark as healthy. Must not be RECOVERY.

• response status a zx_status value indicating success or failure.

fn set_one_shot_recovery( &mut self, responder: Responder<SetOneShotRecovery, ___T>, ) -> impl Future<Output = ()> + Send

Force device to boot to recovery in the next reboot/power cycle. This will only be triggered once and will be reset after the reboot. State of A/B configuration slot will not be affected.

fn flush( &mut self, responder: Responder<Flush, ___T>, ) -> impl Future<Output = ()> + Send

Flush all previously buffered writes to persistent storage.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety".

Implementors