Difference between revisions of "mirc/on events/on dns"

Latest revision as of 19:14, 15 June 2017

The ON DNS event triggers when a /dns command query either succeeds or fails, including when a user does not exist on the server.

Synopsis[edit]

ON <level>:DNS:<commands>

Parameters[edit]

<level> - The corresponding access levels for the event to trigger.

<commands> - The commands to be performed when the event listener's criteria is met.

local identifiers[edit]

$dns[edit]

This identifier can be used to return all the address found.

$iaddress $naddress $raddress[edit]

These return to the ip address, host address, and resolved address, respectively. Although these identifiers work now, it is strongly advised that migration to using the $dns is made.

$nick[edit]

If /dns was performed on a nickname rather than an address, then $nick is filled with that nickname. Otherwise, $nick is filled with your own name.

Examples[edit]

Echo to the active window the results of the DNS:

ON *:DNS:echo -a $iif($1,$iif($dns(1).nick,$v1 has been resolved to) Hostmask: $dns(1).addr IP: $dns(1).ip,Could not resolve DNS query.)

The above example makes use of multiple $iif to ensure that we get proper results, without unforeseen issues. The first surrounding $iif checks to make sure any data has been returned. If no data is returned, then the /dns obviously failed; therefore, we have it return a statement which says that a resolution could not be made. If data has been returned, the second $iif checks to see if a .nick value can be extracted from the $dns. This is filled if a nickname was the target of the /dns request. If the nickname is filled, return the portion containing the nickname. If, however, the nickname is not present, only return the hostmask and ip address.

Compatibility[edit]

Added: mIRC v4.7
Added on: 09 Dec 1996
Note: Unless otherwise stated, this was the date of original functionality.
Further enhancements may have been made in later versions.

See Also[edit]

mIRC on event list

A on Action, on Active, on Agent, on Appactive

B on Ban

C on Char, on Chat, on Chatclose, on Chatopen, on Close, on Connect, on Connectfail, on Ctcpreply

D on Dccserver, on Dehelp, on Deop, on Deowner, on Devoice, on Dialog, on Disconnect, on Dns

E on Error, on Exit

F on Filercvd, on Filesent

G on Getfail

H on Help, on Hotlink

I on Input, on Invite

J on Join

K on Keydown, on Keyup, on Kick

L on Load, on Logon

M on Midiend, on Mode, on Mp3end

N on Nick, on Nosound, on Notice, on Notify

O on Op, on Open, on Owner

P on Parseline, on Part, on Ping, on Playend, on Pong

Q on Queryclose, on Queryopen, on Quit

R on Rawmode

S on Sendfail, on Serv, on Servclose, on Servermode, on Serverop, on Servopen, on Signal, on Snotice, on Sockclose, on Socklisten, on Sockopen, on Sockread, on Sockwrite, on Start

T on Text, on Topic

U on Udpread, on Udpwrite, on Unban, on Unload, on Unotify, on Usermode

V on Vcmd, on Voice

W on Wallops, on Waveend

@@ Line 1: / Line 1: @@
-The '''ON DNS''' event triggers when a [[/dns command - mIRC|DNS]] query either succeeds or fails, including when a user does not exist on the [[Server - IRC|IRC server]].
+{{mirc title|On Dns - Events}}
+The '''ON DNS''' event triggers when a {{mIRC|/dns}} command query either succeeds or fails, including when a user does not exist on the server.
-This event fills the [[$dns identifier - mIRC|$dns]] identifier with the address found for a user, as well as any addresses associated if [[/dns command - mIRC|DNS]] was performed on a [[Host mask - IRC|host mask]].
+== Synopsis ==
+<pre>ON <level>:DNS:<commands></pre>
+== Parameters ==
+* '''<level>''' - The corresponding {{mIRC|access levels}} for the event to trigger.
+* '''<commands>''' - The commands to be performed when the event listener's criteria is met.
+== {{mIRC|local identifiers}} ==
+=== {{mIRC|$dns}} ===
-This event also fills the [[$iaddress identifier - mIRC|$iaddress]], [[$naddress - mIRC|$naddress]] and [[$raddress - mIRC|$raddress]] identifiers. These resolve to [[Ip address|IP Address]], [[Host address]], and resolved address, respectively. Although these identifiers work now, it is strongly advised that migration to using the [[$dns identifier - mIRC|$dns identifier]] is made.
+This identifier can be used to return all the address found.
-The [[$nick identifier - mIRC|$nick identifier]] is filled as well. If [[/dns command - mIRC|/dns]] was performed on a nickname rather than an address, then [[$nick identifier - mIRC|$nick]] is filled with that nickname. Otherwise, [[$nick identifier - mIRC|$nick]] is filled with your own name.
+=== {{mIRC|$iaddress}} {{mIRC|$naddress}} {{mIRC|$raddress}} ===
-== Synopsis ==
+These return to the ip address, host address, and resolved address, respectively. Although these identifiers work now, it is strongly advised that migration to using the {{mIRC|$dns}} is made.
-<pre>ON <level>:DNS:<commands></pre>
+=== $nick ===
-== Parameters ==
+If {{mIRC|/dns}} was performed on a nickname rather than an address, then {{mIRC|$nick}} is filled with that nickname. Otherwise, {{mIRC|$nick}} is filled with your own name.
-<span style="display: inline-block; width: 105px;">'''<level>'''</span>The level for the event to trigger.
-<span style="display: inline-block; width: 105px;">'''<commands>'''</span>The commands to be performed when the event listener's criteria is met.
 == Examples ==
@@ Line 19: / Line 29: @@
 <source lang="mIRC">ON *:DNS:echo -a $iif($1,$iif($dns(1).nick,$v1 has been resolved to) Hostmask: $dns(1).addr IP: $dns(1).ip,Could not resolve DNS query.)</source>
-The above example makes use of multiple [[$iif identifier - mIRC|$iif identifiers]] to ensure that we get proper results, without unforeseen issues. The first surrounding [[$iif identifier - mIRC|$iif identifier]] checks to make sure any data has been returned. If no data is returned, then the [[/dns command - mIRC|DNS]] obviously failed; therefore, we have it return a statement which says that a resolution could not be made. If data has been returned, the second [[$iif identifier - mIRC|$iif identifier]] checks to see if a '''.nick''' value can be extracted from the [[$dns identifier - mIRC|$dns identifier]]. This is filled if a nickname was the target of the [[/dns command - mIRC|DNS]] request. If the nickname is filled, return the portion containing the nickname. If, however, the nickname is not present, present only the [[Hostmask - IRC|hostmask]] and [[Ip address|IP address]].
+The above example makes use of multiple {{mIRC|$iif}} to ensure that we get proper results, without unforeseen issues. The first surrounding {{mIRC|$iif}} checks to make sure any data has been returned. If no data is returned, then the {{mIRC|/dns}} obviously failed; therefore, we have it return a statement which says that a resolution could not be made. If data has been returned, the second {{mIRC|$iif}} checks to see if a '''.nick''' value can be extracted from the {{mIRC|$dns}}. This is filled if a nickname was the target of the {{mIRC|/dns}} request. If the nickname is filled, return the portion containing the nickname. If, however, the nickname is not present, only return the hostmask and ip address.
 == Compatibility ==
-Added: mIRC v4.7
+{{mIRC compatibility|4.7}}
-Added On: 09/12/96
 == See Also ==
+* {{mIRC|$dns}}
 * [[List of on events - mIRC|ON Events]]
+{{mIRC on event list}}
-[[Category:mIRC on events]]
+[[Category:mIRC on events|dns]]

WikiChip

The Fuse Coverage

Social Media

Companies

Microarchitectures

Technology Nodes

Intel

AMD

ARM

Cavium

Samsung

Intel

AMD

Ampere

Apple