_Added in 1.9.0_
*$sock(name,[N])*
Returns information about a the Nth socket connection.
*Parameters*
table(ktable).
|*Parameter*|*Description*|
| name | Name to lookup, can be a [[Scripting_Wildcards|wildcard]]. |
| [N} | If N = 0, number of matches, otherwise the Nth match. (optionally) |
*Properties*
table(ktable).
|*Property*|*Description*|
| .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*
; Print number of sockets.
//echo -ag $sock(*, 0)
; Print the first socket.
//echo -ag $sock(*, 1)