pkgAcqIndexTrans Class Reference

An acquire item that is responsible for fetching a {{{ translated index file. More...

#include <acquire-item.h>

Inheritance diagram for pkgAcqIndexTrans:

Collaboration diagram for pkgAcqIndexTrans:

List of all members.

Public Member Functions
virtual void	Failed (std::string Message, pkgAcquire::MethodConfig *Cnf)
	Invoked by the acquire worker when the object couldn't be fetched.
virtual std::string	Custom600Headers ()
	Custom headers to be sent to the fetch process.
	pkgAcqIndexTrans (pkgAcquire *Owner, std::string URI, std::string URIDesc, std::string ShortDesc)
	Create a pkgAcqIndexTrans.
	pkgAcqIndexTrans (pkgAcquire *Owner, struct IndexTarget const *const Target, HashString const &ExpectedHash, indexRecords const *MetaIndexParser)
Public Member Functions inherited from pkgAcqIndex
virtual void	Done (std::string Message, unsigned long long Size, std::string Md5Hash, pkgAcquire::MethodConfig *Cnf)
	Invoked by the acquire worker when the object was fetched successfully.
virtual std::string	DescURI ()
	A "descriptive" URI-like string.
virtual std::string	HashSum ()
	HashSum.
	pkgAcqIndex (pkgAcquire *Owner, std::string URI, std::string URIDesc, std::string ShortDesc, HashString ExpectedHash, std::string compressExt="")
	Create a pkgAcqIndex.
	pkgAcqIndex (pkgAcquire *Owner, struct IndexTarget const *const Target, HashString const &ExpectedHash, indexRecords const *MetaIndexParser)
void	Init (std::string const &URI, std::string const &URIDesc, std::string const &ShortDesc)
Public Member Functions inherited from pkgAcquire::Item
virtual void	Start (std::string Message, unsigned long long Size)
	Invoked when the worker starts to fetch this object.
virtual std::string	ShortDesc ()
	Short item description.
virtual void	Finished ()
	Invoked by the worker when the download is completely done.
pkgAcquire *	GetOwner ()
virtual bool	IsTrusted ()
void	ReportMirrorFailure (std::string FailCode)
	Report mirror problem.
	Item (pkgAcquire *Owner)
	Initialize an item.
virtual	~Item ()
	Remove this item from its owner's queue by invoking pkgAcquire::Remove.
Public Member Functions inherited from WeakPointable
void	AddWeakPointer (WeakPointable **weakptr)
void	RemoveWeakPointer (WeakPointable **weakptr)
	~WeakPointable ()

Additional Inherited Members
Protected Attributes inherited from pkgAcqIndex
bool	Decompression
	If true, the index file has been decompressed.
bool	Erase
	If true, the partially downloaded file will be removed when the download completes.
bool	Verify
	Verify for correctness by checking if a "Package" tag is found in the index. This can be set to false for optional index targets.
pkgAcquire::ItemDesc	Desc
	The download request that is currently being processed.
std::string	RealURI
	The object that is actually being fetched (minus any compression-related extensions).
HashString	ExpectedHash
	The expected hashsum of the decompressed index file.
std::string	CompressionExtension
	The compression-related file extensions that are being added to the downloaded file one by one if first fails (e.g., "gz bz2").
Protected Attributes inherited from pkgAcquire::Item
pkgAcquire *	Owner
	The acquire object with which this item is associated.

---

Detailed Description

An acquire item that is responsible for fetching a {{{ translated index file.

The only difference from pkgAcqIndex is that transient failures are suppressed: no error occurs if the translated index file is missing.

---

Constructor & Destructor Documentation

pkgAcqIndexTrans	(	pkgAcquire *	Owner,
		std::string	URI,
		std::string	URIDesc,
		std::string	ShortDesc
	)

Create a pkgAcqIndexTrans.

Parameters:

Owner	The pkgAcquire object with which this item is associated.
URI	The URI of the index file that is to be downloaded.
URIDesc	A "URI-style" description of this index file.
ShortDesc	A brief description of this index file.

---

Member Function Documentation

string Custom600Headers ( )

virtual

Custom headers to be sent to the fetch process.

Returns:

a string containing RFC822-style headers that are to be inserted into the 600 URI Acquire message sent to the fetch subprocess. The headers are inserted after a newline-less line, so they should (if nonempty) have a leading newline and no trailing newline.

Reimplemented from pkgAcqIndex.

References pkgAcqIndex::RealURI.

void Failed ( std::string  Message, pkgAcquire::MethodConfig *  Cnf  )

virtual

Invoked by the acquire worker when the object couldn't be fetched.

This is a branch of the continuation of the fetch process.

Parameters:

Message	An RFC822-formatted message from the acquire method describing what went wrong. Use LookupTag() to parse it.
Cnf	The method via which the worker tried to fetch this object.

See also:

pkgAcqMethod

Reimplemented from pkgAcqIndex.

References pkgAcquire::Item::Complete, pkgAcqIndex::CompressionExtension, pkgAcquire::Item::Dequeue(), pkgAcqIndex::Desc, pkgAcquire::ItemDesc::Description, pkgAcquire::MethodConfig::LocalOnly, pkgAcqIndex::RealURI, pkgAcquire::ItemDesc::ShortDesc, pkgAcquire::Item::StatDone, and pkgAcquire::Item::StatIdle.

---

The documentation for this class was generated from the following files:

• /apt-0.9.7.6/apt-pkg/acquire-item.h
• /apt-0.9.7.6/apt-pkg/acquire-item.cc