Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

Alias target name in Makefile

The Problem:

Is it possible to give a target a different name or alias, such that it can be invoked using either the original target name or the alias.

For example something like

/very/long/path/my_binary: dep_a dep_b dep_c
    # Compile

# Desired command
ALIAS my_binary = /very/long/path/my_binary

# NOTE: Notice the use of 'my_binary' in the dependencies
data1: my_binary datafile
    # Build data file using compiled my_binary

Attempt 1: .PHONY

I have tried using a .PHONY target:

.PHONY: my_binary
my_binary: /very/long/path/my_binary

This works great when invoked from the command-line:

# Runs rule 'my_binary' and then *only* runs rule '/very/long/path/my_binary'
# if the rule '/very/long/path/my_binary' needs updating.
make my_binary

However, this does not work well when the alias my_binary is listed as a dependency:

# *Always* thinks that rule 'data1' needs updating, because it always thinks that
# the .PHONY target 'my_binary' "needs updating". As a result, 'data1' is
# rebuilt every time.
make /very/long/path/my_binary

Possible hack?

A possible hack is to use an empty target as suggested in an answer to this question, but that would require introducing fake files with names corresponding to the alias:

my_binary: /very/long/path/my_binary
    touch my_binary

This will clutter the main directory with files! Placing the fake files in a sub-directory would defeat the purpose, as the alias would have to be referred to as 'directory/my_binary'

like image 328
WaelJ Avatar asked Apr 17 '14 14:04

WaelJ


People also ask

What is $@ in makefile?

$@ is the name of the target being generated, and $< the first prerequisite (usually a source file). You can find a list of all these special variables in the GNU Make manual.

What is a makefile target?

A simple makefile consists of "rules" with the following shape: target ... : dependencies ... command ... ... A target is usually the name of a file that is generated by a program; examples of targets are executable or object files.

What is makefile phony?

PHONY: allows to declare phony targets, so that make will not check them as actual file names: it will work all the time even if such files still exist. You can put several . PHONY: in your Makefile : .


3 Answers

Okay, I needed something similar. The path to my output artifacts were quite long, but I wanted short target names and also benefit easily from bash-completion.

Here is what I'm came up with:

os := [arbitrary long path to an artifact] platform := [arbitrary long path to a differ artifact] packer := [common parts of my packer build command]  .PHONY: all all: $(platform)  .PHONY: platform platform: $(platform)  $(platform): platform.json  $(os)     @$(packer) $<  .PHONY: os os: $(os)  $(os): os.json     @$(packer) $<  .PHONY: clean clean:     rm -fr build/ 

With the Makefile above you can say:

$ make os $ make platform 

Which will be aliases for the long artifact names. I've made the snippet above quite long, because it's important to see the relationships between the .PHONY aliases and the real targets. I hope that works for you.

Note: I did not delete the clean target from the above example, because many people does not make that a .PHONY target. However, semantically it should be.

like image 104
frncmx Avatar answered Sep 17 '22 13:09

frncmx


I don't think there's any way to do it so that you can use the alias from within your makefile as well as the command line, except by creating those temporary files.

Why can't you just set a variable in the makefile, like:

my_binary = /very/long/path/my_binary

then use $(my_binary) everywhere in the makefile? I don't see any point in creating a real alias target for use inside the makefile.

like image 30
MadScientist Avatar answered Sep 19 '22 13:09

MadScientist


I had a somewhat similar need. I wanted users of my makefile to be able to enter any of the following to accomplish the same result, such that the following were effectively synonyms of each other:

make hit list
make hitlist
make hit_list

What I did in my makefile was the following:

hit_list:

        @echo Got here
        <the real recipe goes here>

hit: hit_list
hitlist: hit_list
.PHONY: list
list:
        @echo > /dev/null

Then, when I tested it using any of the commands "make hit list", "make hitlist", or "make hit_list", I got identical results, as intended.

By extension, if one of your targets was the one with the long name but you used this approach whereby a simple short name identified the target with the long name as a prerequisite, I think that you should be able to say "make short_name" and accomplish what you're asking about.

This differs from your Approach 1 in that none of the synonyms is defined as a phony target (considering that "make hit list" is a command to make two targets, the second being effectively a noop), so the complication that you described would not arise.

like image 36
fireblood Avatar answered Sep 19 '22 13:09

fireblood