Skip to content

Commit

Permalink
Update to 2.3.1
Browse files Browse the repository at this point in the history
  • Loading branch information
tobydox committed Mar 1, 2021
1 parent 6beba8f commit 97be644
Show file tree
Hide file tree
Showing 18 changed files with 590 additions and 16 deletions.
4 changes: 3 additions & 1 deletion InCore.Foundation/MobileNetworkInterface.rst
Original file line number Diff line number Diff line change
Expand Up @@ -51,6 +51,7 @@ Properties
* :ref:`NetworkInterface.hardwareName <property_NetworkInterface_hardwareName>`
* :ref:`NetworkInterface.networkAddresses <property_NetworkInterface_networkAddresses>`
* :ref:`NetworkInterface.operationalState <property_NetworkInterface_operationalState>`
* :ref:`NetworkInterface.routes <property_NetworkInterface_routes>`
* :ref:`NetworkInterface.setupState <property_NetworkInterface_setupState>`
* :ref:`NetworkInterface.useRoutes <property_NetworkInterface_useRoutes>`
* :ref:`NetworkInterface.useRoutesItem <property_NetworkInterface_useRoutesItem>`
Expand All @@ -74,13 +75,14 @@ Signals
+++++++

.. hlist::
:columns: 1
:columns: 2

* :ref:`connected() <signal_MobileNetworkInterface_connected>`
* :ref:`disconnected() <signal_MobileNetworkInterface_disconnected>`
* :ref:`messageReceived() <signal_MobileNetworkInterface_messageReceived>`
* :ref:`messageSent() <signal_MobileNetworkInterface_messageSent>`
* :ref:`NetworkInterface.errorOccurred() <signal_NetworkInterface_errorOccurred>`
* :ref:`NetworkInterface.routesDataChanged() <signal_NetworkInterface_routesDataChanged>`
* :ref:`ConfigurationObject.itemsDataChanged() <signal_ConfigurationObject_itemsDataChanged>`
* :ref:`Object.completed() <signal_Object_completed>`

Expand Down
33 changes: 33 additions & 0 deletions InCore.Foundation/NetworkInterface.rst
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,7 @@ Properties
* :ref:`hardwareName <property_NetworkInterface_hardwareName>`
* :ref:`networkAddresses <property_NetworkInterface_networkAddresses>`
* :ref:`operationalState <property_NetworkInterface_operationalState>`
* :ref:`routes <property_NetworkInterface_routes>`
* :ref:`setupState <property_NetworkInterface_setupState>`
* :ref:`useRoutes <property_NetworkInterface_useRoutes>`
* :ref:`useRoutesItem <property_NetworkInterface_useRoutesItem>`
Expand All @@ -57,6 +58,7 @@ Signals
:columns: 1

* :ref:`errorOccurred() <signal_NetworkInterface_errorOccurred>`
* :ref:`routesDataChanged() <signal_NetworkInterface_routesDataChanged>`
* :ref:`ConfigurationObject.itemsDataChanged() <signal_ConfigurationObject_itemsDataChanged>`
* :ref:`Object.completed() <signal_Object_completed>`

Expand Down Expand Up @@ -243,6 +245,25 @@ This property holds the operational state of the network interface. The most com
:**› Attributes**: Readonly


.. _property_NetworkInterface_routes:

.. _signal_NetworkInterface_routesChanged:

.. index::
single: routes

routes
++++++

This property holds a list of :ref:`NetworkRoute <object_NetworkRoute>` objects which hold additional network routes to configure.

This property was introduced in InCore 2.3.

:**› Type**: :ref:`List <object_List>`\<:ref:`NetworkRoute <object_NetworkRoute>`>
:**› Signal**: routesChanged()
:**› Attributes**: Readonly


.. _property_NetworkInterface_setupState:

.. _signal_NetworkInterface_setupStateChanged:
Expand Down Expand Up @@ -307,6 +328,18 @@ errorOccurred()
This signal is emitted whenever an error has occurred, regardless of whether the :ref:`error <property_NetworkInterface_error>` property has changed or not. In contrast to the change notification signal of the :ref:`error <property_NetworkInterface_error>` property this signal is also emitted several times if a certain error occurs several times in succession.



.. _signal_NetworkInterface_routesDataChanged:

.. index::
single: routesDataChanged

routesDataChanged(SignedInteger index)
++++++++++++++++++++++++++++++++++++++

This signal is emitted whenever the :ref:`List.dataChanged() <signal_List_dataChanged>` signal is emitted, i.e. the item at ``index`` in the :ref:`routes <property_NetworkInterface_routes>` list itself emitted the dataChanged() signal.


Enumerations
************

Expand Down
298 changes: 298 additions & 0 deletions InCore.Foundation/NetworkRoute.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,298 @@

.. _object_NetworkRoute:


:index:`NetworkRoute`
---------------------

Description
***********

The NetworkRoute object represents a route in TCP/IP networks and can be attached to :ref:`NetworkInterface <object_NetworkInterface>` objects.

This object was introduced in InCore 2.3.

:**› Inherits**: :ref:`Object <object_Object>`

Overview
********

Properties
++++++++++

.. hlist::
:columns: 2

* :ref:`destination <property_NetworkRoute_destination>`
* :ref:`gateway <property_NetworkRoute_gateway>`
* :ref:`metric <property_NetworkRoute_metric>`
* :ref:`mtu <property_NetworkRoute_mtu>`
* :ref:`protocol <property_NetworkRoute_protocol>`
* :ref:`scope <property_NetworkRoute_scope>`
* :ref:`source <property_NetworkRoute_source>`
* :ref:`Object.objectId <property_Object_objectId>`
* :ref:`Object.parent <property_Object_parent>`

Methods
+++++++

.. hlist::
:columns: 1

* :ref:`Object.fromJson() <method_Object_fromJson>`
* :ref:`Object.toJson() <method_Object_toJson>`

Signals
+++++++

.. hlist::
:columns: 1

* :ref:`Object.completed() <signal_Object_completed>`

Enumerations
++++++++++++

.. hlist::
:columns: 1

* :ref:`Protocol <enum_NetworkRoute_Protocol>`
* :ref:`Scope <enum_NetworkRoute_Scope>`



Properties
**********


.. _property_NetworkRoute_destination:

.. _signal_NetworkRoute_destinationChanged:

.. index::
single: destination

destination
+++++++++++

This property holds the destination host or network of the route. For networks, it has to be followed by a slash and the prefix length.

:**› Type**: String
:**› Signal**: destinationChanged()
:**› Attributes**: Writable


.. _property_NetworkRoute_gateway:

.. _signal_NetworkRoute_gatewayChanged:

.. index::
single: gateway

gateway
+++++++

This property holds the gateway of the route.

:**› Type**: String
:**› Signal**: gatewayChanged()
:**› Attributes**: Writable


.. _property_NetworkRoute_metric:

.. _signal_NetworkRoute_metricChanged:

.. index::
single: metric

metric
++++++

This property holds the metric of the route.

:**› Type**: SignedInteger
:**› Signal**: metricChanged()
:**› Attributes**: Writable


.. _property_NetworkRoute_mtu:

.. _signal_NetworkRoute_mtuChanged:

.. index::
single: mtu

mtu
+++

This property holds the maximum transmission unit in bytes to set for the route.

:**› Type**: SignedInteger
:**› Signal**: mtuChanged()
:**› Attributes**: Writable


.. _property_NetworkRoute_protocol:

.. _signal_NetworkRoute_protocolChanged:

.. index::
single: protocol

protocol
++++++++

This property holds the routing protocol identifier of the route.

:**› Type**: :ref:`Protocol <enum_NetworkRoute_Protocol>`
:**› Default**: :ref:`NetworkRoute.Static <enumitem_NetworkRoute_Static>`
:**› Signal**: protocolChanged()
:**› Attributes**: Writable


.. _property_NetworkRoute_scope:

.. _signal_NetworkRoute_scopeChanged:

.. index::
single: scope

scope
+++++

This property holds the scope of the IPv4 route. It's not used for IPv6 routes.

:**› Type**: :ref:`Scope <enum_NetworkRoute_Scope>`
:**› Default**: :ref:`NetworkRoute.Global <enumitem_NetworkRoute_Global>`
:**› Signal**: scopeChanged()
:**› Attributes**: Writable


.. _property_NetworkRoute_source:

.. _signal_NetworkRoute_sourceChanged:

.. index::
single: source

source
++++++

This property holds the optional source prefix of the route, possibly followed by a slash and the prefix length.

:**› Type**: String
:**› Signal**: sourceChanged()
:**› Attributes**: Writable

Enumerations
************


.. _enum_NetworkRoute_Protocol:

.. index::
single: Protocol

Protocol
++++++++

This enumeration describes the supported routing protocol identifiers.

.. index::
single: NetworkRoute.Kernel
.. index::
single: NetworkRoute.Boot
.. index::
single: NetworkRoute.Static
.. index::
single: NetworkRoute.RA
.. index::
single: NetworkRoute.Dhcp
.. list-table::
:widths: auto
:header-rows: 1

* - Name
- Value
- Description

.. _enumitem_NetworkRoute_Kernel:
* - ``NetworkRoute.Kernel``
- ``0``
- The route was installed by the kernel during autoconfiguration.

.. _enumitem_NetworkRoute_Boot:
* - ``NetworkRoute.Boot``
- ``1``
- The route was installed during the bootup sequence.

.. _enumitem_NetworkRoute_Static:
* - ``NetworkRoute.Static``
- ``2``
- The route was installed manually to override dynamic routing.

.. _enumitem_NetworkRoute_RA:
* - ``NetworkRoute.RA``
- ``3``
- The route was installed by Router Discovery protocol.

.. _enumitem_NetworkRoute_Dhcp:
* - ``NetworkRoute.Dhcp``
- ``4``
- The route was installed by DHCP client.


.. _enum_NetworkRoute_Scope:

.. index::
single: Scope

Scope
+++++

This enumeration describes the supported scopes for IPv4 routes.

.. index::
single: NetworkRoute.Global
.. index::
single: NetworkRoute.Site
.. index::
single: NetworkRoute.Link
.. index::
single: NetworkRoute.Host
.. index::
single: NetworkRoute.Nowhere
.. list-table::
:widths: auto
:header-rows: 1

* - Name
- Value
- Description

.. _enumitem_NetworkRoute_Global:
* - ``NetworkRoute.Global``
- ``0``
- The route can reach hosts more than one hop away.

.. _enumitem_NetworkRoute_Site:
* - ``NetworkRoute.Site``
- ``1``
- An interior route in the local autonomous system.

.. _enumitem_NetworkRoute_Link:
* - ``NetworkRoute.Link``
- ``2``
- The route can only reach hosts on the local network (one hop away).

.. _enumitem_NetworkRoute_Host:
* - ``NetworkRoute.Host``
- ``3``
- The route will not leave the local machine (used for internal addresses like 127.0.0.1).

.. _enumitem_NetworkRoute_Nowhere:
* - ``NetworkRoute.Nowhere``
- ``4``
- The destination doesn't exist.

3 changes: 2 additions & 1 deletion InCore.Foundation/NftFlow.rst
Original file line number Diff line number Diff line change
Expand Up @@ -148,9 +148,10 @@ This property holds the network interface to transmit traffic to for this flow.
protocol
++++++++


This property holds the protocol which to match. It has to be set to a protocol such as TCP or UDP in order to use source or destination port matching (:ref:`sourcePorts <property_NftFlow_sourcePorts>`/:ref:`destinationPorts <property_NftFlow_destinationPorts>`).

:**› Type**: :ref:`NftRule.Protocol <enum_NftRule_Protocol>`
:**› Default**: :ref:`NftRule.AllProtocols <enumitem_NftRule_AllProtocols>`
:**› Signal**: protocolChanged()
:**› Attributes**: Writable

Expand Down

0 comments on commit 97be644

Please sign in to comment.