Merge pull request #609 from trapexit/make

cleanup and rework build system
2024-11-25 09:41:43 +08:00 · 2019-05-03 18:49:45 -04:00 · 2019-05-03 18:49:45 -04:00 · 4293cb7253
commit 4293cb7253
parent 85e2a3e71b 825fcf7f35
7 changed files with 132 additions and 130 deletions
--- a/.travis.yml
+++ b/.travis.yml
@ -18,7 +18,17 @@ matrix:
      dist: trusty
      compiler: clang
      sudo: required
+    - os: linux
+      dist: xenial
+      compiler: gcc
+      sudo: required
+    - os: linux
+      dist: xenial
+      compiler: clang
+      sudo: required

 script:
+  - sudo -E apt-get install fakeroot
  - sudo -E make install-build-pkgs
  - make
+  - make deb
--- a/98
+++ b/98
@ -39,8 +39,6 @@ endif
 USE_XATTR = 1

 FUSE_CFLAGS = -D_FILE_OFFSET_BITS=64 -Ilibfuse/include
-FUSE_LIBS   = libfuse/obj/libfuse.a
-FUSE_TARGET = $(FUSE_LIBS)

 ifeq ($(DEBUG),1)
 DEBUG_FLAGS := -g
@ -64,11 +62,11 @@ UGID_USE_RWLOCK = 0

 OPTS 	    = -O2
 SRC	    = $(wildcard src/*.cpp)
-OBJ         = $(SRC:src/%.cpp=obj/%.o)
-DEPS        = $(OBJ:obj/%.o=obj/%.d)
-TARGET      = mergerfs
-MANPAGE     = $(TARGET).1
-CXXFLAGS    = $(OPTS) \
+OBJS        = $(SRC:src/%.cpp=build/%.o)
+DEPS        = $(SRC:src/%.cpp=build/%.d)
+MANPAGE     = mergerfs.1
+CXXFLAGS   += \
+	      $(OPTS) \
              $(DEBUG_FLAGS) \
              $(STATIC_FLAGS) \
              $(LTO_FLAGS) \
@ -79,6 +77,9 @@ CXXFLAGS    = $(OPTS) \
              -MMD \
 	      -DUSE_XATTR=$(USE_XATTR) \
 	      -DUGID_USE_RWLOCK=$(UGID_USE_RWLOCK)
+LDFLAGS    += \
+	      -pthread \
+              -lrt

 PREFIX        = /usr/local
 EXEC_PREFIX   = $(PREFIX)
@ -93,77 +94,79 @@ INSTALLBINDIR  = $(DESTDIR)$(BINDIR)
 INSTALLSBINDIR = $(DESTDIR)$(SBINDIR)
 INSTALLMAN1DIR = $(DESTDIR)$(MAN1DIR)

-all: $(TARGET)
+.PHONY: all
+all: mergerfs

+.PHONY: help
 help:
 	@echo "usage: make\n"
 	@echo "make USE_XATTR=0      - build program without xattrs functionality"
 	@echo "make STATIC=1         - build static binary"
 	@echo "make LTO=1            - build with link time optimization"

-$(TARGET): version obj/obj-stamp $(FUSE_TARGET) $(OBJ)
-	$(CXX) $(CXXFLAGS) $(CPPFLAGS) $(LDFLAGS) $(OBJ) -o $@ $(FUSE_LIBS) -pthread -lrt
+objects: version build/stamp
+	$(MAKE) $(OBJS)

-mount.mergerfs: $(TARGET)
+build/mergerfs: libfuse objects
+	$(CXX) $(CXXFLAGS) $(CPPFLAGS) $(OBJS) -o $@ libfuse/build/libfuse.a $(LDFLAGS)
+
+mergerfs: build/mergerfs
+
+build/mount.mergerfs: build/mergerfs
 	$(LN) -fs "$<" "$@"

 changelog:
 ifeq ($(GIT_REPO),1)
-	$(GIT2DEBCL) --name $(TARGET) > ChangeLog
+	$(GIT2DEBCL) --name mergerfs > ChangeLog
 else
 	@echo "WARNING: need git repo to generate ChangeLog"
 endif

-authors:
-ifeq ($(GIT_REPO),1)
-	$(GIT) log --format='%aN <%aE>' | sort -f | uniq > AUTHORS
-else
-	@echo "WARNING: need git repo to generate AUTHORS"
-endif
-
+.PHONY: version
 version:
 	tools/update-version

-obj/obj-stamp:
-	$(MKDIR) -p obj
+build/stamp:
+	$(MKDIR) -p build
 	$(TOUCH) $@

-obj/%.o: src/%.cpp
+build/%.o: src/%.cpp
 	$(CXX) $(CXXFLAGS) $(CPPFLAGS) -c $< -o $@

+.PHONY: clean
 clean: rpm-clean
-	$(RM) -f src/version.hpp
-	$(RM) -rf obj
-	$(RM) -f "$(TARGET)" mount.mergerfs
+	$(RM) -rf build
 	$(FIND) . -name "*~" -delete
-	cd libfuse && $(MAKE) clean
+	$(MAKE) -C libfuse clean

 distclean: clean
 ifeq ($(GIT_REPO),1)
 	$(GIT) clean -xfd
 endif

+.PHONY: install
 install: install-base install-mount.mergerfs install-man

-install-base: $(TARGET)
+install-base: build/mergerfs
 	$(MKDIR) -p "$(INSTALLBINDIR)"
-	$(INSTALL) -v -m 0755 "$(TARGET)" "$(INSTALLBINDIR)/$(TARGET)"
+	$(INSTALL) -v -m 0755 build/mergerfs "$(INSTALLBINDIR)/mergerfs"

-install-mount.mergerfs: mount.mergerfs
+install-mount.mergerfs: build/mount.mergerfs
 	$(MKDIR) -p "$(INSTALLBINDIR)"
-	$(CP) -a "$<" "$(INSTALLBINDIR)/$<"
+	$(CP) -a build/mount.mergerfs "$(INSTALLBINDIR)/mount.mergerfs"

 install-man: $(MANPAGE)
 	$(MKDIR) -p "$(INSTALLMAN1DIR)"
 	$(INSTALL) -v -m 0644 "man/$(MANPAGE)" "$(INSTALLMAN1DIR)/$(MANPAGE)"

 install-strip: install-base
-	$(STRIP) "$(INSTALLBINDIR)/$(TARGET)"
+	$(STRIP) "$(INSTALLBINDIR)/mergerfs"

+.PHONY: uninstall
 uninstall: uninstall-base uninstall-mount.mergerfs uninstall-man

 uninstall-base:
-	$(RM) -f "$(INSTALLBINDIR)/$(TARGET)"
+	$(RM) -f "$(INSTALLBINDIR)/mergerfs"

 uninstall-mount.mergerfs:
 	$(RM) -f "$(INSTALLBINDIR)/mount.mergerfs"
@ -180,10 +183,11 @@ endif

 man: $(MANPAGE)

-tarball: man changelog authors version
+.PHONY: tarball
+tarball: man changelog version
 	$(eval VERSION := $(shell cat VERSION))
 	$(eval VERSION := $(subst -,_,$(VERSION)))
-	$(eval FILENAME := $(TARGET)-$(VERSION))
+	$(eval FILENAME := mergerfs-$(VERSION))
 	$(eval TMPDIR := $(shell $(MKTEMP) --tmpdir -d .$(FILENAME).XXXXXXXX))
 	$(MKDIR) $(TMPDIR)/$(FILENAME)
 	$(CP) -ar . $(TMPDIR)/$(FILENAME)
@ -192,19 +196,24 @@ tarball: man changelog authors version

 debian-changelog:
 ifeq ($(GIT_REPO),1)
-	$(GIT2DEBCL) --name $(TARGET) > debian/changelog
+	$(GIT2DEBCL) --name mergerfs > debian/changelog
 else
 	cp ChangeLog debian/changelog
 endif

-signed-deb: distclean debian-changelog
+signed-deb:
+	$(MAKE) distclean
+	$(MAKE) debian-changelog
+	dpkg-source -b .
 	dpkg-buildpackage -nc

 deb:
 	$(MAKE) distclean
 	$(MAKE) debian-changelog
+	dpkg-source -b .
 	dpkg-buildpackage -nc -uc -us

+.PHONY: rpm-clean
 rpm-clean:
 	$(RM) -rf rpmbuild

@ -212,19 +221,18 @@ rpm: tarball
 	$(eval VERSION := $(shell cat VERSION))
 	$(eval VERSION := $(subst -,_,$(VERSION)))
 	$(MKDIR) -p rpmbuild/BUILD rpmbuild/RPMS rpmbuild/SOURCES
-	$(SED) 's/__VERSION__/$(VERSION)/g' $(TARGET).spec > \
-		rpmbuild/SOURCES/$(TARGET).spec
-	cp -ar $(TARGET)-$(VERSION).tar.gz rpmbuild/SOURCES
-	$(RPMBUILD) -ba rpmbuild/SOURCES/$(TARGET).spec \
+	$(SED) 's/__VERSION__/$(VERSION)/g' mergerfs.spec > \
+		rpmbuild/SOURCES/mergerfs.spec
+	cp -ar mergerfs-$(VERSION).tar.gz rpmbuild/SOURCES
+	$(RPMBUILD) -ba rpmbuild/SOURCES/mergerfs.spec \
 		--define "_topdir $(CURDIR)/rpmbuild"

+.PHONY: install-build-pkgs
 install-build-pkgs:
 	tools/install-build-pkgs

-unexport CFLAGS
-libfuse/obj/libfuse.a:
-	cd libfuse && $(MAKE) libfuse.a
-
-.PHONY: all clean install help version
+.PHONY: libfuse
+libfuse:
+	$(MAKE) -C libfuse

 -include $(DEPS)
--- a/README.md
+++ b/README.md
@ -1,6 +1,6 @@
 % mergerfs(1) mergerfs user manual
 % Antonio SJ Musumeci <trapexit@spawn.link>
-% 2019-04-23
+% 2019-05-03

 # NAME

@ -19,7 +19,7 @@ mergerfs -o&lt;options&gt; &lt;branches&gt; &lt;mountpoint&gt;
 # FEATURES

 * Runs in userspace (FUSE)
-* Configurable behaviors
+* Configurable behaviors / file placement
 * Support for extended attributes (xattrs)
 * Support for file attributes (chattr)
 * Runtime configurable (via xattrs)
@ -28,7 +28,8 @@ mergerfs -o&lt;options&gt; &lt;branches&gt; &lt;mountpoint&gt;
 * Works with heterogeneous filesystem types
 * Handling of writes to full drives (transparently move file to drive with capacity)
 * Handles pool of read-only and read/write drives
-* Turn read-only files into symlinks to increase read performance
+* Can turn read-only files into symlinks to underlying file
+* Hard link copy-on-write / CoW


 # How it works
@ -56,7 +57,7 @@ A         +      B        =       C
                                  +-- file6
 ```

-mergerfs does **not** support the copy-on-write (CoW) behavior found in **aufs** and **overlayfs**. You can **not** mount a read-only filesystem and write to it. However, mergerfs will ignore read-only drives when creating new files so you can mix rw and ro drives.
+mergerfs does **not** support the copy-on-write (CoW) behavior found in **aufs** and **overlayfs**. You can **not** mount a read-only filesystem and write to it. However, mergerfs will ignore read-only drives when creating new files so you can mix read-write and read-only drives.


 # OPTIONS
@ -348,30 +349,22 @@ $ make
 $ sudo make install
 ```

-#### Generically with system libfuse
-
-**NOTE:** Configurable threading and thus `-o threads=num` option will be unavailable when built with system libfuse.
-
-Have git, g++, make, python, pkg-config installed.
-Also, install libfuse >= 2.9.7 (but not libfuse-3.x) and matching libfuse-dev (or libfuse-devel).
+#### Build options

 ```
-$ cd mergerfs
-$ make INTERNAL_FUSE=0
-$ sudo make INTERNAL_FUSE=0 install
-```
+$ make help
+usage: make

-#### Other build options
-
-```
-$ make STATIC=1 # builds a static binary
-$ make LTO=1    # perform link time optimization
+make USE_XATTR=0      - build program without xattrs functionality
+make STATIC=1         - build static binary
+make LTO=1            - build with link time optimization
 ```


 # RUNTIME CONFIG

 #### .mergerfs pseudo file ####
+
 ```
 <mountpoint>/.mergerfs
 ```
--- a/libfuse/Makefile
+++ b/libfuse/Makefile
@ -24,60 +24,61 @@ SRC   = \
 	lib/fuse_signals.c \
 	lib/helper.c \
 	lib/mount.c
+OBJS = $(SRC:lib/%.c=build/%.o)
+DEPS = $(SRC:lib/%.c=build/%.d)

-OBJ  = $(SRC:lib/%.c=obj/%.o)
-DEPS = $(OBJ:obj/%.o=obj/%.d)
-CFLAGS = $(OPT) \
-	 $(DEBUG_FLAGS) \
-	 -Wall \
-	 -pipe \
-	 '-D_FILE_OFFSET_BITS=64' \
-	 '-D_REENTRANT' \
-	 '-DFUSE_USE_VERSION=29' \
-	 '-DFUSERMOUNT_DIR="/usr/local/bin"' \
-	 '-DPACKAGE_VERSION=$(VERSION)' \
-	 -Iinclude \
-	 -MMD
-LDFLAGS = \
+CFLAGS += \
+	$(OPT) \
+	$(DEBUG_FLAGS) \
+	-Wall \
+	-pipe \
+	'-D_FILE_OFFSET_BITS=64' \
+	'-D_REENTRANT' \
+	'-DFUSE_USE_VERSION=29' \
+	'-DFUSERMOUNT_DIR="/usr/local/bin"' \
+	'-DPACKAGE_VERSION=$(VERSION)' \
+	-Iinclude \
+	-Ibuild \
+	-MMD
+LDFLAGS += \
 	-lrt \
 	-pthread

-all: obj/libfuse.a
+all: build/libfuse.a

-libfuse.a: obj/libfuse.a
+build/config.h: build/stamp
+	ecfd/build | tee build/config.h

-include/config.h:
-	ecfd/build | tee include/config.h
-
-obj/obj-stamp:
-	mkdir -p obj
+build/stamp:
+	mkdir -p build
 	touch $@

-obj/libfuse.a:
-	$(MAKE) obj/obj-stamp
-	$(MAKE) include/config.h
-	$(MAKE) $(OBJ)
-	ar rcs obj/libfuse.a $(OBJ)
+objects: build/config.h
+	$(MAKE) $(OBJS)

-mergerfs-mount: include/config.h util/fusermount.c lib/mount_util.c
+build/libfuse.a: objects
+	ar rcs build/libfuse.a $(OBJS)
+
+build/mergerfs-mount: build/config.h util/fusermount.c lib/mount_util.c
 	$(CC) $(CFLAGS) -Ilib -o mergerfs-mount util/fusermount.c lib/mount_util.c

-mount.mergerfs: obj/libfuse.a util/mount.fuse.c
-	$(CC) $(CFLAGS) -o mount.mergerfs util/mount.fuse.c obj/libfuse.a $(LDFLAGS)
+build/mount.mergerfs: build/libfuse.a util/mount.fuse.c
+	$(CC) $(CFLAGS) -o mount.mergerfs util/mount.fuse.c build/libfuse.a $(LDFLAGS)

-obj/%.o: lib/%.c
+build/%.o: lib/%.c
 	$(CC) $(CFLAGS) -c $< -o $@

 clean:
-	rm -rf obj include/config.h mergerfs-mount mount.mergerfs
+	rm -rf build

 distclean: clean
-	git clean -fdx

-install:
-	install -D mergerfs-mount "$(DESTDIR)$(BINDIR)/mergerfs-mount"
+install: build/mergerfs-mount build/mount.mergerfs
+	install -D build/mergerfs-mount "$(DESTDIR)$(BINDIR)/mergerfs-mount"
 	chown root:root "$(DESTDIR)$(BINDIR)/mergerfs-mount"
 	chmod u+s "$(DESTDIR)$(BINDIR)/mergerfs-mount"
-	install -D mount.mergerfs "$(DESTDIR)$(SBINDIR)/mount.mergerfs"
+	install -D build/mount.mergerfs "$(DESTDIR)$(SBINDIR)/mount.mergerfs"
+
+.PHONY: objects

 -include $(DEPS)
--- a/man/mergerfs.1
+++ b/man/mergerfs.1
@ -1,7 +1,7 @@
 .\"t
 .\" Automatically generated by Pandoc 1.19.2.4
 .\"
-.TH "mergerfs" "1" "2019\-04\-23" "mergerfs user manual" ""
+.TH "mergerfs" "1" "2019\-05\-03" "mergerfs user manual" ""
 .hy
 .SH NAME
 .PP
@ -19,7 +19,7 @@ It is similar to \f[B]mhddfs\f[], \f[B]unionfs\f[], and \f[B]aufs\f[].
 .IP \[bu] 2
 Runs in userspace (FUSE)
 .IP \[bu] 2
-Configurable behaviors
+Configurable behaviors / file placement
 .IP \[bu] 2
 Support for extended attributes (xattrs)
 .IP \[bu] 2
@ -38,7 +38,9 @@ capacity)
 .IP \[bu] 2
 Handles pool of read\-only and read/write drives
 .IP \[bu] 2
-Turn read\-only files into symlinks to increase read performance
+Can turn read\-only files into symlinks to underlying file
+.IP \[bu] 2
+Hard link copy\-on\-write / CoW
 .SH How it works
 .PP
 mergerfs logically merges multiple paths together.
@ -74,7 +76,7 @@ mergerfs does \f[B]not\f[] support the copy\-on\-write (CoW) behavior
 found in \f[B]aufs\f[] and \f[B]overlayfs\f[].
 You can \f[B]not\f[] mount a read\-only filesystem and write to it.
 However, mergerfs will ignore read\-only drives when creating new files
-so you can mix rw and ro drives.
+so you can mix read\-write and read\-only drives.
 .SH OPTIONS
 .SS mount options
 .IP \[bu] 2
@ -815,28 +817,16 @@ $\ make
 $\ sudo\ make\ install
 \f[]
 .fi
-.SS Generically with system libfuse
-.PP
-\f[B]NOTE:\f[] Configurable threading and thus \f[C]\-o\ threads=num\f[]
-option will be unavailable when built with system libfuse.
-.PP
-Have git, g++, make, python, pkg\-config installed.
-Also, install libfuse >= 2.9.7 (but not libfuse\-3.x) and matching
-libfuse\-dev (or libfuse\-devel).
+.SS Build options
 .IP
 .nf
 \f[C]
-$\ cd\ mergerfs
-$\ make\ INTERNAL_FUSE=0
-$\ sudo\ make\ INTERNAL_FUSE=0\ install
-\f[]
-.fi
-.SS Other build options
-.IP
-.nf
-\f[C]
-$\ make\ STATIC=1\ #\ builds\ a\ static\ binary
-$\ make\ LTO=1\ \ \ \ #\ perform\ link\ time\ optimization
+$\ make\ help
+usage:\ make
+
+make\ USE_XATTR=0\ \ \ \ \ \ \-\ build\ program\ without\ xattrs\ functionality
+make\ STATIC=1\ \ \ \ \ \ \ \ \ \-\ build\ static\ binary
+make\ LTO=1\ \ \ \ \ \ \ \ \ \ \ \ \-\ build\ with\ link\ time\ optimization
 \f[]
 .fi
 .SH RUNTIME CONFIG
--- a/mergerfs.spec
+++ b/mergerfs.spec
@ -15,13 +15,15 @@ BuildRequires:	git

 Requires:	fuse

+%global debug_package %{nil}
+
 %prep
 %setup -q

 %description
-mergerfs is similar to mhddfs, unionfs, and aufs. Like mhddfs in that it too
-uses FUSE. Like aufs in that it provides multiple policies for how to handle
-behavior.
+mergerfs is a union filesystem geared towards simplifying storage and
+management of files across numerous commodity storage devices. It is
+similar to mhddfs, unionfs, and aufs.

 %build
 make %{?_smp_mflags}
@ -34,6 +36,9 @@ make install PREFIX=%{_prefix} DESTDIR=%{buildroot}
 %doc %{_mandir}/*

 %changelog
+* Fri Apr 26 2019 Antonio SJ Musumeci <trapexit@spawn.link>
+- Update description
+
 * Mon Jan 25 2016 Antonio SJ Musumeci <trapexit@spawn.link>
 - Remove sbin files

--- a/tools/update-version
+++ b/tools/update-version
@ -1,10 +1,5 @@
 #!/bin/sh

-GIT=$(which git)
-if [ "${GIT}" = "" ]; then
-    exit 0
-fi
-
 VERSION=$(git describe --always --tags --dirty)
 if [ $? -ne 0 ]; then
    VERSION=$(cat VERSION)