Class TarBuilder

Namespace

ZeroInstall.Archives.Builders

Assembly

ZeroInstall.Archives.dll

Builds a TAR archive (.tar).

[MustDisposeResource]
public class TarBuilder : IArchiveBuilder, IForwardOnlyBuilder, IDisposable

Inheritance

object

TarBuilder

Implements

IArchiveBuilder

IForwardOnlyBuilder

IDisposable

Derived

TarBz2Builder

TarGzBuilder

TarLzipBuilder

TarZstandardBuilder

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Constructors

TarBuilder(Stream)

Builds a TAR archive (.tar).

public TarBuilder(Stream stream)

Parameters

stream Stream

The stream to write the archive to. Will be disposed when the builder is disposed.

Methods

AddDirectory(string)

Adds a subdirectory to the implementation.

public void AddDirectory(string path)

Parameters

path string

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

Exceptions

UnauthorizedAccessException

Access to a resource was denied.

IOException

An IO operation failed.

AddFile(string, Stream, UnixTime, bool)

Adds a file to the implementation.

public void AddFile(string path, Stream stream, UnixTime modifiedTime, bool executable = false)

Parameters

path string

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

stream Stream

The contents of the file.

modifiedTime UnixTime

The last write time to set for the file.

executable bool

true if the file's executable bit is to be set; false otherwise.

Exceptions

UnauthorizedAccessException

Access to a resource was denied.

IOException

An IO operation failed.

AddHardlink(string, string, bool)

Adds a hardlink to the implementation.

public void AddHardlink(string path, string target, bool executable = false)

Parameters

path string

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

target string

The path of the existing file the hardlink shall be based on relative to the implementation root. Must point

executable bool

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

Exceptions

UnauthorizedAccessException

Access to a resource was denied.

IOException

An IO operation failed.

NotSupportedException

The currently platform or builder does not support hardlinks. Use AddFile(string, Stream, UnixTime, bool) instead.

AddSymlink(string, string)

Adds a symbolic link to the implementation.

public void AddSymlink(string path, string target)

Parameters

path string

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

target string

The target the symbolic link shall point to relative to path. May use non-native path separators.

Exceptions

UnauthorizedAccessException

Access to a resource was denied.

IOException

An IO operation failed.

Dispose()

Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

public virtual void Dispose()