gnu make: list the values of all variables (or "macros") in a particular run

MakefileGnu Make

Makefile Problem Overview


How can I list the current value of all variables (also called macros) in a Makefile when running make?

E.g. if this is in the Makefile:

CUR-DIR := $(shell /bin/pwd)
LOG-DIR := $(CUR-DIR)/make-logs

Then I would like it to tell me:

CUR-DIR = /home/johv/src/test
LOG-DIR = /home/johv/src/test/make-logs

Makefile Solutions


Solution 1 - Makefile

GNU make provides .VARIABLES which holds all global variables' names. However, this includes built-in variables(like MAKEFLAGS). If you have to exclude built-in variables, some filtering like the following might be needed. The following makefile prints user-defined variables(CUR-DIR, LOG-DIR) using info:

VARS_OLD := $(.VARIABLES)
CUR-DIR := $(shell pwd)
LOG-DIR := $(CUR-DIR)/make-logs
$(foreach v,                                        \
  $(filter-out $(VARS_OLD) VARS_OLD,$(.VARIABLES)), \
  $(info $(v) = $($(v))))

(I renamed CURDIR to CUR-DIR because CURDIR seems to be a built-in variable in my system)

Solution 2 - Makefile

I ended up doing it like this:

gmake -pn | grep -A1 "^# makefile"| grep -v "^#\|^--" | sort | uniq > makevars.txt

which gives:

CUR-DIR := /home/johv/src/test
LOG-DIR := /home/johv/src/test/make-logs
MAKEFILE_LIST :=  Makefile
MAKEFLAGS = pn
SHELL = /bin/sh
VARS_OLD := [...]

gmake -pn is really verbose and looks kinda like this:

# environment
GNOME2_PATH = /usr/local:/opt/gnome:/usr:/usr/local:/opt/gnome:/usr
# automatic
@F = $(notdir $@)
# makefile
SHELL = /bin/sh
# default
RM = rm -f

Solution 3 - Makefile

Thanks to @Ise Wisteria, condensed down, this shows all variables, useful for large projects with multiple makefiles (Buildroot).

$(foreach v, $(.VARIABLES), $(info $(v) = $($(v))))

output: BR2_GCC_TARGET_TUNE = "cortex-a8" ...

If you get an error like: insufficient number of arguments (1) to function 'addprefix' this project had some broken variables... I trimmed the list of variables to show, only with a prefix BR2_

$(foreach v, $(filter BR2_%,$(.VARIABLES)), $(info $(v) = $($(v))))

Solution 4 - Makefile

It's also doable without saving all the .VARIABLES and filtering them out.

Moreover, if one of the original .VARIABLES was modified in your makefile, the two most voted answers won't catch it.

Check out $(origin) function. This target filters out and prints all the variables that were defined in a makefile:

print_file_vars:
	$(foreach v, $(.VARIABLES), $(if $(filter file,$(origin $(v))), $(info $(v)=$($(v)))))

I get only a few excess variables this way: CURDIR SHELL MAKEFILE_LIST .DEFAULT_GOAL MAKEFLAGS.

One can replace file with environment or command line to print the respective kinds of variables.

Solution 5 - Makefile

There are a lot of good answers here, but you're going to have problems using $($(v)) if some of your variables are of the recursive flavor. This is why you should use $(value $(v)).

This variation cleans this up a little bit, sorts variables by name and makes the output a bit more readable.

dump:
	$(foreach v, \
		$(shell echo "$(filter-out .VARIABLES,$(.VARIABLES))" | tr ' ' '\n' | sort), \
		$(info $(shell printf "%-20s" "$(v)")= $(value $(v))) \
	)

Solution 6 - Makefile

Thanks to @kevinf for the great idea. I would suggest a minor change to prevent .VARIABLE itself from printing out in the variable list:

$(foreach v, $(filter-out .VARIABLES,$(.VARIABLES)), $(info $(v) = $($(v))))

Solution 7 - Makefile

Thanks to @kevinf for the foreach solution -- if one wants to export this list as a somewhat machine-readable file, one will have a hard time with uneven quotes or newlines when using echo or printf, since Make isn't able to quote the data correctly -- one needs to use the $(file ...) function to write the data to avoid sh/bash complaining about invalid syntax. For example, use this in your rule -- it prints variable name, definition and expanded value:

$(file > $(MAKEFILE_ENV_FILE),)
$(foreach v, $(.VARIABLES), \
    $(file >> $(MAKEFILE_ENV_FILE),$(v)) \
    $(file >> $(MAKEFILE_ENV_FILE),    := $(value $(v))) \
    $(file >> $(MAKEFILE_ENV_FILE),    == $($(v))) \
    $(file >> $(MAKEFILE_ENV_FILE),) \
)

(This will still not allow to always distinguish malicious variables with double newlines from two variables, for this one now add a sufficiently unique separator infront of each Makefile-generated newline just after each comma inside $(file >> NAME,TEXT))

Set MAKEFILE_ENV_FILE to some filename, e.g.:

MAKEFILE_ENV_FILE := $(abspath $(lastword $(MAKEFILE_LIST))).env

Attributions

All content for this solution is sourced from the original question on Stackoverflow.

The content on this page is licensed under the Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license.

Content TypeOriginal AuthorOriginal Content on Stackoverflow
QuestionjohvView Question on Stackoverflow
Solution 1 - MakefileIse WisteriaView Answer on Stackoverflow
Solution 2 - MakefilejohvView Answer on Stackoverflow
Solution 3 - MakefileKevinView Answer on Stackoverflow
Solution 4 - MakefileVictor SergienkoView Answer on Stackoverflow
Solution 5 - MakefileDaniel SantosView Answer on Stackoverflow
Solution 6 - MakefileWiiBoppView Answer on Stackoverflow
Solution 7 - Makefilephi1010View Answer on Stackoverflow