Interface IBuilder

Namespace

ZeroInstall.Store.FileSystem

Assembly

ZeroInstall.Store.dll

Builds a file system directory.

public interface IBuilder : IForwardOnlyBuilder

Inherited Members

IForwardOnlyBuilder.AddDirectory(string)

IForwardOnlyBuilder.AddFile(string, Stream, UnixTime, bool)

IForwardOnlyBuilder.AddSymlink(string, string)

IForwardOnlyBuilder.AddHardlink(string, string, bool)

Extension Methods

BuilderExtensions.Add(IBuilder, DownloadRetrievalMethod, Stream, ITaskHandler, object?)

BuilderExtensions.AddArchive(IBuilder, Archive, Stream, ITaskHandler, object?)

BuilderExtensions.BuildDirectory(IBuilder, string?)

BuilderExtensions.CopyFrom(IBuilder, CopyFromStep, string, ITaskHandler)

BuilderExtensions.Remove(IBuilder, RemoveStep)

BuilderExtensions.Rename(IBuilder, RenameStep)

BuilderExtensions.AddFile(IForwardOnlyBuilder, string, FileInfo, ManifestElement?, string?)

BuilderExtensions.AddFile(IForwardOnlyBuilder, SingleFile, Stream)

Methods

MarkAsExecutable(string)

Marks a previously added file as executable.

void MarkAsExecutable(string path)

Parameters

path string

The path of the file to create relative to the implementation root.

Exceptions

UnauthorizedAccessException

Access to a resource was denied.

IOException

An IO operation failed.

Remove(string)

Removes a file or directory from the implementation.

void Remove(string path)

Parameters

path string

The path of the file or directory relative to the implementation root.

Exceptions

UnauthorizedAccessException

Access to a resource was denied.

IOException

An IO operation failed.

Rename(string, string)

Renames a file or directory in the implementation.

void Rename(string path, string target)

Parameters

path string

The original path of the file or directory relative to the implementation root.

target string

The new path of the file or directory relative to the implementation root.

Exceptions

UnauthorizedAccessException

Access to a resource was denied.

IOException

An IO operation failed.

TryAddExternalHardlink(string, FileInfo, bool)

Tries to create a hardlink to an existing file from outside the implementation being built.

bool TryAddExternalHardlink(string path, FileInfo target, bool executable = false)

Parameters

path string

The path of the hardlink to create relative to the implementation root.

target FileInfo

The existing file to hardlink to. Must reside within an allowed root on the same filesystem.

executable bool

true if the executable bit of the hardlink is set; false otherwise.

Returns

bool

true if the hardlink was created; false if hardlinks are not supported or the source is outside the allowed root.

Exceptions

UnauthorizedAccessException

Access to a resource was denied.

IOException

An IO operation failed.

TurnIntoSymlink(string)

Turns a previously added file into a symlink.

void TurnIntoSymlink(string path)

Parameters

path string

The path of the symlink to create relative to the implementation root.

Exceptions

UnauthorizedAccessException

Access to a resource was denied.

IOException

An IO operation failed.