add top level Makefile and build samples

Signed-off-by: Jakub Kicinski <kuba@kernel.org>

Author: kuba-moo

.gitignore

@@ -1 +1,3 @@
-*.a
+*.a
+*.o
+lib/__pycache__/

Makefile

@@ -0,0 +1,26 @@
+# SPDX-License-Identifier: GPL-2.0
+
+all: generated lib samples
+
+lib:
+	$(MAKE) -C $@
+
+generated:
+	$(MAKE) -C $@
+
+samples:
+	$(MAKE) -C $@
+
+libynl.a: ynl.o generated
+	@echo -e "\tAR $@"
+	@ar rcs $@ ynl.o $(GENERATED)
+
+clean:
+	rm -f *.o *.d *~
+	$(MAKE) -C generated $@
+
+distclean: clean
+	rm -f *.a
+
+.PHONY: all clean generated lib samples
+.DEFAULT_GOAL=all

README.rst

@@ -5,7 +5,16 @@ YNL CPP is a best effort port of YNL C. Like YNL C is only supports
 static linking (because structs are auto-generated and may change
 version to version).
 
-The best way of using it in your project is probably git submodule.
+The best way of using it in your project is probably git submodule,
+or possibly just copying in the right source files (YNL code is BSD
+licensed).
+
+Dependencies
+------------
+
+This repo uses a Python code generator to turn the Netlink specs in YAML
+into C++ classes. Python support for YAML and JSON Schema are required.
+(``python3-jsonschema python3-yaml`` packages on Fedora).
 
 Building ynl-cpp
 ----------------
@@ -14,10 +23,16 @@ The repo supports building code for a specific family::
 
   make -C generated/ netdev_lib.a
 
-or a big archive with code for all families::
+or a big archive with code for all families (``libynl.a``)::
 
   make -C generated/
 
+Building samples
+----------------
+
+Running ``make`` in the main directory will build a couple of simple
+sample apps under the ``samples/`` directory.
+
 Updating to latest kernel versions
 ----------------------------------
 

samples/.gitignore

@@ -0,0 +1,2 @@
+ethtool
+netdev

samples/Makefile

@@ -0,0 +1,30 @@
+# SPDX-License-Identifier: GPL-2.0
+
+include ../Makefile.deps
+
+LDLIBS=../lib/ynl.a ../lib/ynl-cpp.a
+
+CPPFLAGS += -O2 -W -Wall -Wextra -Wno-unused-parameter -Wshadow \
+	-I../lib/ -I../generated/ -idirafter $(UAPI_PATH)
+
+SRCS=$(wildcard *.cpp)
+BINS=$(patsubst %.cpp,%,${SRCS})
+PROTOS=$(wildcard ../generated/*.a)
+
+include $(wildcard *.d)
+
+all: $(BINS)
+
+$(BINS): ../lib/ynl.a $(PROTOS) $(SRCS)
+	@echo -e '\tCXX sample $@  '
+	@$(COMPILE.cpp) $(CPPFLAGS_$@) $@.cpp -o $@.o
+	@$(LINK.cpp) $@.o -o $@ ../generated/$(patsubst %,%_lib.a,$@) $(LDLIBS)
+
+clean:
+	rm -f *.o *.d *~
+
+distclean: clean
+	rm -f $(BINS)
+
+.PHONY: all clean distclean
+.DEFAULT_GOAL=all