xref: /petsc/makefile (revision f265ae5c0732701d4e4858c519dd37937adf2d2f)
1*f265ae5cSBarry Smith# $Id: makefile,v 1.188 1997/09/22 14:51:34 balay Exp bsmith $
211b6ed10SLois Curfman McInnes#
3cfd69a58SBarry Smith# This is the makefile for installing PETSc. See the file
4cfd69a58SBarry Smith# Installation for directions on installing PETSc.
5cfd69a58SBarry Smith# See also bmake/common for additional commands.
611b6ed10SLois Curfman McInnes#
711b6ed10SLois Curfman McInnes
8ab94cc7aSSatish BalayCFLAGS	 =
961523587SBarry SmithSOURCEC	 =
1061523587SBarry SmithSOURCEF	 =
115eea60f9SBarry SmithDOCS	 = Changes Machines Readme maint/addlinks \
1243a90d84SBarry Smith	   maint/builddist FAQ Installation BugReporting\
13deb7fc1cSBarry Smith	   maint/buildlinks maint/wwwman maint/xclude maint/crontab\
14630a6785SBarry Smith	   bmake/common bmake/*/base* maint/autoftp docs/www/sec/* \
15630a6785SBarry Smith           include/finclude/generateincludes bin/petscviewinfo.text \
16630a6785SBarry Smith           bin/petscoptsinfo.text
1761523587SBarry SmithOBJSC	 =
1861523587SBarry SmithOBJSF	 =
1961523587SBarry SmithLIBBASE	 = libpetscvec
20b16a3bb1SBarry SmithDIRS	 = src include docs
2161523587SBarry Smith
224e627d3aSBarry Smithinclude $(PETSC_DIR)/bmake/$(PETSC_ARCH)/base
2361523587SBarry Smith
2411b6ed10SLois Curfman McInnes# Builds PETSc libraries for a given BOPT and architecture
257857610eSBarry Smithall: chkpetsc_dir
26511caf8eSSatish Balay	-$(RM) -f $(PDIR)/*
270b3634f8SBarry Smith	-@echo "Beginning to compile libraries in all directories"
281d91fb6eSBarry Smith	-@echo On `date` on `hostname`
2930fdcc7aSBarry Smith	-@echo Machine characteristics: `uname -a`
3047794344SBarry Smith	-@echo "Using compiler: $(CC) $(COPTFLAGS)"
3181eac796SBarry Smith	-@if [ "$(CCV)" != "unknown" ] ; then \
32376ee591SBarry Smith	  echo "Compiler version:" ; \
33376ee591SBarry Smith          $(CCV) ; fi
3447794344SBarry Smith	-@echo "-----------------------------------------"
35*f265ae5cSBarry Smith	-@grep PETSC_VERSION_NUMBER include/petsc.h
36*f265ae5cSBarry Smith	-@echo "-----------------------------------------"
37b14e8f29SBarry Smith	-@echo "Using PETSc flags: $(PETSCFLAGS) $(PCONF)"
3847794344SBarry Smith	-@echo "-----------------------------------------"
39b14e8f29SBarry Smith	-@echo "Using configuration flags: $(CONF)"
4047794344SBarry Smith	-@echo "-----------------------------------------"
41b14e8f29SBarry Smith	-@echo "Using include paths: $(PETSC_INCLUDE)"
4247794344SBarry Smith	-@echo "-----------------------------------------"
43c2c9bc36SBarry Smith	-@echo "Using PETSc directory: $(PETSC_DIR)"
44c2c9bc36SBarry Smith	-@echo "Using PETSc arch: $(PETSC_ARCH)"
4547794344SBarry Smith	-@echo "========================================="
46e35bd481SBarry Smith	-@$(OMAKE) BOPT=$(BOPT) PETSC_ARCH=$(PETSC_ARCH) \
47f3848965SBarry Smith	   ACTION=libfast  tree
48f88f42abSSatish Balay	-@cd $(PETSC_DIR)/src/sys/src ; \
49f88f42abSSatish Balay	$(OMAKE) BOPT=$(BOPT) PETSC_ARCH=$(PETSC_ARCH) rs6000_time
504e04c1a0SBarry Smith	$(RANLIB) $(PDIR)/*.a
510be1b381SSatish Balay	-@chmod g+w  $(PDIR)/*.a
520b3634f8SBarry Smith	-@echo "Completed building libraries"
5347794344SBarry Smith	-@echo "========================================="
540b3634f8SBarry Smith
550b3634f8SBarry Smith# Builds PETSc test examples for a given BOPT and architecture
56a9369724SSatish Balaytestexamples: chkopts
570b3634f8SBarry Smith	-@echo "Beginning to compile and run test examples"
581d91fb6eSBarry Smith	-@echo On `date` on `hostname`
59f9c6b2e1SBarry Smith	-@echo Machine characteristics: `uname -a`
6047794344SBarry Smith	-@echo "Using compiler: $(CC) $(COPTFLAGS)"
6147794344SBarry Smith	-@echo "-----------------------------------------"
62b14e8f29SBarry Smith	-@echo "Using PETSc flags: $(PETSCFLAGS) $(PCONF)"
6347794344SBarry Smith	-@echo "-----------------------------------------"
64b14e8f29SBarry Smith	-@echo "Using include paths: $(PETSC_INCLUDE)"
6547794344SBarry Smith	-@echo "-----------------------------------------"
66c2c9bc36SBarry Smith	-@echo "Using PETSc directory: $(PETSC_DIR)"
67c2c9bc36SBarry Smith	-@echo "Using PETSc arch: $(PETSC_ARCH)"
68c2c9bc36SBarry Smith	-@echo "------------------------------------------"
699c69534bSBarry Smith	-@echo "Using linker: $(CLINKER)"
709c69534bSBarry Smith	-@echo "Using libraries: $(PETSC_LIB)"
710b3634f8SBarry Smith	-@echo "------------------------------------------"
72eb817c50SBarry Smith	-@echo "Due to different numerical round-off on certain"
73eb817c50SBarry Smith	-@echo "machines some of the numbers may not match exactly."
7447794344SBarry Smith	-@echo "========================================="
750b3634f8SBarry Smith	-@$(OMAKE) BOPT=$(BOPT) PETSC_ARCH=$(PETSC_ARCH) \
760b3634f8SBarry Smith	   ACTION=testexamples_1  tree
770b3634f8SBarry Smith	-@echo "Completed compiling and running test examples"
7847794344SBarry Smith	-@echo "========================================="
790b3634f8SBarry Smith
800b3634f8SBarry Smith# Builds PETSc test examples for a given BOPT and architecture
81a9369724SSatish Balaytestexamples_uni: chkopts
828475343bSBarry Smith	-@echo "Beginning to compile and run uniprocessor test examples"
831d91fb6eSBarry Smith	-@echo On `date` on `hostname`
84f4ccad53SBarry Smith	-@echo Machine characteristics: `uname -a`
8547794344SBarry Smith	-@echo "Using compiler: $(CC) $(COPTFLAGS)"
868475343bSBarry Smith	-@echo "Using linker: $(CLINKER)"
8747794344SBarry Smith	-@echo "------------------------------------------"
88b14e8f29SBarry Smith	-@echo "Using PETSc flags: $(PETSCFLAGS) $(PCONF)"
8947794344SBarry Smith	-@echo "------------------------------------------"
90b14e8f29SBarry Smith	-@echo "Using include paths: $(PETSC_INCLUDE)"
9147794344SBarry Smith	-@echo "------------------------------------------"
92d6db1478SLois Curfman McInnes	-@echo "Using PETSc directory: $(PETSC_DIR)"
93d6db1478SLois Curfman McInnes	-@echo "Using PETSc arch: $(PETSC_ARCH)"
94d6db1478SLois Curfman McInnes	-@echo "------------------------------------------"
95d6db1478SLois Curfman McInnes	-@echo "Using linker: $(CLINKER)"
968475343bSBarry Smith	-@echo "Using libraries: $(PETSC_LIB)"
978475343bSBarry Smith	-@echo "------------------------------------------"
988475343bSBarry Smith	-@echo "Due to different numerical round-off on certain"
998475343bSBarry Smith	-@echo "machines some of the numbers may not match exactly."
10047794344SBarry Smith	-@echo "========================================="
1018475343bSBarry Smith	-@$(OMAKE) BOPT=$(BOPT) PETSC_ARCH=$(PETSC_ARCH) \
1028475343bSBarry Smith	   ACTION=testexamples_4  tree
1038475343bSBarry Smith	-@echo "Completed compiling and running uniprocessor test examples"
10447794344SBarry Smith	-@echo "========================================="
1058475343bSBarry Smith
10635ca7349SBarry Smith#
10711b6ed10SLois Curfman McInnes# Builds PETSc Fortran interface libary
10811b6ed10SLois Curfman McInnes# Note:	 libfast cannot run on .F files on certain machines, so we
10935ca7349SBarry Smith# use lib and check for errors here.
11083f0b094SBarry Smithfortran: chkpetsc_dir
111727c161cSBarry Smith	-$(RM) -f $(PDIR)/libpetscfortran.*
1120b3634f8SBarry Smith	-@echo "Beginning to compile Fortran interface library"
1131d91fb6eSBarry Smith	-@echo On `date` on `hostname`
114f4ccad53SBarry Smith	-@echo Machine characteristics: `uname -a`
11526de76a5SSatish Balay	-@echo "Using Fortran compiler: $(FC) $(FFLAGS) $(FOPTFLAGS)"
11647794344SBarry Smith	-@echo "Using C/C++ compiler: $(CC) $(COPTFLAGS)"
11747794344SBarry Smith	-@echo "------------------------------------------"
118fc939babSLois Curfman McInnes	-@echo "Using PETSc flags: $(PETSCFLAGS) $(PCONF)"
11947794344SBarry Smith	-@echo "------------------------------------------"
120fc939babSLois Curfman McInnes	-@echo "Using configuration flags: $(CONF)"
12147794344SBarry Smith	-@echo "------------------------------------------"
122fc939babSLois Curfman McInnes	-@echo "Using include paths: $(PETSC_INCLUDE)"
12347794344SBarry Smith	-@echo "------------------------------------------"
124d6db1478SLois Curfman McInnes	-@echo "Using PETSc directory: $(PETSC_DIR)"
125d6db1478SLois Curfman McInnes	-@echo "Using PETSc arch: $(PETSC_ARCH)"
12647794344SBarry Smith	-@echo "========================================="
127b16a3bb1SBarry Smith	-@cd src/fortran/custom; \
12835ca7349SBarry Smith	  $(OMAKE) BOPT=$(BOPT) PETSC_ARCH=$(PETSC_ARCH) lib > trashz 2>&1; \
12935ca7349SBarry Smith	  grep -v clog trashz | grep -v "information sections" | \
13035ca7349SBarry Smith	  egrep -i '(Error|warning|Can)' >> /dev/null;\
13135ca7349SBarry Smith	  if [ "$$?" != 1 ]; then \
13235ca7349SBarry Smith	  cat trashz ; fi; $(RM) trashz
133b16a3bb1SBarry Smith	-@cd src/fortran/auto; \
13435ca7349SBarry Smith	  $(OMAKE) BOPT=$(BOPT) PETSC_ARCH=$(PETSC_ARCH) libfast
13583f0b094SBarry Smith	$(RANLIB) $(PDIR)/libpetscfortran.a
1360be1b381SSatish Balay	-@chmod g+w  $(PDIR)/*.a
1370b3634f8SBarry Smith	-@echo "Completed compiling Fortran interface library"
13847794344SBarry Smith	-@echo "========================================="
13983f0b094SBarry Smith
140971c2310SBarry Smith#
141971c2310SBarry Smith# Builds PETSc Fortran kernels; some numerical kernels have
142971c2310SBarry Smith# a Fortran version that may give better performance on certain
143971c2310SBarry Smith# machines. It always gives better performance for complex numbers.
144971c2310SBarry Smithfortrankernels: chkpetsc_dir
145971c2310SBarry Smith	-$(RM) -f $(PDIR)/libpetsckernels.*
146971c2310SBarry Smith	-@echo "Beginning to compile Fortran kernels library"
147971c2310SBarry Smith	-@echo On `date` on `hostname`
148971c2310SBarry Smith	-@echo Machine characteristics: `uname -a`
149971c2310SBarry Smith	-@echo "Using Fortran compiler: $(FC) $(FFLAGS) $(FOPTFLAGS)"
150971c2310SBarry Smith	-@echo "------------------------------------------"
151971c2310SBarry Smith	-@echo "Using PETSc flags: $(PETSCFLAGS) $(PCONF)"
152971c2310SBarry Smith	-@echo "------------------------------------------"
153971c2310SBarry Smith	-@echo "Using configuration flags: $(CONF)"
154971c2310SBarry Smith	-@echo "------------------------------------------"
155971c2310SBarry Smith	-@echo "Using PETSc directory: $(PETSC_DIR)"
156971c2310SBarry Smith	-@echo "Using PETSc arch: $(PETSC_ARCH)"
157971c2310SBarry Smith	-@echo "========================================="
158971c2310SBarry Smith	-@cd src/fortran/kernels; \
159971c2310SBarry Smith	  $(OMAKE) BOPT=$(BOPT) PETSC_ARCH=$(PETSC_ARCH) lib
160971c2310SBarry Smith	-@chmod g+w  $(PDIR)/*.a
161971c2310SBarry Smith	-@echo "Completed compiling Fortran kernels library"
162971c2310SBarry Smith	-@echo "========================================="
163971c2310SBarry Smith
164727c161cSBarry Smith# Builds PETSc test examples for a given BOPT and architecture
165a9369724SSatish Balaytestfortran: chkopts
166727c161cSBarry Smith	-@echo "Beginning to compile and run Fortran test examples"
1671d91fb6eSBarry Smith	-@echo On `date` on `hostname`
168f4ccad53SBarry Smith	-@echo Machine characteristics: `uname -a`
169727c161cSBarry Smith	-@echo "Using compiler: $(FC) $(FFLAGS) $(FOPTFLAGS)"
170727c161cSBarry Smith	-@echo "Using linker: $(FLINKER)"
171727c161cSBarry Smith	-@echo "Using PETSc flags: $(PETSCFLAGS) $(PCONF)"
17247794344SBarry Smith	-@echo "------------------------------------------"
173727c161cSBarry Smith	-@echo "Using PETSc directory: $(PETSC_DIR)"
174727c161cSBarry Smith	-@echo "Using PETSc arch: $(PETSC_ARCH)"
175727c161cSBarry Smith	-@echo "------------------------------------------"
176727c161cSBarry Smith	-@echo "Using linker: $(FLINKER)"
177727c161cSBarry Smith	-@echo "Using libraries: $(PETSC_FORTRAN_LIB) $(PETSC_LIB)"
17847794344SBarry Smith	-@echo "========================================="
179e4ef9893SBarry Smith	-@echo "Due to different numerical round-off on certain"
180e4ef9893SBarry Smith	-@echo "machines or the way Fortran formats numbers"
181e4ef9893SBarry Smith	-@echo "some of the results may not match exactly."
182e4ef9893SBarry Smith	-@echo "========================================="
183e4ef9893SBarry Smith	-@echo "On some machines you may get messages of the form"
184e4ef9893SBarry Smith	-@echo "PetscScalarAddressToFortran:C and Fortran arrays are"
185e4ef9893SBarry Smith	-@echo "not commonly aligned or are too far apart to be indexed"
186e4ef9893SBarry Smith	-@echo "by an integer. Locations: C xxxc Fortran xxxf"
187e4ef9893SBarry Smith	-@echo "Locations/sizeof(Scalar): C yyc Fortran yyf"
188e4ef9893SBarry Smith	-@echo "This indicates that you may not be able to use the"
189e4ef9893SBarry Smith	-@echo "PETSc routines VecGetArray() and MatGetArray() from Fortran"
190e4ef9893SBarry Smith	-@echo "========================================="
191727c161cSBarry Smith	-@$(OMAKE) BOPT=$(BOPT) PETSC_ARCH=$(PETSC_ARCH) \
192727c161cSBarry Smith	   ACTION=testexamples_3  tree
193727c161cSBarry Smith	-@echo "Completed compiling and running Fortran test examples"
19447794344SBarry Smith	-@echo "========================================="
195b1f85764SBarry Smith#
196b1f85764SBarry Smith# Builds PETSc Fortran90 interface libary
197b1f85764SBarry Smith# Note:	 libfast cannot run on .F files on certain machines, so we
198b1f85764SBarry Smith# use lib and check for errors here.
199b1f85764SBarry Smith# Note: F90 interface currently only supported in NAG F90 compiler
200d7f8d646SSatish Balayfortran90: chkpetsc_dir fortran
201b1f85764SBarry Smith	-@echo "Beginning to compile Fortran90 interface library"
2021d91fb6eSBarry Smith	-@echo On `date` on `hostname`
203f4ccad53SBarry Smith	-@echo Machine characteristics: `uname -a`
204b1f85764SBarry Smith	-@echo "Using Fortran compiler: $(FC) $(FFLAGS) $(FOPTFLAGS)"
205b1f85764SBarry Smith	-@echo "Using C/C++ compiler: $(CC) $(COPTFLAGS)"
206b1f85764SBarry Smith	-@echo "------------------------------------------"
207b1f85764SBarry Smith	-@echo "Using PETSc flags: $(PETSCFLAGS) $(PCONF)"
208b1f85764SBarry Smith	-@echo "------------------------------------------"
209b1f85764SBarry Smith	-@echo "Using configuration flags: $(CONF)"
210b1f85764SBarry Smith	-@echo "------------------------------------------"
211b1f85764SBarry Smith	-@echo "Using include paths: $(PETSC_INCLUDE)"
212b1f85764SBarry Smith	-@echo "------------------------------------------"
213b1f85764SBarry Smith	-@echo "Using PETSc directory: $(PETSC_DIR)"
214b1f85764SBarry Smith	-@echo "Using PETSc arch: $(PETSC_ARCH)"
215b1f85764SBarry Smith	-@echo "========================================="
216b1f85764SBarry Smith	-@cd src/fortran/f90; \
217b1f85764SBarry Smith	  $(OMAKE) BOPT=$(BOPT) PETSC_ARCH=$(PETSC_ARCH) lib > trashz 2>&1; \
218b1f85764SBarry Smith	  grep -v clog trashz | grep -v "information sections" | \
219b1f85764SBarry Smith	  egrep -i '(Error|warning|Can)' >> /dev/null;\
220b1f85764SBarry Smith	  if [ "$$?" != 1 ]; then \
221b1f85764SBarry Smith	  cat trashz ; fi; $(RM) trashz
222b1f85764SBarry Smith	$(RANLIB) $(PDIR)/libpetscfortran.a
2230be1b381SSatish Balay	-@chmod g+w  $(PDIR)/*.a
224b1f85764SBarry Smith	-@echo "Completed compiling Fortran90 interface library"
225b1f85764SBarry Smith	-@echo "========================================="
226b1f85764SBarry Smith
227ad96cc0dSLois Curfman McInnes# Builds noise routines (not yet publically available)
228ad96cc0dSLois Curfman McInnes# Note:	 libfast cannot run on .F files on certain machines, so we
229ad96cc0dSLois Curfman McInnes# use lib and check for errors here.
230ad96cc0dSLois Curfman McInnesnoise: chkpetsc_dir
231ad96cc0dSLois Curfman McInnes	-@echo "Beginning to compile noise routines"
232ad96cc0dSLois Curfman McInnes	-@echo "Using Fortran compiler: $(FC) $(FFLAGS) $(FOPTFLAGS)"
233ad96cc0dSLois Curfman McInnes	-@echo "Using C/C++ compiler: $(CC) $(COPTFLAGS)"
234ad96cc0dSLois Curfman McInnes	-@echo "------------------------------------------"
235ad96cc0dSLois Curfman McInnes	-@echo "Using PETSc flags: $(PETSCFLAGS) $(PCONF)"
236ad96cc0dSLois Curfman McInnes	-@echo "------------------------------------------"
237ad96cc0dSLois Curfman McInnes	-@echo "Using configuration flags: $(CONF)"
238ad96cc0dSLois Curfman McInnes	-@echo "------------------------------------------"
239ad96cc0dSLois Curfman McInnes	-@echo "Using include paths: $(PETSC_INCLUDE)"
240ad96cc0dSLois Curfman McInnes	-@echo "------------------------------------------"
241ad96cc0dSLois Curfman McInnes	-@echo "Using PETSc directory: $(PETSC_DIR)"
242ad96cc0dSLois Curfman McInnes	-@echo "Using PETSc arch: $(PETSC_ARCH)"
243ad96cc0dSLois Curfman McInnes	-@echo "========================================="
244ad96cc0dSLois Curfman McInnes	-@cd src/snes/interface/noise; \
245ad96cc0dSLois Curfman McInnes	  $(OMAKE) BOPT=$(BOPT) PETSC_ARCH=$(PETSC_ARCH) lib > trashz 2>&1; \
246ad96cc0dSLois Curfman McInnes	  grep -v clog trashz | grep -v "information sections" | \
247ad96cc0dSLois Curfman McInnes	  egrep -i '(Error|warning|Can)' >> /dev/null;\
248ad96cc0dSLois Curfman McInnes	  if [ "$$?" != 1 ]; then \
249ad96cc0dSLois Curfman McInnes	  cat trashz ; fi; $(RM) trashz
250ad96cc0dSLois Curfman McInnes	$(RANLIB) $(PDIR)/libpetscsnes.a
251ad96cc0dSLois Curfman McInnes	-@chmod g+w  $(PDIR)/libpetscsnes.a
252ad96cc0dSLois Curfman McInnes	-@echo "Completed compiling noise routines"
253ad96cc0dSLois Curfman McInnes	-@echo "========================================="
254ad96cc0dSLois Curfman McInnes
25566341c5dSSatish Balaypetscblas: chkpetsc_dir
25666341c5dSSatish Balay	-$(RM) -f $(PDIR)/libpetscblas.*
257229e8d5cSBarry Smith	-@echo "Beginning to compile C version of BLAS and LAPACK"
25866341c5dSSatish Balay	-@echo On `date` on `hostname`
259f4ccad53SBarry Smith	-@echo Machine characteristics: `uname -a`
26066341c5dSSatish Balay	-@echo "Using C/C++ compiler: $(CC) $(COPTFLAGS)"
26166341c5dSSatish Balay	-@echo "------------------------------------------"
26266341c5dSSatish Balay	-@echo "Using PETSc flags: $(PETSCFLAGS) $(PCONF)"
26366341c5dSSatish Balay	-@echo "------------------------------------------"
26466341c5dSSatish Balay	-@echo "Using configuration flags: $(CONF)"
26566341c5dSSatish Balay	-@echo "------------------------------------------"
26666341c5dSSatish Balay	-@echo "Using include paths: $(PETSC_INCLUDE)"
26766341c5dSSatish Balay	-@echo "------------------------------------------"
26866341c5dSSatish Balay	-@echo "Using PETSc directory: $(PETSC_DIR)"
26966341c5dSSatish Balay	-@echo "Using PETSc arch: $(PETSC_ARCH)"
27066341c5dSSatish Balay	-@echo "========================================="
27166341c5dSSatish Balay	-@cd src/adic/blas; \
27266341c5dSSatish Balay	  $(OMAKE) BOPT=$(BOPT) PETSC_ARCH=$(PETSC_ARCH) libfast
27366341c5dSSatish Balay	-@cd src/adic/lapack; \
27466341c5dSSatish Balay	  $(OMAKE) BOPT=$(BOPT) PETSC_ARCH=$(PETSC_ARCH) ACTION=libfast tree
27566341c5dSSatish Balay	$(RANLIB) $(PDIR)/libpetscblas.a
27666341c5dSSatish Balay	-@chmod g+w  $(PDIR)/*.a
277229e8d5cSBarry Smith	-@echo "Completed compiling C version of BLAS and LAPACK"
27866341c5dSSatish Balay	-@echo "========================================="
27966341c5dSSatish Balay
280ad96cc0dSLois Curfman McInnes
2818c37ef55SBarry Smithranlib:
2824e04c1a0SBarry Smith	$(RANLIB) $(PDIR)/*.a
28361523587SBarry Smith
28411b6ed10SLois Curfman McInnes# Deletes PETSc libraries
28561523587SBarry Smithdeletelibs:
2864e04c1a0SBarry Smith	-$(RM) -f $(PDIR)/*.a $(PDIR)/complex/* $(PDIR)/c++/*
287d44968ceSBarry Smith
28811b6ed10SLois Curfman McInnes# Deletes man pages (HTML version)
289b346654fSBarry Smithdeletewwwpages:
290dea827f2SLois Curfman McInnes	$(RM) -f $(PETSC_DIR)/docs/www/man*/* $(PETSC_DIR)/docs/www/www.cit \
291dea827f2SLois Curfman McInnes	         $(PETSC_DIR)/docs/www/man*.html
292b346654fSBarry Smith
29311b6ed10SLois Curfman McInnes# Deletes man pages (LaTeX version)
294b346654fSBarry Smithdeletelatexpages:
2957857610eSBarry Smith	$(RM) -f $(PETSC_DIR)/docs/tex/rsum/*sum*.tex
29620563c6bSBarry Smith
2977acb7333SLois Curfman McInnes# To access the tags in emacs, type M-x visit-tags-table and specify
2987acb7333SLois Curfman McInnes# the file petsc/TAGS.	Then, to move to where a PETSc function is
2997acb7333SLois Curfman McInnes# defined, enter M-. and the function name.  To search for a string
3007acb7333SLois Curfman McInnes# and move to the first occurrence, use M-x tags-search and the string.
3017acb7333SLois Curfman McInnes# To locate later occurrences, use M-,
3027acb7333SLois Curfman McInnes
303b38bb785SSatish BalayTAGS_INCLUDE_FILES  = include/*.h include/pinclude/*.h include/FINCLUDE/*.h
304b38bb785SSatish BalayTAGS_BMAKE_FILES    = bmake/common bmake/*/base*
305b38bb785SSatish BalayTAGS_EXAMPLE_FILES  = src/*/examples/*/*.[c,h,F,f] src/*/examples/*/*/*.[c,h,F,f] \
306b38bb785SSatish Balay                      src/benchmarks/*.c src/contrib/*/examples/*/*.[c,h,F,f]
307b38bb785SSatish BalayTAGS_DOC_FILES      = docs/tex/manual/routin.tex docs/tex/manual/manual.tex \
308b38bb785SSatish Balay                      docs/tex/manual/manual_tex.tex docs/tex/manual/intro.tex \
309b38bb785SSatish Balay                      docs/tex/manual/part1.tex docs/tex/manual/part2.tex
3104431cf12SSatish BalayTAGS_SRC_FILES      = src/*/*.[c,h] src/*/interface/*.[c,h] src/*/src/*.[c,h] \
311b38bb785SSatish Balay                      src/*/utils/*.[c,h] \
312b38bb785SSatish Balay                      src/*/impls/*.[c,h] src/*/impls/*/*.[c,h] src/*/impls/*/*/*.[c,h] \
313b334301eSBarry Smith                      src/gvec/impls/*/*/*/*/*.[c,h] src/contrib/*/*.[c,h] \
314b334301eSBarry Smith                      src/contrib/*/src/*.[c,h] src/fortran/custom/*.[c,h,F]
315b38bb785SSatish BalayTAGS_MAKEFILE_FILES = include/makefile include/*/makefile \
316b38bb785SSatish Balay                      makefile \
317b38bb785SSatish Balay                      src/makefile src/*/makefile src/*/src/makefile \
318b38bb785SSatish Balay                      src/*/interface/makefile \
319b38bb785SSatish Balay                      src/*/utils/makefile \
320b38bb785SSatish Balay                      src/*/impls/makefile src/*/impls/*/makefile src/*/impls/*/*/makefile \
321b38bb785SSatish Balay                      src/*/examples/makefile src/*/examples/*/makefile src/*/examples/*/*/makefile \
322b38bb785SSatish Balay                      src/gvec/impls/*/*/*/*/makefile src/gvec/impls/*/*/*/makefile \
323b38bb785SSatish Balay                      src/fortran/*/makefile \
324b38bb785SSatish Balay                      src/contrib/*/makefile src/contrib/*/src/makefile \
325b38bb785SSatish Balay                      src/contrib/*/examples/makefile src/contrib/*/examples/*/makefile \
326b38bb785SSatish Balay                      docs/makefile
327b38bb785SSatish Balay
32811b6ed10SLois Curfman McInnes# Builds all etags files
32911b6ed10SLois Curfman McInnesalletags:
3309ae7ee0fSLois Curfman McInnes	-make etags_complete
33111b6ed10SLois Curfman McInnes	-make etags
33211b6ed10SLois Curfman McInnes	-make etags_noexamples
33311b6ed10SLois Curfman McInnes	-make etags_makefiles
33411b6ed10SLois Curfman McInnes
33511b6ed10SLois Curfman McInnes# Builds the basic etags file.	This should be employed by most users.
33620563c6bSBarry Smithetags:
337edd2f0e1SBarry Smith	$(RM) TAGS
338b38bb785SSatish Balay	etags -f TAGS $(TAGS_INCLUDE_FILES)
339b38bb785SSatish Balay	etags -a -f TAGS $(TAGS_SRC_FILES)
340b38bb785SSatish Balay	etags -a -f TAGS $(TAGS_EXAMPLE_FILES)
341b38bb785SSatish Balay	etags -a -f TAGS $(TAGS_MAKEFILE_FILES)
342b38bb785SSatish Balay	etags -a -f TAGS $(TAGS_BMAKE_FILES)
34328988994SBarry Smith	chmod g+w TAGS
344bfce26a3SBarry Smith
34529cdf679SBarry Smith# Builds complete etags list; only for PETSc developers.
34629cdf679SBarry Smithetags_complete:
34729cdf679SBarry Smith	$(RM) TAGS_COMPLETE
3489ca56a1bSSatish Balay	etags -f TAGS_COMPLETE $(TAGS_SRC_FILES)
3499ca56a1bSSatish Balay	etags -a -f TAGS_COMPLETE $(TAGS_INCLUDE_FILES)
350b38bb785SSatish Balay	etags -a -f TAGS_COMPLETE $(TAGS_EXAMPLE_FILES)
351b38bb785SSatish Balay	etags -a -f TAGS_COMPLETE $(TAGS_MAKEFILE_FILES)
352b38bb785SSatish Balay	etags -a -f TAGS_COMPLETE $(TAGS_BMAKE_FILES)
353b38bb785SSatish Balay	etags -a -f TAGS_COMPLETE $(TAGS_DOC_FILES)
35429cdf679SBarry Smith	chmod g+w TAGS_COMPLETE
35529cdf679SBarry Smith
35611b6ed10SLois Curfman McInnes# Builds the etags file that excludes the examples directories
357bfce26a3SBarry Smithetags_noexamples:
358bfce26a3SBarry Smith	$(RM) TAGS_NO_EXAMPLES
3599ca56a1bSSatish Balay	etags -f TAGS_NO_EXAMPLES $(TAGS_SRC_FILES)
3609ca56a1bSSatish Balay	etags -a -f TAGS_NO_EXAMPLES $(TAGS_INCLUDE_FILES)
361b38bb785SSatish Balay	etags -a -f TAGS_NO_EXAMPLES $(TAGS_MAKEFILE_FILES)
362b38bb785SSatish Balay	etags -a -f TAGS_NO_EXAMPLES $(TAGS_BMAKE_FILES)
363b38bb785SSatish Balay	etags -a -f TAGS_NO_EXAMPLES $(TAGS_DOC_FILES)
364bfce26a3SBarry Smith	chmod g+w TAGS_NO_EXAMPLES
365b16a3bb1SBarry Smith
36611b6ed10SLois Curfman McInnes# Builds the etags file for makefiles
367b16a3bb1SBarry Smithetags_makefiles:
368b16a3bb1SBarry Smith	$(RM) TAGS_MAKEFILES
369b38bb785SSatish Balay	etags -f TAGS_MAKEFILES $(TAGS_MAKEFILE_FILES)
370b38bb785SSatish Balay	etags -a -f TAGS_MAKEFILES $(TAGS_BMAKE_FILES)
371b16a3bb1SBarry Smith	chmod g+w TAGS_MAKEFILES
37211b6ed10SLois Curfman McInnes
373dc80aa23SSatish Balay# Builds the etags file for examples
374dc80aa23SSatish Balayetags_examples:
375dc80aa23SSatish Balay	$(RM) TAGS_EXAMPLES
376dc80aa23SSatish Balay	etags -f TAGS_EXAMPLES $(TAGS_EXAMPLE_FILES)
377dc80aa23SSatish Balay	chmod g+w TAGS_EXAMPLES
378dc80aa23SSatish Balay
379b38bb785SSatish Balay#
380b38bb785SSatish Balay# ctags builds the tags file required for VI.
381b38bb785SSatish Balay# To use the tags file do the following:
382b38bb785SSatish Balay# 1. within vi invole the command - :set tags=/home/bsmith/petsc/tags
383b38bb785SSatish Balay#    or add  the command to your ~/.exrc file - set tags=/home/bsmith/petsc/tags
384b38bb785SSatish Balay# 2. now to go to a tag do - :tag TAGNAME for eg - :tag MatCreate
385b38bb785SSatish Balay#
386b38bb785SSatish Balayctags:
387b38bb785SSatish Balay	$(RM) tags
388b8319b70SSatish Balay	ctags -w -f tags $(TAGS_INCLUDE_FILES)
389b8319b70SSatish Balay	ctags -w -a -f tags $(TAGS_SRC_FILES)
390b38bb785SSatish Balay	ctags -w -a -f tags $(TAGS_EXAMPLE_FILES)
391b38bb785SSatish Balay	ctags -w -a -f tags $(TAGS_MAKEFILE_FILES)
392b38bb785SSatish Balay	ctags -w -a -f tags $(TAGS_BMAKE_FILES)
393b38bb785SSatish Balay	chmod g+w tags
394b38bb785SSatish Balay
39511b6ed10SLois Curfman McInnes# ------------------------------------------------------------------
39611b6ed10SLois Curfman McInnes#
39711b6ed10SLois Curfman McInnes# All remaining actions are intended for PETSc developers only.
39811b6ed10SLois Curfman McInnes# PETSc users should not generally need to use these commands.
39911b6ed10SLois Curfman McInnes#
40011b6ed10SLois Curfman McInnes
40111b6ed10SLois Curfman McInnes# Builds all versions of the man pages
402956e605aSBarry Smithallmanpages: allwwwpages alllatexpages
403dea827f2SLois Curfman McInnesallwwwpages: deletewwwpages
404299192b9SLois Curfman McInnes	-make ACTION=wwwpages_buildcite tree
405c3e30b67SBarry Smith	-cd src/fortran/custom; make wwwpages_buildcite
406c3e30b67SBarry Smith	-cd src/fortran/custom; make wwwpages
407dea827f2SLois Curfman McInnes	-make ACTION=wwwpages tree
408dea827f2SLois Curfman McInnes	-maint/wwwman
4099921e35aSSatish Balay	-maint/examplesindex.tcl -www
410f8cfbf3fSSatish Balay	-maint/htmlkeywords.tcl
41151c61065SBarry Smith	-@chmod g+w docs/www/man*/*
412e01137a2SSatish Balay
413e01137a2SSatish Balay#This is similar to allwwwpages except -www -> -wwwhome
414e01137a2SSatish Balay#The wwwmanpages built this way can pe placed at PETSc Home Page
415e01137a2SSatish Balayallwwwhomepages: deletewwwpages
416e01137a2SSatish Balay	-make ACTION=wwwpages_buildcite tree
417e01137a2SSatish Balay	-cd src/fortran/custom; make wwwpages_buildcite
418e01137a2SSatish Balay	-cd src/fortran/custom; make wwwpages
419e01137a2SSatish Balay	-make ACTION=wwwpages tree
420e01137a2SSatish Balay	-maint/wwwman
421e01137a2SSatish Balay	-maint/examplesindex.tcl -wwwhome
42284047b72SSatish Balay	-maint/htmlkeywords.tcl -wwwhome
423e01137a2SSatish Balay	-@chmod g+w docs/www/man*/*
424e01137a2SSatish Balay
425416022c9SBarry Smithalllatexpages: deletelatexpages
426416022c9SBarry Smith	-make ACTION=latexpages tree
427c3e30b67SBarry Smith	-cd src/fortran/custom; make latexpages
42851c61065SBarry Smith	-@chmod g+w docs/tex/rsum/*
429416022c9SBarry Smith
43011b6ed10SLois Curfman McInnes# Builds Fortran stub files
43111b6ed10SLois Curfman McInnesallfortranstubs:
43235aab85fSBarry Smith	-@include/finclude/generateincludes
4330a0eb2c5SBarry Smith	-@$(RM) -f src/fortran/auto/*.c
43411b6ed10SLois Curfman McInnes	-make ACTION=fortranstubs tree
4350a0eb2c5SBarry Smith	chmod g+w src/fortran/auto/*.c
436f6ff2982SSatish Balay
437d55938c2SBarry Smithallci:
438d55938c2SBarry Smith	-@cd src/fortran/custom ; $(OMAKE) BOPT=$(BOPT) ci
439b951964fSBarry Smith	-@$(OMAKE) BOPT=$(BOPT) PETSC_ARCH=$(PETSC_ARCH) ACTION=ci  tree
440b951964fSBarry Smith
441d55938c2SBarry Smithallco:
442d55938c2SBarry Smith	-@cd src/fortran/custom ; $(OMAKE) BOPT=$(BOPT) co
443d55938c2SBarry Smith	-@$(OMAKE) BOPT=$(BOPT) PETSC_ARCH=$(PETSC_ARCH) ACTION=co  tree
444d55938c2SBarry Smith
445b334301eSBarry Smith#
446b334301eSBarry Smith#   The commands below are for generating ADIC versions of the code;
447b334301eSBarry Smith# they are not currently used.
448b334301eSBarry Smith#
449b334301eSBarry SmithCFLAGS   =  $(CPPFLAGS) $(CONF)
4505eea60f9SBarry Smithalladicignore:
4515eea60f9SBarry Smith	-@$(RM) $(PDIR)/adicignore
4525eea60f9SBarry Smith	-@$(OMAKE) BOPT=$(BOPT) PETSC_ARCH=$(PETSC_ARCH) ACTION=adicignore  tree
4535eea60f9SBarry Smith
4545eea60f9SBarry Smithalladic:
455d18b0ea7SBarry Smith	-@echo "Beginning to compile ADIC source code in all directories"
456d18b0ea7SBarry Smith	-@echo "Using ADIC compiler: $(ADIC_CC) $(CFLAGS)"
457d18b0ea7SBarry Smith	-@echo "========================================="
45847794344SBarry Smith	-@cd include ; \
459f218b1c0SBarry Smith           $(ADIC_CC) -s -f 1 $(CFLAGS) petsc.h
460ba8edd79SBarry Smith	-@$(OMAKE) BOPT=$(BOPT) PETSC_ARCH=$(PETSC_ARCH) ACTION=adic  tree
46147794344SBarry Smith	-@cd src/inline ; \
46247794344SBarry Smith            $(OMAKE) BOPT=$(BOPT) PETSC_ARCH=$(PETSC_ARCH) adic
4637e351921SBarry Smith	-@cd src/adic/blas ; \
4647e351921SBarry Smith            $(OMAKE) BOPT=$(BOPT) PETSC_ARCH=$(PETSC_ARCH) adic
4657e351921SBarry Smith	-@cd src/adic/lapack ; \
466e1063516SSatish Balay            $(OMAKE) BOPT=$(BOPT) PETSC_ARCH=$(PETSC_ARCH) ACTION=adic  tree
4676e81b665SBarry Smith
46847794344SBarry Smithalladiclib:
469d18b0ea7SBarry Smith	-@echo "Beginning to compile ADIC libraries in all directories"
470d18b0ea7SBarry Smith	-@echo "Using compiler: $(CC) $(COPTFLAGS)"
471d18b0ea7SBarry Smith	-@echo "-----------------------------------------"
472d18b0ea7SBarry Smith	-@echo "Using PETSc flags: $(PETSCFLAGS) $(PCONF)"
473d18b0ea7SBarry Smith	-@echo "-----------------------------------------"
474d18b0ea7SBarry Smith	-@echo "Using configuration flags: $(CONF)"
475d18b0ea7SBarry Smith	-@echo "-----------------------------------------"
476d18b0ea7SBarry Smith	-@echo "Using include paths: $(PETSC_INCLUDE)"
477d18b0ea7SBarry Smith	-@echo "-----------------------------------------"
478d18b0ea7SBarry Smith	-@echo "Using PETSc directory: $(PETSC_DIR)"
479d18b0ea7SBarry Smith	-@echo "Using PETSc arch: $(PETSC_ARCH)"
480d18b0ea7SBarry Smith	-@echo "========================================="
481f218b1c0SBarry Smith	-@$(RM) -f  $(PDIR)/*adic.a
48247794344SBarry Smith	-@$(OMAKE) BOPT=$(BOPT) PETSC_ARCH=$(PETSC_ARCH) ACTION=adiclib  tree
4837e351921SBarry Smith	-@cd src/adic/blas ; \
4847e351921SBarry Smith            $(OMAKE) BOPT=$(BOPT) PETSC_ARCH=$(PETSC_ARCH) adiclib
4857e351921SBarry Smith	-@cd src/adic/lapack ; \
486e1063516SSatish Balay            $(OMAKE) BOPT=$(BOPT) PETSC_ARCH=$(PETSC_ARCH) ACTION=adiclib  tree
4877e351921SBarry Smith	-@cd src/adic/src ; \
488cb3b3f49SBarry Smith            $(OMAKE) BOPT=$(BOPT) PETSC_ARCH=$(PETSC_ARCH) lib
4895eea60f9SBarry Smith
4909e417c50SSatish Balay# -------------------------------------------------------------------------------
4919e417c50SSatish Balay#
4929e417c50SSatish Balay# Some macros to check if the fortran interface is up-to-date.
4939e417c50SSatish Balay#
4949e417c50SSatish Balaycountfortranfunctions:
4959e417c50SSatish Balay	-@cd $(PETSC_DIR)/src/fortran; egrep '^void' custom/*.c auto/*.c | \
4969e417c50SSatish Balay	cut -d'(' -f1 | tr -s '' ' ' | cut -d' ' -f2 | uniq | egrep -v "(^$$|Petsc)" | \
4979e417c50SSatish Balay	sed "s/_$$//" | sort > /tmp/countfortranfunctions
498b334301eSBarry Smith
4999e417c50SSatish Balaycountcfunctions:
5009e417c50SSatish Balay	-@ grep extern $(PETSC_DIR)/include/*.h *.h | grep "(" | tr -s '' ' ' | \
5019e417c50SSatish Balay	cut -d'(' -f1 | cut -d' ' -f3 | grep -v "\*" | tr -s '' '\012' |  \
5029e417c50SSatish Balay	tr 'A-Z' 'a-z' |  sort > /tmp/countcfunctions
5039e417c50SSatish Balay
5049e417c50SSatish Balaydifffortranfunctions: countfortranfunctions countcfunctions
5059e417c50SSatish Balay	-@echo -------------- Functions missing in the fortran interface ---------------------
5069e417c50SSatish Balay	-@diff /tmp/countcfunctions /tmp/countfortranfunctions | grep "^<" | cut -d' ' -f2
5079e417c50SSatish Balay	-@echo ----------------- Functions missing in the C interface ------------------------
5089e417c50SSatish Balay	-@diff /tmp/countcfunctions /tmp/countfortranfunctions | grep "^>" | cut -d' ' -f2
5099e417c50SSatish Balay	-@$(RM)  /tmp/countcfunctions /tmp/countfortranfunctions
510b334301eSBarry Smith
5113f4c9a3aSSatish Balaycheckbadfortranstubs:
5123f4c9a3aSSatish Balay	-@echo "========================================="
5133f4c9a3aSSatish Balay	-@echo "Functions with MPI_Comm as an Argument"
5143f4c9a3aSSatish Balay	-@echo "========================================="
5153f4c9a3aSSatish Balay	-@cd $(PETSC_DIR)/src/fortran/auto; grep '^void' *.c | grep 'MPI_Comm' | \
5163f4c9a3aSSatish Balay	tr -s '' ' ' | tr -s ':' ' ' |cut -d'(' -f1 | cut -d' ' -f1,3
5173f4c9a3aSSatish Balay	-@echo "========================================="
5183f4c9a3aSSatish Balay	-@echo "Functions with a String as an Argument"
5193f4c9a3aSSatish Balay	-@echo "========================================="
5203f4c9a3aSSatish Balay	-@cd $(PETSC_DIR)/src/fortran/auto; grep '^void' *.c | grep 'char \*' | \
5213f4c9a3aSSatish Balay	tr -s '' ' ' | tr -s ':' ' ' |cut -d'(' -f1 | cut -d' ' -f1,3
5223f4c9a3aSSatish Balay	-@echo "========================================="
5233f4c9a3aSSatish Balay	-@echo "Functions with Pointers to PETSc Objects as Argument"
5243f4c9a3aSSatish Balay	-@echo "========================================="
5253f4c9a3aSSatish Balay	-@cd $(PETSC_DIR)/src/fortran/auto; \
5263f4c9a3aSSatish Balay	_p_OBJ=`grep _p_ $(PETSC_DIR)/include/*.h | tr -s '' ' ' | \
5273f4c9a3aSSatish Balay	cut -d' ' -f 3 | tr -s '' '\012' | grep -v '{' | cut -d'*' -f1 | \
5283f4c9a3aSSatish Balay	sed "s/_p_//g" | tr -s '\012 ' ' *|' ` ; \
5293f4c9a3aSSatish Balay	for OBJ in $$_p_OBJ; do \
5303f4c9a3aSSatish Balay	grep "$$OBJ \*" *.c | tr -s '' ' ' | tr -s ':' ' ' | \
5313f4c9a3aSSatish Balay	cut -d'(' -f1 | cut -d' ' -f1,3; \
5323f4c9a3aSSatish Balay	done
533