Protocol_Status (changes)

Showing changes from revision #0 to #1: Added | Removed | Changed

URL_Fetcher

» Protocol module interface

» Protocol_Status

Protocol_Status

(SWI SWI_base+1)

Monitor data transfer.

Interrupts

Interrupt status is protocol module dependent.

Re-entrancy

SWI re-entrancy is protocol module dependent.

Use

This SWI is used to monitor the transfer of data from the remote service. It is protocol independent, with the exit status bits of R0 being common to all fetcher services. R2 should contain the remote server’s most recent response code where possible; note that even in the case of, for example, an HTTP 400 (Forbidden) response, some explanatory data may be received, and thus R3 may be non-zero. If the client is unknown to the protocol module then an error should be returned. If the client’s last request has finished, but the client session has not yet been deregistered, then the protocol module should return the status code as of the time that the request finished (ie bit 6 or 5 will be set along with another combination if relevant).

The URL module calls this SWI in response to one of its clients calling SWI URL_Status.

Note that the session identifiers passed in R1 are not the same identifiers used by clients to talk to the URL module. They are not interchangeable.

Related SWIs

• URL_Status
• URL_ProtocolRegister
• URL_ProtocolDeregister
• HTTP_Status?

Related vectors

None