From c38cb25d746736f062ee16e87f553c8a4ec5fced Mon Sep 17 00:00:00 2001 From: Rastislav Szabo Date: Mon, 22 May 2017 13:59:34 +0200 Subject: binapi-generator renamed & moved, finished documentation Change-Id: I7d3b53fa238e822b36a6a82c61ffb792da3898bf Signed-off-by: Rastislav Szabo --- cmd/binapi-generator/doc.go | 13 + cmd/binapi-generator/generator.go | 626 +++++++++++++++++++++ cmd/binapi-generator/generator_test.go | 441 +++++++++++++++ cmd/binapi-generator/testdata/acl.api.json | 67 +++ cmd/binapi-generator/testdata/af_packet.api.json | 37 ++ .../testdata/input-generate-error.json | 3 + .../testdata/input-read-json-error.json | 1 + cmd/binapi-generator/testdata/input.txt | 0 cmd/binapi-generator/testdata/ip.api.json | 292 ++++++++++ 9 files changed, 1480 insertions(+) create mode 100644 cmd/binapi-generator/doc.go create mode 100644 cmd/binapi-generator/generator.go create mode 100644 cmd/binapi-generator/generator_test.go create mode 100644 cmd/binapi-generator/testdata/acl.api.json create mode 100644 cmd/binapi-generator/testdata/af_packet.api.json create mode 100644 cmd/binapi-generator/testdata/input-generate-error.json create mode 100644 cmd/binapi-generator/testdata/input-read-json-error.json create mode 100644 cmd/binapi-generator/testdata/input.txt create mode 100644 cmd/binapi-generator/testdata/ip.api.json (limited to 'cmd/binapi-generator') diff --git a/cmd/binapi-generator/doc.go b/cmd/binapi-generator/doc.go new file mode 100644 index 0000000..e8556ec --- /dev/null +++ b/cmd/binapi-generator/doc.go @@ -0,0 +1,13 @@ +// Generator of Go structs out of the VPP binary API definitions in JSON format. +// +// The JSON input can be specified as a single file (using the `input-file` +// CLI flag), or as a directory that will be scanned for all `.json` files +// (using the `input-dir` CLI flag). The generated Go bindings will be +// placed into `output-dir` (by default the current working directory), +// where each Go package will be placed into its own separate directory, +// for example: +// +// binapi-generator --input-file=examples/bin_api/acl.api.json --output-dir=examples/bin_api +// binapi-generator --input-dir=examples/bin_api --output-dir=examples/bin_api +// +package main diff --git a/cmd/binapi-generator/generator.go b/cmd/binapi-generator/generator.go new file mode 100644 index 0000000..22fe3e1 --- /dev/null +++ b/cmd/binapi-generator/generator.go @@ -0,0 +1,626 @@ +// Copyright (c) 2017 Cisco and/or its affiliates. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at: +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +package main + +import ( + "bufio" + "bytes" + "encoding/json" + "errors" + "flag" + "fmt" + "io" + "io/ioutil" + "os" + "os/exec" + "path/filepath" + "strings" + "unicode" + + "github.com/bennyscetbun/jsongo" +) + +// MessageType represents the type of a VPP message. +type messageType int + +const ( + requestMessage messageType = iota // VPP request message + replyMessage // VPP reply message + otherMessage // other VPP message +) + +const ( + apiImportPath = "git.fd.io/govpp.git/api" // import path of the govpp API + inputFileExt = ".json" // filename extension of files that should be processed as the input +) + +// context is a structure storing details of a particular code generation task +type context struct { + inputFile string // file with input JSON data + inputBuff *bytes.Buffer // contents of the input file + inputLine int // currently processed line in the input file + outputFile string // file with output data + packageName string // name of the Go package being generated + packageDir string // directory where the package source files are located + types map[string]string // map of the VPP typedef names to generated Go typedef names +} + +func main() { + inputFile := flag.String("input-file", "", "Input JSON file.") + inputDir := flag.String("input-dir", ".", "Input directory with JSON files.") + outputDir := flag.String("output-dir", ".", "Output directory where package folders will be generated.") + flag.Parse() + + if *inputFile == "" && *inputDir == "" { + fmt.Fprintln(os.Stderr, "ERROR: input-file or input-dir must be specified") + os.Exit(1) + } + + var err, tmpErr error + if *inputFile != "" { + // process one input file + err = generateFromFile(*inputFile, *outputDir) + if err != nil { + fmt.Fprintf(os.Stderr, "ERROR: code generation from %s failed: %v\n", *inputFile, err) + } + } else { + // process all files in specified directory + files, err := getInputFiles(*inputDir) + if err != nil { + fmt.Fprintf(os.Stderr, "ERROR: code generation failed: %v\n", err) + } + for _, file := range files { + tmpErr = generateFromFile(file, *outputDir) + if tmpErr != nil { + fmt.Fprintf(os.Stderr, "ERROR: code generation from %s failed: %v\n", file, err) + err = tmpErr // remember that the error occurred + } + } + } + if err != nil { + os.Exit(1) + } +} + +// getInputFiles returns all input files located in specified directory +func getInputFiles(inputDir string) ([]string, error) { + files, err := ioutil.ReadDir(inputDir) + if err != nil { + return nil, fmt.Errorf("reading directory %s failed: %v", inputDir, err) + } + res := make([]string, 0) + for _, f := range files { + if strings.HasSuffix(f.Name(), inputFileExt) { + res = append(res, inputDir+"/"+f.Name()) + } + } + return res, nil +} + +// generateFromFile generates Go bindings from one input JSON file +func generateFromFile(inputFile, outputDir string) error { + ctx, err := getContext(inputFile, outputDir) + if err != nil { + return err + } + // read the file + inputData, err := readFile(inputFile) + if err != nil { + return err + } + ctx.inputBuff = bytes.NewBuffer(inputData) + + // parse JSON + jsonRoot, err := parseJSON(inputData) + if err != nil { + return err + } + + // create output directory + err = os.MkdirAll(ctx.packageDir, 0777) + if err != nil { + return fmt.Errorf("creating output directory %s failed: %v", ctx.packageDir, err) + } + + // open output file + f, err := os.Create(ctx.outputFile) + defer f.Close() + if err != nil { + return fmt.Errorf("creating output file %s failed: %v", ctx.outputFile, err) + } + w := bufio.NewWriter(f) + + // generate Go package code + err = generatePackage(ctx, w, jsonRoot) + if err != nil { + return err + } + + // go format the output file (non-fatal if fails) + exec.Command("gofmt", "-w", ctx.outputFile).Run() + + return nil +} + +// getContext returns context details of the code generation task +func getContext(inputFile, outputDir string) (*context, error) { + if !strings.HasSuffix(inputFile, inputFileExt) { + return nil, fmt.Errorf("invalid input file name %s", inputFile) + } + + ctx := &context{inputFile: inputFile} + inputFileName := filepath.Base(inputFile) + + ctx.packageName = inputFileName[0:strings.Index(inputFileName, ".")] + if ctx.packageName == "interface" { + // 'interface' cannot be a package name, it is a go keyword + ctx.packageName = "interfaces" + } + + ctx.packageDir = outputDir + "/" + ctx.packageName + "/" + ctx.outputFile = ctx.packageDir + ctx.packageName + ".go" + + return ctx, nil +} + +// readFile reads content of a file into memory +func readFile(inputFile string) ([]byte, error) { + + inputData, err := ioutil.ReadFile(inputFile) + + if err != nil { + return nil, fmt.Errorf("reading data from file failed: %v", err) + } + + return inputData, nil +} + +// parseJSON parses a JSON data into an in-memory tree +func parseJSON(inputData []byte) (*jsongo.JSONNode, error) { + root := jsongo.JSONNode{} + + err := json.Unmarshal(inputData, &root) + if err != nil { + return nil, fmt.Errorf("JSON unmarshall failed: %v", err) + } + + return &root, nil + +} + +// generatePackage generates Go code of a package from provided JSON +func generatePackage(ctx *context, w *bufio.Writer, jsonRoot *jsongo.JSONNode) error { + // generate file header + generatePackageHeader(ctx, w, jsonRoot) + + // generate data types + ctx.types = make(map[string]string) + types := jsonRoot.Map("types") + for i := 0; i < types.Len(); i++ { + typ := types.At(i) + err := generateMessage(ctx, w, typ, true) + if err != nil { + return err + } + } + + // generate messages + messages := jsonRoot.Map("messages") + for i := 0; i < messages.Len(); i++ { + msg := messages.At(i) + err := generateMessage(ctx, w, msg, false) + if err != nil { + return err + } + } + + // flush the data: + err := w.Flush() + if err != nil { + return fmt.Errorf("flushing data to %s failed: %v", ctx.outputFile, err) + } + + return nil +} + +// generateMessage generates Go code of one VPP message encoded in JSON into provided writer +func generateMessage(ctx *context, w io.Writer, msg *jsongo.JSONNode, isType bool) error { + if msg.Len() == 0 || msg.At(0).GetType() != jsongo.TypeValue { + return errors.New("invalid JSON for message specified") + } + + msgName, ok := msg.At(0).Get().(string) + if !ok { + return fmt.Errorf("invalid JSON for message specified, message name is %T, not a string", msg.At(0).Get()) + } + structName := camelCaseName(strings.Title(msgName)) + + // generate struct fields into the slice & determine message type + fields := make([]string, 0) + msgType := otherMessage + for j := 0; j < msg.Len(); j++ { + if jsongo.TypeArray == msg.At(j).GetType() { + fld := msg.At(j) + err := processMessageField(ctx, &fields, fld) + if err != nil { + return err + } + // determine whether ths is a request / reply / other message + if j == 2 { + fieldName, ok := fld.At(1).Get().(string) + if ok { + if fieldName == "client_index" { + msgType = requestMessage + } else if fieldName == "context" { + msgType = replyMessage + } else { + msgType = otherMessage + } + } + } + } + } + + // generate struct comment + generateMessageComment(ctx, w, structName, msgName, isType) + + // generate struct header + fmt.Fprintln(w, "type", structName, "struct {") + + // print out the fields + for _, field := range fields { + fmt.Fprintln(w, field) + } + + // generate end of the struct + fmt.Fprintln(w, "}") + + // generate name getter + if isType { + generateTypeNameGetter(w, structName, msgName) + } else { + generateMessageNameGetter(w, structName, msgName) + } + + // generate message type getter method + if !isType { + generateMessageTypeGetter(w, structName, msgType) + } + + // generate CRC getter + crcIf := msg.At(msg.Len() - 1).At("crc").Get() + if crc, ok := crcIf.(string); ok { + generateCrcGetter(w, structName, crc) + } + + // generate message factory + if !isType { + generateMessageFactory(w, structName) + } + + // if this is a type, save it in the map for later use + if isType { + ctx.types[fmt.Sprintf("vl_api_%s_t", msgName)] = structName + } + + return nil +} + +// processMessageField process JSON describing one message field into Go code emitted into provided slice of message fields +func processMessageField(ctx *context, fields *[]string, fld *jsongo.JSONNode) error { + if fld.Len() < 2 || fld.At(0).GetType() != jsongo.TypeValue || fld.At(1).GetType() != jsongo.TypeValue { + return errors.New("invalid JSON for message field specified") + } + fieldVppType, ok := fld.At(0).Get().(string) + if !ok { + return fmt.Errorf("invalid JSON for message specified, field type is %T, not a string", fld.At(0).Get()) + } + fieldName, ok := fld.At(1).Get().(string) + if !ok { + return fmt.Errorf("invalid JSON for message specified, field name is %T, not a string", fld.At(1).Get()) + } + + // skip internal fields + fieldNameLower := strings.ToLower(fieldName) + if fieldNameLower == "crc" || fieldNameLower == "_vl_msg_id" { + return nil + } + if len(*fields) == 0 && (fieldNameLower == "client_index" || fieldNameLower == "context") { + return nil + } + + fieldName = strings.TrimPrefix(fieldName, "_") + fieldName = camelCaseName(strings.Title(fieldName)) + + fieldStr := "" + isArray := false + arraySize := 0 + + fieldStr += "\t" + fieldName + " " + if fld.Len() > 2 { + isArray = true + arraySize = int(fld.At(2).Get().(float64)) + fieldStr += "[]" + } + + dataType := translateVppType(ctx, fieldVppType, isArray) + fieldStr += dataType + + if isArray { + if arraySize == 0 { + // variable sized array + if fld.Len() > 3 { + // array size is specified by another field + arraySizeField := string(fld.At(3).Get().(string)) + arraySizeField = camelCaseName(strings.Title(arraySizeField)) + // find & update the field that specifies the array size + for i, f := range *fields { + if strings.Contains(f, fmt.Sprintf("\t%s ", arraySizeField)) { + (*fields)[i] += fmt.Sprintf("\t`struc:\"sizeof=%s\"`", fieldName) + } + } + } + } else { + // fixed size array + fieldStr += fmt.Sprintf("\t`struc:\"[%d]%s\"`", arraySize, dataType) + } + } + + *fields = append(*fields, fieldStr) + return nil +} + +// generatePackageHeader generates package header into provider writer +func generatePackageHeader(ctx *context, w io.Writer, rootNode *jsongo.JSONNode) { + fmt.Fprintln(w, "// Package "+ctx.packageName+" represents the VPP binary API of the '"+ctx.packageName+"' VPP module.") + fmt.Fprintln(w, "// DO NOT EDIT. Generated from '"+ctx.inputFile+"'") + + fmt.Fprintln(w, "package "+ctx.packageName) + + fmt.Fprintln(w, "import \""+apiImportPath+"\"") + + fmt.Fprintln(w) + fmt.Fprintln(w, "// VlApiVersion contains version of the API.") + vlAPIVersion := rootNode.Map("vl_api_version") + if vlAPIVersion != nil { + fmt.Fprintln(w, "const VlAPIVersion = ", vlAPIVersion.Get()) + } + fmt.Fprintln(w) +} + +// generateMessageComment generates comment for a message into provider writer +func generateMessageComment(ctx *context, w io.Writer, structName string, msgName string, isType bool) { + fmt.Fprintln(w) + if isType { + fmt.Fprintln(w, "// "+structName+" represents the VPP binary API data type '"+msgName+"'.") + } else { + fmt.Fprintln(w, "// "+structName+" represents the VPP binary API message '"+msgName+"'.") + } + + // print out the source of the generated message - the JSON + msgFound := false + for { + lineBuff, err := ctx.inputBuff.ReadBytes('\n') + if err != nil { + break + } + ctx.inputLine++ + line := string(lineBuff) + + if !msgFound { + if strings.Contains(line, msgName) { + fmt.Fprintf(w, "// Generated from '%s', line %d:\n", ctx.inputFile, ctx.inputLine) + fmt.Fprintln(w, "//") + fmt.Fprint(w, "//", line) + msgFound = true + } + } else { + fmt.Fprint(w, "//", line) + if len(strings.Trim(line, " ")) < 4 { + break // end of the message in JSON + } + } + } + fmt.Fprintln(w, "//") +} + +// generateMessageNameGetter generates getter for original VPP message name into the provider writer +func generateMessageNameGetter(w io.Writer, structName string, msgName string) { + fmt.Fprintln(w, "func (*"+structName+") GetMessageName() string {") + fmt.Fprintln(w, "\treturn \""+msgName+"\"") + fmt.Fprintln(w, "}") +} + +// generateTypeNameGetter generates getter for original VPP type name into the provider writer +func generateTypeNameGetter(w io.Writer, structName string, msgName string) { + fmt.Fprintln(w, "func (*"+structName+") GetTypeName() string {") + fmt.Fprintln(w, "\treturn \""+msgName+"\"") + fmt.Fprintln(w, "}") +} + +// generateMessageTypeGetter generates message factory for the generated message into the provider writer +func generateMessageTypeGetter(w io.Writer, structName string, msgType messageType) { + fmt.Fprintln(w, "func (*"+structName+") GetMessageType() api.MessageType {") + if msgType == requestMessage { + fmt.Fprintln(w, "\treturn api.RequestMessage") + } else if msgType == replyMessage { + fmt.Fprintln(w, "\treturn api.ReplyMessage") + } else { + fmt.Fprintln(w, "\treturn api.OtherMessage") + } + fmt.Fprintln(w, "}") +} + +// generateCrcGetter generates getter for CRC checksum of the message definition into the provider writer +func generateCrcGetter(w io.Writer, structName string, crc string) { + crc = strings.TrimPrefix(crc, "0x") + fmt.Fprintln(w, "func (*"+structName+") GetCrcString() string {") + fmt.Fprintln(w, "\treturn \""+crc+"\"") + fmt.Fprintln(w, "}") +} + +// generateMessageFactory generates message factory for the generated message into the provider writer +func generateMessageFactory(w io.Writer, structName string) { + fmt.Fprintln(w, "func New"+structName+"() api.Message {") + fmt.Fprintln(w, "\treturn &"+structName+"{}") + fmt.Fprintln(w, "}") +} + +// translateVppType translates the VPP data type into Go data type +func translateVppType(ctx *context, vppType string, isArray bool) string { + // basic types + switch vppType { + case "u8": + if isArray { + return "byte" + } + return "uint8" + case "i8": + return "int8" + case "u16": + return "uint16" + case "i16": + return "int16" + case "u32": + return "uint32" + case "i32": + return "int32" + case "u64": + return "uint64" + case "i64": + return "int64" + case "f64": + return "float64" + } + + // typedefs + typ, ok := ctx.types[vppType] + if ok { + return typ + } + + panic(fmt.Sprintf("Unknown VPP type %s", vppType)) +} + +// camelCaseName returns correct name identifier (camelCase). +func camelCaseName(name string) (should string) { + // Fast path for simple cases: "_" and all lowercase. + if name == "_" { + return name + } + allLower := true + for _, r := range name { + if !unicode.IsLower(r) { + allLower = false + break + } + } + if allLower { + return name + } + + // Split camelCase at any lower->upper transition, and split on underscores. + // Check each word for common initialisms. + runes := []rune(name) + w, i := 0, 0 // index of start of word, scan + for i+1 <= len(runes) { + eow := false // whether we hit the end of a word + if i+1 == len(runes) { + eow = true + } else if runes[i+1] == '_' { + // underscore; shift the remainder forward over any run of underscores + eow = true + n := 1 + for i+n+1 < len(runes) && runes[i+n+1] == '_' { + n++ + } + + // Leave at most one underscore if the underscore is between two digits + if i+n+1 < len(runes) && unicode.IsDigit(runes[i]) && unicode.IsDigit(runes[i+n+1]) { + n-- + } + + copy(runes[i+1:], runes[i+n+1:]) + runes = runes[:len(runes)-n] + } else if unicode.IsLower(runes[i]) && !unicode.IsLower(runes[i+1]) { + // lower->non-lower + eow = true + } + i++ + if !eow { + continue + } + + // [w,i) is a word. + word := string(runes[w:i]) + if u := strings.ToUpper(word); commonInitialisms[u] { + // Keep consistent case, which is lowercase only at the start. + if w == 0 && unicode.IsLower(runes[w]) { + u = strings.ToLower(u) + } + // All the common initialisms are ASCII, + // so we can replace the bytes exactly. + copy(runes[w:], []rune(u)) + } else if w > 0 && strings.ToLower(word) == word { + // already all lowercase, and not the first word, so uppercase the first character. + runes[w] = unicode.ToUpper(runes[w]) + } + w = i + } + return string(runes) +} + +// commonInitialisms is a set of common initialisms that need to stay in upper case. +var commonInitialisms = map[string]bool{ + "ACL": true, + "API": true, + "ASCII": true, + "CPU": true, + "CSS": true, + "DNS": true, + "EOF": true, + "GUID": true, + "HTML": true, + "HTTP": true, + "HTTPS": true, + "ID": true, + "IP": true, + "ICMP": true, + "JSON": true, + "LHS": true, + "QPS": true, + "RAM": true, + "RHS": true, + "RPC": true, + "SLA": true, + "SMTP": true, + "SQL": true, + "SSH": true, + "TCP": true, + "TLS": true, + "TTL": true, + "UDP": true, + "UI": true, + "UID": true, + "UUID": true, + "URI": true, + "URL": true, + "UTF8": true, + "VM": true, + "XML": true, + "XMPP": true, + "XSRF": true, + "XSS": true, +} diff --git a/cmd/binapi-generator/generator_test.go b/cmd/binapi-generator/generator_test.go new file mode 100644 index 0000000..7527a98 --- /dev/null +++ b/cmd/binapi-generator/generator_test.go @@ -0,0 +1,441 @@ +// Copyright (c) 2017 Cisco and/or its affiliates. +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at: +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +package main + +import ( + "bufio" + "bytes" + "os" + "testing" + + "github.com/bennyscetbun/jsongo" + . "github.com/onsi/gomega" +) + +func TestGetInputFiles(t *testing.T) { + RegisterTestingT(t) + result, err := getInputFiles("testdata") + Expect(err).ShouldNot(HaveOccurred()) + Expect(result).To(HaveLen(5)) + for _, file := range result { + Expect(file).To(BeAnExistingFile()) + } +} + +func TestGetInputFilesError(t *testing.T) { + RegisterTestingT(t) + result, err := getInputFiles("nonexisting_directory") + Expect(err).Should(HaveOccurred()) + Expect(result).To(BeNil()) +} + +func TestGenerateFromFile(t *testing.T) { + RegisterTestingT(t) + outDir := "test_output_directory" + // remove directory created during test + defer os.RemoveAll(outDir) + err := generateFromFile("testdata/acl.api.json", outDir) + Expect(err).ShouldNot(HaveOccurred()) + fileInfo, err := os.Stat(outDir + "/acl/acl.go") + Expect(err).ShouldNot(HaveOccurred()) + Expect(fileInfo.IsDir()).To(BeFalse()) + Expect(fileInfo.Name()).To(BeEquivalentTo("acl.go")) +} + +func TestGenerateFromFileInputError(t *testing.T) { + RegisterTestingT(t) + outDir := "test_output_directory" + err := generateFromFile("testdata/nonexisting.json", outDir) + Expect(err).Should(HaveOccurred()) + Expect(err.Error()).To(ContainSubstring("reading data from file failed")) +} + +func TestGenerateFromFileReadJsonError(t *testing.T) { + RegisterTestingT(t) + outDir := "test_output_directory" + err := generateFromFile("testdata/input-read-json-error.json", outDir) + Expect(err).Should(HaveOccurred()) + Expect(err.Error()).To(ContainSubstring("JSON unmarshall failed")) +} + +func TestGenerateFromFileGeneratePackageError(t *testing.T) { + RegisterTestingT(t) + outDir := "test_output_directory" + // generate package throws panic, recover after it + defer func() { + if recovery := recover(); recovery != nil { + t.Logf("Recovered from panic: %v", recovery) + } + os.RemoveAll(outDir) + }() + err := generateFromFile("testdata/input-generate-error.json", outDir) + Expect(err).Should(HaveOccurred()) +} + +func TestGetContext(t *testing.T) { + RegisterTestingT(t) + outDir := "test_output_directory" + result, err := getContext("testdata/af_packet.api.json", outDir) + Expect(err).ShouldNot(HaveOccurred()) + Expect(result).ToNot(BeNil()) + Expect(result.outputFile).To(BeEquivalentTo(outDir + "/af_packet/af_packet.go")) +} + +func TestGetContextNoJsonFile(t *testing.T) { + RegisterTestingT(t) + outDir := "test_output_directory" + result, err := getContext("testdata/input.txt", outDir) + Expect(err).Should(HaveOccurred()) + Expect(err.Error()).To(ContainSubstring("invalid input file name")) + Expect(result).To(BeNil()) +} + +func TestGetContextInterfaceJson(t *testing.T) { + RegisterTestingT(t) + outDir := "test_output_directory" + result, err := getContext("testdata/interface.json", outDir) + Expect(err).ShouldNot(HaveOccurred()) + Expect(result).ToNot(BeNil()) + Expect(result.outputFile) + Expect(result.outputFile).To(BeEquivalentTo(outDir + "/interfaces/interfaces.go")) + +} + +func TestReadJson(t *testing.T) { + RegisterTestingT(t) + inputData, err := readFile("testdata/af_packet.api.json") + Expect(err).ShouldNot(HaveOccurred()) + result, err := parseJSON(inputData) + Expect(err).ShouldNot(HaveOccurred()) + Expect(result).ToNot(BeNil()) + Expect(result.Len()).To(BeEquivalentTo(3)) +} + +func TestReadJsonError(t *testing.T) { + RegisterTestingT(t) + inputData, err := readFile("testdata/input-read-json-error.json") + Expect(err).ShouldNot(HaveOccurred()) + result, err := parseJSON(inputData) + Expect(err).Should(HaveOccurred()) + Expect(err.Error()).To(ContainSubstring("JSON unmarshall failed")) + Expect(result).To(BeNil()) +} + +func TestGeneratePackage(t *testing.T) { + RegisterTestingT(t) + // prepare context + testCtx := new(context) + testCtx.packageName = "test-package-name" + + // prepare input/output output files + inputData, err := readFile("testdata/ip.api.json") + Expect(err).ShouldNot(HaveOccurred()) + testCtx.inputBuff = bytes.NewBuffer(inputData) + inFile, _ := parseJSON(inputData) + outDir := "test_output_directory" + outFile, _ := os.Create(outDir) + defer os.RemoveAll(outDir) + + // prepare writer + writer := bufio.NewWriter(outFile) + Expect(writer.Buffered()).To(BeZero()) + err = generatePackage(testCtx, writer, inFile) + Expect(err).ShouldNot(HaveOccurred()) +} + +func TestGenerateMessageType(t *testing.T) { + RegisterTestingT(t) + // prepare context + testCtx := new(context) + testCtx.packageName = "test-package-name" + + // prepare input/output output files + inputData, err := readFile("testdata/ip.api.json") + Expect(err).ShouldNot(HaveOccurred()) + testCtx.inputBuff = bytes.NewBuffer(inputData) + inFile, _ := parseJSON(inputData) + outDir := "test_output_directory" + outFile, _ := os.Create(outDir) + defer os.RemoveAll(outDir) + + // prepare writer + writer := bufio.NewWriter(outFile) + + types := inFile.Map("types") + testCtx.types = map[string]string{ + "u32": "sw_if_index", + "u8": "weight", + } + Expect(types.Len()).To(BeEquivalentTo(1)) + for i := 0; i < types.Len(); i++ { + typ := types.At(i) + Expect(writer.Buffered()).To(BeZero()) + err := generateMessage(testCtx, writer, typ, true) + Expect(err).ShouldNot(HaveOccurred()) + Expect(writer.Buffered()).ToNot(BeZero()) + + } +} + +func TestGenerateMessageName(t *testing.T) { + RegisterTestingT(t) + // prepare context + testCtx := new(context) + testCtx.packageName = "test-package-name" + + // prepare input/output output files + inputData, err := readFile("testdata/ip.api.json") + Expect(err).ShouldNot(HaveOccurred()) + testCtx.inputBuff = bytes.NewBuffer(inputData) + inFile, _ := parseJSON(inputData) + outDir := "test_output_directory" + outFile, err := os.Create(outDir) + Expect(err).ShouldNot(HaveOccurred()) + defer os.RemoveAll(outDir) + + // prepare writer + writer := bufio.NewWriter(outFile) + + types := inFile.Map("types") + Expect(types.Len()).To(BeEquivalentTo(1)) + for i := 0; i < types.Len(); i++ { + typ := types.At(i) + Expect(writer.Buffered()).To(BeZero()) + err := generateMessage(testCtx, writer, typ, false) + Expect(err).ShouldNot(HaveOccurred()) + Expect(writer.Buffered()).ToNot(BeZero()) + + } +} + +func TestGenerateMessageFieldTypes(t *testing.T) { + // expected results according to acl.api.json in testdata + expectedTypes := []string{"\tIsPermit uint8", "\tIsIpv6 uint8", "\tSrcIPAddr []byte `struc:\"[16]byte\"`", + "\tSrcIPPrefixLen uint8", "\tDstIPAddr []byte `struc:\"[16]byte\"`", "\tDstIPPrefixLen uint8", "\tProto uint8", + "\tSrcportOrIcmptypeFirst uint16", "\tSrcportOrIcmptypeLast uint16", "\tDstportOrIcmpcodeFirst uint16", + "\tDstportOrIcmpcodeLast uint16", "\tTCPFlagsMask uint8", "\tTCPFlagsValue uint8"} + RegisterTestingT(t) + // prepare context + testCtx := new(context) + testCtx.packageName = "test-package-name" + + // prepare input/output output files + inputData, err := readFile("testdata/acl.api.json") + Expect(err).ShouldNot(HaveOccurred()) + inFile, _ := parseJSON(inputData) + Expect(err).ShouldNot(HaveOccurred()) + Expect(inFile).ToNot(BeNil()) + + // test types + types := inFile.Map("types") + fields := make([]string, 0) + for i := 0; i < types.Len(); i++ { + for j := 0; j < types.At(i).Len(); j++ { + field := types.At(i).At(j) + if jsongo.TypeArray == field.GetType() { + err := processMessageField(testCtx, &fields, field) + Expect(err).ShouldNot(HaveOccurred()) + Expect(fields[j-1]).To(BeEquivalentTo(expectedTypes[j-1])) + } + } + } +} + +func TestGenerateMessageFieldMessages(t *testing.T) { + // expected results according to acl.api.json in testdata + expectedTypes := []string{"\tMajor uint32", "\tMinor uint32", "\tACLIndex uint32", + "\tTag []byte `struc:\"[64]byte\"`", "\tACLIndex uint32", "\tRetval int32", "\tACLIndex uint32"} + RegisterTestingT(t) + // prepare context + testCtx := new(context) + testCtx.packageName = "test-package-name" + + // prepare input/output output files + inputData, err := readFile("testdata/acl.api.json") + Expect(err).ShouldNot(HaveOccurred()) + inFile, err := parseJSON(inputData) + Expect(err).ShouldNot(HaveOccurred()) + Expect(inFile).ToNot(BeNil()) + + // test types + messages := inFile.Map("messages") + customIndex := 0 + fields := make([]string, 0) + for i := 0; i < messages.Len(); i++ { + for j := 0; j < messages.At(i).Len(); j++ { + field := messages.At(i).At(j) + if jsongo.TypeArray == field.GetType() { + specificFieldName := field.At(1).Get().(string) + if specificFieldName == "crc" || specificFieldName == "_vl_msg_id" || + specificFieldName == "client_index" || specificFieldName == "context" { + continue + } + err := processMessageField(testCtx, &fields, field) + Expect(err).ShouldNot(HaveOccurred()) + Expect(fields[customIndex]).To(BeEquivalentTo(expectedTypes[customIndex])) + customIndex++ + } + } + } +} + +func TestGeneratePackageHeader(t *testing.T) { + RegisterTestingT(t) + // prepare context + testCtx := new(context) + testCtx.packageName = "test-package-name" + + // prepare input/output output files + inputData, err := readFile("testdata/acl.api.json") + Expect(err).ShouldNot(HaveOccurred()) + inFile, err := parseJSON(inputData) + Expect(err).ShouldNot(HaveOccurred()) + outDir := "test_output_directory" + outFile, err := os.Create(outDir) + Expect(err).ShouldNot(HaveOccurred()) + defer os.RemoveAll(outDir) + // prepare writer + writer := bufio.NewWriter(outFile) + Expect(writer.Buffered()).To(BeZero()) + generatePackageHeader(testCtx, writer, inFile) + Expect(writer.Buffered()).ToNot(BeZero()) +} + +func TestGenerateMessageCommentType(t *testing.T) { + RegisterTestingT(t) + // prepare context + testCtx := new(context) + testCtx.packageName = "test-package-name" + testCtx.inputBuff = bytes.NewBuffer([]byte("test content")) + + outDir := "test_output_directory" + outFile, err := os.Create(outDir) + Expect(err).ShouldNot(HaveOccurred()) + writer := bufio.NewWriter(outFile) + defer os.RemoveAll(outDir) + Expect(writer.Buffered()).To(BeZero()) + generateMessageComment(testCtx, writer, "test-struct", "msg-name", true) + Expect(writer.Buffered()).ToNot(BeZero()) +} + +func TestGenerateMessageCommentMessage(t *testing.T) { + RegisterTestingT(t) + // prepare context + testCtx := new(context) + testCtx.packageName = "test-package-name" + testCtx.inputBuff = bytes.NewBuffer([]byte("test content")) + + outDir := "test_output_directory" + outFile, err := os.Create(outDir) + Expect(err).ShouldNot(HaveOccurred()) + writer := bufio.NewWriter(outFile) + defer os.RemoveAll(outDir) + Expect(writer.Buffered()).To(BeZero()) + generateMessageComment(testCtx, writer, "test-struct", "msg-name", false) + Expect(writer.Buffered()).ToNot(BeZero()) +} + +func TestGenerateMessageNameGetter(t *testing.T) { + RegisterTestingT(t) + outDir := "test_output_directory" + outFile, err := os.Create(outDir) + Expect(err).ShouldNot(HaveOccurred()) + writer := bufio.NewWriter(outFile) + defer os.RemoveAll(outDir) + Expect(writer.Buffered()).To(BeZero()) + generateMessageNameGetter(writer, "test-struct", "msg-name") + Expect(writer.Buffered()).ToNot(BeZero()) +} + +func TestGenerateTypeNameGetter(t *testing.T) { + RegisterTestingT(t) + outDir := "test_output_directory" + outFile, err := os.Create(outDir) + Expect(err).ShouldNot(HaveOccurred()) + writer := bufio.NewWriter(outFile) + defer os.RemoveAll(outDir) + Expect(writer.Buffered()).To(BeZero()) + generateTypeNameGetter(writer, "test-struct", "msg-name") + Expect(writer.Buffered()).ToNot(BeZero()) +} + +func TestGenerateCrcGetter(t *testing.T) { + RegisterTestingT(t) + outDir := "test_output_directory" + outFile, err := os.Create(outDir) + Expect(err).ShouldNot(HaveOccurred()) + writer := bufio.NewWriter(outFile) + defer os.RemoveAll(outDir) + Expect(writer.Buffered()).To(BeZero()) + generateCrcGetter(writer, "test-struct", "msg-name") + Expect(writer.Buffered()).ToNot(BeZero()) +} + +func TestTranslateVppType(t *testing.T) { + RegisterTestingT(t) + context := new(context) + typesToTranslate := []string{"u8", "i8", "u16", "i16", "u32", "i32", "u64", "i64", "f64"} + expected := []string{"uint8", "int8", "uint16", "int16", "uint32", "int32", "uint64", "int64", "float64"} + translated := []string{} + for _, value := range typesToTranslate { + translated = append(translated, translateVppType(context, value, false)) + } + for index, value := range expected { + Expect(value).To(BeEquivalentTo(translated[index])) + } + +} + +func TestTranslateVppTypeArray(t *testing.T) { + RegisterTestingT(t) + context := new(context) + translated := translateVppType(context, "u8", true) + Expect(translated).To(BeEquivalentTo("byte")) +} + +func TestTranslateVppUnknownType(t *testing.T) { + defer func() { + if recovery := recover(); recovery != nil { + t.Logf("Recovered from panic: %v", recovery) + } + }() + context := new(context) + translateVppType(context, "?", false) +} + +func TestCamelCase(t *testing.T) { + RegisterTestingT(t) + // test camel case functionality + expected := "allYourBaseAreBelongToUs" + result := camelCaseName("all_your_base_are_belong_to_us") + Expect(expected).To(BeEquivalentTo(result)) + // test underscore + expected = "_" + result = camelCaseName(expected) + Expect(expected).To(BeEquivalentTo(result)) + // test all lower + expected = "lower" + result = camelCaseName(expected) + Expect(expected).To(BeEquivalentTo(result)) +} + +func TestCommonInitialisms(t *testing.T) { + RegisterTestingT(t) + + for key, value := range commonInitialisms { + Expect(value).ShouldNot(BeFalse()) + Expect(key).ShouldNot(BeEmpty()) + } +} diff --git a/cmd/binapi-generator/testdata/acl.api.json b/cmd/binapi-generator/testdata/acl.api.json new file mode 100644 index 0000000..91d3d2f --- /dev/null +++ b/cmd/binapi-generator/testdata/acl.api.json @@ -0,0 +1,67 @@ +{ + "types" : [ + ["acl_rule", + ["u8", "is_permit"], + ["u8", "is_ipv6"], + ["u8", "src_ip_addr", 16], + ["u8", "src_ip_prefix_len"], + ["u8", "dst_ip_addr", 16], + ["u8", "dst_ip_prefix_len"], + ["u8", "proto"], + ["u16", "srcport_or_icmptype_first"], + ["u16", "srcport_or_icmptype_last"], + ["u16", "dstport_or_icmpcode_first"], + ["u16", "dstport_or_icmpcode_last"], + ["u8", "tcp_flags_mask"], + ["u8", "tcp_flags_value"], + {"crc" : "0x2715e1c0"} + ], + ["macip_acl_rule", + ["u8", "is_permit"], + ["u8", "is_ipv6"], + ["u8", "src_mac", 6], + ["u8", "src_mac_mask", 6], + ["u8", "src_ip_addr", 16], + ["u8", "src_ip_prefix_len"], + {"crc" : "0x6723f13e"} + ] + ], + "messages" : [ + ["acl_plugin_get_version", + ["u16", "_vl_msg_id"], + ["u32", "client_index"], + ["u32", "context"], + {"crc" : "0xd7c07748"} + ], + ["acl_plugin_get_version_reply", + ["u16", "_vl_msg_id"], + ["u32", "context"], + ["u32", "major"], + ["u32", "minor"], + {"crc" : "0x43eb59a5"} + ], + ["acl_add_replace", + ["u16", "_vl_msg_id"], + ["u32", "client_index"], + ["u32", "context"], + ["u32", "acl_index"], + ["u8", "tag", 64], + {"crc" : "0x3c317936"} + ], + ["acl_add_replace_reply", + ["u16", "_vl_msg_id"], + ["u32", "context"], + ["u32", "acl_index"], + ["i32", "retval"], + {"crc" : "0xa5e6d0cf"} + ], + ["acl_del", + ["u16", "_vl_msg_id"], + ["u32", "client_index"], + ["u32", "context"], + ["u32", "acl_index"], + {"crc" : "0x82cc30ed"} + ] + ], +"vl_api_version" :"0x3cd02d84" +} diff --git a/cmd/binapi-generator/testdata/af_packet.api.json b/cmd/binapi-generator/testdata/af_packet.api.json new file mode 100644 index 0000000..211fc3e --- /dev/null +++ b/cmd/binapi-generator/testdata/af_packet.api.json @@ -0,0 +1,37 @@ +{ + "types" : [ + + ], + "messages" : [ + ["af_packet_create", + ["u16", "_vl_msg_id"], + ["u32", "client_index"], + ["u32", "context"], + ["u8", "host_if_name", 64], + ["u8", "hw_addr", 6], + ["u8", "use_random_hw_addr"], + {"crc" : "0x92768640"} + ], + ["af_packet_create_reply", + ["u16", "_vl_msg_id"], + ["u32", "context"], + ["i32", "retval"], + ["u32", "sw_if_index"], + {"crc" : "0x718bac92"} + ], + ["af_packet_delete", + ["u16", "_vl_msg_id"], + ["u32", "client_index"], + ["u32", "context"], + ["u8", "host_if_name", 64], + {"crc" : "0xc063ce85"} + ], + ["af_packet_delete_reply", + ["u16", "_vl_msg_id"], + ["u32", "context"], + ["i32", "retval"], + {"crc" : "0x1a80431a"} + ] + ], +"vl_api_version" :"0x4ca71f33" +} diff --git a/cmd/binapi-generator/testdata/input-generate-error.json b/cmd/binapi-generator/testdata/input-generate-error.json new file mode 100644 index 0000000..d5df76e --- /dev/null +++ b/cmd/binapi-generator/testdata/input-generate-error.json @@ -0,0 +1,3 @@ +{ + "key": "value" +} \ No newline at end of file diff --git a/cmd/binapi-generator/testdata/input-read-json-error.json b/cmd/binapi-generator/testdata/input-read-json-error.json new file mode 100644 index 0000000..02691e3 --- /dev/null +++ b/cmd/binapi-generator/testdata/input-read-json-error.json @@ -0,0 +1 @@ +% \ No newline at end of file diff --git a/cmd/binapi-generator/testdata/input.txt b/cmd/binapi-generator/testdata/input.txt new file mode 100644 index 0000000..e69de29 diff --git a/cmd/binapi-generator/testdata/ip.api.json b/cmd/binapi-generator/testdata/ip.api.json new file mode 100644 index 0000000..970ec4b --- /dev/null +++ b/cmd/binapi-generator/testdata/ip.api.json @@ -0,0 +1,292 @@ +{ + "types" : [ + ["fib_path", + ["u32", "sw_if_index"], + ["u32", "weight"], + ["u8", "is_local"], + ["u8", "is_drop"], + ["u8", "is_unreach"], + ["u8", "is_prohibit"], + ["u8", "afi"], + ["u8", "next_hop", 16], + {"crc" : "0x315b1889"} + ] + ], + "messages" : [ + ["ip_fib_dump", + ["u16", "_vl_msg_id"], + ["u32", "client_index"], + ["u32", "context"], + {"crc" : "0x5fe56ca3"} + ], + ["ip_fib_details", + ["u16", "_vl_msg_id"], + ["u32", "context"], + ["u32", "table_id"], + ["u8", "address_length"], + ["u8", "address", 4], + ["u32", "count"], + ["vl_api_fib_path_t", "path", 0, "count"], + {"crc" : "0xfd8c6584"} + ], + ["ip6_fib_dump", + ["u16", "_vl_msg_id"], + ["u32", "client_index"], + ["u32", "context"], + {"crc" : "0x25c89676"} + ], + ["ip6_fib_details", + ["u16", "_vl_msg_id"], + ["u32", "context"], + ["u32", "table_id"], + ["u8", "address_length"], + ["u8", "address", 16], + ["u32", "count"], + ["vl_api_fib_path_t", "path", 0, "count"], + {"crc" : "0xe0825cb5"} + ], + ["ip_neighbor_dump", + ["u16", "_vl_msg_id"], + ["u32", "client_index"], + ["u32", "context"], + ["u32", "sw_if_index"], + ["u8", "is_ipv6"], + {"crc" : "0x3289e160"} + ], + ["ip_neighbor_details", + ["u16", "_vl_msg_id"], + ["u32", "context"], + ["u8", "is_static"], + ["u8", "is_ipv6"], + ["u8", "mac_address", 6], + ["u8", "ip_address", 16], + {"crc" : "0x3a00e32a"} + ], + ["ip_neighbor_add_del", + ["u16", "_vl_msg_id"], + ["u32", "client_index"], + ["u32", "context"], + ["u32", "vrf_id"], + ["u32", "sw_if_index"], + ["u8", "is_add"], + ["u8", "is_ipv6"], + ["u8", "is_static"], + ["u8", "mac_address", 6], + ["u8", "dst_address", 16], + {"crc" : "0x66f2112c"} + ], + ["ip_neighbor_add_del_reply", + ["u16", "_vl_msg_id"], + ["u32", "context"], + ["i32", "retval"], + {"crc" : "0xe5b0f318"} + ], + ["set_ip_flow_hash", + ["u16", "_vl_msg_id"], + ["u32", "client_index"], + ["u32", "context"], + ["u32", "vrf_id"], + ["u8", "is_ipv6"], + ["u8", "src"], + ["u8", "dst"], + ["u8", "sport"], + ["u8", "dport"], + ["u8", "proto"], + ["u8", "reverse"], + {"crc" : "0x92ad3798"} + ], + ["set_ip_flow_hash_reply", + ["u16", "_vl_msg_id"], + ["u32", "context"], + ["i32", "retval"], + {"crc" : "0x35a9e5eb"} + ], + ["sw_interface_ip6nd_ra_config", + ["u16", "_vl_msg_id"], + ["u32", "client_index"], + ["u32", "context"], + ["u32", "sw_if_index"], + ["u8", "suppress"], + ["u8", "managed"], + ["u8", "other"], + ["u8", "ll_option"], + ["u8", "send_unicast"], + ["u8", "cease"], + ["u8", "is_no"], + ["u8", "default_router"], + ["u32", "max_interval"], + ["u32", "min_interval"], + ["u32", "lifetime"], + ["u32", "initial_count"], + ["u32", "initial_interval"], + {"crc" : "0xec4a29f6"} + ], + ["sw_interface_ip6nd_ra_config_reply", + ["u16", "_vl_msg_id"], + ["u32", "context"], + ["i32", "retval"], + {"crc" : "0x16e25c5b"} + ], + ["sw_interface_ip6nd_ra_prefix", + ["u16", "_vl_msg_id"], + ["u32", "client_index"], + ["u32", "context"], + ["u32", "sw_if_index"], + ["u8", "address", 16], + ["u8", "address_length"], + ["u8", "use_default"], + ["u8", "no_advertise"], + ["u8", "off_link"], + ["u8", "no_autoconfig"], + ["u8", "no_onlink"], + ["u8", "is_no"], + ["u32", "val_lifetime"], + ["u32", "pref_lifetime"], + {"crc" : "0x5db6555c"} + ], + ["sw_interface_ip6nd_ra_prefix_reply", + ["u16", "_vl_msg_id"], + ["u32", "context"], + ["i32", "retval"], + {"crc" : "0x8050adb3"} + ], + ["sw_interface_ip6_enable_disable", + ["u16", "_vl_msg_id"], + ["u32", "client_index"], + ["u32", "context"], + ["u32", "sw_if_index"], + ["u8", "enable"], + {"crc" : "0x4a4e5405"} + ], + ["sw_interface_ip6_enable_disable_reply", + ["u16", "_vl_msg_id"], + ["u32", "context"], + ["i32", "retval"], + {"crc" : "0xeb8b4a40"} + ], + ["sw_interface_ip6_set_link_local_address", + ["u16", "_vl_msg_id"], + ["u32", "client_index"], + ["u32", "context"], + ["u32", "sw_if_index"], + ["u8", "address", 16], + {"crc" : "0x3db6d52b"} + ], + ["sw_interface_ip6_set_link_local_address_reply", + ["u16", "_vl_msg_id"], + ["u32", "context"], + ["i32", "retval"], + {"crc" : "0x0a781e17"} + ], + ["ip_add_del_route", + ["u16", "_vl_msg_id"], + ["u32", "client_index"], + ["u32", "context"], + ["u32", "next_hop_sw_if_index"], + ["u32", "table_id"], + ["u32", "classify_table_index"], + ["u32", "next_hop_table_id"], + ["u8", "create_vrf_if_needed"], + ["u8", "is_add"], + ["u8", "is_drop"], + ["u8", "is_unreach"], + ["u8", "is_prohibit"], + ["u8", "is_ipv6"], + ["u8", "is_local"], + ["u8", "is_classify"], + ["u8", "is_multipath"], + ["u8", "is_resolve_host"], + ["u8", "is_resolve_attached"], + ["u8", "not_last"], + ["u8", "next_hop_weight"], + ["u8", "dst_address_length"], + ["u8", "dst_address", 16], + ["u8", "next_hop_address", 16], + ["u8", "next_hop_n_out_labels"], + ["u32", "next_hop_via_label"], + ["u32", "next_hop_out_label_stack", 0, "next_hop_n_out_labels"], + {"crc" : "0xa0ab24bf"} + ], + ["ip_add_del_route_reply", + ["u16", "_vl_msg_id"], + ["u32", "context"], + ["i32", "retval"], + {"crc" : "0xea57492b"} + ], + ["ip_mroute_add_del", + ["u16", "_vl_msg_id"], + ["u32", "client_index"], + ["u32", "context"], + ["u32", "next_hop_sw_if_index"], + ["u32", "table_id"], + ["u32", "entry_flags"], + ["u32", "itf_flags"], + ["u16", "grp_address_length"], + ["u8", "create_vrf_if_needed"], + ["u8", "is_add"], + ["u8", "is_ipv6"], + ["u8", "is_local"], + ["u8", "grp_address", 16], + ["u8", "src_address", 16], + {"crc" : "0x8312830f"} + ], + ["ip_mroute_add_del_reply", + ["u16", "_vl_msg_id"], + ["u32", "context"], + ["i32", "retval"], + {"crc" : "0x8cabe02c"} + ], + ["ip_address_details", + ["u16", "_vl_msg_id"], + ["u32", "client_index"], + ["u32", "context"], + ["u8", "ip", 16], + ["u8", "prefix_length"], + ["u32", "sw_if_index"], + ["u8", "is_ipv6"], + {"crc" : "0x190d4266"} + ], + ["ip_address_dump", + ["u16", "_vl_msg_id"], + ["u32", "client_index"], + ["u32", "context"], + ["u32", "sw_if_index"], + ["u8", "is_ipv6"], + {"crc" : "0x632e859a"} + ], + ["ip_details", + ["u16", "_vl_msg_id"], + ["u32", "sw_if_index"], + ["u32", "context"], + ["u8", "is_ipv6"], + {"crc" : "0x695c8227"} + ], + ["ip_dump", + ["u16", "_vl_msg_id"], + ["u32", "client_index"], + ["u32", "context"], + ["u8", "is_ipv6"], + {"crc" : "0x3c1e33e0"} + ], + ["mfib_signal_dump", + ["u16", "_vl_msg_id"], + ["u32", "client_index"], + ["u32", "context"], + {"crc" : "0xbbbbd40d"} + ], + ["mfib_signal_details", + ["u16", "_vl_msg_id"], + ["u32", "client_index"], + ["u32", "context"], + ["u32", "sw_if_index"], + ["u32", "table_id"], + ["u16", "grp_address_len"], + ["u8", "grp_address", 16], + ["u8", "src_address", 16], + ["u16", "ip_packet_len"], + ["u8", "ip_packet_data", 256], + {"crc" : "0x6ba92c72"} + ] + ], +"vl_api_version" :"0x6a819870" +} -- cgit 1.2.3-korg