4
\description{Creates a new \code{\link{GSocket}} with the defined family, type and protocol.
5
If \code{protocol} is 0 (\code{G_SOCKET_PROTOCOL_DEFAULT}) the default protocol type
6
for the family and type is used.}
7
\usage{gSocketNew(family, type, protocol, .errwarn = TRUE)}
9
\item{\verb{family}}{the socket family to use, e.g. \code{G_SOCKET_FAMILY_IPV4}.}
10
\item{\verb{type}}{the socket type to use.}
11
\item{\verb{protocol}}{the id of the protocol to use, or 0 for default.}
12
\item{.errwarn}{Whether to issue a warning on error or fail silently}
14
\details{The \code{protocol} is a family and type specific int that specifies what
15
kind of protocol to use. \code{\link{GSocketProtocol}} lists several common ones.
16
Many families only support one protocol, and use 0 for this, others
17
support several and using 0 means to use the default protocol for
20
The protocol id is passed directly to the operating
21
system, so you can use protocols not listed in \code{\link{GSocketProtocol}} if you
22
know the protocol number used for it.
25
A list containing the following elements:
26
\item{retval}{[\code{\link{GSocket}}] a \code{\link{GSocket}} or \code{NULL} on error.}
27
\item{\verb{error}}{\code{\link{GError}} for error reporting, or \code{NULL} to ignore.}
29
\author{Derived by RGtkGen from GTK+ documentation}