1 # $Id: Makefile.include.header $
3 # VirtualBox Guest Additions kernel module Makefile, common parts.
5 # (For 2.6.x, the main file must be called 'Makefile'!)
9 # Copyright (C) 2006-2017 Oracle Corporation
11 # This file is part of VirtualBox Open Source Edition (OSE), as
12 # available from http://www.virtualbox.org. This file is free software;
13 # you can redistribute it and/or modify it under the terms of the GNU
14 # General Public License (GPL) as published by the Free Software
15 # Foundation, in version 2 as it comes in the "COPYING" file of the
16 # VirtualBox OSE distribution. VirtualBox OSE is distributed in the
17 # hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
21 # * Building with KERN_DIR set uses the value specified and
22 # the default value for the unspecified one if any.
25 # These file should be included by the Makefiles for any kernel modules we
26 # build as part of the Guest Additions. The intended way of doing this is as
29 # # Linux kbuild sets this to our source directory if we are called from
32 # include $(obj)/Makefile.include.header
33 # MOD_NAME = <name of the module to be built, without extension>
34 # MOD_OBJS = <list of object files which should be included>
35 # MOD_DEFS = <any additional defines which this module needs>
36 # MOD_INCL = <any additional include paths which this module needs>
37 # MOD_CFLAGS = <any additional CFLAGS which this module needs>
38 # include $(obj)/Makefile.include.footer
40 # The kmk kBuild define KBUILD_TARGET_ARCH is available.
45 # First, figure out which architecture we're targeting and the build type.
46 # (We have to support basic cross building (ARCH=i386|x86_64).)
47 # While at it, warn about BUILD_* vars found to help with user problems.
49 ifeq ($(filter-out x86_64 amd64 AMD64,$(shell dpkg-architecture -qDEB_HOST_GNU_CPU)),)
50 BUILD_TARGET_ARCH_DEF := amd64
52 BUILD_TARGET_ARCH_DEF := x86
54 ifneq ($(filter-out amd64 x86,$(BUILD_TARGET_ARCH)),)
55 $(warning Ignoring unknown BUILD_TARGET_ARCH value '$(BUILD_TARGET_ARCH)'.)
58 ifeq ($(BUILD_TARGET_ARCH),)
60 BUILD_TARGET_ARCH := amd64
63 BUILD_TARGET_ARCH := x86
65 BUILD_TARGET_ARCH := $(BUILD_TARGET_ARCH_DEF)
69 ifneq ($(BUILD_TARGET_ARCH),$(BUILD_TARGET_ARCH_DEF))
70 $(warning Using BUILD_TARGET_ARCH='$(BUILD_TARGET_ARCH)' from the $(origin BUILD_TARGET_ARCH).)
74 ifneq ($(filter-out release profile debug strict,$(BUILD_TYPE)),)
75 $(warning Ignoring unknown BUILD_TYPE value '$(BUILD_TYPE)'.)
81 ifneq ($(BUILD_TYPE),release)
82 $(warning Using BUILD_TYPE='$(BUILD_TYPE)' from the $(origin BUILD_TYPE).)
89 ifeq ($(KERNELRELEASE),)
92 # building from this directory
95 # kernel base directory
98 ifeq ($(filter %/build,$(KERN_DIR)),)
99 $(error The variable KERN_DIR must be a kernel build folder and end with /build without a trailing slash, or KERN_VER must be set)
106 KERN_VER = $(notdir $(patsubst %/build,%,$(KERN_DIR)))
107 ifeq ($(shell expr $(KERN_VER) : '[0-9]*\.[0-9]*.[0-9]*'),0)
108 $(error The kernel build folder path must end in <version>/build, or the variable KERN_VER must be set)
111 KERN_VER ?= $(shell uname -r)
114 # guess kernel major version (24 or later)
115 ifeq ($(shell if grep '"2\.4\.' /lib/modules/$(KERN_VER)/build/include/linux/version.h > /dev/null 2>&1; then echo yes; fi),yes)
121 else # neq($(KERNELRELEASE),)
124 # building from kbuild (make -C <kernel_directory> M=`pwd`)
127 # guess kernel version (24 or 26)
128 ifeq ($(shell if echo "$(VERSION).$(PATCHLEVEL)." | grep '2\.4\.' > /dev/null; then echo yes; fi),yes)
134 KERN_VER := $(KERNELRELEASE)
136 endif # neq($(KERNELRELEASE),)
138 # Kernel build folder
139 KERN_DIR := $(srctree)
140 ifneq ($(shell if test -d $(KERN_DIR); then echo yes; fi),yes)
141 $(error Error: unable to find the headers of the Linux kernel to build against. \
142 Specify KERN_VER=<version> (currently $(KERN_VER)) and run Make again)
144 # Kernel include folder
145 KERN_INCL := $(KERN_DIR)/include
146 # module install folder
147 INSTALL_MOD_DIR ?= misc
148 MODULE_DIR := $(INSTALL_MOD_PATH)/lib/modules/$(KERN_VER)/$(INSTALL_MOD_DIR)
150 # debug - show guesses.
152 $(warning dbg: INSTALL_MOD_PATH = $(INSTALL_MOD_PATH))
153 $(warning dbg: INSTALL_MOD_DIR = $(INSTALL_MOD_DIR))
154 $(warning dbg: KERN_DIR = $(KERN_DIR))
155 $(warning dbg: KERN_INCL = $(KERN_INCL))
156 $(warning dbg: KERN_VERSION = $(KERN_VERSION))
157 $(warning dbg: MODULE_DIR = $(MODULE_DIR))