implements a forwarder-side transport that can be paired with another
More...
#include <daemon/face/internal-transport.hpp>
implements a forwarder-side transport that can be paired with another
Definition at line 56 of file internal-transport.hpp.
identifies an endpoint on the link
Definition at line 118 of file transport.hpp.
nfd::face::InternalForwarderTransport::InternalForwarderTransport |
( |
const FaceUri & |
localUri = FaceUri("internal://") , |
|
|
const FaceUri & |
remoteUri = FaceUri("internal://") , |
|
|
ndn::nfd::FaceScope |
scope = ndn::nfd::FACE_SCOPE_LOCAL , |
|
|
ndn::nfd::LinkType |
linkType = ndn::nfd::LINK_TYPE_POINT_TO_POINT |
|
) |
| |
void nfd::face::Transport::afterChangePersistency |
( |
ndn::nfd::FacePersistency |
oldPersistency | ) |
|
|
protectedvirtualinherited |
bool nfd::face::Transport::canChangePersistencyTo |
( |
ndn::nfd::FacePersistency |
newPersistency | ) |
const |
|
inherited |
check whether the face persistency can be changed to newPersistency
This function serves as the external API, and invokes the protected function canChangePersistencyToImpl to perform further checks if newPersistency
differs from the current persistency.
- Returns
- true if the change can be performed, false otherwise
Definition at line 136 of file transport.cpp.
bool nfd::face::Transport::canChangePersistencyToImpl |
( |
ndn::nfd::FacePersistency |
newPersistency | ) |
const |
|
protectedvirtualinherited |
void nfd::face::Transport::close |
( |
| ) |
|
|
inherited |
request the transport to be closed
This operation is effective only if transport is in UP or DOWN state, otherwise it has no effect. The transport changes state to CLOSING, and performs cleanup procedure. The state will be changed to CLOSED when cleanup is complete, which may happen synchronously or asynchronously.
Definition at line 85 of file transport.cpp.
void nfd::face::InternalForwarderTransport::doClose |
( |
| ) |
|
|
overrideprotectedvirtual |
performs Transport specific operations to close the transport
This is invoked once by close()
after changing state to CLOSING. It will not be invoked by Transport class if the transport is already CLOSING or CLOSED.
When the cleanup procedure is complete, this method should change state to CLOSED. This transition can happen synchronously or asynchronously.
Implements nfd::face::Transport.
Definition at line 67 of file internal-transport.cpp.
time::steady_clock::TimePoint nfd::face::Transport::getExpirationTime |
( |
| ) |
const |
|
inlineinherited |
- Returns
- expiration time of the transport
- Return values
-
time::steady_clock::TimePoint::max() | the transport has indefinite lifetime |
Definition at line 490 of file transport.hpp.
const Face * nfd::face::Transport::getFace |
( |
| ) |
const |
|
inlineinherited |
const LinkService * nfd::face::Transport::getLinkService |
( |
| ) |
const |
|
inlineinherited |
ndn::nfd::LinkType nfd::face::Transport::getLinkType |
( |
| ) |
const |
|
inlineinherited |
- Returns
- whether face is point-to-point or multi-access
Definition at line 447 of file transport.hpp.
FaceUri nfd::face::Transport::getLocalUri |
( |
| ) |
const |
|
inlineinherited |
- Returns
- a FaceUri representing local endpoint
Definition at line 405 of file transport.hpp.
ssize_t nfd::face::Transport::getMtu |
( |
| ) |
const |
|
inlineinherited |
- Returns
- maximum payload size
- Return values
-
MTU_UNLIMITED | transport has no limit on payload size |
This size is the maximum packet size that can be sent or received through this transport.
For a datagram-based transport, this is typically the Maximum Transmission Unit (MTU), after the overhead of headers introduced by the transport has been accounted for. For a stream-based transport, this is typically unlimited (MTU_UNLIMITED).
Definition at line 459 of file transport.hpp.
ndn::nfd::FacePersistency nfd::face::Transport::getPersistency |
( |
| ) |
const |
|
inlineinherited |
FaceUri nfd::face::Transport::getRemoteUri |
( |
| ) |
const |
|
inlineinherited |
- Returns
- a FaceUri representing remote endpoint
Definition at line 417 of file transport.hpp.
ndn::nfd::FaceScope nfd::face::Transport::getScope |
( |
| ) |
const |
|
inlineinherited |
- Returns
- whether face is local or non-local for scope control purpose
Definition at line 429 of file transport.hpp.
ssize_t nfd::face::Transport::getSendQueueCapacity |
( |
| ) |
const |
|
inlineinherited |
- Returns
- capacity of the send queue (in bytes)
- Return values
-
QUEUE_UNSUPPORTED | transport does not support queue capacity retrieval |
QUEUE_ERROR | transport was unable to retrieve the queue capacity |
Definition at line 472 of file transport.hpp.
ssize_t nfd::face::Transport::getSendQueueLength |
( |
| ) |
|
|
virtualinherited |
- Returns
- current send queue length of the transport (in octets)
- Return values
-
QUEUE_UNSUPPORTED | transport does not support queue length retrieval |
QUEUE_ERROR | transport was unable to retrieve the queue length |
Reimplemented in nfd::face::MulticastUdpTransport, nfd::face::DatagramTransport< Protocol, Addressing >, nfd::face::DatagramTransport< boost::asio::ip::udp, Unicast >, nfd::face::DatagramTransport< boost::asio::ip::udp, Multicast >, nfd::face::StreamTransport< Protocol >, nfd::face::StreamTransport< boost::asio::ip::tcp >, nfd::face::StreamTransport< boost::asio::local::stream_protocol >, and nfd::face::TcpTransport.
Definition at line 130 of file transport.cpp.
void nfd::face::Transport::receive |
( |
Packet && |
packet | ) |
|
|
protectedinherited |
receive a link-layer packet
- Warning
- undefined behavior if packet size exceeds MTU limit
Definition at line 118 of file transport.cpp.
void nfd::face::InternalForwarderTransport::receiveFromLink |
( |
const Block & |
packet | ) |
|
|
overridevirtual |
void nfd::face::Transport::send |
( |
Packet && |
packet | ) |
|
|
inherited |
send a link-layer packet
- Note
- This operation has no effect if
getState()
is neither UP nor DOWN
- Warning
- undefined behavior if packet size exceeds MTU limit
Definition at line 98 of file transport.cpp.
void nfd::face::Transport::setExpirationTime |
( |
const time::steady_clock::TimePoint & |
expirationTime | ) |
|
|
inlineprotectedinherited |
void nfd::face::Transport::setFaceAndLinkService |
( |
Face & |
face, |
|
|
LinkService & |
service |
|
) |
| |
|
inherited |
void nfd::face::Transport::setLinkType |
( |
ndn::nfd::LinkType |
linkType | ) |
|
|
inlineprotectedinherited |
void nfd::face::Transport::setLocalUri |
( |
const FaceUri & |
uri | ) |
|
|
inlineprotectedinherited |
void nfd::face::Transport::setMtu |
( |
ssize_t |
mtu | ) |
|
|
inlineprotectedinherited |
void nfd::face::Transport::setPersistency |
( |
ndn::nfd::FacePersistency |
newPersistency | ) |
|
|
inherited |
void nfd::face::Transport::setRemoteUri |
( |
const FaceUri & |
uri | ) |
|
|
inlineprotectedinherited |
void nfd::face::Transport::setScope |
( |
ndn::nfd::FaceScope |
scope | ) |
|
|
inlineprotectedinherited |
void nfd::face::Transport::setSendQueueCapacity |
( |
ssize_t |
sendQueueCapacity | ) |
|
|
inlineprotectedinherited |
set transport state
Only the following transitions are valid: UP->DOWN, DOWN->UP, UP/DOWN->CLOSING/FAILED, CLOSING/FAILED->CLOSED
- Exceptions
-
std::runtime_error | transition is invalid. |
Definition at line 181 of file transport.cpp.
signals when transport state changes
Definition at line 281 of file transport.hpp.
total incoming bytes
This counter includes headers imposed by NFD (such as NDNLP), but excludes overhead of underlying protocol (such as IP header). For a datagram-based transport, an incoming packet that cannot be parsed as TLV would not be counted.
Definition at line 83 of file transport.hpp.
count of incoming packets
A 'packet' typically means a top-level TLV block. For a datagram-based transport, an incoming packet that cannot be parsed as TLV would not be counted.
Definition at line 67 of file transport.hpp.
total outgoing bytes
This counter includes headers imposed by NFD (such as NDNLP), but excludes overhead of underlying protocol (such as IP header). This counter is increased only if transport is UP.
Definition at line 91 of file transport.hpp.
count of outgoing packets
A 'packet' typically means a top-level TLV block. This counter is incremented only if transport is UP.
Definition at line 74 of file transport.hpp.