Common GNU makefile directory path

Makefile

Makefile Problem Overview


I'm trying to consolidate some build information by using a common makefile. My problem is that I want to use that makefile from different subdirectory levels, which makes the working directory value (pwd) unpredictable. For example:

# Makefile.common
TOP := $(shell pwd)
COMPONENT_DIR := $(TOP)/component
COMPONENT_INC := $(COMPONENT_DIR)/include
COMPONENT_LIB := $(COMPONENT_DIR)/libcomponent.a

If I include Makefile.common from a subdirectory, like so, the $(TOP) directory is incorrect and everything else follows suit:

# other_component/Makefile
include ../Makefile.common
# $(COMPONENT_LIB) is incorrectly other_component/component

What's the best way to get Makefile.common to use its own directory path instead of the more fickle pwd?

Makefile Solutions


Solution 1 - Makefile

You should be able to use the MAKEFILE_LIST variable, like this:

# This must be the first line in Makefile.common
TOP := $(dir $(firstword $(MAKEFILE_LIST)))

From the documentation: >As make reads various makefiles, including any obtained from the MAKEFILES variable, the command line, the default files, or from include directives, their names will be automatically appended to the MAKEFILE_LIST variable. They are added right before make begins to parse them. This means that if the first thing a makefile does is examine the last word in this variable, it will be the name of the current makefile. Once the current makefile has used include, however, the last word will be the just-included makefile.

Solution 2 - Makefile

This isn't good style because it adds another dependency (i.e. the realpath binary). Depending on your use case, that may be acceptable.

ROOT_DIR := $(shell dirname $(realpath $(lastword $(MAKEFILE_LIST))))

If you don't have realpath installed:

$ sudo apt-get install realpath # on debian and derivatives

Edit: Be sure to use := instead of = because the latter causes make to use late-binding and MAKEFILE_LIST may have changed due to later includes.

Solution 3 - Makefile

Have you tried doing:

# Makefile.common
TOP ?= $(shell pwd)
COMPONENT_DIR := $(TOP)/component
COMPONENT_INC := $(COMPONENT_DIR)/include
COMPONENT_LIB := $(COMPONENT_DIR)/libcomponent.a

# other_component/Makefile
TOP ?= ..
include ../Makefile.common

Using the ?= construct will keep TOP from being redefined if it is already set. You can set it to the appropriate value based on where you are in the tree when you invoke make. I confess it's been awhile since I've used GNU make so this may not work or may need some tweaks.

Solution 4 - Makefile

write the common stuff in common.mk. Then put the common.mk in the default directories that Make looks for when it encounters an include statement. See the manual for common directories Make looks for.

You could also put the common.mk in custom directory, and then type make -I customdir.

Inside the Makefile in each subfolder, you do

include common.mk

That is all. No need to worry about path and moving things around.

Solution 5 - Makefile

My solution:

cwd  :=  $(shell readlink -en $(dir $(word $(words $(MAKEFILE_LIST)),$(MAKEFILE_LIST)))) 

This also works for calls like make -f /opt/some/dir/Makefile whenn your in /opt/other/path/subdir.

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
QuestioncdlearyView Question on Stackoverflow
Solution 1 - MakefileJesperEView Answer on Stackoverflow
Solution 2 - MakefileBillView Answer on Stackoverflow
Solution 3 - MakefiletvanfossonView Answer on Stackoverflow
Solution 4 - MakefileRobert HView Answer on Stackoverflow
Solution 5 - MakefileMegaSoftView Answer on Stackoverflow