gSocketClientConnectToService: gSocketClientConnectToService
Description
Attempts to create a TCP connection to a service.Usage
gSocketClientConnectToService(object, domain, service, cancellable = NULL, .errwarn = TRUE)
Arguments
service
the name of the service to connect to
.errwarn
Whether to issue a warning on error or fail silently
Details
This call looks up the SRV record for service at domain for the
"tcp" protocol. It then attempts to connect, in turn, to each of
the hosts providing the service until either a connection succeeds
or there are no hosts remaining.
Upon a successful connection, a new GSocketConnection is constructed
and returned. The caller owns this new object and must drop their
reference to it when finished with it.
In the event of any failure (DNS error, service not found, no hosts
connectable) NULL is returned and error (if non-NULL) is set
accordingly.