964

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 8

1072

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 the override 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 script
    • SHELL 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 the override 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.

15
  • 21
    to pass from command line somthing with spaces do make A='"as df"' Commented Jan 16, 2013 at 17:27
  • 7
    Seems 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
  • 18
    Just 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 as make -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
  • 38
    WARNING: 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
    Any difference ? make target FOO=bar make FOO=bar target ?
    – gfan
    Commented Oct 8, 2018 at 7:20
406

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

6
  • 3
    by sub-makes you mean to the makefiles included in the main makefile?
    – Pablo
    Commented 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.
    – Mark Byers
    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
    make target foo=bar also works!! Commented Dec 28, 2021 at 11:18
  • 1
    on windows is set foo=bar && make
    – superbem
    Commented Oct 5, 2022 at 19:53
200

Say you have a makefile like this:

action:
    echo argument is $(argument)

You would then call it make action argument=something

3
  • 8
    so the target and arguments can be interchanged in terms of position?
    – Pablo
    Commented May 13, 2010 at 10:40
  • 8
    @Michael: Yes (see the answer of Mark Byers)
    – nc3b
    Commented May 13, 2010 at 10:42
  • 3
    I love this answer. It's concise and very informative. Precisely what I was looking for. Thank you Commented Aug 27, 2021 at 9:51
47

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
35

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.

3
  • 2
    The other way is indeed better in nearly all cases. I'll leave this here for completeness.
    – Thomas
    Commented May 13, 2010 at 10:58
  • 4
    This 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_M
    Commented Apr 1, 2020 at 20:23
  • 5
    The 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.
    – user615501
    Commented Jan 28, 2022 at 18:48
9

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 or make 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)
1
6

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

4
export ROOT_DIR=<path/value>

Then use the variable, $(ROOT_DIR) in the Makefile.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.