An item that is responsible for fetching a package file. More...

#include <acquire-item.h>

Inheritance diagram for pkgAcqArchive:

Collaboration diagram for pkgAcqArchive:

Public Types
enum	ItemState { StatIdle, StatFetching, StatDone, StatError, StatAuthError, StatTransientNetworkError }
	The current status of this item. More...

Public Member Functions
	pkgAcqArchive (pkgAcquire Owner, pkgSourceList Sources, pkgRecords *Recs, pkgCache::VerIterator const &Version, std::string &StoreFilename)
	Create a new pkgAcqArchive. More...

void	AddWeakPointer (WeakPointable **weakptr)
	Add a new weak pointer. More...

virtual std::string	Custom600Headers ()
	Custom headers to be sent to the fetch process. More...

virtual std::string	DescURI ()
	A "descriptive" URI-like string. More...

virtual void	Done (std::string Message, unsigned long long Size, std::string Hash, pkgAcquire::MethodConfig *Cnf)
	Invoked by the acquire worker when the object was fetched successfully. More...

virtual void	Failed (std::string Message, pkgAcquire::MethodConfig *Cnf)
	Invoked by the acquire worker when the object couldn't be fetched. More...

virtual void	Finished ()
	Invoked by the worker when the download is completely done. More...

pkgAcquire *	GetOwner ()

virtual std::string	HashSum ()
	HashSum. More...

virtual bool	IsTrusted ()

void	RemoveWeakPointer (WeakPointable **weakptr)
	Remove the weak pointer from the list of weak pointers. More...

void	ReportMirrorFailure (std::string FailCode)
	Report mirror problem. More...

virtual std::string	ShortDesc ()
	Short item description. More...

virtual void	Start (std::string Message, unsigned long long Size)
	Invoked when the worker starts to fetch this object. More...

Public Attributes
bool	Complete
	If true, the entire object has been successfully fetched. More...

std::string	DestFile
	The name of the file into which the retrieved object will be written. More...

std::string	ErrorText
	Contains a textual description of the error encountered if Status is StatError or StatAuthError. More...

unsigned long long	FileSize
	The size of the object to fetch. More...

unsigned long	ID
	A client-supplied unique identifier. More...

bool	Local
	If true, the URI of this object is "local". More...

const char *	Mode
	If not NULL, contains the name of a subprocess that is operating on this object (for instance, "gzip" or "gpgv"). More...

unsigned long long	PartialSize
	How much of the object was already fetched. More...

unsigned int	QueueCounter
	The number of fetch queues into which this item has been inserted. More...

enum pkgAcquire::Item::ItemState	Status

std::string	UsedMirror

Protected Member Functions
void	Dequeue ()
	Remove this item from its owner's queue. More...

bool	QueueNext ()
	Queue up the next available file for this version. More...

void	QueueURI (ItemDesc &Item)
	Insert this item into its owner's queue. More...

void	Rename (std::string From, std::string To)
	Rename a file without modifying its timestamp. More...

Protected Attributes
pkgAcquire::ItemDesc	Desc
	The fetch command that is currently being processed. More...

HashString	ExpectedHash
	The hashsum of this package. More...

pkgAcquire *	Owner
	The acquire object with which this item is associated. More...

pkgRecords *	Recs
	A package records object, used to look up the file corresponding to each version of the package. More...

unsigned int	Retries
	How many (more) times to try to find a new source from which to download this package version if it fails. More...

pkgSourceList *	Sources
	The list of sources from which to pick archives to download this package from. More...

std::string &	StoreFilename
	A location in which the actual filename of the package should be stored. More...

bool	Trusted
	true if this version file is being downloaded from a trusted source. More...

pkgCache::VerIterator	Version
	The package version being fetched. More...

pkgCache::VerFileIterator	Vf
	The next file for this version to try to download. More...

Detailed Description

An item that is responsible for fetching a package file.

{{{

If the package file already exists in the cache, nothing will be done.

Member Enumeration Documentation

enum pkgAcquire::Item::ItemState

inherited

The current status of this item.

Enumerator
StatIdle	The item is waiting to be downloaded.
StatFetching	The item is currently being downloaded.
StatDone	The item has been successfully downloaded.
StatError	An error was encountered while downloading this item.
StatAuthError	The item was downloaded but its authenticity could not be verified.
StatTransientNetworkError	The item was could not be downloaded because of a transient network error (e.g. network down)

Constructor & Destructor Documentation

pkgAcqArchive::pkgAcqArchive	(	pkgAcquire *	Owner,
		pkgSourceList *	Sources,
		pkgRecords *	Recs,
		pkgCache::VerIterator const &	Version,
		std::string &	StoreFilename
	)

Create a new pkgAcqArchive.

Parameters

Owner	The pkgAcquire object with which this item is associated.
Sources	The sources from which to download version files.
Recs	A package records object, used to look up the file corresponding to each version of the package.
Version	The package version to download.
StoreFilename	A location in which the actual filename of the package should be stored. It will be set to a guessed basename in the constructor, and filled in with a fully qualified filename once the download finishes.

Member Function Documentation

void WeakPointable::AddWeakPointer ( WeakPointable ** weakptr )

inlineinherited

Add a new weak pointer.

References WeakPointable::pointers.

virtual std::string pkgAcquire::Item::Custom600Headers ( )

inlinevirtualinherited

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 in pkgAcqFile, pkgAcqMetaClearSig, pkgAcqMetaIndex, pkgAcqMetaSig, pkgAcqIndexTrans, pkgAcqIndex, pkgAcqDiffIndex, and pkgAcqSubIndex.

void pkgAcquire::Item::Dequeue ( )

inlineprotectedinherited

Remove this item from its owner's queue.

References pkgAcquire::Dequeue(), and pkgAcquire::Item::Owner.

Here is the call graph for this function:

virtual std::string pkgAcqArchive::DescURI ( )

inlinevirtual

A "descriptive" URI-like string.

Returns: a URI that should be used to describe what is being fetched.

Implements pkgAcquire::Item.

References Desc, and pkgAcquire::ItemDesc::URI.

virtual void pkgAcqArchive::Done	(	std::string	Message,
		unsigned long long	Size,
		std::string	Hash,
		pkgAcquire::MethodConfig *	Cnf
	)

virtual

Invoked by the acquire worker when the object was fetched successfully.

Note that the object might not have been written to DestFile; check for the presence of an Alt-Filename entry in Message to find the file to which it was really written.

Done is often used to switch from one stage of the processing to the next (e.g. fetching, unpacking, copying). It is one branch of the continuation of the fetch process.

Parameters

Message	Data from the acquire method. Use LookupTag() to parse it.
Size	The size of the object that was fetched.
Hash	The HashSum of the object that was fetched.
Cnf	The method via which the object was fetched.

See Also: pkgAcqMethod

Reimplemented from pkgAcquire::Item.

virtual void pkgAcqArchive::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 pkgAcquire::Item.

virtual void pkgAcqArchive::Finished ( )

virtual

Invoked by the worker when the download is completely done.

Reimplemented from pkgAcquire::Item.

pkgAcquire* pkgAcquire::Item::GetOwner ( )

inlineinherited

Returns: the acquire process with which this item is associated.

References pkgAcquire::Item::Owner.

virtual std::string pkgAcqArchive::HashSum ( )

inlinevirtual

HashSum.

Returns: the HashSum of this object, if applicable; otherwise, an empty string.

Reimplemented from pkgAcquire::Item.

References ExpectedHash, and HashString::toStr().

Here is the call graph for this function:

virtual bool pkgAcqArchive::IsTrusted ( )

virtual

Returns: true if this object is being fetched from a trusted source.

Reimplemented from pkgAcquire::Item.

bool pkgAcqArchive::QueueNext ( )

protected

Queue up the next available file for this version.

void pkgAcquire::Item::QueueURI ( ItemDesc & Item )

inlineprotectedinherited

Insert this item into its owner's queue.

Parameters

ItemDesc Metadata about this item (its URI and description).

References pkgAcquire::Enqueue(), and pkgAcquire::Item::Owner.

Here is the call graph for this function:

void WeakPointable::RemoveWeakPointer ( WeakPointable ** weakptr )

inlineinherited

Remove the weak pointer from the list of weak pointers.

References WeakPointable::pointers.

void pkgAcquire::Item::Rename	(	std::string	From,
		std::string	To
	)

protectedinherited

Rename a file without modifying its timestamp.

Many item methods call this as their final action.

Parameters

From	The file to be renamed.
To	The new name of #From. If #To exists it will be overwritten.

void pkgAcquire::Item::ReportMirrorFailure ( std::string FailCode )

inherited

Report mirror problem.

This allows reporting mirror failures back to a centralized server. The apt-report-mirror-failure script is called for this

Parameters

FailCode A short failure string that is send

virtual std::string pkgAcqArchive::ShortDesc ( )

inlinevirtual

Short item description.

Returns: a brief description of the object being fetched.

Reimplemented from pkgAcquire::Item.

References Desc, and pkgAcquire::ItemDesc::ShortDesc.

virtual void pkgAcquire::Item::Start	(	std::string	Message,
		unsigned long long	Size
	)

virtualinherited

Invoked when the worker starts to fetch this object.

Parameters

Message	RFC822-formatted data from the worker process. Use LookupTag() to parse it.
Size	The size of the object being fetched.

See Also: pkgAcqMethod

Member Data Documentation

bool pkgAcquire::Item::Complete

inherited

If true, the entire object has been successfully fetched.

Subclasses should set this to true when appropriate.

pkgAcquire::ItemDesc pkgAcqArchive::Desc

protected

The fetch command that is currently being processed.

Referenced by DescURI(), and ShortDesc().

std::string pkgAcquire::Item::DestFile

inherited

The name of the file into which the retrieved object will be written.

std::string pkgAcquire::Item::ErrorText

inherited

Contains a textual description of the error encountered if Status is StatError or StatAuthError.

HashString pkgAcqArchive::ExpectedHash

protected

The hashsum of this package.

Referenced by HashSum().

unsigned long long pkgAcquire::Item::FileSize

inherited

The size of the object to fetch.

unsigned long pkgAcquire::Item::ID

inherited

A client-supplied unique identifier.

This field is initalized to 0; it is meant to be filled in by clients that wish to use it to uniquely identify items.

Todo:: it's unused in apt itself

bool pkgAcquire::Item::Local

inherited

If true, the URI of this object is "local".

The only effect of this field is to exclude the object from the download progress indicator's overall statistics.

const char* pkgAcquire::Item::Mode

inherited

If not NULL, contains the name of a subprocess that is operating on this object (for instance, "gzip" or "gpgv").

pkgAcquire* pkgAcquire::Item::Owner

protectedinherited

The acquire object with which this item is associated.

Referenced by pkgAcquire::Item::Dequeue(), pkgAcquire::Item::GetOwner(), and pkgAcquire::Item::QueueURI().

unsigned long long pkgAcquire::Item::PartialSize

inherited

How much of the object was already fetched.

unsigned int pkgAcquire::Item::QueueCounter

inherited

The number of fetch queues into which this item has been inserted.

There is one queue for each source from which an item could be downloaded.

See Also: pkgAcquire

pkgRecords* pkgAcqArchive::Recs

protected

A package records object, used to look up the file corresponding to each version of the package.

unsigned int pkgAcqArchive::Retries

protected

How many (more) times to try to find a new source from which to download this package version if it fails.

Set from Acquire::Retries.

pkgSourceList* pkgAcqArchive::Sources

protected

The list of sources from which to pick archives to download this package from.

enum pkgAcquire::Item::ItemState pkgAcquire::Item::Status

inherited

std::string& pkgAcqArchive::StoreFilename

protected

A location in which the actual filename of the package should be stored.

bool pkgAcqArchive::Trusted

protected

true if this version file is being downloaded from a trusted source.

std::string pkgAcquire::Item::UsedMirror

inherited

pkgCache::VerIterator pkgAcqArchive::Version

protected

The package version being fetched.

pkgCache::VerFileIterator pkgAcqArchive::Vf

protected

The next file for this version to try to download.

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

/usr/include/apt-pkg/acquire-item.h

Public Types

Public Member Functions

Public Attributes

Protected Member Functions

Protected Attributes

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation