Latest revision as of 03:43, 25 April 2023

The /sockopen command initiates a connection to the specified addresses and port; a named address can be substituted for an IP address (which will get resolved to an IP address eventually). On success, the on sockopen event should get executed.

Synopsis[edit]

/sockopen [-de[swap]tn46] [bindip] <name> <address> <port>

Switches[edit]

• -d - the specified IP address is the bind IP address
• -e - creates an SSL connection, with this switch you can also use:
  • -s - skip invalid certificates
  • -w - display warning dialog
  • -a - accept invalid certificates
  • -p - prevent certificate caching
• -t - initiates an SSL negotiation on a non-SSL connection (STARTTLS feature), this is not meant to be used when creating the socket but later after the connection has been established, trigger on sockopen a second time with $sock().starttls set to $true
• -4 - specify the IPv4 context when resolving address (enforce ipv4 when it is disabled entirely because your status window is in 'ipv6 mode'
• -6 - specify the IPv6 context when resolving address (enforce ipv6)
• -n - disable Nagle algorithm on socket

Parameters[edit]

• [bindip] - bind ip to be used
• <name> - socket name (for future reference)
• <address> - ip address or server name of the end point
• <port> - port of the end point

Example[edit]

Alias irc_connect {
  ;Initiate a connection with "irc.freenode.org" on port 6669, Secured connection
  sockopen -e IRC irc.freenode.org +6697
}
 
On *:sockopen:IRC:{
  ;Send our USER and NICK irc commands
  sockwrite -n IRC USER Tester $+ $rand(1,100) Test Test:mSL Testing $+ $crlf
  sockwrite -n IRC NICK Tester $+ $rand(1,100) $crlf
}
 
;Show all receiving data in a window
On *:sockread:IRC:{
  window -de @IRC
  var %x
  sockread %x
  aline -p @IRC $iif(%x,$v1,-)
}

Compatibility[edit]

Added: mIRC v5.3
Added on: 13 Dec 1997
Note: Unless otherwise stated, this was the date of original functionality.
Further enhancements may have been made in later versions.

See also[edit]

• List of commands
• List of identifiers
• $sockname
• $sock
• /socklist
• /sockmark
• /sockpause
• /sockread
• /sockrename
• /sockwrite
• on sockopen