From WikiChip
Difference between revisions of "mirc/commands/sockopen"
< mirc‎ | commands

(Created page with "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 ...")
 
(→‎See also)
 
(25 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 +
{{mirc title|/sockopen Command}}
 
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.
 
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 ==
 
== Synopsis ==
−
  /sockopen [-de] [bindip] <name> <address> <port>
+
  /sockopen [-de[swap]tn46] [bindip] <name> <address> <port>
  
 
== Switches ==
 
== Switches ==
 
* '''-d''' - the specified IP address is the bind IP address
 
* '''-d''' - the specified IP address is the bind IP address
−
* '''-e''' - creates an SSL connection
+
* '''-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 ==
 
== Parameters ==
 
* '''[bindip]''' - bind ip to be used
 
* '''[bindip]''' - bind ip to be used
 
* '''<name>''' - socket name (for future reference)
 
* '''<name>''' - socket name (for future reference)
−
* '''<address>''' - ip address of the
+
* '''<address>''' - ip address or server name of the end point
−
* '''<port>''' - port to connect to
+
* '''<port>''' - port of the end point
  
 
== Example ==
 
== Example ==
Line 35: Line 44:
  
 
== Compatibility ==
 
== Compatibility ==
−
Added: mIRC v5.3
+
{{mIRC compatibility|5.3}}
−
 
 
−
Added On: 13/12/97
 
−
 
 
−
<small>Note: Individual switches were not taken into consideration.</small>
 
  
 
== See also ==
 
== See also ==
 
* [[List of commands - mIRC|List of commands]]
 
* [[List of commands - mIRC|List of commands]]
 
* [[List of identifiers - mIRC|List of identifiers]]
 
* [[List of identifiers - mIRC|List of identifiers]]
−
* [[$sockName identifier - mIRC|$sockName]]
+
* {{mIRC|$sockname}}
−
* [[$sock identifier - mIRC|$sock]]
+
* {{mIRC|$sock}}
−
* [[/socklist command - mIRC|/socklist]]
+
* {{mIRC|/socklist}}
−
* [[/sockmark command - mIRC|/sockmark]]
+
* {{mIRC|/sockmark}}
−
* [[/sockpause command - mIRC|/sockpause]]
+
* {{mIRC|/sockpause}}
−
* [[/sockread command - mIRC|/sockread]]
+
* {{mIRC|/sockread}}
−
* [[/sockrename command - mIRC|/sockrename]]
+
* {{mIRC|/sockrename}}
 +
* {{mIRC|/sockwrite}}
 +
* {{mIRC|on sockopen}}
 +
{{mIRC command list}}
  
−
[[Category:mIRC commands]]
+
[[Category:mIRC commands|sockopen command - mIRC]]

Latest revision as of 04:43, 25 April 2023

Commands & Identifiers
Basics
Events
Matching Tools
Data Storage
Control Structures
GUI Scripting
Sockets
Advanced Scripting
Additional Resources
Security
Other
v · d · e

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]

[Expand]
v · d · e mIRC commands list
Retrieved from "https://en.wikichip.org/w/index.php?title=mirc/commands/sockopen&oldid=101595"