menu_bookGuides

  1. arrow_forward
    Welcome to oneAPI Construction Kit’s documentation!
    1. subdirectory_arrow_right
      oneAPI Construction Kit Overview
      1. arrow_forward
        Preface
        1. subdirectory_arrow_right
          Introduction
          1. arrow_forward
            oneAPI Construction Kit Architecture
            1. arrow_forward
              Compiler View
            2. subdirectory_arrow_right
              Mapping ComputeMux to Hardware
              1. arrow_forward
                Memory Requirements
                1. arrow_forward
                  Atomic Requirements
                  1. arrow_forward
                    Floating-Point Requirements
                    1. arrow_forward
                      Synchronization Requirements
                    2. subdirectory_arrow_right
                      Runtime Information
                      1. arrow_forward
                        ComputeMux Runtime
                        1. arrow_forward
                          Driver Requirements
                          1. arrow_forward
                            Supported Toolchains
                          2. subdirectory_arrow_right
                            Compiler Information
                            1. arrow_forward
                              ComputeMux Compiler
                              1. arrow_forward
                                Intermediate Representation
                                1. arrow_forward
                                  Supported LLVM Versions
                                  1. arrow_forward
                                    ComputeMux Compiler Non-Requirements
                                  2. subdirectory_arrow_right
                                    Example Hardware Feature Scenarios
                                    1. arrow_forward
                                      Mapping Custom Instructions To Builtin Functions
                                      1. arrow_forward
                                        Mapping Custom IP Blocks To Builtin Kernels
                                        1. arrow_forward
                                          How To Support Large Scratchpad Memories
                                          1. arrow_forward
                                            Mapping Algorithms To Vector Hardware
                                            1. arrow_forward
                                              RefSi In-Kernel DMA for RISC-V
                                            2. arrow_forward
                                              oneAPI Construction Kit
                                              1. arrow_forward
                                                Creating a New ComputeMux Target: Quick Start
                                                1. subdirectory_arrow_right
                                                  Tutorials
                                                  1. subdirectory_arrow_right
                                                    Creating a New HAL
                                                    1. arrow_forward
                                                      Initial Setup
                                                      1. arrow_forward
                                                        Kernel Compilation
                                                        1. arrow_forward
                                                          Running clik Tests
                                                          1. arrow_forward
                                                            Overview of the Skeleton HAL Code
                                                            1. arrow_forward
                                                              Implementing HAL Operations
                                                            2. subdirectory_arrow_right
                                                              Creating a New ComputeMux Target
                                                              1. arrow_forward
                                                                Running the create_target.py Script
                                                                1. arrow_forward
                                                                  Building and Running Tests
                                                                  1. arrow_forward
                                                                    Adapting the Pass Pipeline for the Target
                                                                    1. arrow_forward
                                                                      Extending it Further
                                                                  2. subdirectory_arrow_right
                                                                    Codeplay Reference Silicon
                                                                    1. arrow_forward
                                                                      Codeplay Reference Silicon Overview
                                                                      1. arrow_forward
                                                                        Command Processor Reference
                                                                        1. arrow_forward
                                                                          DMA Controller Reference
                                                                          1. arrow_forward
                                                                            DMA Programming Guide
                                                                            1. arrow_forward
                                                                              RefSi Driver Interface
                                                                              1. arrow_forward
                                                                                How The Platform Maps to SYCL and OpenCL
                                                                            2. arrow_forward
                                                                              Getting Started
                                                                              1. subdirectory_arrow_right
                                                                                Specifications
                                                                                1. arrow_forward
                                                                                  Versioning Scheme
                                                                                  1. arrow_forward
                                                                                    ComputeMux Runtime Specification
                                                                                    1. arrow_forward
                                                                                      ComputeMux Compiler Specification
                                                                                    2. arrow_forward
                                                                                      Developer Guide
                                                                                      1. subdirectory_arrow_right
                                                                                        Tutorials
                                                                                        1. arrow_forward
                                                                                          Adding A Custom Builtins Extension
                                                                                          1. arrow_forward
                                                                                            Custom Lowering Work-Item Builtins
                                                                                            1. arrow_forward
                                                                                              Adding Target-Specific Metadata
                                                                                            2. arrow_forward
                                                                                              Design
                                                                                              1. subdirectory_arrow_right
                                                                                                OpenCL
                                                                                                1. arrow_forward
                                                                                                  OpenCL CMake
                                                                                                  1. arrow_forward
                                                                                                    How OpenCL Concepts Are Mapped Onto ComputeMux
                                                                                                    1. subdirectory_arrow_right
                                                                                                      OpenCL Extensions
                                                                                                      1. arrow_forward
                                                                                                        Kernel Debug - cl_codeplay_kernel_debug
                                                                                                        1. arrow_forward
                                                                                                          Extra Build Options - cl_codeplay_extra_build_options
                                                                                                          1. arrow_forward
                                                                                                            Kernel Exec Info - cl_codeplay_kernel_exec_info
                                                                                                            1. arrow_forward
                                                                                                              Performance Counters - cl_codeplay_performance_counters
                                                                                                              1. arrow_forward
                                                                                                                Soft Math - cl_codeplay_soft_math
                                                                                                                1. arrow_forward
                                                                                                                  Whole Function Vectorization - cl_codeplay_wfv
                                                                                                                  1. arrow_forward
                                                                                                                    USM - cl_intel_unified_shared_memory
                                                                                                                    1. arrow_forward
                                                                                                                      Required subgroup sizes for kernels - cl_intel_required_subgroup_size
                                                                                                                    2. arrow_forward
                                                                                                                      OpenCL External Extensions
                                                                                                                      1. arrow_forward
                                                                                                                        OpenCL ICD Loader
                                                                                                                        1. arrow_forward
                                                                                                                          OpenCL Intercept Layer
                                                                                                                          1. arrow_forward
                                                                                                                            Tools
                                                                                                                            1. subdirectory_arrow_right
                                                                                                                              Tests
                                                                                                                              1. arrow_forward
                                                                                                                                UnitCL
                                                                                                                            2. arrow_forward
                                                                                                                              Vulkan
                                                                                                                              1. subdirectory_arrow_right
                                                                                                                                Modules
                                                                                                                                1. subdirectory_arrow_right
                                                                                                                                  Builtins
                                                                                                                                  1. arrow_forward
                                                                                                                                    Abacus
                                                                                                                                    1. arrow_forward
                                                                                                                                      Image Library
                                                                                                                                    2. subdirectory_arrow_right
                                                                                                                                      ComputeMux
                                                                                                                                      1. arrow_forward
                                                                                                                                        Change Log
                                                                                                                                        1. arrow_forward
                                                                                                                                          Compiler
                                                                                                                                          1. arrow_forward
                                                                                                                                            CMake
                                                                                                                                            1. arrow_forward
                                                                                                                                              Bumping the Specification Version
                                                                                                                                            2. subdirectory_arrow_right
                                                                                                                                              Host CPU
                                                                                                                                              1. arrow_forward
                                                                                                                                                cl_codeplay_host_builtins
                                                                                                                                                1. arrow_forward
                                                                                                                                                  cl_codeplay_set_threads
                                                                                                                                                  1. arrow_forward
                                                                                                                                                    Host lit test suite
                                                                                                                                                    1. arrow_forward
                                                                                                                                                      Host Debug Features
                                                                                                                                                    2. arrow_forward
                                                                                                                                                      RISC-V
                                                                                                                                                      1. subdirectory_arrow_right
                                                                                                                                                        Compiler
                                                                                                                                                        1. arrow_forward
                                                                                                                                                          Overview
                                                                                                                                                          1. arrow_forward
                                                                                                                                                            Compiler Utilities
                                                                                                                                                            1. subdirectory_arrow_right
                                                                                                                                                              Tools
                                                                                                                                                              1. arrow_forward
                                                                                                                                                                muxc
                                                                                                                                                            2. arrow_forward
                                                                                                                                                              ELF loader
                                                                                                                                                              1. subdirectory_arrow_right
                                                                                                                                                                Vecz
                                                                                                                                                                1. arrow_forward
                                                                                                                                                                  Vecz Documentation
                                                                                                                                                                2. arrow_forward
                                                                                                                                                                  spirv-ll
                                                                                                                                                                  1. arrow_forward
                                                                                                                                                                    Debug Module
                                                                                                                                                                    1. arrow_forward
                                                                                                                                                                      Cargo Module
                                                                                                                                                                      1. arrow_forward
                                                                                                                                                                        Metadata API
                                                                                                                                                                      2. arrow_forward
                                                                                                                                                                        CMake Development
                                                                                                                                                                        1. arrow_forward
                                                                                                                                                                          Scripts

                                                                                                                                                                          Kernel Debug - cl_codeplay_kernel_debug

                                                                                                                                                                          Name String

                                                                                                                                                                          link

                                                                                                                                                                          cl_codeplay_kernel_debug

                                                                                                                                                                          Contact

                                                                                                                                                                          link

                                                                                                                                                                          • Ewan Crawford, Codeplay Software Ltd. (ewan ‘at’ codeplay.com)

                                                                                                                                                                          Contributors

                                                                                                                                                                          link

                                                                                                                                                                          • Ewan Crawford, Codeplay Software Ltd.

                                                                                                                                                                          • Kenneth Benzie, Codeplay Software Ltd.

                                                                                                                                                                          Version

                                                                                                                                                                          link

                                                                                                                                                                          Version 3, November 12, 2021

                                                                                                                                                                          Number

                                                                                                                                                                          link

                                                                                                                                                                          OpenCL Extension #XX

                                                                                                                                                                          Status

                                                                                                                                                                          link

                                                                                                                                                                          Proposal

                                                                                                                                                                          Dependencies

                                                                                                                                                                          link

                                                                                                                                                                          OpenCL 1.2 is required.

                                                                                                                                                                          Overview

                                                                                                                                                                          link

                                                                                                                                                                          The kernel debug extension grants developers the ability to specify build options which enable attaching a debugger to a kernel being executed on a device.

                                                                                                                                                                          This is done by allowing cl_program objects to be built with debug information. Secondly letting developers set the source file directly means that the debugger can display source code even when the program source is generated at runtime.

                                                                                                                                                                          Modifications to the OpenCL API Specification

                                                                                                                                                                          link

                                                                                                                                                                          Add a new Section 5.6.4.7 - “Options for Debugging”

                                                                                                                                                                          -g

                                                                                                                                                                          Build program with debug info.

                                                                                                                                                                          -S <path/to/source/file>

                                                                                                                                                                          Point debug information to a source file on disk. If this does not exist, the runtime creates the file with cached source.

                                                                                                                                                                          Revision History

                                                                                                                                                                          link

                                                                                                                                                                          Rev

                                                                                                                                                                          Date

                                                                                                                                                                          Author

                                                                                                                                                                          Changes

                                                                                                                                                                          1

                                                                                                                                                                          2016/03/11

                                                                                                                                                                          Ewan Crawford

                                                                                                                                                                          -g build flag

                                                                                                                                                                          2

                                                                                                                                                                          2016/06/25

                                                                                                                                                                          Ewan Crawford

                                                                                                                                                                          -S build option

                                                                                                                                                                          3

                                                                                                                                                                          2021/11/12

                                                                                                                                                                          Kenneth Benzie

                                                                                                                                                                          Add -g and -S, forked from cl_codeplay_extra_build_options

                                                                                                                                                                          Select a Product

                                                                                                                                                                          Please select a product

                                                                                                                                                                          oneAPI

                                                                                                                                                                          oneAPI is a cross-industry, open, standards-based unified programming model that delivers a common developer experience across accelerator architecture - for faster application performance, more productivity, and greater innovation.

                                                                                                                                                                          Dark Mode
                                                                                                                                                                          brightness_2

                                                                                                                                                                          Dark Mode

                                                                                                                                                                          Light text on a dark background.

                                                                                                                                                                          Light Mode
                                                                                                                                                                          lightbulb_outline

                                                                                                                                                                          Light Mode

                                                                                                                                                                          Dark text on a light background.

                                                                                                                                                                          public

                                                                                                                                                                          Also,

                                                                                                                                                                          part of our network

                                                                                                                                                                          search
                                                                                                                                                                          No results found, please try another search term.
                                                                                                                                                                          sync
                                                                                                                                                                          Searching, Please Wait...

                                                                                                                                                                          Please type to begin searching or try these:


                                                                                                                                                                          • oneapi nvidia
                                                                                                                                                                          • cl::sycl
                                                                                                                                                                          • 2.5.0
                                                                                                                                                                          • download oneapi amd
                                                                                                                                                                          • getting started guide
                                                                                                                                                                          • construction kit
                                                                                                                                                                          Tip: Press 'enter' key to select first result.
                                                                                                                                                                          There was a problem searching, please try again later.