/*!
Writes a block of \a size bytes from \a data to the socket.
Returns the number of bytes written, or -1 if an error occurred.
*/
qint64 QNativeSocketEngine::write(const char *data, qint64 size)
{
Q_D(QNativeSocketEngine);
Q_CHECK_VALID_SOCKETLAYER(QNativeSocketEngine::write(), -1);
Q_CHECK_STATE(QNativeSocketEngine::write(), QAbstractSocket::ConnectedState, -1);
return d->nativeWrite(data, size);
}
/*!
\since 4.8
*/
bool QNativeSocketEngine::leaveMulticastGroup(const QHostAddress &groupAddress,
const QNetworkInterface &iface)
{
Q_D(QNativeSocketEngine);
Q_CHECK_VALID_SOCKETLAYER(QNativeSocketEngine::leaveMulticastGroup(), false);
Q_CHECK_STATE(QNativeSocketEngine::leaveMulticastGroup(), QAbstractSocket::BoundState, false);
Q_CHECK_TYPE(QNativeSocketEngine::leaveMulticastGroup(), QAbstractSocket::UdpSocket, false);
return d->nativeLeaveMulticastGroup(groupAddress, iface);
}
/*!
Accepts a pending connection from the socket, which must be in
ListeningState, and returns its socket descriptor. If no pending
connections are available, -1 is returned.
\sa bind(), listen()
*/
int QNativeSocketEngine::accept()
{
Q_D(QNativeSocketEngine);
Q_CHECK_VALID_SOCKETLAYER(QNativeSocketEngine::accept(), -1);
Q_CHECK_STATE(QNativeSocketEngine::accept(), QAbstractSocket::ListeningState, false);
Q_CHECK_TYPE(QNativeSocketEngine::accept(), QAbstractSocket::TcpSocket, false);
return d->nativeAccept();
}
/*!
Prepares a TCP server for accepting incoming connections. This
function must be called after bind(), and only by TCP sockets.
After this function has been called, pending client connections
are detected by checking if the socket is ready for reading. This
can be done by either creating a QSocketNotifier, passing the
socket descriptor returned by socketDescriptor(), or by calling
the blocking function waitForRead().
Example:
\snippet doc/src/snippets/code/src_network_socket_qnativesocketengine.cpp 1
\sa bind(), accept()
*/
bool QNativeSocketEngine::listen()
{
Q_D(QNativeSocketEngine);
Q_CHECK_VALID_SOCKETLAYER(QNativeSocketEngine::listen(), false);
Q_CHECK_STATE(QNativeSocketEngine::listen(), QAbstractSocket::BoundState, false);
Q_CHECK_TYPE(QNativeSocketEngine::listen(), QAbstractSocket::TcpSocket, false);
// We're using a backlog of 50. Most modern kernels support TCP
// syncookies by default, and if they do, the backlog is ignored.
// When there is no support for TCP syncookies, this value is
// fine.
return d->nativeListen(50);
}
/*!
Binds the socket to the address \a address and port \a
port. Returns true on success; otherwise false is returned. The
port may be 0, in which case an arbitrary unused port is assigned
automatically by the operating system.
Servers call this function to set up the server's address and
port. TCP servers must in addition call listen() after bind().
*/
bool QNativeSocketEngine::bind(const QHostAddress &address, quint16 port)
{
Q_D(QNativeSocketEngine);
Q_CHECK_VALID_SOCKETLAYER(QNativeSocketEngine::bind(), false);
if (!d->checkProxy(address))
return false;
Q_CHECK_STATE(QNativeSocketEngine::bind(), QAbstractSocket::UnconnectedState, false);
if (!d->nativeBind(address, port))
return false;
d->fetchConnectionParameters();
return true;
}
/*!
\since 4.8
*/
bool QNativeSocketEngine::joinMulticastGroup(const QHostAddress &groupAddress,
const QNetworkInterface &iface)
{
Q_D(QNativeSocketEngine);
Q_CHECK_VALID_SOCKETLAYER(QNativeSocketEngine::joinMulticastGroup(), false);
Q_CHECK_STATE(QNativeSocketEngine::joinMulticastGroup(), QAbstractSocket::BoundState, false);
Q_CHECK_TYPE(QNativeSocketEngine::joinMulticastGroup(), QAbstractSocket::UdpSocket, false);
// if the user binds a socket to an IPv6 address (or QHostAddress::Any) and
// then attempts to join an IPv4 multicast group, this won't work on
// Windows. In order to make this cross-platform, we warn & fail on all
// platforms.
if (groupAddress.protocol() == QAbstractSocket::IPv4Protocol &&
(d->socketProtocol == QAbstractSocket::IPv6Protocol ||
d->socketProtocol == QAbstractSocket::AnyIPProtocol)) {
qWarning("QAbstractSocket: cannot bind to QHostAddress::Any (or an IPv6 address) and join an IPv4 multicast group;"
" bind to QHostAddress::AnyIPv4 instead if you want to do this");
return false;
}
return d->nativeJoinMulticastGroup(groupAddress, iface);
}
/*!
Binds the socket to the address \a address and port \a
port. Returns true on success; otherwise false is returned. The
port may be 0, in which case an arbitrary unused port is assigned
automatically by the operating system.
Servers call this function to set up the server's address and
port. TCP servers must in addition call listen() after bind().
*/
bool QNativeSocketEngine::bind(const QHostAddress &address, quint16 port)
{
Q_D(QNativeSocketEngine);
Q_CHECK_VALID_SOCKETLAYER(QNativeSocketEngine::bind(), false);
#if defined (QT_NO_IPV6)
if (address.protocol() == QAbstractSocket::IPv6Protocol) {
d->setError(QAbstractSocket::UnsupportedSocketOperationError,
QNativeSocketEnginePrivate::NoIpV6ErrorString);
return false;
}
#endif
if (!d->checkProxy(address))
return false;
Q_CHECK_STATE(QNativeSocketEngine::bind(), QAbstractSocket::UnconnectedState, false);
if (!d->nativeBind(address, port))
return false;
d->fetchConnectionParameters();
return true;
}
