Exemplo n.º 1
0
 /**
  * Gets the DHCPBinding object from the DHCPPool containing {@code byte[]} mac
  *
  * @param {@code byte[]} mac: The MAC address to match in in a DHCPBinding
  * @return {@code DHCPBinding}: The matching DHCPBinding object or null if mac is not found
  */
 public DHCPBinding getDHCPbindingFromMAC(MacAddress mac) {
   if (mac == null) return null;
   for (DHCPBinding binding : DHCP_POOL) {
     if (binding.getMACAddress().equals(mac)) {
       return binding;
     }
   }
   return null;
 }
Exemplo n.º 2
0
 /**
  * Gets the DHCPBinding object from the DHCPPool containing {@code byte[]} ip
  *
  * @param {@code byte[]} ip: The IPv4 address to match in a DHCPBinding
  * @return {@code DHCPBinding}: The matching DHCPBinding object or null if ip is not found
  */
 public DHCPBinding getDHCPbindingFromIPv4(IPv4Address ip) {
   if (ip == null) return null;
   for (DHCPBinding binding : DHCP_POOL) {
     if (binding.getIPv4Address().equals(ip)) {
       return binding;
     }
   }
   return null;
 }
Exemplo n.º 3
0
 /**
  * Tries to renew an IP lease.
  *
  * @param {@code byte[]}: The IP address on which to try and renew a lease
  * @param {@code long}: The time in seconds for which the lease will be valid
  * @return {@code DHCPBinding}: True on success, false if unknown IP address
  */
 public boolean renewLease(IPv4Address ip, int time) {
   DHCPBinding binding = this.getDHCPbindingFromIPv4(ip);
   if (binding != null) {
     binding.setLeaseStartTimeSeconds();
     binding.setLeaseDurationSeconds(time);
     binding.setLeaseStatus(true);
     return true;
   }
   return false;
 }
Exemplo n.º 4
0
 /**
  * Assigns a MAC address to the IP address of the DHCPBinding object in the DHCPPool object. This
  * method also sets the lease to active (i.e. true) when the assignment is made.
  *
  * @param {@code DHCPBinding} binding: The DHCPBinding object in which to set the MAC
  * @param {@code byte[]} mac: The MAC address to set in the DHCPBinding object
  * @param {@code long}: The time in seconds for which the lease will be valid
  * @return none
  */
 public void setDHCPbinding(DHCPBinding binding, MacAddress mac, int time) {
   int index = DHCP_POOL.indexOf(binding);
   binding.setMACAddress(mac);
   binding.setLeaseStatus(true);
   this.setPoolAvailability(this.getPoolAvailability() - 1);
   DHCP_POOL.set(index, binding);
   if (this.getPoolAvailability() == 0) setPoolFull(true);
   binding.setLeaseStartTimeSeconds();
   binding.setLeaseDurationSeconds(time);
 }
Exemplo n.º 5
0
 /**
  * Used to set a particular IP binding in the pool as a fixed/static IP lease. This method does
  * not set the lease as active, but instead reserves that IP for only the MAC provided. To set the
  * lease as active, the methods getAnyAvailableLease() or getSpecificAvailableLease() will return
  * the correct binding given the same MAC provided to this method is used to bind the lease later
  * on.
  *
  * @param {@code byte[]}: The IP address to set as static/fixed.
  * @param {@code byte[]}: The MAC address to match to the IP address ip when an address is
  *     requested from the MAC mac
  * @return {@code boolean}: True upon success; false upon failure (e.g. no IP found)
  */
 public boolean configureFixedIPLease(IPv4Address ip, MacAddress mac) {
   DHCPBinding binding = this.getDHCPbindingFromIPv4(ip);
   if (binding != null) {
     binding.setMACAddress(mac);
     binding.setStaticIPLease(true);
     binding.setLeaseStatus(false);
     return true;
   } else {
     return false;
   }
 }
Exemplo n.º 6
0
 /**
  * Cancel an IP lease.
  *
  * @param {@code byte[]}: The MAC address on which to try and cancel a lease
  * @return {@code boolean}: True on success, false if unknown IP address
  */
 public boolean cancelLeaseOfMAC(MacAddress mac) {
   DHCPBinding binding = getDHCPbindingFromMAC(mac);
   if (binding != null) {
     binding.clearLeaseTimes();
     binding.setLeaseStatus(false);
     this.setPoolAvailability(this.getPoolAvailability() + 1);
     this.setPoolFull(false);
     return true;
   }
   return false;
 }
Exemplo n.º 7
0
 /**
  * Cancel an IP lease.
  *
  * @param {@code byte[]}: The IP address on which to try and cancel a lease
  * @return {@code boolean}: True on success, false if unknown IP address
  */
 public boolean cancelLeaseOfIPv4(IPv4Address ip) {
   DHCPBinding binding = this.getDHCPbindingFromIPv4(ip);
   if (binding != null) {
     binding.clearLeaseTimes();
     binding.setLeaseStatus(false);
     this.setPoolAvailability(this.getPoolAvailability() + 1);
     this.setPoolFull(false);
     return true;
   }
   return false;
 }
Exemplo n.º 8
0
 /**
  * Make the addresses of expired leases available and reset the lease times.
  *
  * @return {@code ArrayList<DHCPBinding>}: A list of the bindings that are now available
  */
 public ArrayList<DHCPBinding> cleanExpiredLeases() {
   ArrayList<DHCPBinding> newAvailableLeases = new ArrayList<DHCPBinding>();
   for (DHCPBinding binding : DHCP_POOL) {
     // isLeaseExpired() automatically excludes configured static leases
     if (binding.isLeaseExpired() && binding.isActiveLease()) {
       this.cancelLeaseOfIPv4(binding.getIPv4Address());
       this.setPoolAvailability(this.getPoolAvailability() + 1);
       this.setPoolFull(false);
       newAvailableLeases.add(binding);
     }
   }
   return newAvailableLeases;
 }
Exemplo n.º 9
0
  /**
   * Returns an available address (DHCPBinding) for lease.
   * If this MAC is configured for a static/fixed IP, that DHCPBinding will be returned.
   * If this MAC has had a lease before and that same lease is available, that DHCPBinding will be returned.
   * If not, then an attempt to return an address that has not been active before will be made.
   * If there are no addresses that have not been used, then the lowest currently inactive address will be returned.
   * If all addresses are being used, then null will be returned.
   * @param {@code byte[]): MAC address of the device requesting the lease
   * @return {@code DHCPBinding}: Reference to the DHCPBinding object if successful, null if unsuccessful
   */
  public DHCPBinding getAnyAvailableLease(MacAddress mac) {
    if (isPoolFull()) return null;
    DHCPBinding usedBinding = null;
    usedBinding = this.getDHCPbindingFromMAC(mac);
    if (usedBinding != null) return usedBinding;

    for (DHCPBinding binding : DHCP_POOL) {
      if (!binding.isActiveLease() && binding.getMACAddress().equals(UNASSIGNED_MAC)) {
        return binding;
      } else if (!binding.isActiveLease() && usedBinding == null && !binding.isStaticIPLease()) {
        usedBinding = binding;
      }
    }
    return usedBinding;
  }
Exemplo n.º 10
0
  /**
   * Returns a specific available IP address binding for lease. The MAC and IP will be queried
   * against the DHCP pool. (1) If the MAC is found in an available, fixed binding, and that binding
   * is not for the provided IP, the fixed binding associated with the MAC will be returned. (2) If
   * the IP is found in an available, fixed binding, and that binding also contains the MAC address
   * provided, then the binding will be returned -- this is true only if the IP and MAC result in
   * the same available, fixed binding. (3) If the IP is found in the pool and it is available and
   * not fixed, then its binding will be returned. (4) If the IP provided does not match any
   * available entries or is invalid, null will be returned. If this is the case, run
   * getAnyAvailableLease(mac) to resolve.
   *
   * @param {@code byte[]}: The IP address on which to try and obtain a lease
   * @param {@code byte[]}: The MAC address on which to try and obtain a lease.
   * @return {@code DHCPBinding}: Reference to the DHCPBinding object if successful, null if
   *     unsuccessful.
   */
  public DHCPBinding getSpecificAvailableLease(IPv4Address ip, MacAddress mac) {
    if (ip == null || mac == null || isPoolFull()) return null;

    DHCPBinding binding = this.getDHCPbindingFromIPv4(ip);
    DHCPBinding binding2 = this.getDHCPbindingFromMAC(mac);

    // For all of the following, the binding is also determined to be inactive:

    // If configured, we must return a fixed binding for a MAC address even if it's requesting
    // another IP
    if (binding2 != null
        && !binding2.isActiveLease()
        && binding2.isStaticIPLease()
        && binding != binding2) {
      if (log != null)
        log.info("Fixed DHCP entry for MAC trumps requested IP. Returning binding for MAC");
      return binding2;
      // If configured, we must return a fixed binding for an IP if the binding is fixed to the
      // provided MAC (ideal static request case)
    } else if (binding != null
        && !binding.isActiveLease()
        && binding.isStaticIPLease()
        && mac.equals(binding.getMACAddress())) {
      if (log != null)
        log.info(
            "Found matching fixed DHCP entry for IP with MAC. Returning binding for IP with MAC");
      return binding;
      // The IP and MAC are not a part of a fixed binding, so return the binding of the requested IP
    } else if (binding != null && !binding.isActiveLease() && !binding.isStaticIPLease()) {
      if (log != null)
        log.info("No fixed DHCP entry for IP or MAC found. Returning dynamic binding for IP.");
      return binding;
      // Otherwise, the binding is fixed for both MAC and IP and this MAC does not match either, so
      // we can't return it as available
    } else {
      if (log != null)
        log.debug(
            "Invalid IP address request or IP is actively leased...check for any available lease to resolve");
      return null;
    }
  }
Exemplo n.º 11
0
 /**
  * Completely removes the DHCPBinding object with IP address {@code byte[]} ip from the DHCPPool
  *
  * @param {@code byte[]} ip: The IP address to remove from the pool. This address will not be
  *     available for lease after removal.
  * @return none
  */
 public void removeIPv4FromDHCPPool(IPv4Address ip) {
   if (ip == null || getDHCPbindingFromIPv4(ip) == null) return;
   if (ip.equals(STARTING_ADDRESS)) {
     DHCPBinding lowest = null;
     // Locate the lowest address (other than ip), which will be the new starting address
     for (DHCPBinding binding : DHCP_POOL) {
       if (lowest == null) {
         lowest = binding;
       } else if (binding.getIPv4Address().getInt() < lowest.getIPv4Address().getInt()
           && !binding.getIPv4Address().equals(ip)) {
         lowest = binding;
       }
     }
     // lowest is new starting address
     STARTING_ADDRESS = lowest.getIPv4Address();
   }
   DHCP_POOL.remove(this.getDHCPbindingFromIPv4(ip));
   this.setPoolSize(this.getPoolSize() - 1);
   this.setPoolAvailability(this.getPoolAvailability() - 1);
   if (this.getPoolAvailability() == 0) this.setPoolFull(true);
 }
Exemplo n.º 12
0
 /**
  * Gets the lease status of a particular IPv4 address, {@code byte[]} ip
  *
  * @param {@code byte[]} ip: The IPv4 address of which to check the lease status
  * @return {@code boolean}: true if lease is active, false if lease is inactive/expired
  */
 public boolean isIPv4Leased(IPv4Address ip) {
   DHCPBinding binding = this.getDHCPbindingFromIPv4(ip);
   if (binding != null) return binding.isActiveLease();
   else return false;
 }