All Classes Namespaces Files Functions Pages
Layer4.Igmp.Schedule.IpMulticastListen Class Reference

Use this class to configure the source-specific properties of an IGMPv3 Multicast session. More...

Methods

 Description.Get
 Returns a textual description of the object.
 
 InitialTimeToWait.Get
 Returns the time when the action is scheduled. This time is set using InitialTimeToWait.Set At that time, the first frame will be sent. More...
 
 InitialTimeToWait.Set time
 Sets the time when the action will be scheduled. That is, when the first frame will be sent. More...
 
 MulticastSources.Get
 Gets the list of Multicast Sources for this Schedule. More...
 
 MulticastSources.Set multicastSources
 Configures the list of Multicast Sources for this Schedule. These sources will either be included or excluded. More...
 
 Parent.Get
 Returns the parent object.
 
 SourceFilter.Get
 Gets the currently set filter for the source specific multicast.
 
 SourceFilter.Set filter
 Sets the filter for the source specific multicast. You can choose between include and exclude. More...
 
 Start
 Starts the scheduled action. More...
 
 Stop
 Stops the running scheduled action. More...
 

Class overview

Use this class to configure the source-specific properties of an IGMPv3 Multicast session.

Source-specific multicast (SSM) is a method of delivering multicast packets in which the only packets that are delivered to a receiver are those originating from a specific source address requested by the receiver. By so limiting the source, SSM reduces demands on the network and improves security.

SSM is possible in IPv4's IGMPv3 and IPv6's MLDv2, but this class can be used to configure IGMPv3 only.

You can set a filter to include or exclude a list of multicast sources.

This action is a schedule, so after configuring it, it needs to be started. See Start

Use Layer4.Igmpv3MemberSession::Schedule.Add <IpMulticastListen> to get an object of this class.

Definition at line 7922 of file api.tcl.

Method documentation

Layer4.Igmp.Schedule.IpMulticastListen::InitialTimeToWait.Get

Returns the time when the action is scheduled. This time is set using InitialTimeToWait.Set At that time, the first frame will be sent.

Returns
The initial time to wait in nanoseconds.

Definition at line 7935 of file api.tcl.

Layer4.Igmp.Schedule.IpMulticastListen::InitialTimeToWait.Set   time  

Sets the time when the action will be scheduled. That is, when the first frame will be sent.

Parameters
timeThe time when the action will be scheduled.
Valid range: 0 to <max_uint64>[ns]
Where
<max_uint64>
0xFFFFFFFFFFFFFFFF = 18446744073709551615 = maximum unsigned 64bit integer)

Sets the initial time to wait before the first frame will be sent. By default, the unit has a nanosecond resolution. But you can also provide a time unit.

The schedule can be started using Start

Exceptions
<tcl_error>Failed to parse time string: When the value could not be interpreted as a valid time string
Example

Set the initial time to wait to 9 ns

1 $schedule InitialTimeToWait.Set 9

Set the initial time to wait to 1.25 milliseconds

1 $icmpSession Echo.Loop.Interval.Set 1250us

Set the initial time to wait to 9 ms

1 $schedule InitialTimeToWait.Set 9ms

Set the initial time to wait to 9 hours

1 $schedule InitialTimeToWait.Set 9h

Definition at line 7955 of file api.tcl.

Layer4.Igmp.Schedule.IpMulticastListen::MulticastSources.Get

Gets the list of Multicast Sources for this Schedule.

Returns
The specified multicast source IPv4 addresses.
Example

Get the list of specified source addresses

1 $multicast MulticastSources.Get

Returns:

{"1.2.3.4" "5.6.7.8"} 

Definition at line 7967 of file api.tcl.

Layer4.Igmp.Schedule.IpMulticastListen::MulticastSources.Set   multicastSources  

Configures the list of Multicast Sources for this Schedule. These sources will either be included or excluded.

Parameters
multicastSourcesA List of IPv4 Multicast Source Addresses. This may also be an empty list.
Example

Specify one multicast group source address

1 $multicast MulticastSources.Set {"1.2.3.4"}

Specify two multicast group source addresses

1 $multicast MulticastSources.Set {"1.2.3.4" "5.6.7.8"}

Specify no multicast group source addresses at all

1 $multicast MulticastSources.Set {}

Definition at line 7979 of file api.tcl.

Layer4.Igmp.Schedule.IpMulticastListen::SourceFilter.Set   filter  

Sets the filter for the source specific multicast. You can choose between include and exclude.

Parameters
filterThe source filter. Choose between
include
only multicast sources set using MulticastSources.Set will be used
exclude
all multicast sources, except those set using MulticastSources.Set will be used
Example

Set the filter to include

1 $multicast SourceFilter.Set include

Definition at line 8002 of file api.tcl.

Layer4.Igmp.Schedule.IpMulticastListen::Start

Starts the scheduled action.

The first packet will be sent after the initial time to wait.

Definition at line 8010 of file api.tcl.

Layer4.Igmp.Schedule.IpMulticastListen::Stop

Stops the running scheduled action.

If the action has not been started, nothing will happen.

Definition at line 8018 of file api.tcl.