Skip to content

Latest commit

 

History

History
227 lines (160 loc) · 7.61 KB

CHANGELOG.md

File metadata and controls

227 lines (160 loc) · 7.61 KB
Raw

Changelog

This file lists changes for the GoVPP releases.

0.6.0

09 September 2022

Changes

  • Added GitHub CI
  • Remove deprecated vppapiclient
  • Remove unused Travis CI
  • Remove gerrit remains

Fixes

  • Call munmap when failed to check stat segment version (#34)

0.5.0

28 July 2022

Features

  • Also generate APIName/APIVersion/CrcVersion constants for the types packages
  • Stat segment client fixes & improvements

Fixes

  • Fix go 1.18 support
  • Fixed data race in core.Connection.Close()
  • Fix channel ID overlap

0.4.0

17 January 2022

Binapi Generator

  • the generator code has been split into multiple packages:
    • vppapi - parses VPP API (.api.json) files
    • binapigen - processes parsed VPP API files and handles code generation
  • added support for VPP enumflags type
  • previously required manual patches for generated code should no longer be needed
  • many generated aliases were removed and referenced to *_types files for simpler reading
  • any types imported from other VPP API (*_types.api) files are now automatically resolved for generated Go code
  • marshal/unmarshal methods for memory client messages are now generated
  • generated new helper methods for more convenient IP and MAC address conversion
  • RPC service code is now generated into a separated file (*_rpc.ba.go) in the same directory and uses a new low level stream API
  • added option to generate HTTP handlers for RPC services
  • generated code now contains comments with information about versions of VPP and binapi-generator
  • in addition to the file name, the binapi generator now accepts full path (including extension, e.g. /usr/share/vpp/api/core/vpe.api.json)
  • dependency on github.com/lunixbochs/struc was removed
  • generated helper methods for vpe_types.Timestamp
  • generated API messages comment may contain additional information about the given API development state (in progress, deprecated)
  • type []bool is now known to the generator
  • enhanced VPP version resolution - the generator is more reliable to evaluate installed VPP version

Features

  • socketclient was optimized and received a new method to add client name
  • added new API stream for low-level access to VPP API
    • the Stream API uses the same default values as the Channel API
    • it supports the same functional options (request size, reply size, reply timeout)
  • statsclient supports additional options (retry period, retry timeout)
  • the compatibility check error now contains a list of compatible and incompatible messages wrapped as CompatibilityError
  • removed global binary API adapter. This change allows GoVPP to manage multiple VPP connections with different sockets simultaneously
  • added support for the stats v2. The statsclient adapter recognizes the version automatically so the StatsAPI remains unchanged. In relation to this change, the legacy support (i.e. stat segment v0) for VPP <=19.04 was dropped.
  • GoVPP now recognizes VPP state NotResponding which can be used to prevent disconnecting in case the VPP hangs or is overloaded
  • added method SetLogger() for setting the global logger
  • StatsAPI has a new method GetMemory() retrieving values related to the statseg memory heap
  • the stats socket allows an option to connect asynchronously in the same manner as the API socket connection. Use AsyncConnectStats() to receive ConnectionEvent notifications
  • Instead of a cumulative value, the statsclient error counter now provides a value per worker
  • ListStats(patterns ...string) returns StatIdentifier containing the message name and the ID (instead of the name only)
  • added support for VPP stat symlinks
  • GoVPP received its own API trace. See the example for more details.

Fixes

  • MsgCodec will recover panic occurring during a message decoding
  • calling Unsubscibe will close the notification channel
  • GoVPP omits to send sockclnt_delete while cleaning up socket clients in order to remove VPP duplicated close complaints - VPP handles it itself
  • fixed major bug causing GoVPP to not receive stats updates after VPP restart
  • fixed name conflict in generated union field constructors
  • the size of unions composed of other unions is now calculated correctly
  • fixed race condition in the VPP adapter mock
  • fixed crash caused by the return value of uint kind
  • fixed encoding/decoding of float64
  • fixed the stats reconnect procedure which occasionally failed re-enable the connection.
  • fixed occasional panic during disconnect
  • statsclient wait for socket procedure works properly
  • fixed memory leak in health check

Other

  • improved log messages to provide more relevant info
  • updated extras/libmemif to be compatible with the latest VPP changes
  • default health check parameter was increased to 250 milliseconds (up from 100 milliseconds), and the default threshold was increased to 2 (up from 1)
  • improved decoding of message context (message evaluation uses also the package path, not just the message ID)
  • statsclient now recognizes between empty stat directories and does not treat them as unknown
  • proxy client was updated to VPP 20.05

Examples

Dependencies

  • updated github.com/sirupsen/logrus dep to v1.6.0
  • updated github.com/lunixbochs/struc dep to v0.0.0-20200521075829-a4cb8d33dbbe

0.3.5

18 May 2020

Fixes

  • statsclient: Fix stats data errors and panic for VPP 20.05

0.3.4

17 April 2020

Features

  • binapi-generator: Format generated Go source code in-process

0.3.3

9 April 2020

Fixes

  • proxy: Unexport methods that do not satisfy rpc to remove warning

0.3.2

20 March 2020

Fixes

  • statsclient: Fix panic occurring with VPP 20.05-rc0 (master)

0.3.1

18 March 2020

Fixes

  • Fix import path in examples/binapi

0.3.0

18 March 2020

Fixes

  • binapi-generator: Fix parsing default meta parameter

Features

  • api: Improve compatibility checking with new error types: adapter.UnknownMsgError and api.CompatibilityError
  • api: Added exported function api.GetRegisteredMessageTypes() for getting list of all registered message types
  • binapi-generator: Support imports of common types from other packages
  • binapi-generator: Generate Reset() method for messages
  • binapi-generator: Compact generated methods

Other

  • deps: Update github.com/bennyscetbun/jsongo to v1.1.0
  • regenerate examples/binapi for latest VPP from stable/2001

0.2.0

04 November 2019

Fixes

  • fixed socketclient for 19.08
  • fixed binapi compatibility with master (20.01-rc0)
  • fixed panic during stat data conversion

Features

  • introduce proxy for remote access to stats and binapi
  • optimizations for statclient

Other

  • migrate to Go modules
  • print info for users when sockets are missing

0.1.0

03 July 2019

The first release that introduces versioning for GoVPP.