initial commit

Signed-off-by: Rastislav Szabo <raszabo@cisco.com>

1 files changed, 20 insertions, 0 deletions

diff --git a/core/doc.go b/core/doc.go
new file mode 100644
index 0000000..a4ecd50
--- /dev/null
+++ b/core/doc.go
@@ -0,0 +1,20 @@
+// Package core provides connectivity to VPP via the adapter: sends and receives the messages to/from VPP,
+// marshalls/unmarshalls them and forwards them between the client Go channels and the VPP.
+//
+// The interface_plugin APIs the core exposes is tied to a connection: Connect provides a connection, that cane be
+// later used to request an API channel via NewAPIChannel / NewAPIChannelBuffered functions:
+//
+//	conn, err := govpp.Connect()
+//	if err != nil {
+//		// handle error!
+//	}
+//	defer conn.Disconnect()
+//
+//	ch, err := conn.NewAPIChannel()
+//	if err != nil {
+//		// handle error!
+//	}
+//	defer ch.Close()
+//
+// Note that one application can open only one connection, that can serve multiple API channels.
+package core