From 8eb0acf79c6918a4d8e446c662e5f56a982246b0 Mon Sep 17 00:00:00 2001 From: Joseph Henry Date: Tue, 30 Aug 2016 16:54:06 -0700 Subject: [PATCH] updated makefiles --- make-liblwip.mk | 4 +- make-linux.mk | 121 +++++++++++++++++++++++++++++++---------------- make-mac.mk | 122 +++++++++++++++++++++++++++++++++--------------- 3 files changed, 166 insertions(+), 81 deletions(-) diff --git a/make-liblwip.mk b/make-liblwip.mk index 35685a1..c307952 100644 --- a/make-liblwip.mk +++ b/make-liblwip.mk @@ -104,8 +104,8 @@ depend dep: .depend include .depend $(LWIPLIB): $(LWIPOBJS) - mkdir -p build/lwip - $(CC) -g -nostartfiles -shared -o build/lwip/$@ $^ + mkdir -p build + $(CC) -g -nostartfiles -shared -o build/$@ $^ .depend: $(LWIPFILES) $(CCDEP) $(CFLAGS) -MM $^ > .depend || rm -f .depend diff --git a/make-linux.mk b/make-linux.mk index 0b64c59..b2129ae 100644 --- a/make-linux.mk +++ b/make-linux.mk @@ -63,11 +63,73 @@ ifeq ($(SDK_DEBUG_LOG_TO_FILE),1) DEFS+=-DSDK_DEBUG_LOG_TO_FILE endif + +# Target output filenames +SHARED_LIB_NAME = libztlinux.so +INTERCEPT_NAME = libztintercept.so +SDK_SERVICE_NAME = zerotier-sdk-service +ONE_SERVICE_NAME = zerotier-one +ONE_CLI_NAME = zerotier-cli +ONE_ID_TOOL_NAME = zerotier-idtool +LWIP_LIB_NAME = liblwip.so +# +SHARED_LIB = $(BUILD)/$(SHARED_LIB_NAME) +INTERCEPT = $(BUILD)/$(INTERCEPT_NAME) +SDK_SERVICE = $(BUILD)/$(SDK_SERVICE_NAME) +ONE_SERVICE = $(BUILD)/$(ONE_SERVICE_NAME) +ONE_CLI = $(BUILD)/$(ONE_CLI_NAME) +ONE_IDTOOL = $(BUILD)/$(ONE_IDTOOL_NAME) +LWIP_LIB = $(BUILD)/$(LWIP_LIB_NAME) + all: remove_only_intermediates linux_shared_lib check remove_only_intermediates: -find . -type f \( -name '*.o' -o -name '*.so' \) -delete + + + +# --- EXTERNAL LIBRARIES --- +lwip: + make -f make-liblwip.mk $(LWIP_FLAGS) + + + + +# --------- LINUX ---------- +# Build everything +linux: one linux_service_and_intercept linux_shared_lib + +# Build vanilla ZeroTier One binary +one: $(OBJS) $(ZT1)/service/OneService.o $(ZT1)/one.o $(ZT1)/osdep/LinuxEthernetTap.o + mkdir -p $(BUILD) + $(CXX) $(CXXFLAGS) $(LDFLAGS) -o $(BUILD)/zerotier-one $(OBJS) $(ZT1)/service/OneService.o $(ZT1)/one.o $(ZT1)/osdep/LinuxEthernetTap.o $(LDLIBS) + $(STRIP) $(ONE_SERVICE) + cp $(ONE_SERVICE) $(INT)/docker/docker_demo/$(ONE_SERVICE_NAME) + +# Build only the intercept library +linux_intercept: + # Use gcc not clang to build standalone intercept library since gcc is typically used for libc and we want to ensure maximal ABI compatibility + cd src ; gcc $(DEFS) -O2 -Wall -std=c99 -fPIC -DVERBOSE -D_GNU_SOURCE -DSDK_INTERCEPT -I. -I../$(ZT1)/node -nostdlib -shared -o ../$(INTERCEPT) SDK_Sockets.c SDK_Intercept.c SDK_Debug.c SDK_RPC.c -ldl + +# Build only the SDK service +linux_sdk_service: lwip $(OBJS) + mkdir -p $(BUILD)/linux_intercept + $(CXX) $(CXXFLAGS) $(LDFLAGS) $(DEFS) -DSDK -DZT_ONE_NO_ROOT_CHECK -Iext/lwip/src/include -Iext/lwip/src/include/ipv4 -Iext/lwip/src/include/ipv6 -I$(ZT1)/osdep -I$(ZT1)/node -Isrc -o $(SDK_SERVICE) $(OBJS) $(ZT1)/service/OneService.cpp src/SDK_EthernetTap.cpp src/SDK_Proxy.cpp $(ZT1)/one.cpp -x c src/SDK_RPC.c $(LDLIBS) -ldl + ln -sf $(SDK_SERVICE_NAME) $(BUILD)/zerotier-cli + ln -sf $(SDK_SERVICE_NAME) $(BUILD)/zerotier-idtool + +# Build both intercept library and SDK service (separate) +linux_service_and_intercept: linux_intercept linux_sdk_service + +# Builds a single shared library which contains everything +linux_shared_lib: $(OBJS) + $(CXX) $(CXXFLAGS) $(LDFLAGS) -DSDK -DZT_ONE_NO_ROOT_CHECK -Iext/lwip/src/include -Iext/lwip/src/include/ipv4 -Iext/lwip/src/include/ipv6 -Izerotierone/osdep -Izerotierone/node -Izerotierone/service -Isrc -shared -o $(SHARED_LIB) $(OBJS) zerotierone/service/OneService.cpp src/SDK_Service.cpp src/SDK_EthernetTap.cpp src/SDK_Proxy.cpp zerotierone/one.cpp -x c src/SDK_Sockets.c src/SDK_Intercept.c src/SDK_Debug.c src/SDK_RPC.c $(LDLIBS) -ldl + + + + +# -------- ANDROID --------- # TODO: CHECK if ANDROID/GRADLE TOOLS are installed # Build library for Android Unity integrations # Build JNI library for Android app integration @@ -77,44 +139,18 @@ android_jni_lib: cp docs/android_zt_sdk.md $(BUILD)/android_jni_lib/README.md mv -f $(INT)/android/android_jni_lib/java/libs/* $(BUILD)/android_jni_lib cp -R $(BUILD)/android_jni_lib/* $(INT)/android/example_app/app/src/main/jniLibs - -lwip: - make -f make-liblwip.mk $(LWIP_FLAGS) - -# Builds libztlinux.so (full bundle) -linux_shared_lib: - -linux_intercept: - # Use gcc not clang to build standalone intercept library since gcc is typically used for libc and we want to ensure maximal ABI compatibility - cd src ; gcc $(DEFS) -O2 -Wall -std=c99 -fPIC -DVERBOSE -D_GNU_SOURCE -DSDK_INTERCEPT -I. -I../$(ZT1)/node -nostdlib -shared -o ../$(BUILD)/libztintercept.so SDK_Sockets.c SDK_Intercept.c SDK_Debug.c SDK_RPC.c -ldl - -# Build a dynamically-loadable library -linux_service_and_intercept: lwip linux_intercept $(OBJS) - mkdir -p $(BUILD)/linux_intercept - $(CXX) $(CXXFLAGS) $(LDFLAGS) $(DEFS) -DSDK -DZT_ONE_NO_ROOT_CHECK -Iext/lwip/src/include -Iext/lwip/src/include/ipv4 -Iext/lwip/src/include/ipv6 -I$(ZT1)/osdep -I$(ZT1)/node -Isrc -o $(BUILD)/zerotier-sdk-service $(OBJS) $(ZT1)/service/OneService.cpp src/SDK_EthernetTap.cpp src/SDK_Proxy.cpp $(ZT1)/one.cpp -x c src/SDK_RPC.c $(LDLIBS) -ldl - # Build liblwip.so which must be placed in ZT home for zerotier-netcon-service to work - ln -sf zerotier-sdk-service $(BUILD)/zerotier-cli - ln -sf zerotier-sdk-service $(BUILD)/zerotier-idtool - -# Build vanilla ZeroTier One binary -one: $(OBJS) $(ZT1)/service/OneService.o $(ZT1)/one.o $(ZT1)/osdep/LinuxEthernetTap.o - mkdir -p $(BUILD) - $(CXX) $(CXXFLAGS) $(LDFLAGS) -o $(BUILD)/zerotier-one $(OBJS) $(ZT1)/service/OneService.o $(ZT1)/one.o $(ZT1)/osdep/LinuxEthernetTap.o $(LDLIBS) - $(STRIP) $(BUILD)/zerotier-one - cp $(BUILD)/zerotier-one $(INT)/docker/docker_demo/zerotier-one + + +# -------- TESTING --------- # Build the docker demo images docker_demo: one linux_shared_lib mkdir -p $(BUILD) - # Intercept library - cp $(BUILD)/linux_shared_lib/libztintercept.so $(INT)/docker/docker_demo/libztintercept.so - # SDK service - cp $(BUILD)/zerotier-sdk-service $(INT)/docker/docker_demo/zerotier-sdk-service - # lwIP network stack library - cp $(BUILD)/lwip/liblwip.so $(INT)/docker/docker_demo/liblwip.so - # CLI interface for ZeroTier - cp $(BUILD)/zerotier-cli $(INT)/docker/docker_demo/zerotier-cli + cp $(INTERCEPT) $(INT)/docker/docker_demo/$(INTERCEPT_NAME) + cp $(SERVICE) $(INT)/docker/docker_demo/$(SERVICE_NAME) + cp $(LWIP_LIB) $(INT)/docker/docker_demo/$(LWIP_LIB_NAME) + cp $(ONE_CLI) $(INT)/docker/docker_demo/$(ONE_CLI_NAME) touch $(INT)/docker/docker_demo/docker_demo.name # Server image # This image will contain the server application and everything required to @@ -139,8 +175,11 @@ docker_check_test: # Check for the presence of built frameworks/bundles/libaries check: - ./check.sh $(BUILD)/lwip/liblwip.so - ./check.sh $(BUILD)/linux_shared_lib/libztintercept.so + ./check.sh $(LWIP_LIB) + ./check.sh $(INTERCEPT) + ./check.sh $(ONE_SERVICE) + ./check.sh $(SDK_SERVICE) + ./check.sh $(SHARED_LIB) ./check.sh $(BUILD)/android_jni_lib/arm64-v8a/libZeroTierOneJNI.so ./check.sh $(BUILD)/android_jni_lib/armeabi/libZeroTierOneJNI.so ./check.sh $(BUILD)/android_jni_lib/armeabi-v7a/libZeroTierOneJNI.so @@ -160,9 +199,6 @@ $(BUILD)/tests/$(OSTYPE).%.out: tests/api_test/%.c $(TEST_OBJDIR): mkdir -p $(TEST_OBJDIR) -tests: $(TEST_OBJDIR) $(TEST_TARGETS) - mkdir -p $(BUILD)/tests; - tests: $(TEST_OBJDIR) $(TEST_TARGETS) linux_service_and_intercept mkdir -p $(BUILD)/tests; mkdir -p build/tests/zerotier @@ -170,11 +206,14 @@ tests: $(TEST_OBJDIR) $(TEST_TARGETS) linux_service_and_intercept cp tests/api_test/servers.sh $(BUILD)/tests/servers.sh cp tests/api_test/clients.sh $(BUILD)/tests/clients.sh cp tests/cleanup.sh $(BUILD)/tests/cleanup.sh - cp $(BUILD)/lwip/liblwip.so $(BUILD)/tests/zerotier/liblwip.so + cp $(LWIP_LIB) $(BUILD)/tests/zerotier/liblwip.so + + +# ----- ADMINISTRATIVE ----- clean_android: # android JNI lib project - test -s /usr/bin/javac || { echo "Javac not found"; exit 1; } + -test -s /usr/bin/javac || { echo "Javac not found"; exit 1; } -cd $(INT)/android/android_jni_lib/proj; ./gradlew clean -rm -rf $(INT)/android/android_jni_lib/proj/build # example android app project @@ -184,7 +223,7 @@ clean_basic: -rm -rf $(BUILD)/* -rm -rf $(INT)/Unity3D/Assets/Plugins/* -rm -rf zerotier-cli zerotier-idtool - -find . -type f \( -name 'zerotier-one' -o -name 'zerotier-sdk-service' \) -delete + -find . -type f \( -name $(ONE_SERVICE_NAME) -o -name $(SDK_SERVICE_NAME) \) -delete -find . -type f \( -name '*.o' -o -name '*.so' -o -name '*.o.d' -o -name '*.out' -o -name '*.log' -o -name '*.dSYM' \) -delete clean: clean_basic clean_android diff --git a/make-mac.mk b/make-mac.mk index 6997ba9..3ddfc33 100644 --- a/make-mac.mk +++ b/make-mac.mk @@ -49,14 +49,47 @@ endif CXXFLAGS=$(CFLAGS) -fno-rtti -# Build everything -all: osx ios android lwip check +# Target output filenames +SHARED_LIB_NAME = libztosx.so +INTERCEPT_NAME = libztintercept.so +SDK_SERVICE_NAME = zerotier-sdk-service +ONE_SERVICE_NAME = zerotier-one +ONE_CLI_NAME = zerotier-cli +ONE_ID_TOOL_NAME = zerotier-idtool +LWIP_LIB_NAME = liblwip.so +# +SHARED_LIB = $(BUILD)/$(SHARED_LIB_NAME) +INTERCEPT = $(BUILD)/$(INTERCEPT_NAME) +SDK_SERVICE = $(BUILD)/$(SDK_SERVICE_NAME) +ONE_SERVICE = $(BUILD)/$(ONE_SERVICE_NAME) +ONE_CLI = $(BUILD)/$(ONE_CLI_NAME) +ONE_IDTOOL = $(BUILD)/$(ONE_IDTOOL_NAME) +LWIP_LIB = $(BUILD)/$(LWIP_LIB_NAME) + + +# Build everything +all: one osx ios android lwip check + + + + +# --- EXTERNAL LIBRARIES --- lwip: make -f make-liblwip.mk + + +# ------- IOS / OSX -------- # Build all Apple targets -apple: osx ios +apple: one osx ios + +# Build vanilla ZeroTier One binary +one: $(OBJS) $(ZT1)/service/OneService.o $(ZT1)/one.o $(ZT1)/osdep/OSXEthernetTap.o + mkdir -p $(BUILD) + $(CXX) $(CXXFLAGS) $(LDFLAGS) -o $(BUILD)/zerotier-one $(OBJS) $(ZT1)/service/OneService.o $(ZT1)/one.o $(ZT1)/osdep/OSXEthernetTap.o $(LDLIBS) + $(STRIP) $(ONE_SERVICE) + cp $(ONE_SERVICE) $(INT)/docker/docker_demo/$(ONE_SERVICE_NAME) # Build all iOS targets ios: ios_app_framework ios_unity3d_bundle @@ -64,10 +97,6 @@ ios: ios_app_framework ios_unity3d_bundle # Build all OSX targets osx: osx_app_framework osx_unity3d_bundle osx_shared_lib osx_service_and_intercept -# Build all Android targets -# Chip architectures can be specified in integrations/android/android_jni_lib/java/jni/Application.mk -android: android_jni_lib - # TODO: CHECK if XCODE TOOLS are installed # Build frameworks for application development osx_app_framework: @@ -91,6 +120,40 @@ ios_unity3d_bundle: cd $(INT)/apple/ZeroTierSDK_Apple; xcodebuild -configuration Release -scheme ZeroTierSDK_Unity3D_iOS build SYMROOT="../../../$(BUILD)/ios_unity3d_bundle" cd $(INT)/apple/ZeroTierSDK_Apple; xcodebuild -configuration Debug -scheme ZeroTierSDK_Unity3D_iOS build SYMROOT="../../../$(BUILD)/ios_unity3d_bundle" cp docs/ios_unity3d_zt_sdk.md $(BUILD)/ios_unity3d_bundle/README.md +# +simple_app: tests osx_service_and_intercept + mkdir -p build/simple_app + mkdir -p build/tests/zerotier + $(CXX) -Isrc $(SHARED_LIB) integrations/simple_app/app.cpp -o $(BUILD)/simple_app/app + cp $(LWIP_LIB) $(BUILD)/tests/zerotier/$(LWIP_LIB_NAME) + +remove_only_intermediates: + -find . -type f \( -name '*.o' -o -name '*.so' \) -delete + +# Builds a single shared library which contains everything +osx_shared_lib: remove_only_intermediates $(OBJS) + $(CXX) $(CXXFLAGS) $(LDFLAGS) -DSDK -DZT_ONE_NO_ROOT_CHECK -Iext/lwip/src/include -Iext/lwip/src/include/ipv4 -Iext/lwip/src/include/ipv6 -Izerotierone/osdep -Izerotierone/node -Izerotierone/service -Isrc -shared -o $(SHARED_LIB) $(OBJS) zerotierone/service/OneService.cpp src/SDK_Service.cpp src/SDK_EthernetTap.cpp src/SDK_Proxy.cpp zerotierone/one.cpp -x c src/SDK_Sockets.c src/SDK_Intercept.c src/SDK_Debug.c src/SDK_RPC.c $(LDLIBS) -ldl + +osx_intercept: + # Use gcc not clang to build standalone intercept library since gcc is typically used for libc and we want to ensure maximal ABI compatibility + cd src ; gcc $(DEFS) -O2 -Wall -std=c99 -fPIC -fno-common -dynamiclib -flat_namespace -DVERBOSE -D_GNU_SOURCE -DNETCON_INTERCEPT -I. -I../zerotierone/node -nostdlib -shared -o ../$(INTERCEPT) SDK_Sockets.c SDK_Intercept.c SDK_Debug.c SDK_RPC.c -ldl + #mv src/$(INTERCEPT_NAME) $(INTERCEPT) + +# Build only the SDK service +osx_sdk_service: lwip $(OBJS) + $(CXX) $(CXXFLAGS) $(LDFLAGS) -DSDK -DZT_ONE_NO_ROOT_CHECK -Iext/lwip/src/include -Iext/lwip/src/include/ipv4 -Iext/lwip/src/include/ipv6 -Izerotierone/osdep -Izerotierone/node -Isrc -o $(BUILD)/zerotier-sdk-service $(OBJS) zerotierone/service/OneService.cpp src/SDK_EthernetTap.cpp src/SDK_Proxy.cpp zerotierone/one.cpp -x c src/SDK_RPC.c $(LDLIBS) -ldl + ln -sf $(SDK_SERVICE_NAME) zerotier-cli + ln -sf $(SDK_SERVICE_NAME) zerotier-idtool + +# Build both intercept library and SDK service (separate) +osx_service_and_intercept: remove_only_intermediates osx_intercept osx_sdk_service $(OBJS) + + + +# -------- ANDROID --------- +# Build all Android targets +# Chip architectures can be specified in integrations/android/android_jni_lib/java/jni/Application.mk +android: android_jni_lib # TODO: CHECK if ANDROID/GRADLE TOOLS are installed # Build library for Android Unity integrations @@ -103,38 +166,17 @@ android_jni_lib: mv -f $(INT)/android/android_jni_lib/java/libs/* $(BUILD)/android_jni_lib cp -R $(BUILD)/android_jni_lib/* $(INT)/android/example_app/app/src/main/jniLibs -# -simple_app: tests osx_service_and_intercept - mkdir -p build/simple_app - mkdir -p build/tests/zerotier - $(CXX) -Isrc $(BUILD)/libztosx.so integrations/simple_app/app.cpp -o $(BUILD)/simple_app/app - cp $(BUILD)/lwip/liblwip.so $(BUILD)/tests/zerotier/liblwip.so -remove_only_intermediates: - -find . -type f \( -name '*.o' -o -name '*.so' \) -delete -osx_shared_lib: remove_only_intermediates $(OBJS) - $(CXX) $(CXXFLAGS) $(LDFLAGS) -DSDK -DZT_ONE_NO_ROOT_CHECK -Iext/lwip/src/include -Iext/lwip/src/include/ipv4 -Iext/lwip/src/include/ipv6 -Izerotierone/osdep -Izerotierone/node -Izerotierone/service -Isrc -shared -o $(BUILD)/libztosx.so $(OBJS) zerotierone/service/OneService.cpp src/SDK_Service.cpp src/SDK_EthernetTap.cpp src/SDK_Proxy.cpp zerotierone/one.cpp -x c src/SDK_Sockets.c src/SDK_Intercept.c src/SDK_Debug.c src/SDK_RPC.c $(LDLIBS) -ldl - -osx_service_and_intercept: remove_only_intermediates $(OBJS) - # Need to selectively rebuild one.cpp and OneService.cpp with ZT_SERVICE_NETCON and ZT_ONE_NO_ROOT_CHECK defined, and also NetconEthernetTap - $(CXX) $(CXXFLAGS) $(LDFLAGS) -DSDK -DZT_ONE_NO_ROOT_CHECK -Iext/lwip/src/include -Iext/lwip/src/include/ipv4 -Iext/lwip/src/include/ipv6 -Izerotierone/osdep -Izerotierone/node -Isrc -o $(BUILD)/zerotier-sdk-service $(OBJS) zerotierone/service/OneService.cpp src/SDK_EthernetTap.cpp src/SDK_Proxy.cpp zerotierone/one.cpp -x c src/SDK_RPC.c $(LDLIBS) -ldl - # Build liblwip.so which must be placed in ZT home for zerotier-sdk-service to work - make -f make-liblwip.mk - # Use gcc not clang to build standalone intercept library since gcc is typically used for libc and we want to ensure maximal ABI compatibility - cd src ; gcc $(DEFS) -O2 -Wall -std=c99 -fPIC -fno-common -dynamiclib -flat_namespace -DVERBOSE -D_GNU_SOURCE -DNETCON_INTERCEPT -I. -I../zerotierone/node -nostdlib -shared -o libztintercept.so SDK_Sockets.c SDK_Intercept.c SDK_Debug.c SDK_RPC.c -ldl - mv src/libztintercept.so $(BUILD)/libztintercept.so - ln -sf zerotier-sdk-service zerotier-cli - ln -sf zerotier-sdk-service zerotier-idtool - -prep: - cp $(INT)/android/android_jni_lib/java/libs/* build +# -------- TESTING --------- # Check for the presence of built frameworks/bundles/libaries check: - ./check.sh $(BUILD)/lwip/liblwip.so - ./check.sh $(BUILD)/libztintercept.so - ./check.sh $(BUILD)/libztosx.so + ./check.sh $(LWIP_LIB) + ./check.sh $(INTERCEPT) + ./check.sh $(ONE_SERVICE) + ./check.sh $(SDK_SERVICE) + ./check.sh $(SHARED_LIB) ./check.sh $(BUILD)/osx_unity3d_bundle/Debug/ZeroTierSDK_Unity3D_OSX.bundle ./check.sh $(BUILD)/osx_app_framework/Debug/ZeroTierSDK_OSX.framework ./check.sh $(BUILD)/ios_app_framework/Debug-iphoneos/ZeroTierSDK_iOS.framework @@ -165,15 +207,18 @@ tests: $(TEST_OBJDIR) $(TEST_TARGETS) osx_service_and_intercept cp tests/api_test/servers.sh $(BUILD)/tests/servers.sh cp tests/api_test/clients.sh $(BUILD)/tests/clients.sh cp tests/cleanup.sh $(BUILD)/tests/cleanup.sh - cp $(BUILD)/lwip/liblwip.so $(BUILD)/tests/zerotier/liblwip.so + cp $(LWIP_LIB) $(BUILD)/tests/zerotier/$(LWIP_LIB_NAME) + + +# ----- ADMINISTRATIVE ----- JAVAC := $(shell which javac) clean_unity: clean_android: # android JNI lib project - test -s /usr/bin/javac || { echo "Javac not found"; exit 1; } + -test -s /usr/bin/javac || { echo "Javac not found"; exit 1; } -cd $(INT)/android/android_jni_lib/proj; ./gradlew clean -rm -rf $(INT)/android/android_jni_lib/proj/build # example android app project @@ -183,7 +228,7 @@ clean_basic: -rm -rf $(BUILD)/* -rm -rf $(INT)/Unity3D/Assets/Plugins/* -rm -rf zerotier-cli zerotier-idtool - -find . -type f \( -name 'zerotier-one' -o -name 'zerotier-sdk-service' \) -delete + -find . -type f \( -name $(ONE_SERVICE_NAME) -o -name $(SDK_SERVICE_NAME) \) -delete -find . -type f \( -name '*.o' -o -name '*.so' -o -name '*.o.d' -o -name '*.out' -o -name '*.log' -o -name '*.dSYM' \) -delete clean: clean_basic clean_android @@ -191,7 +236,8 @@ clean: clean_basic clean_android clean_for_production: -find . -type f \( -name '*.identity'\) -delete -## --- BELOW ARE DEVELOPMENT AIDS --- +prep: + cp $(INT)/android/android_jni_lib/java/libs/* build # Copy and rename source files into example projects to follow local ordinances update_examples: