$sock » History » Revision 11
Revision 10 (Per Amundsen, 02/11/2021 10:02 PM) → Revision 11/12 (Per Amundsen, 01/09/2023 11:46 PM)
_Added in 1.9.0_
*$sock(name,[N])*
Returns information about a the Nth socket connection.
*Parameters*
name - Name to lookup, can be a [[Scripting_Wildcards|wildcard]].
[N} - If N = 0, number of matches, otherwise the Nth match. (optionally)
*Properties*
.name - Name of the socket.
.addr - Hostname the socket is connected to.
.sent - Number of bytes sent.
.rcvd - Number of bytes received.
.sq - Number of bytes in send queue.
.rq - Number of bytes in receive queue.
.status - Status of the connection: paused/active.
.ip - IP Addresss the socket is connected to.
.port - Port the socket is connected to.
.ls - Number of seconds since the socket last sent data.
.lr - Number of seconds since the socket last received data.
.mark - Socket mark set by [[/sockmark]].
.type - Socket type udp/tcp.
.to - Number of sockets since it was opened.
.wsmsg - Return the last socket error message.
.wserr - Return the last socket error.
.pause - Returns [[$true]] if socket is paused, otherwise [[$false]].
.ssl - Returns [[$true]] if socket is a SSL connection, otherwise [[$false]].
.sport - Returns the source port from the last received UDP packet.
.saddr - Returns the source address from the last received UDP packet.
.bindip - Returns the local ip address the socket is bound to.
.bindport - Returns the local port the socket is bound to.
.starttls - *TODO*
.certfile - Returns the server certificate file if the socket is a listening socket, otherwise the client certificate file. *(AdiIRC only)*
.upnp - Returns [[$true]] if using "UPNP":https://en.wikipedia.org/wiki/Universal_Plug_and_Play otherwise [[$false]].
*Example*
<pre>
; Print number of sockets.
//echo -ag $sock(*, 0)
; Print the first socket.
//echo -ag $sock(*, 1)
</pre>