Enum glean_core::upload::PingUploadTask [−][src]
pub enum PingUploadTask {
Upload(PingRequest),
Wait(u64),
Done,
}
Expand description
An enum representing the possible upload tasks to be performed by an uploader.
When asking for the next ping request to upload, the requester may receive one out of three possible tasks.
If new variants are added, this should be reflected in glean-core/ffi/src/upload.rs
as well.
Variants
Upload(PingRequest)
Tuple Fields
0: PingRequest
A PingRequest popped from the front of the queue.
See PingRequest
for more information.
Wait(u64)
Tuple Fields
0: u64
A flag signaling that the pending pings directories are not done being processed, thus the requester should wait and come back later.
Contains the amount of time in milliseconds the requester should wait before requesting a new task.
Done
A flag signaling that requester doesn’t need to request any more upload tasks at this moment.
There are three possibilities for this scenario:
- Pending pings queue is empty, no more pings to request;
- Requester has gotten more than MAX_WAIT_ATTEMPTS (3, by default)
PingUploadTask::Wait
responses in a row; - Requester has reported more than MAX_RECOVERABLE_FAILURES_PER_UPLOADING_WINDOW recoverable upload failures on the same uploading window (see below) and should stop requesting at this moment.
An “uploading window” starts when a requester gets a new
PingUploadTask::Upload(PingRequest)
response and finishes when they
finally get a PingUploadTask::Done
or PingUploadTask::Wait
response.
Implementations
Trait Implementations
This method tests for self
and other
values to be equal, and is used
by ==
. Read more
This method tests for !=
.