{"id":136,"date":"2018-02-06T12:33:46","date_gmt":"2018-02-06T20:33:46","guid":{"rendered":"https:\/\/sysprogs.com\/tutorials\/?p=136"},"modified":"2018-02-06T12:40:10","modified_gmt":"2018-02-06T20:40:10","slug":"creating-a-basic-linux-kernel-module-with-visual-studio","status":"publish","type":"post","link":"https:\/\/sysprogs.com\/VisualKernel\/tutorials\/basicmodule\/","title":{"rendered":"Creating a basic Linux Kernel Module with Visual Studio"},"content":{"rendered":"

This tutorial shows how to create, build and debug a basic Linux kernel module with Visual Studio and VisualKernel. Before you begin, install VisualKernel 3.0 or later and ensure you have a Linux machine running a recent version of the Linux kernel.<\/p>\n

    \n
  1. Start Visual Studio and open the VisualKernel Module project wizard:\"\"<\/li>\n
  2. Proceed with the\u00a0 default “Create a new kernel module from template” option. For better performance and more accurate IntelliSense we recommend selecting the Advanced Kernel Project Subsystem:\u00a0\"\"<\/li>\n
  3. Select your Linux machine in the “Targeted Linux Computer” field. If you have not\u00a0used that machine with VisualKernel before, click “Create a new SSH connection”:\u00a0\"\"<\/li>\n
  4. If you are creating a new SSH connection, ensure you use the user\u00a0that can run commands as root via\u00a0sudo, as otherwise VisualKernel won’t be able to load your kernel module:\u00a0\"\"<\/li>\n
  5. Ensure that the “Download and install kernel symbols” checkbox is checked. Kernel symbols are not strictly required when debugging kernel modules, however\u00a0installing them will greatly improve the debugging usability by\u00a0showing the source code of the kernel functions, stepping through them and\u00a0allowing to explore it via Code Map:\"\"<\/li>\n
  6. Press “Next”. VisualKernel will automatically download and install the kernel symbols for most common Linux distros:\"\"<\/li>\n
  7. On the last page of the wizard select your debug settings. If your module does not directly interact with the hardware, we recommend using VMWare\u00a0with the VMWare-specific debug connection. It utilizes a high-performance gdb stub\u00a0that runs\u00a0inside VMWare (and outside the Linux kernel) and is much more stable than debug methods provided by the kernel itself. For embedded ARM-based boards we recommend using JTAG as the debug method:\u00a0\"\"<\/li>\n
  8. Press “Finish” to create the project. Build it via Ctrl-Shift-B:\"\"<\/li>\n
  9. Set a breakpoint in the init function of your module and press F5 to start debugging the project. VisualKernel will automatically configure\u00a0your kernel for debugging and will start the debug session. Once the breakpoint is hit, you can debug your module as if it was a regular program:\"\"<\/li>\n
  10. If you are using the Advanced Kernel Project Subsystem, you can conveniently explore the sources of the kernel itself by locating it in Solution Explorer and double-clicking on it:\"\"<\/li>\n
  11. This will\u00a0create a special\u00a0kernel release project, store it in your kernel cache directory and add it to Solution Explorer. Once the kernel release project is present in the solution, you can use functions like Go to Definition, Peek Definition and Code Map\u00a0to explore the kernel sources:\"\"<\/li>\n
  12. If you have\u00a0created the project without downloading the kernel symbols, you can always select them later via the Module Build Settings page of VisualKernel Project Properties:\u00a0\"\"<\/li>\n<\/ol>\n","protected":false},"excerpt":{"rendered":"

    This tutorial shows how to create, build and debug a basic Linux kernel module with Visual Studio and VisualKernel. Before<\/p>\n","protected":false},"author":1,"featured_media":153,"comment_status":"closed","ping_status":"closed","sticky":true,"template":"","format":"standard","meta":{"footnotes":""},"categories":[19],"tags":[20],"_links":{"self":[{"href":"https:\/\/sysprogs.com\/tutorials\/wp-json\/wp\/v2\/posts\/136"}],"collection":[{"href":"https:\/\/sysprogs.com\/tutorials\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/sysprogs.com\/tutorials\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/sysprogs.com\/tutorials\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/sysprogs.com\/tutorials\/wp-json\/wp\/v2\/comments?post=136"}],"version-history":[{"count":2,"href":"https:\/\/sysprogs.com\/tutorials\/wp-json\/wp\/v2\/posts\/136\/revisions"}],"predecessor-version":[{"id":152,"href":"https:\/\/sysprogs.com\/tutorials\/wp-json\/wp\/v2\/posts\/136\/revisions\/152"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/sysprogs.com\/tutorials\/wp-json\/wp\/v2\/media\/153"}],"wp:attachment":[{"href":"https:\/\/sysprogs.com\/tutorials\/wp-json\/wp\/v2\/media?parent=136"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/sysprogs.com\/tutorials\/wp-json\/wp\/v2\/categories?post=136"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/sysprogs.com\/tutorials\/wp-json\/wp\/v2\/tags?post=136"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}