panic

Panic handling framework.

A ‘panic’ is raised by the EOS SDK to signal a programming error on behalf of the SDK user. A regular ‘assert’ is used by the SDK to signal an Arista error which should be reported for correction.

Panics occur under a number of conditions, such as an invalid string format for an IP address when using ip_addr_t’s constructor to checks of incompatible type attributes during manager calls. The panic exception passed to the exception_handler_t callback describes the fault condition observed.

During a panic call, any panic handler set with exception_handler_is is called with the message, and then the panic message is also written to stderr and a SIGABRT raised. The SIGABRT will also cause a stack trace to be dumped.

namespace eos

Typedefs

typedef void(* exception_handler_t)(error const &exception)

The exception handler callback definition.

Parameters

• exception -

  The exception that needs to be handled.

Functions

void panic(error const & exception)

Reports an exception from the SDK. Internal errors and programming errors are reported via subclasses of exception. See eos/exception.h for possible exceptions.

void panic(char const * fmt, ...)

void vpanic(char const * fmt, va_list ap)

void exception_handler_is(exception_handler_t)

Sets a custom panic handler.

Parameters

• exception_handler_t -

  An exception handler callback