xref: /libCEED/Makefile (revision 9011e65c41c991b52e757e3fc0bff946fa2ee750)
1# Copyright (c) 2017-2018, Lawrence Livermore National Security, LLC.
2# Produced at the Lawrence Livermore National Laboratory. LLNL-CODE-734707.
3# All Rights reserved. See files LICENSE and NOTICE for details.
4#
5# This file is part of CEED, a collection of benchmarks, miniapps, software
6# libraries and APIs for efficient high-order finite element and spectral
7# element discretizations for exascale applications. For more information and
8# source code availability see http://github.com/ceed.
9#
10# The CEED research is supported by the Exascale Computing Project 17-SC-20-SC,
11# a collaborative effort of two U.S. Department of Energy organizations (Office
12# of Science and the National Nuclear Security Administration) responsible for
13# the planning and preparation of a capable exascale ecosystem, including
14# software, applications, hardware, advanced system engineering and early
15# testbed platforms, in support of the nation's exascale computing imperative.
16
17ifeq (,$(filter-out undefined default,$(origin CC)))
18  CC = gcc
19endif
20ifeq (,$(filter-out undefined default,$(origin FC)))
21  FC = gfortran
22endif
23NVCC = $(CUDA_DIR)/bin/nvcc
24
25# ASAN must be left empty if you don't want to use it
26ASAN ?=
27
28LDFLAGS ?=
29UNDERSCORE ?= 1
30
31# MFEM_DIR env variable should point to sibling directory
32ifneq ($(wildcard ../mfem/libmfem.*),)
33  MFEM_DIR?=../mfem
34endif
35
36# OCCA_DIR env variable should point to OCCA master (github.com/libocca/occa)
37OCCA_DIR ?= ../occa
38
39# env variable MAGMA_DIR can be used too
40MAGMA_DIR ?= ../magma
41# If CUDA_DIR is not set, check for nvcc, or resort to /usr/local/cuda
42CUDA_DIR  ?= $(or $(patsubst %/,%,$(dir $(patsubst %/,%,$(dir \
43               $(shell which nvcc 2> /dev/null))))),/usr/local/cuda)
44
45# Warning: SANTIZ options still don't run with /gpu/occa
46# export LSAN_OPTIONS=suppressions=.asanignore
47AFLAGS = -fsanitize=address #-fsanitize=undefined -fno-omit-frame-pointer
48
49OPT    = -O -g
50CFLAGS = -std=c99 $(OPT) -Wall -Wextra -Wno-unused-parameter -fPIC -MMD -MP
51NVCCFLAGS = $(OPT)
52# If using the IBM XL Fortran (xlf) replace FFLAGS appropriately:
53ifneq ($(filter %xlf %xlf_r,$(FC)),)
54  FFLAGS = $(OPT) -qpreprocess -qextname -qpic -MMD
55else # gfortran/Intel-style options
56  FFLAGS = -cpp     $(OPT) -Wall -Wextra -Wno-unused-parameter -Wno-unused-dummy-argument -fPIC -MMD -MP
57endif
58
59ifeq ($(UNDERSCORE), 1)
60  CFLAGS += -DUNDERSCORE
61endif
62
63ifeq ($(COVERAGE), 1)
64  CFLAGS += --coverage
65  LDFLAGS += --coverage
66endif
67
68CFLAGS += $(if $(ASAN),$(AFLAGS))
69FFLAGS += $(if $(ASAN),$(AFLAGS))
70LDFLAGS += $(if $(ASAN),$(AFLAGS))
71CPPFLAGS = -I./include
72LDLIBS = -lm
73OBJDIR := build
74LIBDIR := lib
75
76# Installation variables
77prefix ?= /usr/local
78bindir = $(prefix)/bin
79libdir = $(prefix)/lib
80okldir = $(libdir)/okl
81includedir = $(prefix)/include
82pkgconfigdir = $(libdir)/pkgconfig
83INSTALL = install
84INSTALL_PROGRAM = $(INSTALL)
85INSTALL_DATA = $(INSTALL) -m644
86
87# Get number of processors of the machine
88NPROCS := $(shell getconf _NPROCESSORS_ONLN)
89# prepare make options to run in parallel
90MFLAGS := -j $(NPROCS) --warn-undefined-variables \
91                       --no-print-directory --no-keep-going
92
93PROVE ?= prove
94PROVE_OPTS ?= -j $(NPROCS)
95DARWIN := $(filter Darwin,$(shell uname -s))
96SO_EXT := $(if $(DARWIN),dylib,so)
97
98ceed.pc := $(LIBDIR)/pkgconfig/ceed.pc
99libceed := $(LIBDIR)/libceed.$(SO_EXT)
100libceed.c := $(wildcard interface/ceed*.c)
101BACKENDS := /cpu/self/ref /cpu/self/tmpl /cpu/self/opt
102
103# Tests
104tests.c   := $(sort $(wildcard tests/t[0-9][0-9][0-9]-*.c))
105tests.f   := $(sort $(wildcard tests/t[0-9][0-9][0-9]-*.f))
106tests     := $(tests.c:tests/%.c=$(OBJDIR)/%)
107ctests    := $(tests)
108tests     += $(tests.f:tests/%.f=$(OBJDIR)/%)
109#examples
110examples.c := $(sort $(wildcard examples/ceed/*.c))
111examples.f := $(sort $(wildcard examples/ceed/*.f))
112examples  := $(examples.c:examples/ceed/%.c=$(OBJDIR)/%)
113examples  += $(examples.f:examples/ceed/%.f=$(OBJDIR)/%)
114#mfemexamples
115mfemexamples.cpp := $(sort $(wildcard examples/mfem/*.cpp))
116mfemexamples  := $(mfemexamples.cpp:examples/mfem/%.cpp=$(OBJDIR)/mfem-%)
117petscexamples.c := $(sort $(wildcard examples/petsc/*.c))
118petscexamples  := $(petscexamples.c:examples/petsc/%.c=$(OBJDIR)/petsc-%)
119
120# backends/[ref, template, optimized, occa, magma]
121ref.c      := $(sort $(wildcard backends/ref/*.c))
122template.c := $(sort $(wildcard backends/template/*.c))
123optimized.c:= $(sort $(wildcard backends/optimized/*.c))
124occa.c     := $(sort $(wildcard backends/occa/*.c))
125magma_preprocessor := python backends/magma/gccm.py
126magma_pre_src  := $(filter-out %_tmp.c, $(wildcard backends/magma/ceed-*.c))
127magma_dsrc     := $(wildcard backends/magma/magma_d*.c)
128magma_tmp.c    := $(magma_pre_src:%.c=%_tmp.c)
129magma_tmp.cu   := $(magma_pre_src:%.c=%_cuda.cu)
130magma_allsrc.c := $(magma_dsrc) $(magma_tmp.c)
131magma_allsrc.cu:= $(magma_tmp.cu)
132
133# Output using the 216-color rules mode
134rule_file = $(notdir $(1))
135rule_path = $(patsubst %/,%,$(dir $(1)))
136last_path = $(notdir $(patsubst %/,%,$(dir $(1))))
137ansicolor = $(shell echo $(call last_path,$(1)) | cksum | cut -b1-2 | xargs -IS expr 2 \* S + 17)
138emacs_out = @printf "  %10s %s/%s\n" $(1) $(call rule_path,$(2)) $(call rule_file,$(2))
139color_out = @if [ -t 1 ]; then \
140				printf "  %10s \033[38;5;%d;1m%s\033[m/%s\n" \
141					$(1) $(call ansicolor,$(2)) \
142					$(call rule_path,$(2)) $(call rule_file,$(2)); else \
143				printf "  %10s %s\n" $(1) $(2); fi
144# if TERM=dumb, use it, otherwise switch to the term one
145output = $(if $(TERM:dumb=),$(call color_out,$1,$2),$(call emacs_out,$1,$2))
146
147# if V is set to non-nil, turn the verbose mode
148quiet = $(if $(V),$($(1)),$(call output,$1,$@);$($(1)))
149
150.SUFFIXES:
151.SUFFIXES: .c .f .o .d
152# cancel some built-in implicit rules
153%: %.c
154%: %.f
155%: %.o
156%.o: %.c
157%.o: %.f
158.SECONDEXPANSION: # to expand $$(@D)/.DIR
159
160.SECONDARY: $(magma_tmp.c) $(magma_tmp.cu)
161
162%/.DIR :
163	@mkdir -p $(@D)
164	@touch $@
165
166.PRECIOUS: %/.DIR
167
168lib: $(libceed) $(ceed.pc)
169# run 'lib' target in parallel
170all:;@$(MAKE) $(MFLAGS) V=$(V) lib
171info:
172	$(info ------------------------------------)
173	$(info CC        = $(CC))
174	$(info FC        = $(FC))
175	$(info CPPFLAGS  = $(CPPFLAGS))
176	$(info CFLAGS    = $(value CFLAGS))
177	$(info FFLAGS    = $(value FFLAGS))
178	$(info NVCCFLAGS = $(value NVCCFLAGS))
179	$(info LDFLAGS   = $(value LDFLAGS))
180	$(info LDLIBS    = $(LDLIBS))
181	$(info OPT       = $(OPT))
182	$(info AFLAGS    = $(AFLAGS))
183	$(info ASAN      = $(or $(ASAN),(empty)))
184	$(info V         = $(or $(V),(empty)) [verbose=$(if $(V),on,off)])
185	$(info ------------------------------------)
186	$(info CUDA_DIR  = $(CUDA_DIR))
187	$(info OCCA_DIR  = $(OCCA_DIR))
188	$(info MAGMA_DIR = $(MAGMA_DIR))
189	$(info $1    Enabled backends:$(if $(OCCA_ON), OCCA)$(if \
190	  $(MAGMA_ON), MAGMA))
191	$(info ------------------------------------)
192	$(info MFEM_DIR  = $(MFEM_DIR))
193	$(info PETSC_DIR = $(PETSC_DIR))
194	$(info ------------------------------------)
195	$(info prefix       = $(prefix))
196	$(info includedir   = $(value includedir))
197	$(info libdir       = $(value libdir))
198	$(info okldir       = $(value okldir))
199	$(info pkgconfigdir = $(value pkgconfigdir))
200	$(info ------------------------------------)
201	@true
202info-backends:
203	$(if $(OCCA_ON),\
204	  $(info libCEED: OCCA backend enabled [OCCA_DIR=$(OCCA_DIR)]))
205	$(if $(MAGMA_ON),\
206	  $(info libCEED: MAGMA backend enabled [MAGMA_DIR=$(MAGMA_DIR)]))
207	@true
208.PHONY: lib all info info-backends
209
210$(libceed) : LDFLAGS += $(if $(DARWIN), -install_name @rpath/$(notdir $(libceed)))
211
212libceed.c += $(ref.c)
213libceed.c += $(template.c)
214libceed.c += $(optimized.c)
215
216override OCCA_ON =
217ifneq ($(wildcard $(OCCA_DIR)/lib/libocca.*),)
218  override OCCA_ON = YES
219  $(libceed) : LDFLAGS += -L$(OCCA_DIR)/lib -Wl,-rpath,$(abspath $(OCCA_DIR)/lib)
220  $(libceed) : LDLIBS += -locca
221  libceed.c += $(occa.c)
222  $(occa.c:%.c=$(OBJDIR)/%.o) : CFLAGS += -I$(OCCA_DIR)/include
223  BACKENDS += /cpu/occa /gpu/occa /omp/occa
224endif
225
226override MAGMA_ON =
227ifneq ($(wildcard $(MAGMA_DIR)/lib/libmagma.*),)
228  CUDA_LIB_DIR := $(wildcard $(foreach d,lib lib64,$(CUDA_DIR)/$d/libcudart.${SO_EXT}))
229  CUDA_LIB_DIR := $(patsubst %/,%,$(dir $(firstword $(CUDA_LIB_DIR))))
230  ifneq ($(CUDA_LIB_DIR),)
231  override MAGMA_ON = YES
232  cuda_link = -Wl,-rpath,$(CUDA_LIB_DIR) -L$(CUDA_LIB_DIR) -lcublas -lcusparse -lcudart
233  omp_link = -fopenmp
234  magma_link_static = -L$(MAGMA_DIR)/lib -lmagma $(cuda_link) $(omp_link)
235  magma_link_shared = -L$(MAGMA_DIR)/lib -Wl,-rpath,$(abspath $(MAGMA_DIR)/lib) -lmagma
236  magma_link := $(if $(wildcard $(MAGMA_DIR)/lib/libmagma.${SO_EXT}),$(magma_link_shared),$(magma_link_static))
237  $(libceed)           : LDLIBS += $(magma_link)
238  $(tests) $(examples) : LDLIBS += $(magma_link)
239  libceed.c  += $(magma_allsrc.c)
240  libceed.cu += $(magma_allsrc.cu)
241  $(magma_allsrc.c:%.c=$(OBJDIR)/%.o) : CFLAGS += -DADD_ -I$(MAGMA_DIR)/include -I$(CUDA_DIR)/include
242  $(magma_allsrc.cu:%.cu=$(OBJDIR)/%.o) : NVCCFLAGS += --compiler-options=-fPIC -DADD_ -I$(MAGMA_DIR)/include -I$(MAGMA_DIR)/magmablas -I$(MAGMA_DIR)/control -I$(CUDA_DIR)/include
243  BACKENDS += /gpu/magma
244  endif
245endif
246
247export BACKENDS
248
249# generate magma_tmp.c and magma_cuda.cu from magma.c
250$(magma_tmp.c) $(magma_tmp.cu): $(magma_pre_src)
251	$(magma_preprocessor) $<
252
253libceed.o = $(libceed.c:%.c=$(OBJDIR)/%.o) $(libceed.cu:%.cu=$(OBJDIR)/%.o)
254$(libceed.o): | info-backends
255$(libceed) : $(libceed.o) | $$(@D)/.DIR
256	$(call quiet,CC) $(LDFLAGS) -shared -o $@ $^ $(LDLIBS)
257
258$(OBJDIR)/%.o : %.c | $$(@D)/.DIR
259	$(call quiet,CC) $(CPPFLAGS) $(CFLAGS) -c -o $@ $(abspath $<)
260
261$(OBJDIR)/%.o : %.cu | $$(@D)/.DIR
262	$(call quiet,NVCC) $(CPPFLAGS) $(NVCCFLAGS) -c -o $@ $(abspath $<)
263
264$(OBJDIR)/% : tests/%.c | $$(@D)/.DIR
265	$(call quiet,LINK.c) -o $@ $(abspath $<) -lceed $(LDLIBS)
266
267$(OBJDIR)/% : tests/%.f | $$(@D)/.DIR
268	$(call quiet,LINK.F) -o $@ $(abspath $<) -lceed $(LDLIBS)
269
270$(OBJDIR)/% : examples/ceed/%.c | $$(@D)/.DIR
271	$(call quiet,LINK.c) -o $@ $(abspath $<) -lceed $(LDLIBS)
272
273$(OBJDIR)/% : examples/ceed/%.f | $$(@D)/.DIR
274	$(call quiet,LINK.F) -o $@ $(abspath $<) -lceed $(LDLIBS)
275
276$(OBJDIR)/mfem-% : examples/mfem/%.cpp $(libceed) | $$(@D)/.DIR
277	$(MAKE) -C examples/mfem CEED_DIR=`pwd` $*
278	mv examples/mfem/$* $@
279
280$(OBJDIR)/petsc-% : examples/petsc/%.c $(libceed) $(ceed.pc) | $$(@D)/.DIR
281	$(MAKE) -C examples/petsc CEED_DIR=`pwd` $*
282	mv examples/petsc/$* $@
283
284$(tests) $(examples) : $(libceed)
285$(tests) $(examples) : LDFLAGS += -Wl,-rpath,$(abspath $(LIBDIR)) -L$(LIBDIR)
286
287run-% : $(OBJDIR)/%
288	@tests/tap.sh $(<:build/%=%)
289# Test core libCEED
290test : $(tests:$(OBJDIR)/%=run-%) $(examples:$(OBJDIR)/%=run-%)
291
292# run test target in parallel
293tst : ;@$(MAKE) $(MFLAGS) V=$(V) test
294# CPU C tests only for backend %
295ctc-% : $(ctests);@$(foreach tst,$(ctests),$(tst) /cpu/$*;)
296
297prove : $(tests) $(examples)
298	$(info Testing backends: $(BACKENDS))
299	$(PROVE) $(PROVE_OPTS) --exec 'tests/tap.sh' $(tests:$(OBJDIR)/%=%) $(examples:$(OBJDIR)/%=%)
300# run prove target in parallel
301prv : ;@$(MAKE) $(MFLAGS) V=$(V) prove
302
303alltests := $(tests) $(examples) $(if $(MFEM_DIR),$(mfemexamples)) $(if $(PETSC_DIR),$(petscexamples))
304prove-all : $(alltests)
305	$(info Testing backends: $(BACKENDS))
306	$(PROVE) $(PROVE_OPTS) --exec 'tests/tap.sh' $(alltests:$(OBJDIR)/%=%)
307
308examples : $(examples)
309
310$(ceed.pc) : pkgconfig-prefix = $(abspath .)
311$(OBJDIR)/ceed.pc : pkgconfig-prefix = $(prefix)
312.INTERMEDIATE : $(OBJDIR)/ceed.pc
313%/ceed.pc : ceed.pc.template | $$(@D)/.DIR
314	@sed "s:%prefix%:$(pkgconfig-prefix):" $< > $@
315
316OCCA        := $(OCCA_DIR)/bin/occa
317OKL_KERNELS := $(wildcard backends/occa/*.okl)
318
319okl-cache :
320	$(OCCA) cache ceed $(OKL_KERNELS)
321
322okl-clear:
323	$(OCCA) clear -y -l ceed
324
325install : $(libceed) $(OBJDIR)/ceed.pc
326	$(INSTALL) -d $(addprefix $(if $(DESTDIR),"$(DESTDIR)"),"$(includedir)"\
327	  "$(libdir)" "$(pkgconfigdir)" $(if $(OCCA_ON),"$(okldir)"))
328	$(INSTALL_DATA) include/ceed.h "$(DESTDIR)$(includedir)/"
329	$(INSTALL_DATA) include/ceedf.h "$(DESTDIR)$(includedir)/"
330	$(INSTALL_DATA) $(libceed) "$(DESTDIR)$(libdir)/"
331	$(INSTALL_DATA) $(OBJDIR)/ceed.pc "$(DESTDIR)$(pkgconfigdir)/"
332	$(if $(OCCA_ON),$(INSTALL_DATA) $(OKL_KERNELS) "$(DESTDIR)$(okldir)/")
333
334.PHONY : cln clean print test tst prove prv examples style install doc okl-cache okl-clear
335
336cln clean :
337	$(RM) $(libceed)
338	$(RM) -r $(OBJDIR) $(LIBDIR)/pkgconfig
339	$(MAKE) -C examples/ceed clean
340	$(MAKE) -C examples/mfem clean
341	$(MAKE) -C examples/petsc clean
342	(cd examples/nek5000 && bash make-nek-examples.sh clean)
343	$(RM) $(magma_tmp.c) $(magma_tmp.cu) backends/magma/*~ backends/magma/*.o
344
345distclean : clean
346	$(RM) -r doc/html
347
348doc :
349	doxygen Doxyfile
350
351style :
352	astyle --style=google --indent=spaces=2 --max-code-length=80 \
353            --keep-one-line-statements --keep-one-line-blocks --lineend=linux \
354            --suffix=none --preserve-date --formatted \
355            --exclude=include/ceedf.h \
356            include/*.h interface/*.[ch] tests/*.[ch] backends/*/*.[ch] \
357            examples/*/*.[ch] examples/*/*.[ch]pp
358
359print :
360	@echo $(VAR)=$($(VAR))
361
362print-% :
363	$(info [ variable name]: $*)
364	$(info [        origin]: $(origin $*))
365	$(info [         value]: $(value $*))
366	$(info [expanded value]: $($*))
367	$(info )
368	@true
369
370-include $(libceed.c:%.c=build/%.d) $(tests.c:tests/%.c=build/%.d)
371