Can I pass variables to a GNU Makefile as command line arguments? In other words, I want to pass some arguments which will eventually become variables in the Makefile.
8 Answers
You have several options to set up variables from outside your makefile:
From environment - each environment variable is transformed into a makefile variable with the same name and value.
You may also want to set
-e
option (aka--environments-override
) on, and your environment variables will override assignments made into makefile (unless these assignments themselves use theoverride
directive . However, it's not recommended, and it's much better and flexible to use?=
assignment (the conditional variable assignment operator, it only has an effect if the variable is not yet defined):FOO?=default_value_if_not_set_in_environment
Note that certain variables are not inherited from environment:
MAKE
is gotten from name of the scriptSHELL
is either set within a makefile, or defaults to/bin/sh
(rationale: commands are specified within the makefile, and they're shell-specific).
From command line -
make
can take variable assignments as part of his command line, mingled with targets:make target FOO=bar
But then all assignments to
FOO
variable within the makefile will be ignored unless you use theoverride
directive in assignment. (The effect is the same as with-e
option for environment variables).Exporting from the parent Make - if you call Make from a Makefile, you usually shouldn't explicitly write variable assignments like this:
# Don't do this! target: $(MAKE) -C target CC=$(CC) CFLAGS=$(CFLAGS)
Instead, better solution might be to export these variables. Exporting a variable makes it into the environment of every shell invocation, and Make calls from these commands pick these environment variable as specified above.
# Do like this CFLAGS=-g export CFLAGS target: $(MAKE) -C target
You can also export all variables by using
export
without arguments.
-
21to pass from command line somthing with spaces do
make A='"as df"'
Commented Jan 16, 2013 at 17:27 -
7Seems like you're asking for trouble if you care about environment variables. For one thing, it's a debugging nightmare if it works in place A and not in place B, just because they have different environments. Commented Jan 30, 2013 at 1:00
-
18Just based on experience, exporting stuff like CFLAGS is a recipe for nightmare for large projects. Large projects often have 3rd party libraries that only compile with a given set of flags (that no one bothers fixing). If you export CFLAGS, your project's CFLAGS ends up overriding the 3rd party library's and triggers compile errors. An alternate way might be to define
export PROJECT_MAKE_ARGS = CC=$(CC) CFLAGS=$(CFLAGS)
and pass it along asmake -C folder $(PROJECT_MAKE_FLAGS)
. If there's a way to tell the library's makefile to ignore the environment, that'd be ideal (opposite of -e).– R.D.Commented Mar 17, 2014 at 7:09 -
38WARNING: In the section "Exporting from the parent Make" above, "Don't do this!" is critically misleading. Passing variables on the command line overrides assignments in the sub-makefile but exported variables do not override assignments in the sub-makefile. These two methods for passing variables to a sub-makefile are not equivalent and should not be confused. Commented Aug 17, 2015 at 5:28
-
14
The simplest way is:
make foo=bar target
Then in your makefile you can refer to $(foo)
. Note that this won't propagate to sub-makes automatically.
If you are using sub-makes, see this article: Communicating Variables to a Sub-make
-
3by sub-makes you mean to the makefiles
included
in the main makefile?– PabloCommented May 13, 2010 at 10:49 -
2@Michael: It means calling make again from inside the makefile. I've updated my answer since you seem to be interested in this detail. Commented May 13, 2010 at 10:54
-
4"Note that this won't propagate to sub-makes automatically." Untrue! "By default, only variables that came from the environment or the command line are passed to recursive invocations. You can use the export directive to pass other variables." gnu.org/software/make/manual/html_node/… Commented Jul 31, 2018 at 1:10
-
3
-
1
Say you have a makefile like this:
action:
echo argument is $(argument)
You would then call it make action argument=something
-
8so the target and arguments can be interchanged in terms of position?– PabloCommented May 13, 2010 at 10:40
-
8
-
3I love this answer. It's concise and very informative. Precisely what I was looking for. Thank you Commented Aug 27, 2021 at 9:51
It seems command args overwrite environment variable.
Makefile:
send:
echo $(MESSAGE1) $(MESSAGE2)
Example run:
$ MESSAGE1=YES MESSAGE2=NG make send MESSAGE2=OK
echo YES OK
YES OK
From the manual:
Variables in make can come from the environment in which make is run. Every environment variable that make sees when it starts up is transformed into a make variable with the same name and value. However, an explicit assignment in the makefile, or with a command argument, overrides the environment.
So you can do (from bash):
FOOBAR=1 make
resulting in a variable FOOBAR
in your Makefile.
-
2The other way is indeed better in nearly all cases. I'll leave this here for completeness.– ThomasCommented May 13, 2010 at 10:58
-
4This is the only answer which shows the assignment of variables before the make command on the same line - it's worth knowing this isn't a syntax error.– M_MCommented Apr 1, 2020 at 20:23
-
5The nuance to understand is that with the assignment in front you're setting an environment variable for the make subprocess. With the assignment after the target you're passing an argument to make and it is parsing it and it will override what's set in your environment. Commented Jan 28, 2022 at 18:48
There's another option not cited here which is included in the GNU Make book by Stallman and McGrath (see http://www.chemie.fu-berlin.de/chemnet/use/info/make/make_7.html). It provides the example:
archive.a: ...
ifneq (,$(findstring t,$(MAKEFLAGS)))
+touch archive.a
+ranlib -t archive.a
else
ranlib archive.a
endif
It involves verifying if a given parameter appears in MAKEFLAGS
. For example .. suppose that you're studying about threads in c++11 and you've divided your study across multiple files (class01
, ... , classNM
) and you want to: compile then all and run individually or compile one at a time and run it if a flag is specified (-r
, for instance). So, you could come up with the following Makefile
:
CXX=clang++-3.5
CXXFLAGS = -Wall -Werror -std=c++11
LDLIBS = -lpthread
SOURCES = class01 class02 class03
%: %.cxx
$(CXX) $(CXXFLAGS) -o [email protected] $^ $(LDLIBS)
ifneq (,$(findstring r, $(MAKEFLAGS)))
./[email protected]
endif
all: $(SOURCES)
.PHONY: clean
clean:
find . -name "*.out" -delete
Having that, you'd:
- build and run a file w/
make -r class02
; - build all w/
make
ormake all
; - build and run all w/
make -r
(suppose that all of them contain some certain kind of assert stuff and you just want to test them all)
-
That url is no longer valid; a pdf of the full book is available at: gnu.org/software/make/manual/make.pdf That section Ciro quoted is in Chapter 7 on page 89. Commented yesterday
If you make a file called Makefile and add a variable like this $(unittest) then you will be able to use this variable inside the Makefile even with wildcards
example :
make unittest=*
I use BOOST_TEST and by giving a wildcard to parameter --run_test=$(unittest) then I will be able to use regular expression to filter out the test I want my Makefile to run