|void||comm_read_base (const Comm::ConnectionPointer &conn, char *buf, int size, AsyncCall::Pointer &callback)|
|void||comm_read_cancel (int fd, IOCB *callback, void *data)|
|void comm_read_base||(||const Comm::ConnectionPointer &||conn,|
Queue a read. If a buffer is given the callback is scheduled when the read completes, on error, or on file descriptor close.
If no buffer (NULL) is given the callback is scheduled when the socket FD is ready for a read(2)/recv(2).
References assert, COMM_SELECT_READ, COMMIO_FD_READCB, commStopHalfClosedMonitor(), conn, debugs, Comm::Connection::fd, fd_table, Comm::HandleRead, Comm::IOCB_READ, Comm::IsConnOpen(), NULL, and Comm::SetSelect().
Cancel a pending read. Assert that we have the right parameters, and that there are no pending read events!
XXX: We do not assert that there are no pending read events and with async calls it becomes even more difficult. The whole interface should be reworked to do callback->cancel() instead of searching for places where the callback may be stored and updating the state of those places.
AHC Don't call the comm handlers?
References Comm::IoCallback::active(), assert, Comm::IoCallback::callback, Comm::IoCallback::cancel(), COMM_SELECT_READ, COMMIO_FD_READCB, debugs, RefCount< C >::getRaw(), isOpen(), NULL, and Comm::SetSelect().