apt
0.9.7.1ubuntu2
|
An item that is responsible for fetching a package file. {{{. More...
#include <acquire-item.h>
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 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. | |
virtual std::string | DescURI () |
A "descriptive" URI-like string. | |
virtual std::string | ShortDesc () |
Short item description. | |
virtual void | Finished () |
Invoked by the worker when the download is completely done. | |
virtual std::string | HashSum () |
HashSum. | |
virtual bool | IsTrusted () |
pkgAcqArchive (pkgAcquire *Owner, pkgSourceList *Sources, pkgRecords *Recs, pkgCache::VerIterator const &Version, std::string &StoreFilename) | |
Create a new pkgAcqArchive. | |
![]() | |
virtual void | Start (std::string Message, unsigned long long Size) |
Invoked when the worker starts to fetch this object. | |
virtual std::string | Custom600Headers () |
Custom headers to be sent to the fetch process. | |
pkgAcquire * | GetOwner () |
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. | |
![]() | |
void | AddWeakPointer (WeakPointable **weakptr) |
void | RemoveWeakPointer (WeakPointable **weakptr) |
~WeakPointable () |
Protected Member Functions | |
bool | QueueNext () |
Queue up the next available file for this version. | |
![]() | |
void | QueueURI (ItemDesc &Item) |
Insert this item into its owner's queue. | |
void | Dequeue () |
Remove this item from its owner's queue. | |
void | Rename (std::string From, std::string To) |
Rename a file without modifying its timestamp. |
Protected Attributes | |
pkgCache::VerIterator | Version |
The package version being fetched. | |
pkgAcquire::ItemDesc | Desc |
The fetch command that is currently being processed. | |
pkgSourceList * | Sources |
The list of sources from which to pick archives to download this package from. | |
pkgRecords * | Recs |
A package records object, used to look up the file corresponding to each version of the package. | |
HashString | ExpectedHash |
The hashsum of this package. | |
std::string & | StoreFilename |
A location in which the actual filename of the package should be stored. | |
pkgCache::VerFileIterator | Vf |
The next file for this version to try to download. | |
unsigned int | Retries |
How many (more) times to try to find a new source from which to download this package version if it fails. | |
bool | Trusted |
true if this version file is being downloaded from a trusted source. | |
![]() | |
pkgAcquire * | Owner |
The acquire object with which this item is associated. |
Additional Inherited Members | |
![]() | |
enum | ItemState { StatIdle, StatFetching, StatDone, StatError, StatAuthError, StatTransientNetworkError } |
The current status of this item. More... | |
![]() | |
enum pkgAcquire::Item::ItemState | Status |
std::string | ErrorText |
Contains a textual description of the error encountered if #Status is StatError or StatAuthError. | |
unsigned long long | FileSize |
The size of the object to fetch. | |
unsigned long long | PartialSize |
How much of the object was already fetched. | |
const char * | Mode |
If not NULL, contains the name of a subprocess that is operating on this object (for instance, "gzip" or "gpgv"). | |
unsigned long | ID |
A client-supplied unique identifier. | |
bool | Complete |
If true, the entire object has been successfully fetched. | |
bool | Local |
If true, the URI of this object is "local". | |
std::string | UsedMirror |
unsigned int | QueueCounter |
The number of fetch queues into which this item has been inserted. | |
std::string | DestFile |
The name of the file into which the retrieved object will be written. |
An item that is responsible for fetching a package file. {{{.
If the package file already exists in the cache, nothing will be done.
pkgAcqArchive | ( | pkgAcquire * | Owner, |
pkgSourceList * | Sources, | ||
pkgRecords * | Recs, | ||
pkgCache::VerIterator const & | Version, | ||
std::string & | StoreFilename | ||
) |
Create a new pkgAcqArchive.
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. |
References QueueNext(), Retries, Trusted, and Vf.
|
inlinevirtual |
A "descriptive" URI-like string.
Implements pkgAcquire::Item.
References Desc, and pkgAcquire::ItemDesc::URI.
|
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.
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. |
Reimplemented from pkgAcquire::Item.
References pkgAcquire::Item::Complete, pkgAcquire::Item::DestFile, pkgAcquire::Item::ErrorText, pkgAcquire::Item::Local, pkgAcquire::Item::Rename(), pkgAcquire::Item::StatError, StoreFilename, and Version.
|
virtual |
Invoked by the acquire worker when the object couldn't be fetched.
This is a branch of the continuation of the fetch process.
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. |
Reimplemented from pkgAcquire::Item.
References pkgAcquire::Item::ErrorText, pkgAcquire::MethodConfig::LocalOnly, QueueNext(), pkgAcquire::MethodConfig::Removable, Retries, StoreFilename, Version, and Vf.
|
inlinevirtual |
HashSum.
Reimplemented from pkgAcquire::Item.
References ExpectedHash.
|
virtual |
Reimplemented from pkgAcquire::Item.
References Trusted.
|
inlinevirtual |
Short item description.
Reimplemented from pkgAcquire::Item.
References Desc, and pkgAcquire::ItemDesc::ShortDesc.
|
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.
Referenced by Failed(), and pkgAcqArchive().