From WikiChip
Editing mirc/on events/on socklisten
Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.
The edit can be undone.
Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
This page supports semantic in-text annotations (e.g. "[[Is specified as::World Heritage Site]]") to build structured and queryable content provided by Semantic MediaWiki. For a comprehensive description on how to use annotations or the #ask parser function, please have a look at the getting started, in-text annotation, or inline queries help pages.
Latest revision | Your text | ||
Line 1: | Line 1: | ||
− | + | The '''ON SOCKLISTEN''' event triggers when a connection is made on a listening socket created with {{mIRC|/socklisten}} | |
− | The '''ON SOCKLISTEN''' event triggers when a connection is made on a listening | ||
== Synopsis == | == Synopsis == | ||
Line 6: | Line 5: | ||
== Parameters == | == Parameters == | ||
− | |||
− | |||
<span style="display: inline-block; width: 105px;">'''<matchtext>'''</span>The name of the socket you want event to trigger on. | <span style="display: inline-block; width: 105px;">'''<matchtext>'''</span>The name of the socket you want event to trigger on. | ||
Line 14: | Line 11: | ||
== Accepting a connection == | == Accepting a connection == | ||
− | '''Note''': By design, you cannot prevent a socket from being accepted, as in, Windows | + | '''Note''': By design, you cannot prevent a socket from being accepted, as in, Windows accept the connection even before mIRC. |
You can use /sockaccept <newsocket> to accept a socket, mIRC create the new socket. | You can use /sockaccept <newsocket> to accept a socket, mIRC create the new socket. | ||
− | '''Note''': If a new connection occurs on a | + | '''Note''': If a new connection occurs on a socket but there is no on socklisten event matching that socket, the connection is rejected. |
You should be checking for $sockerr before accepting the connection to see if an error occured, here is a list of the possible value for $sockerr in the on SOCKLISTEN event: | You should be checking for $sockerr before accepting the connection to see if an error occured, here is a list of the possible value for $sockerr in the on SOCKLISTEN event: | ||
− | * '''0''' - New socket | + | * '''0''' - New socket successfully accepted. |
* '''1''' - Error occurred on listening socket, $sock().wsmsg will contain a more specific error message. Note that getting this error is considered rare. | * '''1''' - Error occurred on listening socket, $sock().wsmsg will contain a more specific error message. Note that getting this error is considered rare. | ||
* '''2''' - Error accepting new socket, $sock().wsmsg will contain a more specific error message. | * '''2''' - Error accepting new socket, $sock().wsmsg will contain a more specific error message. | ||
Line 39: | Line 36: | ||
== Compatibility == | == Compatibility == | ||
− | {{mIRC compatibility|5 | + | {{mIRC compatibility|3.5}} |
== See Also == | == See Also == | ||
− | * {{mIRC|on events|mIRC events | + | * {{mIRC|List of on events|mIRC events}} |
− | |||
− | |||
− | |||
− | |||
* {{mIRC|/sockwrite}} | * {{mIRC|/sockwrite}} | ||
* {{mIRC|/sockclose}} | * {{mIRC|/sockclose}} | ||
Line 54: | Line 47: | ||
* {{mIRC|$sock}} | * {{mIRC|$sock}} | ||
* {{mIRC|$sockbr}} | * {{mIRC|$sockbr}} | ||
− | * {{mIRC| | + | * {{mIRC|/sockerr}} |
− | [[Category: | + | [[Category:MIRC on events]] |