org.onosproject.net.host

Interface HostService

All Superinterfaces:

ListenerService<HostEvent,HostListener>

All Known Subinterfaces:

HostAdminService

public interface HostService
extends ListenerService<HostEvent,HostListener>

Service for interacting with the inventory of end-station hosts.

Method Summary

Modifier and Type	Method and Description
Set<Host>	getConnectedHosts(ConnectPoint connectPoint) Returns the set of hosts whose most recent location is the specified connection point.
Set<Host>	getConnectedHosts(DeviceId deviceId) Returns the set of hosts whose most recent location is the specified infrastructure device.
Host	getHost(HostId hostId) Returns the host with the specified identifier.
int	getHostCount() Returns the number of end-station hosts known to the system.
Iterable<Host>	getHosts() Returns a collection of all end-station hosts.
Set<Host>	getHostsByIp(IpAddress ip) Returns the set of hosts that have the specified IP address.
Set<Host>	getHostsByMac(MacAddress mac) Returns the set of hosts that have the specified MAC address.
Set<Host>	getHostsByVlan(VlanId vlanId) Returns the set of hosts that belong to the specified VLAN.
void	requestMac(IpAddress ip) Requests the host service to resolve the MAC address for the given IP address.
void	startMonitoringIp(IpAddress ip) Requests the host service to monitor hosts with the given IP address and notify listeners of changes.
void	stopMonitoringIp(IpAddress ip) Stops the host service from monitoring an IP address.

Methods inherited from interface org.onosproject.event.ListenerService

addListener, removeListener

Method Detail

getHostCount

int getHostCount()

Returns the number of end-station hosts known to the system.

Returns:

number of end-station hosts

getHosts

Iterable<Host> getHosts()

Returns a collection of all end-station hosts.

Returns:

collection of hosts

getHost

Host getHost(HostId hostId)

Returns the host with the specified identifier.

Parameters:

hostId - host identifier

Returns:

host or null if one with the given identifier is not known

getHostsByVlan

Set<Host> getHostsByVlan(VlanId vlanId)

Returns the set of hosts that belong to the specified VLAN.

Parameters:

vlanId - vlan identifier

Returns:

set of hosts in the given vlan id

getHostsByMac

Set<Host> getHostsByMac(MacAddress mac)

Returns the set of hosts that have the specified MAC address.

Parameters:

mac - mac address

Returns:

set of hosts with the given mac

getHostsByIp

Set<Host> getHostsByIp(IpAddress ip)

Returns the set of hosts that have the specified IP address.

Parameters:

ip - ip address

Returns:

set of hosts with the given IP

getConnectedHosts

Set<Host> getConnectedHosts(ConnectPoint connectPoint)

Returns the set of hosts whose most recent location is the specified connection point.

Parameters:

connectPoint - connection point

Returns:

set of hosts connected to the connection point

getConnectedHosts

Set<Host> getConnectedHosts(DeviceId deviceId)

Returns the set of hosts whose most recent location is the specified infrastructure device.

Parameters:

deviceId - device identifier

Returns:

set of hosts connected to the device

startMonitoringIp

void startMonitoringIp(IpAddress ip)

Requests the host service to monitor hosts with the given IP address and notify listeners of changes.

Parameters:

ip - IP address of the host to monitor

stopMonitoringIp

void stopMonitoringIp(IpAddress ip)

Stops the host service from monitoring an IP address.

Parameters:

ip - IP address to stop monitoring

requestMac

void requestMac(IpAddress ip)

Requests the host service to resolve the MAC address for the given IP address. This will trigger a notification to the host listeners if the MAC address is found.

Parameters:

ip - IP address to find the MAC address for