senf::UDPSocketProtocol Class Reference

Protocol facet to support UDP operations. More...

#include <senf/Socket/Protocols/INet/UDPSocketProtocol.hh>

Inheritance diagram for senf::UDPSocketProtocol:

Abstract Interface Implementation

unsigned available () const
 Return (maximum) number of bytes available for reading without < blocking. More...
 
bool eof () const
 Check for end-of-file condition. More...
 

Additional Inherited Members

- Public Member Functions inherited from senf::INetSocketProtocol
void bindInterface (std::string const &iface) const
 Bind socket to specific interface. More...
 
std::string bindInterface ()
 Get bound interface. More...
 
- Public Member Functions inherited from senf::SocketProtocol
virtual SocketPolicyBase const & policy () const =0
 Access the policy instance. More...
 
virtual void close ()
 Close socket. More...
 
virtual void terminate () const
 Forcibly close socket. More...
 
virtual void state (SocketStateMap &map, unsigned lod) const
 Return socket state information. More...
 
int fd () const
 Get file descriptor. More...
 
 SocketProtocol ()
 
virtual ~SocketProtocol ()=0
 
- Protected Member Functions inherited from senf::SocketProtocol
FileHandle fh () const
 Get a FileHandle for this instance. More...
 
void fd (int) const
 Initialize file descriptor. More...
 

Detailed Description

Protocol facet to support UDP operations.

This protocol facet provides all those protocol functions, which are available on any UDP socket.

Definition at line 37 of file UDPSocketProtocol.hh.

Member Function Documentation

◆ available()

unsigned senf::UDPSocketProtocol::available ( ) const
virtual

Return (maximum) number of bytes available for reading without < blocking.

This member will check in a (very, sigh) protocol dependent way, how many bytes may be read from a socket in a single (non-blocking) read operation. If the socket does not support reading (viz. NotReadablePolicy is set), this member should always return 0.

Depending on the protocol, it may not be possible to return a good value. In this case, an upper bound may be returned (e.g.: When reading from a socket which returns ethernet frames, returning 1500 from available() is ok). However, this should only be done as a last resort. Also beware, that this number should not be too large since the socket layer will always need to allocate that number of bytes for the data to be read.

Implements senf::SocketProtocol.

Definition at line 29 of file UDPSocketProtocol.cc.

◆ eof()

bool senf::UDPSocketProtocol::eof ( ) const
virtual

Check for end-of-file condition.

This is another check which (like available()) is extremely protocol dependent. This member will return true only, if at end-of-file. If the protocol does not support the notion of EOF, this member should always return false.

Implements senf::SocketProtocol.

Definition at line 38 of file UDPSocketProtocol.cc.


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