apt
0.9.11.4
|
An item that is responsible for fetching an index file of {{{ package list diffs and starting the package list's download. 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. More... | |
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. More... | |
virtual std::string | DescURI () |
A "descriptive" URI-like string. More... | |
virtual std::string | Custom600Headers () |
Custom headers to be sent to the fetch process. More... | |
bool | ParseDiffIndex (std::string IndexDiffFile) |
Parse the Index file for a set of Packages diffs. More... | |
pkgAcqDiffIndex (pkgAcquire *Owner, std::string URI, std::string URIDesc, std::string ShortDesc, HashString ExpectedHash) | |
Create a new pkgAcqDiffIndex. More... | |
![]() | |
virtual void | Start (std::string Message, unsigned long long Size) |
Invoked when the worker starts to fetch this object. More... | |
virtual std::string | ShortDesc () |
Short item description. More... | |
virtual void | Finished () |
Invoked by the worker when the download is completely done. | |
virtual std::string | HashSum () |
HashSum. More... | |
pkgAcquire * | GetOwner () |
virtual bool | IsTrusted () |
void | ReportMirrorFailure (std::string FailCode) |
Report mirror problem. More... | |
Item (pkgAcquire *Owner) | |
Initialize an item. More... | |
virtual | ~Item () |
Remove this item from its owner's queue by invoking pkgAcquire::Remove. | |
![]() | |
void | AddWeakPointer (WeakPointable **weakptr) |
void | RemoveWeakPointer (WeakPointable **weakptr) |
~WeakPointable () | |
Protected Attributes | |
bool | Debug |
If true, debugging information will be written to std::clog. | |
pkgAcquire::ItemDesc | Desc |
The item that is currently being downloaded. | |
std::string | RealURI |
The URI of the index file to recreate at our end (either by downloading it or by applying partial patches). | |
HashString | ExpectedHash |
The Hash that the real index file should have after all patches have been applied. | |
std::string | CurrentPackagesFile |
The index file which will be patched to generate the new file. | |
std::string | Description |
A description of the Packages file (stored in pkgAcquire::ItemDesc::Description). | |
![]() | |
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. More... | |
bool | Complete |
If true, the entire object has been successfully fetched. More... | |
bool | Local |
If true, the URI of this object is "local". More... | |
std::string | UsedMirror |
unsigned int | QueueCounter |
The number of fetch queues into which this item has been inserted. More... | |
std::string | DestFile |
The name of the file into which the retrieved object will be written. | |
![]() | |
void | QueueURI (ItemDesc &Item) |
Insert this item into its owner's queue. More... | |
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. More... | |
An item that is responsible for fetching an index file of {{{ package list diffs and starting the package list's download.
This item downloads the Index file and parses it, then enqueues additional downloads of either the individual patches (using pkgAcqIndexDiffs) or the entire Packages file (using pkgAcqIndex).
pkgAcqDiffIndex | ( | pkgAcquire * | Owner, |
std::string | URI, | ||
std::string | URIDesc, | ||
std::string | ShortDesc, | ||
HashString | ExpectedHash | ||
) |
Create a new pkgAcqDiffIndex.
Owner | The Acquire object that owns this item. |
URI | The URI of the list file to download. |
URIDesc | A long description of the list file to download. |
ShortDesc | A short description of the list file to download. |
ExpectedHash | The list file's MD5 signature. |
References CurrentPackagesFile, Debug, Desc, pkgAcquire::ItemDesc::Description, pkgAcquire::Item::DestFile, Failed(), pkgAcquire::ItemDesc::Owner, pkgAcquire::Item::QueueURI(), RealURI, pkgAcquire::Item::ShortDesc(), pkgAcquire::ItemDesc::ShortDesc, and pkgAcquire::ItemDesc::URI.
|
virtual |
Custom headers to be sent to the fetch process.
Reimplemented from pkgAcquire::Item.
|
inlinevirtual |
A "descriptive" URI-like string.
Implements pkgAcquire::Item.
References RealURI.
|
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, Debug, pkgAcquire::Item::Dequeue(), Desc, pkgAcquire::Item::DestFile, Failed(), ParseDiffIndex(), RealURI, pkgAcquire::Item::Rename(), pkgAcquire::Item::StatDone, and pkgAcquire::ItemDesc::URI.
|
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::Complete, Debug, pkgAcquire::Item::Dequeue(), Desc, Description, ExpectedHash, pkgAcquire::Item::Owner, RealURI, pkgAcquire::ItemDesc::ShortDesc, pkgAcquire::Item::StatDone, and pkgAcquire::ItemDesc::URI.
Referenced by Done(), and pkgAcqDiffIndex().
bool ParseDiffIndex | ( | std::string | IndexDiffFile) |
Parse the Index file for a set of Packages diffs.
Parses the Index file and creates additional download items as necessary.
IndexDiffFile | The name of the Index file. |
References pkgAcquire::Item::Complete, CurrentPackagesFile, Debug, pkgAcquire::Item::Dequeue(), Desc, Description, ExpectedHash, DiffInfo::file, pkgAcquire::Item::Owner, RealURI, DiffInfo::sha1, pkgAcquire::ItemDesc::ShortDesc, and pkgAcquire::Item::StatDone.
Referenced by Done().