Compiler options - Revision history

Huebsch at 14:37, 20 February 2024

2024-02-20T14:37:27Z

← Older revision		Revision as of 14:37, 20 February 2024
Line 85:		Line 85:
	----		----

	[[Category:VASP]][[Category:Installation]][[Category:Performance]][[Category:GPU~~]][[Category:VASP6~~]]		[[Category:VASP]][[Category:Installation]][[Category:Performance]][[Category:GPU]]

Ftran at 08:21, 20 October 2023

2023-10-20T08:21:31Z

← Older revision		Revision as of 08:21, 20 October 2023
Line 84:		Line 84:

	----		----
	~~[[The_VASP_Manual\|Contents]]~~

	[[Category:VASP]][[Category:Installation]][[Category:Performance]][[Category:GPU]][[Category:VASP6]]		[[Category:VASP]][[Category:Installation]][[Category:Performance]][[Category:GPU]][[Category:VASP6]]

Vaspmaster at 14:54, 7 April 2022

2022-04-07T14:54:42Z

← Older revision		Revision as of 14:54, 7 April 2022
Line 72:		Line 72:
	SOURCE_O1 =		SOURCE_O1 =
	OBJECTS_O1 = .. your list of objects ..		OBJECTS_O1 = .. your list of objects ..

			== Related articles ==
			[[Installing VASP.6.X.X]],
			[[makefile.include]],
			[[Precompiler options]],
			[[Linking to libraries]],
			[[OpenACC GPU port of VASP]],
			[[Toolchains]],
			[[Validation tests]],
			[[Known issues]]

	----		----
	[[The_VASP_Manual\|Contents]]		[[The_VASP_Manual\|Contents]]

	[[Category:VASP]]		[[Category:VASP]][[Category:Installation]][[Category:Performance]][[Category:GPU]][[Category:VASP6]]
	[[Category:Installation]]

Huebsch: Huebsch moved page Construction:Compiler options to Compiler options without leaving a redirect

2022-01-20T11:29:56Z

Huebsch moved page Construction:Compiler options to Compiler options without leaving a redirect

← Older revision	Revision as of 11:29, 20 January 2022
(No difference)

Huebsch at 11:06, 20 January 2022

2022-01-20T11:06:02Z

@@ Line 37: / Line 37: @@
 :*Using gfortran:
 :<pre>FREE=-ffree-form -ffree-line-length-none</pre>
 = Special rules =
 The current <code>src/makefile</code> contains a set of recipes to allow for the compilation of objects at different levels of optimization other than the general level specified by <code>OFLAG</code>.

Huebsch at 09:46, 20 January 2022

2022-01-20T09:46:15Z

← Older revision		Revision as of 09:46, 20 January 2022
Line 1:		Line 1:
	The compiler options ~~specify~~ by compiler variables that set the compiler and compiler flags ~~you want to use~~. The Fortran compiler will then be invoked as:		The compiler options are specified by compiler variables that set the compiler and compiler flags. The Fortran compiler will then be invoked as:

	$(FC) $(FREE) $(FFLAGS) $(OFLAG) $(INCS)		$(FC) $(FREE) $(FFLAGS) $(OFLAG) $(INCS)
Line 37:		Line 37:
	:*Using gfortran:		:*Using gfortran:
	:<pre>FREE=-ffree-form -ffree-line-length-none</pre>		:<pre>FREE=-ffree-form -ffree-line-length-none</pre>


	= Special rules =		= Special rules =
	The current <code>src/makefile</code> contains a set of recipes to allow for the compilation of objects at different levels of optimization (other than the general level specified by <code>OFLAG</code>).		The current <code>src/makefile</code> contains a set of recipes to allow for the compilation of objects at different levels of optimization other than the general level specified by <code>OFLAG</code>.
	In these recipes the compiler will be invoked as:		In these recipes, the compiler will be invoked as:
	$(FC) $(FREE) $(FFLAGS_x) $(OFLAG_x) $(INCS_x)		$(FC) $(FREE) $(FFLAGS_x) $(OFLAG_x) $(INCS_x)

Line 55:		Line 53:
	:Default: <code>INCS_x=$(INCS)</code>, for x=1, 2, 3, and IN.		:Default: <code>INCS_x=$(INCS)</code>, for x=1, 2, 3, and IN.

	The objects to be compiled in accordance with these recipes have to be specified by means of the variables:~~<br />~~		The objects to be compiled in accordance with these recipes have to be specified by means of the variables: <code>OBJECTS_O1</code>, <code>OBJECTS_O2</code>, <code>OBJECTS_O3</code>, <code>OBJECTS_IN</code>
	<code>OBJECTS_O1</code>, <code>OBJECTS_O2</code>, <code>OBJECTS_O3</code>, <code>OBJECTS_IN</code>

	Several objects are compiled at <code>-O1</code> and <code>-O2</code> by default. These lists of objects are specified in the ~~<tt>~~path/to/vasp.X.X.X/src/.objects~~</tt>~~ file through the variables:~~<br />~~		Several objects are compiled at <code>-O1</code> and <code>-O2</code> by default. These lists of objects are specified in the '''/path/to/vasp.X.X.X/src/.objects''' file through the variables: <code>SOURCE_O1</code>, <code>SOURCE_O2</code>, <code>SOURCE_IN</code>.
	<code>SOURCE_O1</code>, <code>SOURCE_O2</code>, <code>SOURCE_IN</code>

	~~and reflect~~ the special rules ~~as they were present in most of~~ the ~~makefiles~~ of ~~the old build system~~.		To completely overrule a default setting (for instance for the <code>-O1</code> special rules) you can use the following construct:
			SOURCE_O1 =
			OBJECTS_O1 = .. your list of objects ..

	~~To completely overrule a default setting (for instance for the <code>~~-~~O1</code> special rules) you can use the following construct~~:		----
	~~SOURCE_O1 =~~		[[The_VASP_Manual\|Contents]]
	~~OBJECTS_O1= .. your list of objects ..~~
			[[Category:VASP]]
			[[Category:Installation]]

Huebsch: Created page with "The compiler options specify by compiler variables that set the compiler and compiler flags you want to use. The Fortran compiler will then be invoked as: $(FC) $(FREE) $(FF..."

2022-01-19T16:28:00Z

Created page with "The compiler options specify by compiler variables that set the compiler and compiler flags you want to use. The Fortran compiler will then be invoked as: $(FC) $(FREE) $(FF..."

New page

The compiler options specify by compiler variables that set the compiler and compiler flags you want to use. The Fortran compiler will then be invoked as:

$(FC) $(FREE) $(FFLAGS) $(OFLAG) $(INCS)

= Compiler variables =
=== FC ===
:The command to invoke your Fortran compiler (e.g. <code>gfortran</code>, <code>ifort</code>, <code>mpif90</code>, <code>mpiifort</code>, ... ).

=== FCL ===
:The command that invokes the linker. In most cases:
:<pre>FCL=$(FC) [+ some options]</pre>

=== OFLAG ===
:The general level of optimization (default: <code>OFLAG=-O2</code>).

=== FFLAGS ===
:Additional compiler flags. To enable debugging, for instance, the following line could be added:
:<pre>FFLAGS+=-g </pre>

=== OFLAG_IN ===
:(default: <code>-O2</code>) In the vast majority of <code>makefile.include</code> files this variable is set:
:<pre>OFLAG_IN=$(OFLAG)</pre>

=== DEBUG ===
:The optimization level with which the main program (main.F) will be compiled, usually:
:<pre>DEBUG=-O0</pre>

=== INCS ===
:Use this variable to specify objects to be included in the sense of:
:<pre>INCS=-I/path/to/directory-with-files-to-be-included</pre>

=== FREE ===
:Specify the options that your Fortran compiler needs for it to accept free-form source layout, without line-length limitation. For instance:
:*Using Intel's Fortran compiler:
:<pre>FREE=-free -names lowercase</pre>

:*Using gfortran:
:<pre>FREE=-ffree-form -ffree-line-length-none</pre>

= Special rules =
The current <code>src/makefile</code> contains a set of recipes to allow for the compilation of objects at different levels of optimization (other than the general level specified by <code>OFLAG</code>).
In these recipes the compiler will be invoked as:
$(FC) $(FREE) $(FFLAGS_x) $(OFLAG_x) $(INCS_x)

where <code>x</code> stands for: 1, 2, 3, or IN.

=== FFLAGS_x ===
:Default: <code>FFLAGS_x=$(FFLAGS)</code>, for x=1, 2, 3, and IN.

=== OFLAG_x ===
:Default: <code>OFLAG_x=-Ox</code> (for x=1, 2, 3), and <code>OFLAG_IN=-O2</code>

=== INCS_x ===
:Default: <code>INCS_x=$(INCS)</code>, for x=1, 2, 3, and IN.

The objects to be compiled in accordance with these recipes have to be specified by means of the variables:<br />
<code>OBJECTS_O1</code>, <code>OBJECTS_O2</code>, <code>OBJECTS_O3</code>, <code>OBJECTS_IN</code>

Several objects are compiled at <code>-O1</code> and <code>-O2</code> by default. These lists of objects are specified in the <tt>path/to/vasp.X.X.X/src/.objects</tt> file through the variables:<br />
<code>SOURCE_O1</code>, <code>SOURCE_O2</code>, <code>SOURCE_IN</code>

and reflect the special rules as they were present in most of the makefiles of the old build system.

To completely overrule a default setting (for instance for the <code>-O1</code> special rules) you can use the following construct:
SOURCE_O1 =
OBJECTS_O1= .. your list of objects ..