Interface IRootfsClient

Namespace

OpenShell

Assembly

OpenShell.Sdk.dll

Stages a local rootfs tar archive for compute drivers that boot from one (for example the VM driver). Only a client that shares the gateway's filesystem can complete the upload, so this is a local-gateway workflow.

public interface IRootfsClient

Methods

BeginStagingAsync(string, ulong, CancellationToken)

Allocates a staging slot. The gateway validates fileName (a base name, no separators) and rejects archives over the driver limit before allocating anything.

ValueTask<RootfsStagingSlot> BeginStagingAsync(string fileName, ulong sizeBytes, CancellationToken cancellationToken = default)

Parameters

fileName string

sizeBytes ulong

cancellationToken CancellationToken

Returns

ValueTask<RootfsStagingSlot>

StageAsync(string, CancellationToken)

Allocates a slot, copies tarPath into it while enforcing the gateway's byte limit, and returns the token to pass to WithStagingToken(string, string?, string).

ValueTask<string> StageAsync(string tarPath, CancellationToken cancellationToken = default)

Parameters

tarPath string

cancellationToken CancellationToken

Returns

ValueTask<string>