apt  0.9.12.1
Public Member Functions | Protected Attributes | List of all members
pkgAcqMetaSig Class Reference

An acquire item that downloads the detached signature {{{ of a meta-index (Release) file, then queues up the release file itself. More...

#include <acquire-item.h>

Inheritance diagram for pkgAcqMetaSig:
pkgAcquire::Item WeakPointable

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 Custom600Headers ()
 Custom headers to be sent to the fetch process. More...
 
virtual std::string DescURI ()
 A "descriptive" URI-like string. More...
 
 pkgAcqMetaSig (pkgAcquire *Owner, std::string URI, std::string URIDesc, std::string ShortDesc, std::string MetaIndexURI, std::string MetaIndexURIDesc, std::string MetaIndexShortDesc, const std::vector< struct IndexTarget * > *IndexTargets, indexRecords *MetaIndexParser)
 Create a new pkgAcqMetaSig.
 
- 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. 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...
 
pkgAcquireGetOwner ()
 
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.
 
- Public Member Functions inherited from WeakPointable
void AddWeakPointer (WeakPointable **weakptr)
 
void RemoveWeakPointer (WeakPointable **weakptr)
 
 ~WeakPointable ()
 

Protected Attributes

std::string LastGoodSig
 The last good signature file.
 
pkgAcquire::ItemDesc Desc
 The fetch request that is currently being processed.
 
std::string RealURI
 The URI of the signature file. Unlike Desc.URI, this is never modified; it is used to determine the file that is being downloaded.
 
std::string MetaIndexURI
 The URI of the meta-index file to be fetched after the signature.
 
std::string MetaIndexURIDesc
 A "URI-style" description of the meta-index file to be fetched after the signature.
 
std::string MetaIndexShortDesc
 A brief description of the meta-index file to be fetched after the signature.
 
indexRecordsMetaIndexParser
 A package-system-specific parser for the meta-index file.
 
const std::vector< struct
IndexTarget * > * 
IndexTargets
 The index files which should be looked up in the meta-index and then downloaded. More...
 
- Protected Attributes inherited from pkgAcquire::Item
pkgAcquireOwner
 The acquire object with which this item is associated.
 

Additional Inherited Members

- Public Types inherited from pkgAcquire::Item
enum  ItemState {
  StatIdle, StatFetching, StatDone, StatError,
  StatAuthError, StatTransientNetworkError
}
 The current status of this item. More...
 
- Public Attributes inherited from pkgAcquire::Item
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.
 
- Protected Types inherited from pkgAcquire::Item
enum  RenameOnErrorState { HashSumMismatch, SizeMismatch, InvalidFormat }
 
- Protected Member Functions inherited from pkgAcquire::Item
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...
 
bool RenameOnError (RenameOnErrorState const state)
 Rename failed file and set error. More...
 

Detailed Description

An acquire item that downloads the detached signature {{{ of a meta-index (Release) file, then queues up the release file itself.

Todo:
Why protected members?
See Also
pkgAcqMetaIndex

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

References LastGoodSig.

virtual std::string DescURI ( )
inlinevirtual

A "descriptive" URI-like string.

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

Implements pkgAcquire::Item.

References RealURI.

void 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
MessageData from the acquire method. Use LookupTag() to parse it.
SizeThe size of the object that was fetched.
HashThe HashSum of the object that was fetched.
CnfThe method via which the object was fetched.
See Also
pkgAcqMethod

Reimplemented from pkgAcquire::Item.

References pkgAcquire::Item::Complete, Desc, pkgAcquire::Item::DestFile, pkgAcquire::Item::ErrorText, IndexTargets, LastGoodSig, pkgAcquire::Item::Local, MetaIndexShortDesc, MetaIndexURI, MetaIndexURIDesc, pkgAcquire::Item::QueueURI(), pkgAcquire::Item::Rename(), pkgAcquire::Item::StatError, and pkgAcquire::ItemDesc::URI.

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
MessageAn RFC822-formatted message from the acquire method describing what went wrong. Use LookupTag() to parse it.
CnfThe method via which the worker tried to fetch this object.
See Also
pkgAcqMethod

Reimplemented from pkgAcquire::Item.

References pkgAcquire::Item::Complete, pkgAcquire::Item::Dequeue(), IndexTargets, LastGoodSig, pkgAcquire::MethodConfig::LocalOnly, MetaIndexShortDesc, MetaIndexURI, MetaIndexURIDesc, RealURI, pkgAcquire::Item::Rename(), pkgAcquire::Item::StatDone, and pkgAcquire::Item::StatTransientNetworkError.

Member Data Documentation

const std::vector<struct IndexTarget*>* IndexTargets
protected

The index files which should be looked up in the meta-index and then downloaded.

Todo:
Why a list of pointers instead of a list of structs?

Referenced by Done(), and Failed().


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