pathd: Add optional support for PCEP to pathd

This new dynamic module makes pathd behave as a PCC for dynamic candidate path
using the external library pcpelib https://github.com/volta-networks/pceplib .

The candidate paths defined as dynamic will trigger computation requests to the
configured PCE, and the PCE response will be used to update the policy.

It supports multiple PCE. The one with smaller precedence will be elected
as the master PCE, and only if the connection repeatedly fails, the PCC will
switch to another PCE.

Example of configuration:

segment-routing
 traffic-eng
  pcep
   pce-config CONF
    source-address ip 10.10.10.10
    sr-draft07
   !
   pce PCE1
    config CONF
    address ip 1.1.1.1
   !
   pce PCE2
    config CONF
    address ip 2.2.2.2
   !
   pcc
    peer PCE1 precedence 10
    peer PCE2 precedence 20
   !
  !
 !
!

Co-authored-by: Brady Johnson <brady@voltanet.io>
Co-authored-by: Emanuele Di Pascale <emanuele@voltanet.io>
Co-authored-by: GalaxyGorilla <sascha@netdef.org>
Co-authored-by: Javier Garcia <javier.garcia@voltanet.io>
Co-authored-by: Renato Westphal <renato@opensourcerouting.org>
Co-authored-by: Sebastien Merle <sebastien@netdef.org>
Signed-off-by: Sebastien Merle <sebastien@netdef.org>

1 files changed, 91 insertions, 0 deletions

diff --git a/pathd/path_errors.c b/pathd/path_errors.c
index f266b6b4ea..f8560a848c 100644
--- a/pathd/path_errors.c
+++ b/pathd/path_errors.c
@@ -25,14 +25,105 @@
 /* clang-format off */
 static struct log_ref ferr_path_err[] = {
 	{
+		.code = EC_PATH_SYSTEM_CALL,
+		.title = "Thread setup error",
+		.description = "A system call for creating, or setting up PCEP module's pthread failed",
+		.suggestion = "Open an Issue with all relevant log files and restart FRR"
+	},
+	{
+		.code = EC_PATH_PCEP_PCC_INIT,
+		.title = "PCC initialization error",
+		.description = "pceplib PCC initialization call failed",
+		.suggestion = "Open an Issue with all relevant log files and restart FRR"
+	},
+	{
+		.code = EC_PATH_PCEP_PCC_FINI,
+		.title = "PCC finalization error",
+		.description = "pceplib PCC finalization call failed",
+		.suggestion = "Open an Issue with all relevant log files and restart FRR"
+	},
+	{
+		.code = EC_PATH_PCEP_PCC_CONF_UPDATE,
+		.title = "PCC configuration update error",
+		.description = "The update of the PCC configuration failed",
+		.suggestion = "Open an Issue with all relevant log files and restart FRR"
+	},
+	{
 		.code = END_FERR,
 	}
 };
 
 static struct log_ref ferr_path_warn[] = {
 	{
+		.code = EC_PATH_PCEP_LIB_CONNECT,
+		.title = "PCC connection error",
+		.description = "The PCEP module failed to connected to configured PCE",
+		.suggestion = "Check the connectivity between the PCC and the PCE"
+	},
+	{
+		.code = EC_PATH_PCEP_MISSING_SOURCE_ADDRESS,
+		.title = "PCC connection error",
+		.description = "The PCEP module did not try to connect because it is missing a source address",
+		.suggestion = "Wait for the router ID to be defined or set the PCC source address in the configuration"
+	},
+	{
+		.code = EC_PATH_PCEP_RECOVERABLE_INTERNAL_ERROR,
+		.title = "Recoverable internal error",
+		.description = "Some recoverable internal error",
+		.suggestion = "Open an Issue with all relevant log files"
+	},
+	{
+		.code = EC_PATH_PCEP_UNSUPPORTED_PCEP_FEATURE,
+		.title = "Unsupported PCEP feature",
+		.description = "Receved an unsupported PCEP message",
+		.suggestion = "The PCC and PCE are probably not compatible. Open an Issue with all relevant log files"
+	},
+	{
+		.code = EC_PATH_PCEP_UNEXPECTED_PCEP_MESSAGE,
+		.title = "Unexpected PCEP message",
+		.description = "The PCEP module received an unexpected PCEP message",
+		.suggestion = "Open an Issue with all relevant log files"
+	},
+	{
+		.code = EC_PATH_PCEP_UNEXPECTED_PCEPLIB_EVENT,
+		.title = "Unexpected pceplib event",
+		.description = "The PCEP module received an unexpected event from pceplib",
+		.suggestion = "Open an Issue with all relevant log files"
+	},
+	{
+		.code = EC_PATH_PCEP_UNEXPECTED_PCEP_OBJECT,
+		.title = "Unexpected PCEP object",
+		.description = "The PCEP module received an unexpected PCEP object from a PCE",
+		.suggestion = "Open an Issue with all relevant log files"
+	},
+	{
+		.code = EC_PATH_PCEP_UNEXPECTED_PCEP_TLV,
+		.title = "Unexpected PCEP TLV",
+		.description = "The PCEP module received an unexpected PCEP TLV from a PCE",
+		.suggestion = "Open an Issue with all relevant log files"
+	},
+	{
+		.code = EC_PATH_PCEP_UNEXPECTED_PCEP_ERO_SUBOBJ,
+		.title = "Unexpected PCEP ERO sub-object",
+		.description = "The PCEP module received an unexpected PCEP ERO sub-object from a PCE",
+		.suggestion = "Open an Issue with all relevant log files"
+	},
+	{
+		.code = EC_PATH_PCEP_UNEXPECTED_SR_NAI,
+		.title = "Unexpected PCEP SR segment NAI",
+		.description = "The PCEP module received an SR segment with an unsupported NAI specification from the PCE",
+		.suggestion = "Open an Issue with all relevant log files"
+	},
+	{
+		.code = EC_PATH_PCEP_COMPUTATION_REQUEST_TIMEOUT,
+		.title = "Computation request timeout",
+		.description = "The PCE did not respond in time to the PCC computation request",
+		.suggestion = "The PCE is overloaded or incompatible with the PCC, try with a different PCE"
+	},
+	{
 		.code = END_FERR,
 	}
+
 };
 /* clang-format on */