阅读数:426 评论数:0

说明：这种方式只是用于方便阅读代码，因为可以在源代间快速索引跳跃。但是最后可能会有一些warning，可以不必关心，如果是强迫症，可以使用下面这种方式来去掉。

// @suppress("Unused static function") @suppress("Unused function declaration")

1、下载安装eclipse 加　cdt

  cdt全称为c/c++　development tooling。有两种方式安装eclipse-cdt开发环境。

　（１）先安装eclipse基本环境：http://www.eclipse.org/downloads/

　　　　然后安装cdt扩展：http://www.eclipse.org/cdt/

　（２）直接安装集成的eclipse c/c++开发环境：https://www.eclipse.org/downloads/packages/

２、配置编译内核以生成autoconf.h文件，这个文件里会有CONFIG_*的一些宏定义。

2、进入代码所在目录，make prepare生成kconfig.h，Eclipse的indexer会使用

３、打开eclipse

４、点击File->New->Makefile Project with Existing Code

５、在弹出的窗口中，选择c/c++ -> C project，点击Next。

６、填写一个项目名称，如Linux v5.1

7、去掉勾选Use default location，选择你的Linux源码所在目录

８、在下面的Project type面板中，选择Makefile project中的empty project。

９、在右侧Toolchain ofr Indexer Settings选择Linux GCC，点击Finish。

１０、右键工程，点击Properties。

１１、注意，现在Eclipse Oxygen已经开始对你的项目建索引，所以会使你的下面配置过程变卡。为了防止变卡，可以临时关闭索引功能：打开c/c++ General部分，选择Indexer，点击Enable project-specific settings，去掉Enable indexer的勾选。

１２、打开c/c++ General

１３、选择Preprocessor Include Paths

１４、在Languages列表中选择GNU C

１５、在Setting Entries列表中选择CDT User Setting Entries　

１６、点击Add... ，在左侧下拉框中选择Preprocessor Macros File，右侧下拉框中选择Project Path，在File文本框中输入include/linux/kconfig.h。

１７、同样的方式　添加你使用的其它宏文件，比gcc目录下的stdbool.h。

１８、点击Indexer

１９、在Enable project specifi setting框中去掉Index source files not included in the build勾选　

２０、选择左侧的Paths and Symbols

２１、选择Includes　tab页，然后选择GNU C

２２、点击Add...

２３、点击Workspace...然后选择你的内核的include目录和include/uapi目录　

２４、再次添加arch/architecture/include和arch/architecture/include/uapi目录，如arch/powerpc/include和arch/powerpc/include/uapi

２５、点击#Symbols tab页

２６、添加Add...

２７、设置名称__KERNEL__，值为１添加ok.

２８、点击　Source Location　tab页

２９、点击加号或箭头、三角在你的项目上

３０、点击Filter，选择Edit Filter...

３１、点击Add Multiple...，然后选择arch/下所有不使用的目录（即你不使用的architecture）

３２、　点击ok再ok关闭对话框

３３、在c/c++ General下选择Preprocessor Include Paths，Macros　etc.

３４、点击Providers tab页，选择CDT GCC Built-in Compiler Settings

３５、去掉Use global provider shared between projects勾选　，勾选 the Allocate console in the Console View checkbox

３６、在Command to get compiler specs中追加-nostdinc，因为kernel是一个使用ISO C99定义的free-standing环境。所以不能引用标准的头文件和库，只以使用指定的。

３７、打开一个termial，输入echo -isystem $(gcc -print-file-name=include/)，把结果追加到-nostdinc后。虽然kernel不依赖以的标准系统的头文件的库，但是确依赖gcc提供的头文件　，一般在/usr/lib/gcc/arch/version/include，所以添加　。

另外一种方式是使用-iwithprefix include

３８、点击ok关闭对话框

３９、点击Finish

４０、工程会自动索引，在机械硬盘下大约用时２０分钟，固态硬盘大约５分钟

https://wiki.eclipse.org/HowTo_use_the_CDT_to_navigate_Linux_kernel_source

英语原文：

1. Download and install Eclipse plus the CDT.
2. Configure and build your kernel to define CONFIG_* and generate autoconf.h.
3. Start up Eclipse.
4. Click File -> New -> Project
5. In the pop-up window, choose C/C++-> C Project. Click Next
6. Fill in a project name like Linux v5.1
7. Uncheck the Use default location box and type in the root directory of your kernel into the Location box.
8. In the Project type: pane, click the Makefile project and select Empty Project
9. On the right side, select Linux GCC. Click Next
10. Click Advanced settings... and a Properties dialog will pop up.
11. Note: At this point, and starting from Eclipse Oxygen, Eclipse will aggressively start indexing your project, which can make Eclipse painfully slow for the rest of the configuration steps below. To mitigate that, temporarily disable indexing now by opening C/C++ General section, click on Indexer, click on Enable project-specific settings, then unmark the Enable indexer option.
12. Open the C/C++ General selection on the left.
13. Click on Preprocessor Include Paths
14. Select GNU C in the Languages list
15. Select CDT User Setting Entries in the Setting Entries list
16. Click on Add.... Choose Preprocessor Macros File from the top left dropdown, Project Path from the top right dropdown, and enter "include/linux/kconfig.h" into the File text box.
17. Also add any other macros files you are using.
18. Click on Indexer
19. Checkmark the Enable project specific settings box.
20. Uncheck Index source files not included in the build
21. Click on Paths and Symbols on the left.
22. Select the Includes tab and then select GNU C
23. Click Add...
24. Click Workspace... then select your kernel's include, and include/uapi directories
25. Do another Add, Workspace and add both arch/architecture/include, and arch/architecture/include/uapi directories. e.g., arch/powerpc/include and arch/powerpc/include/uapi (The UAPI directories are due to the kernel's user/kernel header split covered here in-detail)
26. Click the # Symbols tab
27. Click Add...
28. Set the name to __KERNEL__
29. Set the value to 1 and click OK
30. Click the Source Location tab
31. Click the plus sign (or arrow/triangle) next to your project name.
32. Select the Filter item and click Edit Filter...
33. Click Add Multiple... and then select all of the arch/* directories in your kernel source that will not be used (i.e. all the ones that are not for the architecture you are using)
34. Click OK and OK again to dismiss that dialog.
35. Under C/C++ General, select Preprocessor Include Paths, Macros etc.
36. Click the Providers tab and select CDT GCC Built-in Compiler Settings
37. Uncheck Use global provider shared between projects
38. Append -nostdinc to the curretly-existing Command to get compiler specs. The kernel is a free-standing environment by ISO C99 definition. That is, it does not want to be polluted, and obviously cannot work with, the "host" header files and libraries.
39. Open a terminal, and type "echo -isystem $(gcc -print-file-name=include/)". Append the resulting output to the Command to get compiler specs mentioned above. If you're using a cross-toolchain to compile the kernel, use the full path of that cross GCC compiler, instead of just typing gcc in the command mentioned. Rationale for this step: -nostdinc already asked gcc to not search the standard system directories for header files. But the Linux Kernel depends on GCC-provided "freestanding environment" headers like stdarg.h, stdbool.h and so on, which are typically hosted by GCC under /usr/lib/gcc/<arch>/<version>/include. Thus this step.
40. Click OK on the Properties dialog.
41. Note: If you temporarily disabled indexing as earlier recommended. This is the right time to re-enable it. Under C/C++ General, click on Indexer, and mark the Enable indexer option.
42. Click Finish on the C Project dialog.
43. The Project will index automatically.
44. On a platter drive indexing will take upwards of 20 minutes to complete, on a SSD indexing will take about 5 minutes to complete.