<doc>
	<legacy_id></legacy_id>
	<name>reachabilityChanged</name>
	<type>message</type>

	<syntax>
		<example>reachabilityChanged <i>hostNameOrAddress</i>, <i>reachabilityInfo</i></example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Sent when the network connectivity to a monitored server changes.</summary>

	<examples>
<example><p>on reachabilityChanged pHost, pInfo</p><p>   updateConnectivityList pHost, pInfo</p><p>on reachabilityChanged</p></example>
	</examples>

	<history>
		<introduced version="6.0">6.0</introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		
		<experimental version=""></experimental>
		<nonexperimental version=""></nonexperimental>
	</history>

	<objects>
		<stack/>
	</objects>

	<platforms>
		<ios/>
	</platforms>

	<classes>
		<mobile/>
	</classes>

	<security>
	</security>


	<classification>
	</classification>

	<references>
		<function tag="iphoneReachabilityTarget">iphoneReachabilityTarget Function</function>
		<command tag="iphoneSetReachabilityTarget">iphoneSetReachabilityTarget Command</command>
	</references>

	<description>
	<overview>Handle the reachabilityChanged message if you want to perform an action when changes to network connectivity occur.</overview>

		<parameters>
  <parameter>
    <name>hostNameOrAddress</name>
    <description>The server being monitored</description>
  </parameter>
  <parameter>
    <name>reachabilityInfo</name>
    <description>Comma delimited list of zero or more of the following</description>
    <options title="">
      <option>
        <item>transient</item>
        <description>the specified server can be reached via a transient connection</description>
      </option>
      <option>
        <item>reachable</item>
        <description>the specified server can be reached via the current network configuration</description>
      </option>
      <option>
        <item>connection required</item>
        <description>the specified server can be reached via the current network configuration, but a connection needs to be established before it can</description>
      </option>
      <option>
        <item>connection on traffic</item>
        <description>the specified server can be reached via the current network configuration, but a connection needs to be established before it can. Any traffic directed to the server will initiate the connection</description>
      </option>
      <option>
        <item>intervention required</item>
        <description>the specified server can be reached via the current network configuration, but some form of user intervention will be required to establish this connection</description>
      </option>
      <option>
        <item>is local</item>
        <description>the specified server is associated with a network interface on the current system</description>
      </option>
      <option>
        <item>is direct</item>
        <description>network traffic to the given server will not go through a gateway, but is routed directly to one of the interfaces in the system</description>
      </option>
      <option>
        <item>is cell</item>
        <description>the specified server can be reached via an EDGE, GPRS or other 'cell' connection</description>
      </option>
    </options>
  </parameter>		</parameters>

	<value></value>
	<comments>The <b>reachabilityChanged</b> message is sent to the current card of the defaultStack when a change to network connectivity, that affects access to a server that is being monitored, occurs.</comments>
	</description>
</doc>