linux中gmake怎么调用

78次阅读
没有评论

共计 13371 个字符,预计需要花费 34 分钟才能阅读完成。

本篇内容主要讲解“linux 中 gmake 怎么调用”,感兴趣的朋友不妨来看看。本文介绍的方法操作简单快捷,实用性强。下面就让丸趣 TV 小编来带大家学习“linux 中 gmake 怎么调用”吧!

在 linux 中,gmake 就是 GUN make,是一种流行的、常用的用于构建 C 语言软件的程序,用于构建 Linux 内核和其他常用的 GNU/Linux 程序和软件库。GNU Make 是一个可以自动运行 shell 命令并帮助执行重复任务的程序;它通常用于将文件转换成其他形式,例如将源代码文件编译成程序或库。

gmake 就是 GUN make,因为在 linux 外的平台上,make 一般被占用了,所以 GUN make 只好叫 gmake 了。

GNU Make 是一种流行的、常用的用于构建 C 语言软件的程序。用于构建 Linux 内核和其他常用的 GNU/Linux 程序和软件库。

大多数嵌入式软件开发人员在职业生涯中的某个时候都会使用 GNU Make,要么使用它来编译小型库,要么构建整个项目。尽管有很多很多的选项可以替代 Make,但是由于它的特性集和广泛的支持,它仍然通常被选择为新软件的构建系统。

什么是 GNU Make?

GNU Make 是一个可以自动运行 shell 命令并帮助执行重复任务的程序。它通常用于将文件转换成其他形式,例如将源代码文件编译成程序或库。

它通过跟踪先决条件和执行命令层次结构来生成目标来实现这一点。

何时选择 Make

Make 适用于构建小型 C / c++ 项目或库,这些项目或库将包含在另一个项目的构建系统中。大多数构建系统都有办法集成基于 make 的子项目。

对于较大的项目,您会发现更现代的构建系统更易于使用。

在以下情况下,我建议使用非 Make 的构建系统:

当正在构建的目标 (或文件) 数量为 (或最终将为) 数百时。需要一个“配置”步骤,它设置和保存变量、目标定义和环境配置。该项目将保持内部或私有,将不需要由终端用户构建。您会发现调试是一项令人沮丧的工作。您需要构建的是跨平台的,可以在 macOS、Linux 和 Windows 上构建。在这些情况下,您可能会发现使用 CMake、Bazel、Meson 或其他现代构建系统是一种更愉快的体验。

调用 Make

运行 make 将从当前目录加载一个名为 Makefile 的文件,并尝试更新默认目标(稍后会详细介绍目标)。

Make 将依次搜索名为 GNUmakefile、makefile 和 makefile 的文件

你可以使用 -f/——file 参数指定一个特定的 makefile:

$ make -f foo.mk 你可以指定任意数量的目标,列出它们作为位置参数:

# 典型目标 $ make clean all 你可以用 - C 参数传递 Make 目录,它会运行 Make,就像它首先被 cd 到那个目录一样。

$ make -C some/sub/directory 有趣的事实:git 也可以和 - C 一起运行,达到同样的效果!

并行调用

如果提供 - j 或 - l 选项,Make 可以并行运行作业。我被告知的一个指导原则是,将作业限制设置为处理器核心数量的 1.5 倍:

#a machine with 4 cores: make -j make -j 有趣的是,我发现使用 -l“负载限制”选项的 CPU 利用率比使用 -j“工作”选项略好。尽管 YMMV !

有几种方法可以通过编程方式找到当前机器的 CPU 计数。一个简单的方法是使用 python multiprocessing.cpu_count()函数来获得支持的系统的线程数量(注意与超线程系统, 这将消耗大量的计算机资源, 但可能是更可取的让让产生无限的工作)。

# 在子 shell 中调用 python 的 cpu_count()函数 make -l (python -c import multiprocessing;print (multiprocessing.cpu_count())”)

并行调用期间的输出

如果 Make 正在并行执行的命令有大量输出,您可能会看到在 stdout 上交错输出。为了处理这个问题,Make 有一个选项——output -sync。

我建议使用——output-sync=recurse,它将在每个目标完成时打印 recipe 的全部输出,而不会分散其他 recipe 输出。

如果 recipe 使用递归 Make,它还将一起输出整个递归 Make 的输出。

对 Makefile 的剖析 Makefile 包含用于生成目标的规则。Makefile 的一些基本组件如下所示:

#Comments are prefixed with the # symbol

#A variable assignment
FOO = hello there!

#A rule creating target test , with test.c as a prerequisite
test: test.c
# The contents of a rule is called the recipe , and is
# typically composed of one or more shell commands.
# It must be indented from the target name (historically with
# tabs, spaces are permitted)

# Using the variable FOO
echo $(FOO)

# Calling the C compiler using a predefined variable naming
# the default C compiler, $(CC)
$(CC) test.c -o test

让我们看看上面例子的每个部分。

变量

变量使用语法 $(FOO),其中 FOO 是变量名。

变量包含纯字符串,因为 Make 没有其他数据类型。附加到一个变量将添加一个空格和新的内容:

FOO = one
FOO += two
# FOO is now one two

FOO = one
FOO = $(FOO)two
# FOO is now onetwo

变量赋值

在 GNU Make 语法中,变量的赋值方式有两种:

右边的表达式是逐字赋值给变量的——这很像 C / c++ 中的宏,在使用变量时对表达式求值:

FOO = 1
BAR = $(FOO)
FOO = 2
# prints BAR=2
$(info BAR=$(BAR))

将一个表达式的结果赋值给一个变量; 表达式在赋值时展开:

FOO = 1
BAR := $(FOO)
FOO = 2
# prints BAR=1
$(info BAR=$(BAR))

注意: 上面的 $(info…)函数用于打印表达式,在调试 makefile 时非常方便!*’

未显式、隐式或未自动设置的变量将计算为空字符串。

环境变量

环境变量被携带到 Make 执行环境中。以下面的 makefile 为例:

$(info YOLO variable = $(YOLO))

如果我们在运行 make 时在 shell 命令中设置了变量 YOLO,我们将设置这个值:

$ YOLO= hello there! make
YOLO variable = hello there!
make: *** No targets.  Stop.

注意:Make 打印“No targets”错误,因为我们的 makefile 没有列出目标!

如果你使用?= 赋值语法,Make 只会在变量没有值的情况下赋值:

Makefile:

# 默认 CC 为 gcc
CC ? = gcc

然后我们可以重写 makefile 中的 $(CC):

$ CC=clang make

另一个常见的模式是允许插入额外的标志。在 makefile 中,我们将追加变量而不是直接赋值给它。

CFLAGS += -Wall

这允许从环境中传入额外的标志:

$ CFLAGS= -Werror=conversion -Werror=double-promotion  make

这是非常有用的!

最重要的变量

变量使用的一个特殊类别称为覆盖变量。使用此命令行选项将覆盖设置在环境中的或 Makefile 中的值!

Makefile:

# any value set elsewhere
YOLO = not overridden
$(info $(YOLO))

命令:

# setting YOLO to different values in the environment + makefile + overriding
# variable, yields the overriding value
$ YOLO= environment set make YOLO= overridden!!
overridden!!
make: *** No targets.  Stop.

有针对性的变量

这些变量仅在 recipe 上下文中可用。它们也适用于任何必备配方!

# set the -g value to CFLAGS
# applies to the prog.o/foo.o/bar.o recipes too!
prog : CFLAGS = -g
prog : prog.o foo.o bar.o
echo $(CFLAGS) # will print -g

隐式变量

这些都是由 Make 预先定义的(除非用同名的任何其他变量类型重写)。一些常见的例子:

$(CC) - the C compiler (gcc)
$(AR) - archive program (ar)
$(CFLAGS) - flags for the C compiler

自动变量

这些是由 Make 设置的特殊变量,在 recipe 上下文中可用。它们对于防止重复的名字很有用(Don t Repeat Yourself)。

一些常见的自动变量:

# $@ : the target name, here it would be test.txt 
test.txt:
echo HEYO $@

# $^ : name of all the prerequisites
all.zip: foo.txt test.txt
# run the gzip command with all the prerequisites $^ , outputting to the
# name of the target, $@
gzip -c $^ $@
See more at: https://www.gnu.org/software/make/manual/html_node/Automatic-Variables.html

目标(目标)

目标是规则语法的左边:

arget: prerequisite
recipe

target 几乎总是命名文件。这是因为 Make 使用最后修改时间来跟踪 target 是否比其 prerequistite 更新或更早,以及是否需要重新构建它!

当调用 Make 时,你可以通过将其指定为位置参数来指定想要构建的 target:

# make the test.txt and all.zip targets
make test.txt all.zip

如果您没有在命令中指定目标,Make 将使用 makefile 中指定的第一个目标,称为“默认目标”(如果需要,也可以覆盖默认目标)。

虚假 phony 目标

有时候设置元目标是很有用的,比如 all, clean, test 等等。在这些情况下,您不希望 Make 检查名为 all/clean 等的文件。

Make 提供.PHONY 目标语法,将目标标记为不指向文件:

假设我们的项目构建了一个程序和一个库 foo 和 foo.a; 如果我们想要 在默认情况下,我们可以创建一个 all 规则来构建两者 .PHONY:all all : foo foo.a

如果你有多个假目标,一个好的模式可能是将每个目标都附加到定义它的.PHONY 中:

# the all rule that builds and tests. Note that it s listed first to make it
# the default rule
.PHONY: all
all: build test

# compile foo.c into a program foo
foo: foo.c
$(CC) foo.c -o foo

# compile foo-lib.c into a library foo.a
foo.a: foo-lib.c
# compile the object file
$(CC) foo-lib.c -c foo-lib.o
# use ar to create a static library containing our object file. using the
# $@ variable here to specify the rule target foo.a
$(AR) rcs $@ foo-lib.o

# a phony rule that builds our project; just contains a prerequisite of the
# library + program
.PHONY: build
build: foo foo.a

# a phony rule that runs our test harness. has the build target as a
# prerequisite! Make will make sure (pardon the pun) the build rule executes
# first
.PHONY: test
test: build
./run-tests.sh

请注意! !. phony 目标总是被认为是过期的,因此 Make 将总是运行这些目标的配方 (因此也运行任何具有. phony 先决条件的目标!) 小心使用! !

隐式规则

隐含规则由 Make 提供。我发现使用它们会让人感到困惑,因为在幕后发生了太多的行为。你偶尔会在野外遇到它们,所以要小心。

# this will compile test.c with the default $(CC), $(CFLAGS), into the program
# test . it will handle prerequisite tracking on test.c
test: test.o

模式的规则

模式规则允许你编写一个通用规则,通过模式匹配应用于多个目标:

# Note the use of the $ automatic variable, specifying the first
# prerequisite, which is the .c file
%.o: %.c
$(CC) -c $ -o $@

or

OBJ_FILES = foo.o bar.o

# Use CC to link foo.o + bar.o into program . Note the use of the $^
# automatic variable, specifying ALL the prerequisites (all the OBJ_FILES)
# should be part of the link command
program: $(OBJ_FILES)
   $(CC) -o $@ $^

先决条件

如上所述,Make 将在运行规则之前检查这些目标。它们可以是文件或其他目标。

如果任何先决条件比目标更新(修改时间),Make 将运行目标规则。

在 C 项目中,你可能有一个将 C 文件转换为目标文件的规则,如果 C 文件发生变化,你希望目标文件重新生成:

foo.o: foo.c
# use automatic variables for the input and output file names
$(CC) $^ -c $@

自动的先决条件

对于 C 语言项目来说,一个非常重要的考虑是,如果 C 文件的 #include 头文件发生了变化,那么将触发重新编译。这是通过 gcc/clang 的 - M 编译器标志完成的,它将输出一个.d 文件,然后用 Make include 指令导入。

.d 文件将包含.c 文件的必要先决条件,因此任何头文件的更改都会导致重新构建。

基本形式可能是:

# these are the compiler flags for emitting the dependency tracking file. Note
# the usage of the $ automatic variable
DEPFLAGS = -MMD -MP -MF $ .d

test.o: test.c
   $(CC) $(DEPFLAGS) $ -c $@

# bring in the prerequisites by including all the .d files. prefix the line with
# - to prevent an error if any of the files do not exist
-include $(wildcard *.d)

Order-only 先决条件

这些先决条件只有在不存在的情况下才会构建; 如果它们比目标更新,则不会触发目标重新构建。

典型的用法是为输出文件创建一个目录; 将文件发送到目录将更新其 mtime 属性,但我们不希望由此触发重新构建。

OUTPUT_DIR = build

# output the .o to the build directory, which we add as an order-only
# prerequisite- anything right of the | pipe is considered order-only
$(OUTPUT_DIR)/test.o: test.c | $(OUTPUT_DIR)
$(CC) -c $^ -o $@

# rule to make the directory
$(OUTPUT_DIR):
mkdir -p $@

recipe

“recipe”是创建目标时要执行的 shell 命令列表。它们被传递到子 shell 中(默认为 /bin/sh)。如果 target 在 recipe 运行后更新,则认为规则是成功的(但如果没有更新,则不视为错误)。

foo.txt:
# a simple recipe
echo HEYO $@

如果配方中的任何一行返回非零退出代码,Make 将终止并打印一条错误消息。你可以通过前缀 - 字符来告诉 Make 忽略非零退出码:

.PHONY: clean
clean:
# we don t care if rm fails
-rm -r ./build

在 recipe 行前面加上 @将禁止在执行之前 echo 该行:

clean:
@# this recipe will just print About to clean everything!
@# prefixing the shell comment lines # here also prevents them from
@# appearing during execution
@echo About to clean everything!

Make 会在运行 recipe 上下文中展开变量 / 函数表达式,但不会处理它。如果你想访问 shell 变量,请使用 $:

USER = linus

print-user:
# print out the shell variable $USER
echo $$USER

# print out the make variable USER
echo $(USER)

function

Make 函数的调用语法如下:

$(function-name arguments) 其中 arguments 是用逗号分隔的参数列表。

For example:

FILES=$(wildcard *.c)

# you can combine function calls; here we strip the suffix off of $(FILES) with
# the $(basename) function, then add the .o suffix
O_FILES=$(addsuffix .o,$(basename $(FILES)))

# note that the GNU Make Manual suggests an alternate form for this particular
# operation:
O_FILES=$(FILES:.c=.o)

用户定义函数

reverse = $(2) $(1)

foo = $(call reverse,a,b)

# recursive wildcard (use it instead of $(shell find . -name *.c))
# taken from https://stackoverflow.com/a/18258352
rwildcard=$(foreach d,$(wildcard $1*),$(call rwildcard,$d/,$2) $(filter $(subst *,%,$2),$d))

C_FILES = $(call rwildcard,.,*.c)

shell 函数

你可以让 Make 调用一个 shell 表达式并捕获结果:

TODAYS_DATE=$(shell date –iso-8601)

不过,我在使用这个功能时很谨慎; 它会增加对你使用的任何程序的依赖,所以如果你正在调用更奇特的程序,确保你的构建环境是受控的(例如在容器中或使用 Conda)。

make 的条件表达式

FOO=yolo
ifeq ($(FOO),yolo)
$(info foo is yolo!)
else
$(info foo is not yolo :()
endif

# testing if a variable is set; unset variables are empty
ifneq ($(FOO),)  # checking if FOO is blank
$(info FOO is unset)
endif

# complex conditional
ifeq ($(FOO),yolo)
$(info foo is yolo)
else ifeq ($(FOO), heyo)
$(info foo is heyo)
else
$(info foo is not yolo or heyo :()
endif

make include

sources.mk:

SOURCE_FILES :=
bar.c
foo.c \

Makefile:

include sources.mk

OBJECT_FILES = $(SOURCE_FILES:.c=.o)

%.o: %.c (CC) -c ^ -o $@

make eval

# generate rules for xml- json in some weird world
FILES = $(wildcard inputfile/*.xml)

# create a user-defined function that generates rules
define GENERATE_RULE =
$(eval
# prereq rule for creating output directory
$(1)_OUT_DIR = $(dir $(1))/$(1)_out
$(1)_OUT_DIR:
mkdir -p $@

# rule that calls a script on the input file and produces $@ target
$(1)_OUT_DIR/$(1).json: $(1) | $(1)_OUT_DIR
./convert-xml-to-json.sh $(1) $@
)

# add the target to the all rule
all: $(1)_OUT_DIR/$(1).json
endef

# produce the rules
.PHONY: all
all:

$(foreach file,$(FILES),$(call GENERATE_RULE,$(file)))

请注意,使用 Make 的这个特性的方法可能会让人很困惑,添加一些有用的注释来解释意图是什么,对您未来的自己会很有用!

VPATH

VPATH 是一个特殊的 Make 变量,它包含 Make 在查找先决条件和目标时应该搜索的目录列表。

它可以用来将对象文件或其他派生文件发送到./build 目录中,而不是把 src 目录弄得乱七八糟:

# This makefile should be invoked from the temporary build directory, eg:
# $ mkdir -p build cd ./build make -f ../Makefile

# Derive the directory containing this Makefile
MAKEFILE_DIR = $(shell dirname $(realpath $(firstword $(MAKEFILE_LIST))))

# now inform Make we should look for prerequisites from the root directory as
# well as the cwd
VPATH += $(MAKEFILE_DIR)

SRC_FILES = $(wildcard $(MAKEFILE_DIR)/src/*.c)

# Set the obj file paths to be relative to the cwd
OBJ_FILES = $(subst $(MAKEFILE_DIR)/,,$(SRC_FILES:.c=.o))

# now we can continue as if Make was running from the root directory, and not a
# subdirectory

# $(OBJ_FILES) will be built by the pattern rule below
foo.a: $(OBJ_FILES)
$(AR) rcs $@ $(OBJ_FILES)

# pattern rule; since we added ROOT_DIR to VPATH, Make can find prerequisites
# like `src/test.c` when running from the build directory!
%.o: %.c
# create the directory tree for the output file  
echo $@
mkdir -p $(dir $@)
# compile
$(CC) -c $^ -o $@

touch file

# our tools are stored in tools.tar.gz, and downloaded from a server
TOOLS_ARCHIVE = tools.tar.gz
TOOLS_URL = https://httpbin.org/get

# the rule to download the tools using wget
$(TOOLS_ARCHIVE):
wget $(TOOLS_URL) -O $(TOOLS_ARCHIVE)

# rule to unpack them
tools-unpacked.dummy: $(TOOLS_ARCHIVE)
# running this command results in a directory.. but how do we know it
# completed, without a file to track?
tar xzvf $^
# use the touch command to record completion in a dummy file
touch $@

调试 makefile

对于小问题,我通常使用 printf 的 Make 等效函数,即 $(info/warning/error)函数,例如当检查不工作的条件路径时:

ifeq ($(CC),clang)
$(error whoops, clang not supported!)
endif

verbose flag

# Makefile for building the example binary from C sources

# Verbose flag
ifeq ($(V),1)
Q :=
else
Q := @
endif

# The build folder, for all generated output. This should normally be included
# in a .gitignore rule
BUILD_FOLDER := build

# Default all rule will build the example target, which here is an executable
.PHONY:
all: $(BUILD_FOLDER)/example

# List of C source files. Putting this in a separate variable, with a file on
# each line, makes it easy to add files later (and makes it easier to see
# additions in pull requests). Larger projects might use a wildcard to locate
# source files automatically.
SRC_FILES = \
   src/example.c \
   src/main.c

# Generate a list of .o files from the .c files. Prefix them with the build
# folder to output the files there
OBJ_FILES = $(addprefix $(BUILD_FOLDER)/,$(SRC_FILES:.c=.o))

# Generate a list of depfiles, used to track includes. The file name is the same
# as the object files with the .d extension added
DEP_FILES = $(addsuffix .d,$(OBJ_FILES))

# Flags to generate the .d dependency-tracking files when we compile.  It s
# named the same as the target file with the .d extension
DEPFLAGS = -MMD -MP -MF $@.d

# Include the dependency tracking files
-include $(DEP_FILES)

# List of include dirs. These are put into CFLAGS.
INCLUDE_DIRS = \
   src/

# Prefix the include dirs with -I when passing them to the compiler
CFLAGS += $(addprefix -I,$(INCLUDE_DIRS))

# Set some compiler flags we need. Note that we re appending to the CFLAGS
# variable
CFLAGS += \
   -std=c11 \
   -Wall \
   -Werror \
   -ffunction-sections -fdata-sections \
   -Og \
   -g3

# Our project requires some linker flags: garbage collect sections, output a
# .map file
LDFLAGS += \
   -Wl,--gc-sections,-Map,$@.map

# Set LDLIBS to specify linking with libm, the math library
LDLIBS += \
   -lm

# The rule for compiling the SRC_FILES into OBJ_FILES
$(BUILD_FOLDER)/%.o: %.c
@echo Compiling $(notdir $)
@# Create the folder structure for the output file
@mkdir -p $(dir $@)
$(Q) $(CC) $(CFLAGS) $(DEPFLAGS) -c $ -o $@

# The rule for building the executable example , using OBJ_FILES as
# prerequisites. Since we re not relying on an implicit rule, we need to
# explicity list CFLAGS, LDFLAGS, LDLIBS
$(BUILD_FOLDER)/example: $(OBJ_FILES)
@echo Linking $(notdir $@)
$(Q) $(CC) $(CFLAGS) $(LDFLAGS) $^ $(LDLIBS) -o $@

# Remove debug information for a smaller executable. An embedded project might
# instead using [arm-none-eabi-]objcopy to convert the ELF file to a raw binary
# suitable to be written to an embedded device
STRIPPED_OUTPUT = $(BUILD_FOLDER)/example-stripped

$(STRIPPED_OUTPUT): $(BUILD_FOLDER)/example
@echo Stripping $(notdir $@)
$(Q)objcopy --strip-debug $^ $@

# Since all our generated output is placed into the build folder, our clean rule
# is simple. Prefix the recipe line with - to not error if the build folder
# doesn t exist (the -f flag for rm also has this effect)
.PHONY: clean
clean:
- rm -rf $(BUILD_FOLDER)

$ V=1 make

make 建议

让 Make 发挥最大作用的建议列表:

target 通常应该是真实的文件。当发出子 MAKE 命令时,总是使用 (MAKE)。尽量避免使用.phony 目标。如果规则生成任何文件工件,请考虑将其作为目标,而不是冒名! 尽量避免使用隐含的规则。对于 C 文件,确保使用.d 自动包括跟踪! 小心使用元编程。在规则中使用自动变量。总是尝试使用 @作为菜谱输出路径,这样你的规则和 Make 的路径就完全相同了。在 makefile 中自由地使用注释,特别是在使用了复杂的行为或微妙的语法时。你的同事(还有未来的自己) 会感谢你的。使用 - j 或 - l 选项并行运行 Make ! 尽量避免使用 touch 命令来跟踪规则完成。

到此,相信大家对“linux 中 gmake 怎么调用”有了更深的了解,不妨来实际操作一番吧!这里是丸趣 TV 网站,更多相关内容可以进入相关频道进行查询,关注我们,继续学习!

正文完
 
丸趣
版权声明:本站原创文章,由 丸趣 2023-07-13发表,共计13371字。
转载说明:除特殊说明外本站除技术相关以外文章皆由网络搜集发布,转载请注明出处。
评论(没有评论)