kStatus kTar_Construct	(	kTar *	tar,
		kStream	stream,
		kTarMode	mode,
		kAlloc	allocator
	)

Constructs a kTar object.

The tar archive is read from or written to the destination stream.

It is the caller's reponsiblity to destroy the stream object passed to this constructor. However, the caller may not read from, write to, or destroy the stream object during the lifetime of the kTar object.

Parameters

tar	Destination for the constructed object handle.
stream	Stream.
mode	Operation mode (kTAR_MODE_READ or kTAR_MODE_WRITE).
allocator	Memory allocator (or kNULL for default).

Returns

Operation status.