X-Git-Url: https://gerrit.fd.io/r/gitweb?p=govpp.git;a=blobdiff_plain;f=README.md;fp=README.md;h=b07820e023d675d9ebad66b6c01a4fbeb469922e;hp=f1c83c6e8a7fb022044a759ed5395be79c1a649a;hb=fa21c9d726ebb807895a8571af9a16dab5cd8d6e;hpb=8ba70a7b13950593aab9863246f830eda450f06b diff --git a/README.md b/README.md index f1c83c6..b07820e 100644 --- a/README.md +++ b/README.md @@ -3,9 +3,9 @@ This set of packages provide the API for communication with VPP from Go. It consists of the following packages: -- [adapter](adapter/): adapter between GoVPP core and the VPP +- [adapter](adapter/): adapter between GoVPP core and the VPP binary API - [api](api/api.go): API for communication with GoVPP core -- [binapi-generator](cmd/binapi-generator/): Generator for the VPP binary API definitions in JSON format to Go code +- [binapi-generator](cmd/binapi-generator/): generator for the VPP binary API definitions in JSON format to Go code - [codec](codec/): handles encoding/decoding of generated messages into binary form - [core](core/): main functionality of the GoVPP - [examples](examples/): examples that use the GoVPP API in real use-cases of VPP management application @@ -92,12 +92,14 @@ func main() { } ``` -The example above uses simple wrapper API over underlying go channels, see [example client](examples/cmd/simple-client/simple_client.go) +The example above uses simple wrapper API over underlying go channels, +see [example client](examples/simple-client/simple_client.go) for more examples, including the example on how to use the Go channels directly. ## Build & Installation Procedure -Govpp uses `vppapiclient` library from VPP codebase to communicate with VPP. To build GoVPP, vpp-dev package must be installed, +GoVPP uses `vppapiclient` library from VPP codebase to communicate with VPP. +To build GoVPP, vpp-dev package must be installed, either [from packages](https://wiki.fd.io/view/VPP/Installing_VPP_binaries_from_packages) or [from sources](https://wiki.fd.io/view/VPP/Build,_install,_and_test_images#Build_A_VPP_Package). @@ -138,7 +140,7 @@ binapi-generator --input-dir=examples/bin_api --output-dir=examples/bin_api In Go, [go generate](https://blog.golang.org/generate) tool can be leveraged to ease the code generation process. It allows to specify generator instructions in any one of the regular (non-generated) `.go` files that are dependent on generated code using special comments, e.g. the one from -[example client](examples/cmd/simple-client/simple_client.go): +[example client](examples/simple-client/simple_client.go): ```go //go:generate binapi-generator --input-dir=bin_api --output-dir=bin_api