Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Fetching contributors…
Cannot retrieve contributors at this time
119 lines (108 sloc) 3.83 KB
<title>IPv6 plugin API</title>
<meta http-equiv="Content-type" content="text/html; charset=utf-8">
<link rel="stylesheet" type="text/css" href="../boomerang-docs.css">
<span style="float:right;"><a href="../">All Docs</a> | <a href="index.html">Index</a></span>
<h1>IPv6 plugin API</h1>
<strong>Note:</strong> The IPv6 plugin hasn't been tested. Your help in testing it is appreciated.
The IPv6 plugin measures various IPv6 related metrics. It is encapsulated within
the <code>BOOMR.plugins.IPv6</code> namespace. This plugin tries to do a few things:
<li>Check if the client can connect to an ipv6 address</li>
<li>Check if the client can resolve DNS that points to an ipv6 address</li>
<li>Check latency of connecting to an ipv6 address</li>
<li>Check avg latency of doing dns lookup to an ipv6 address (not worstcase)</li>
This plugin needs a server that has an IPv6 address, and a DNS name to point to it.
Additionally, the server needs to be configured to serve content requested
from the IPv6 address and should not require a virtual host name. This means
that you probably cannot use shared hosting that puts multiple hosts on the
same IP address.
<h2 id="config">Configuration</h2>
All configuration parameters are within the IPv6 namespace.
<dd>An image URL referenced by its IPv6 address, eg, <code>http://fe80::1/image-i.png</code>.
If not specified, the test will abort.</dd>
An image URL on an IPv6 only host referenced by its DNS hostname. The hostname should not
resolve to an IPv4 address. If not specified, the host test will be skipped.
The time, in milliseconds, that boomerang should wait for a network response before giving up
and assuming that the request failed. The default is 1200ms.
<h2 id="methods">Methods</h2>
<dl class="api">
Called by the <a href="BOOMR.html#init">BOOMR.init()</a> method to configure the DNS
plugin. See the <a href="#config">Configuration section</a> for details.
<em>IPv6: { </em>
<em> ipv6_url: "http://fe80::1/images/image-i.png" </em>
<em> host_url: ""</em>
<em>} </em>
a reference to the <code>BOOMR.plugins.IPv6</code> object, so you can chain methods.
The IPv6 test will not run if a <code>ipv6_url</code> is not configured.
Called by <a href="BOOMR.html#sendBeacon">BOOMR.sendBeacon()</a> to determine if the IPv6 plugin has
finished what it's doing or not.
<li><code>true</code> if the plugin has completed.</li>
<li><code>false</code> if the plugin has not completed.</li>
<h2 id="beacon">Beacon Parameters</h2>
This plugin adds two parameters to the beacon, both prefixed with <code>ipv6_</code>:
<dd>Latency in milliseconds of getting data from an ipv6 host when connecting to the IP.
Will be set to NA if the client cannot connect to the ipv6 host.</dd>
<dd>Latency of getting data from a hostname that resolves to an ipv6 address. Will be set
to NA if the client cannot resolve or connect to the ipv6 host.</dd>
<p class="perma-link">
The latest code and docs is available on <a href=""></a>
Copyright (c) 2011, Yahoo! Inc. All rights reserved.
Copyrights licensed under the BSD License. See the accompanying LICENSE.txt file for terms.
Jump to Line
Something went wrong with that request. Please try again.