<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet href="../plugin.xsl" type="text/xsl"?>
<plugin name="IpProvider">
  <object class="org.ow2.isac.plugin.ipprovider.SessionObject">
    <params>
      <param name="policy" type="String" />
      <param name="filters" type="String" />
      <param name="unique" type="String" />
    </params>
    <help>Provides locally available IP addresses, either in a round-robin or in a random way, accordlingly to the chosen policy.&#xD;
Delivered addresses may or may not be unique among virtual users, accordingly to the "unique" switch.
IP addresses may be restricted to one or several subnetworks through the optional setting of filters.&#xD;
The obtained IP address is available through an empty variable notation ${ipprovider-id:}.</help>
  </object>
  <control name="release" number="1">
    <params />
    <help>Releases the address that had been previously obtained by this virtual user. Ignored of the virtual user  has not got an IP address.</help>
  </control>
  <control name="next" number="2">
    <params />
    <help>Gets a locally available IP address, according to the attribution policy and possible subnetwork filters. This address may also be given or not to another virtual user according to the "unique" switch setting. Getting a new IP address automatically releases current IP address (if any) previously obtained by this virtual user.</help>
  </control>
</plugin>

