Struct SysrootLock 

pub struct SysrootLock {
    pub sysroot: Sysroot,
    unowned: bool,
}

A locked system root.

Fields

sysroot: Sysroot

The underlying sysroot value.

unowned: bool

True if we didn’t actually lock

Implementations

impl SysrootLock

pub async fn new_from_sysroot(sysroot: &Sysroot) -> Result<Self>

Asynchronously acquire a sysroot lock. If the lock cannot be acquired immediately, a status message will be printed to standard output. The lock will be unlocked when this object is dropped.

pub fn from_assumed_locked(sysroot: &Sysroot) -> Self

This function should only be used when you have locked the sysroot externally (e.g. in C/C++ code). This also does not unlock on drop.

pub fn change_finalization(&self, deployment: &Deployment) -> Result<()>

Toggle the finalization lock state of a staged deployment. If the deployment is currently locked, it will be unlocked, and vice versa. The deployment must be a staged deployment.

Methods from Deref<Target = Sysroot>

pub fn change_finalization(&self, deployment: &Deployment) -> Result<(), Error>

pub fn cleanup( &self, cancellable: Option<&impl IsA<Cancellable>>, ) -> Result<(), Error>

pub fn clear_soft_reboot( &self, cancellable: Option<&impl IsA<Cancellable>>, ) -> Result<(), Error>

pub fn deploy_tree( &self, osname: Option<&str>, revision: &str, origin: Option<&KeyFile>, provided_merge_deployment: Option<&Deployment>, override_kernel_argv: &[&str], cancellable: Option<&impl IsA<Cancellable>>, ) -> Result<Deployment, Error>

pub fn deploy_tree_with_options( &self, osname: Option<&str>, revision: &str, origin: Option<&KeyFile>, provided_merge_deployment: Option<&Deployment>, opts: Option<&SysrootDeployTreeOpts<'_>>, cancellable: Option<&impl IsA<Cancellable>>, ) -> Result<Deployment, Error>

pub fn deployment_can_soft_reboot(&self, deployment: &Deployment) -> bool

pub fn deployment_kexec_load( &self, deployment: &Deployment, cancellable: Option<&impl IsA<Cancellable>>, ) -> Result<(), Error>

pub fn deployment_set_kargs( &self, deployment: &Deployment, new_kargs: &[&str], cancellable: Option<&impl IsA<Cancellable>>, ) -> Result<(), Error>

pub fn deployment_set_kargs_in_place( &self, deployment: &Deployment, kargs_str: Option<&str>, cancellable: Option<&impl IsA<Cancellable>>, ) -> Result<(), Error>

pub fn deployment_set_mutable( &self, deployment: &Deployment, is_mutable: bool, cancellable: Option<&impl IsA<Cancellable>>, ) -> Result<(), Error>

pub fn deployment_set_pinned( &self, deployment: &Deployment, is_pinned: bool, ) -> Result<(), Error>

pub fn deployment_set_soft_reboot( &self, deployment: &Deployment, allow_kernel_skew: bool, cancellable: Option<&impl IsA<Cancellable>>, ) -> Result<(), Error>

pub fn deployment_unlock( &self, deployment: &Deployment, unlocked_state: DeploymentUnlockedState, cancellable: Option<&impl IsA<Cancellable>>, ) -> Result<(), Error>

pub fn ensure_initialized( &self, cancellable: Option<&impl IsA<Cancellable>>, ) -> Result<(), Error>

pub fn booted_deployment(&self) -> Option<Deployment>

pub fn bootversion(&self) -> i32

pub fn deployment_directory(&self, deployment: &Deployment) -> File

pub fn deployment_dirpath(&self, deployment: &Deployment) -> GString

pub fn deployments(&self) -> Vec<Deployment>

pub fn fd(&self) -> i32

pub fn merge_deployment(&self, osname: Option<&str>) -> Option<Deployment>

pub fn path(&self) -> File

pub fn staged_deployment(&self) -> Option<Deployment>

pub fn subbootversion(&self) -> i32

pub fn init_osname( &self, osname: &str, cancellable: Option<&impl IsA<Cancellable>>, ) -> Result<(), Error>

pub fn initialize(&self) -> Result<(), Error>

pub fn initialize_with_mount_namespace( &self, cancellable: Option<&impl IsA<Cancellable>>, ) -> Result<(), Error>

pub fn is_booted(&self) -> bool

pub fn load( &self, cancellable: Option<&impl IsA<Cancellable>>, ) -> Result<(), Error>

pub fn load_if_changed( &self, cancellable: Option<&impl IsA<Cancellable>>, ) -> Result<bool, Error>

pub fn lock(&self) -> Result<(), Error>

pub fn lock_async<P>( &self, cancellable: Option<&impl IsA<Cancellable>>, callback: P, )

where P: FnOnce(Result<(), Error>) + 'static,

pub fn lock_future(&self) -> Pin<Box<dyn Future<Output = Result<(), Error>>>>

pub fn origin_new_from_refspec(&self, refspec: &str) -> KeyFile

pub fn prepare_cleanup( &self, cancellable: Option<&impl IsA<Cancellable>>, ) -> Result<(), Error>

pub fn query_deployments_for( &self, osname: Option<&str>, ) -> (Option<Deployment>, Option<Deployment>)

pub fn repo(&self) -> Repo

pub fn require_booted_deployment(&self) -> Result<Deployment, Error>

pub fn set_mount_namespace_in_use(&self)

pub fn simple_write_deployment( &self, osname: Option<&str>, new_deployment: &Deployment, merge_deployment: Option<&Deployment>, flags: SysrootSimpleWriteDeploymentFlags, cancellable: Option<&impl IsA<Cancellable>>, ) -> Result<(), Error>

pub fn stage_overlay_initrd( &self, fd: i32, cancellable: Option<&impl IsA<Cancellable>>, ) -> Result<GString, Error>

pub fn stage_tree( &self, osname: Option<&str>, revision: &str, origin: Option<&KeyFile>, merge_deployment: Option<&Deployment>, override_kernel_argv: &[&str], cancellable: Option<&impl IsA<Cancellable>>, ) -> Result<Deployment, Error>

pub fn stage_tree_with_options( &self, osname: Option<&str>, revision: &str, origin: Option<&KeyFile>, merge_deployment: Option<&Deployment>, opts: &SysrootDeployTreeOpts<'_>, cancellable: Option<&impl IsA<Cancellable>>, ) -> Result<Deployment, Error>

pub fn try_lock(&self) -> Result<bool, Error>

pub fn unload(&self)

pub fn unlock(&self)

pub fn update_post_copy( &self, cancellable: Option<&impl IsA<Cancellable>>, ) -> Result<(), Error>

pub fn write_deployments( &self, new_deployments: &[Deployment], cancellable: Option<&impl IsA<Cancellable>>, ) -> Result<(), Error>

pub fn write_deployments_with_options( &self, new_deployments: &[Deployment], opts: &SysrootWriteDeploymentsOpts, cancellable: Option<&impl IsA<Cancellable>>, ) -> Result<(), Error>

pub fn write_origin_file( &self, deployment: &Deployment, new_origin: Option<&KeyFile>, cancellable: Option<&impl IsA<Cancellable>>, ) -> Result<(), Error>

pub fn connect_journal_msg<F>(&self, f: F) -> SignalHandlerId

where F: Fn(&Sysroot, &str) + Send + 'static,

pub fn dfd_borrow(&self) -> BorrowedFd<'_>

Borrow the directory file descriptor for this sysroot.

Trait Implementations

impl Debug for SysrootLock

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

Formats the value using the given formatter.

impl Deref for SysrootLock

type Target = Sysroot

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl Drop for SysrootLock

fn drop(&mut self)

Executes the destructor for this type.