msobjdump

This tool is used to parse and decompress the executable and linkable format (ELF) files generated after operator build in kernel launch projects (NPU mode) and standard custom operator projects, as well as simple custom operator projects. It displays the results in a readable format, helping you obtain kernel file information easily.

  • The ELF file is a file format used for binary files, executable files, object code, shared libraries, and core dumps, such as *.a and *.so files. An ELF file typically consists of the following parts:
    • ELF header: describes the structure of the entire file, including the file type, machine type, and version number.
    • Program header table: describes various segments in the file, including information about how a program is loaded to the memory for execution.
    • Section header table: describes the information about each section in the file, including the code, data, and symbol table of the program.
  • If the following faults occur during the use of the tool, analyze and rectify the faults based on the log information:
    • No ELF file is found.
    • The ELF file permission is incorrect.
    • The ELF file exists but cannot be parsed or decompressed.

Applicability

Product

Supported

Atlas 350 Accelerator Card

Atlas A3 training product/Atlas A3 inference product

Atlas A2 training product/Atlas A2 inference product

Atlas 200I/500 A2 inference product

Atlas inference product

Atlas training product

Tool Installation

  1. Install the msobjdump tool.

    The tool is released with the CANN software package. (For details about how to install the CANN software package, see Environment Setup). The default path is ${INSTALL_DIR}/tools/msobjdump. Replace ${INSTALL_DIR} with the CANN component directory. For example, if the installation is performed by the root user, the default file storage path is /usr/local/Ascend/cann.

  2. Set environment variables.
    • Install the Ascend-CANN-Toolkit package as the root user:
      source /usr/local/Ascend/cann/set_env.sh
    • Install the Ascend-CANN-Toolkit package as a non-root user:
      source ${HOME}/Ascend/cann/set_env.sh
  3. Check whether the tool is successfully installed.
    Run the following command. If --help or -h is displayed, the tool environment is normal and the functions are normal.
    msobjdump -h

Command Format

  • Command for parsing an ELF file
    msobjdump --dump-elf <elf_file> [--verbose]
    Table 1 Parameters

    Parameter (Case Sensitive)

    Optional/Required

    Description

    --dump-elf <elf_file>, -d

    Required

    Parses device information contained in the ELF file, such as the file name, file type, file length, and symbol table, and displays the information on the device screen.

    <elf_file> indicates the path of the ELF file to be parsed, for example, /home/op_api/lib_api.so. Two printing modes are supported:

    Simple printing: Only certain device information is printed by default.

    Full printing: This option is used together with --verbose to enable display of all device information on the screen.

    The fields to be printed vary with projects. For details, see Table 4 and Table 5.

    --verbose, -V

    Optional

    This option must be used together with --dump-elf to enable the function of printing all device information in the ELF file.

  • Command for decompressing an ELF file
    msobjdump --extract-elf <elf_file> [--out-dir <out_path>]
    Table 2 Parameters

    Parameter (Case Sensitive)

    Optional/Required

    Description

    --extract-elf <elf_file>, -e

    Required

    Decompresses device information contained in the ELF file and flushes the file to the output path based on the original folder rules.

    <elf_file> indicates the path of the ELF file to be decompressed, for example, /home/op_api/lib_api.so.

    Default path: The decompressed result file is flushed to the current execution path by default.

    Custom path: The --out-dir parameter can be used together to set the flushing path.

    --out-dir <out_path>, -o

    Optional

    This parameter must be used together with --extract-elf to set the path for flushing the decompressed file.

    <out_path> indicates the directory for flushing the file, for example, /home/extract/.

    Note: msobjdump can be called by multiple users concurrently. However, users need to specify different --out-dir values. Otherwise, the flushed content may be overwritten.

  • Command for obtaining the list of ELF files
    msobjdump --list-elf <elf_file>
    Table 3 Parameters

    Parameter (Case Sensitive)

    Optional/Required

    Description

    --list-elf <elf_file>, -l

    Optional

    Obtains and prints the list of device information files contained in the ELF file.

    <elf_file> indicates the path of the ELF file to be printed, for example, /home/op_api/lib_api.so.

Table 4 ELF file parsing fields (kernel launch project)

Field

Description

Required (Yes/No)

Printing Description

VERSION

Version number.

Yes

If --verbose is not set, the file is printed by default.

TYPE COUNT

Number of kernel files contained in the ELF file.

Yes

If --verbose is not set, the file is printed by default.

ELF FILE ${id}

Name of a kernel file contained in the ELF file. ${id} indicates the sequence number of the kernel file.

The kernel file naming rule is as follows:

A kernel file name is in the format of ${sec_prefix}_${file_index}_${kernel_type}.o, where ${sec_prefix} indicates the section name (which is obtained by the tool based on the .ascend.kernel keyword), ${file_index} indicates the file number, and ${kernel_type} indicates the kernel type.

Yes

If --verbose is not set, the file is printed by default.

KERNEL LEN

Length of the current kernel file.

Yes

If --verbose is not set, the file is printed by default.

KERNEL TYPE

Type of a kernel file. The mapping is {0 : 'mix', 1: 'aiv', 2: 'aic'}.

No

If --verbose is not set, the file is printed by default.

ASCEND META

Inter-core synchronization, ratio of Cube Cores to Vector Cores (task_ration), and other information during operator execution.

If the information is not obtained, None is displayed by default.

No

If --verbose is not set, the file is printed by default.

elf header infos

Information such as the ELF header, section headers, key to flags, program headers, and symbol tables.

No

If --verbose is set, full information printing is enabled.

Table 5 ELF file parsing fields (standard/simple custom operator project)

Field

Description

Required (Yes/No)

Printing Description

.ascend.meta. ${id}

Kernel function name of an operator. ${id} indicates the index value of the meta information.

Yes

If --verbose is not set, the file is printed by default.

VERSION

Version number.

Yes

If --verbose is not set, the file is printed by default.

DEBUG

Debugging information, including the following two parts:

debugBufSize: memory size required for debugging information.

debugOptions: status of the debugging switch. The options are as follows:

0: The debugging function is disabled.

1: Debugging is performed through DumpTensor and printf.

2: Debugging is performed through the assert function.

4: Debugging is performed through timestamp marking.

8: Debugging is performed through memory overwriting detection.

No

If --verbose is not set, the file is printed by default.

DYNAMIC_PARAM

Whether to enable dynamic parameters for the operator's kernel function. The options are as follows:

0: The dynamic parameter mode is disabled.

1: The dynamic parameter mode is enabled.

No

If --verbose is not set, the file is printed by default.

OPTIONAL_PARAM

Optional parameter information, including the following two parts:

optionalInputMode: Indicates whether an optional input needs to occupy a placeholder in the operator's kernel function. The options are as follows:

0: The optional input does not occupy a placeholder.

1: The optional input occupies a placeholder.

optionalOutputMode: Indicates whether an optional output needs to occupy a placeholder in the operator's kernel function. The options are as follows:

0: The optional output does not occupy a placeholder.

1: The optional output occupies a placeholder.

No

If --verbose is not set, the file is printed by default.

KERNEL_TYPE

Core type at the kernel function runtime. For details about the values, see Table 6.

No

If --verbose is not set, the file is printed by default.

CROSS_CORE_SYNC

Hardware synchronization (syncall) type.

USE_SYNC: Hardware synchronization is used.

NO_USE_SYNC: Hardware synchronization is not used.

No

If --verbose is not set, the file is printed by default.

MIX_TASK_RATION

Ratio of Cube Cores to Vector Cores (core allocation type) at the kernel function runtime.

No

If --verbose is not set, the file is printed by default.

DETERMINISTIC_INFO

Whether the operator performs deterministic computation.

0: non-deterministic computation.

1: deterministic computation.

No

If --verbose is not set, the file is printed by default.

BLOCK_NUM

Number of cores used to execute the operator. This field is not supported currently. Only the default value 0xFFFFFFFF is printed.

No

If --verbose is not set, the file is printed by default.

FUNCTION_ENTRY

TilingKey value of the operator.

No

If --verbose is not set, the file is printed by default.

elf header infos

Information such as the ELF header, section headers, key to flags, program headers, and symbol tables.

No

If --verbose is set, full information printing is enabled.

Table 6 Kernel type information

KERNEL_TYPE

Description

AICORE

This parameter is reserved and is not supported in the current version.

Only the AI Cores are started during operator execution. For example, if blocknum is set to 5 on the host, 5 AI Cores are started.

AIC

Only the Cube Cores on the AI Cores are started during operator execution. For example, if blocknum is set to 10 on the host, 10 Cube Cores are started.

AIV

Only the Vector Cores on the AI Cores are started during operator execution. For example, if blocknum is set to 10 on the host, 10 Vector Cores are started.

MIX_AIC_MAIN

In the scenario of mixing AIC and AIV, if the kernel function type is set to MIX, the Cube and Vector Cores on the AI Cores are started at the same time during operator execution. For example, you can set blocknum to 10 and task_ration to 1:2 on the host. In this case, 10 Cube Cores and 20 Vector Cores are started.

MIX_AIV_MAIN

In the scenario of mixing AIC and AIV, when multi-core control instructions are used and the kernel function type is set to MIX, the Cube and Vector Cores on the AI Cores are started at the same time during operator execution. For example, you can set blocknum to 10 and task_ration to 1:2 on the host. In this case, 10 Vector Cores and 20 Cube Cores are started.

AIC_ROLLBACK

When the operator is executed, the AI Cores and Vector Cores are started at the same time. In this case, the AI Cores are used as the Cube Cores.

AIV_ROLLBACK

When the operator is executed, the AI Cores and Vector Cores are started at the same time. In this case, the AI Cores are used as the Vector Cores.

Example (Kernel Launch Operator Project)

Take the MatmulInvocationNeo operator as an example (NPU mode). Assume that ${cmake_install_dir} is the root directory of the operator's CMake build artifacts. The directory structure is as follows (for reference only), in a style similar to that in Compiling the CMake Build Configuration File.

out
├── lib
│   ├── libascendc_kernels_npu.so
├── include
│   ├── ascendc_kernels_npu
│           ├── aclrtlaunch_matmul_custom.h
│           ├── aclrtlaunch_triple_chevrons_func.h
......

To parse and decompress the library files (such as *.so and *.a files) generated after compilation, run the following the commands:

  • Parsing the library file containing device information

    Two printing modes are supported. Select one as required. For details about the parsed fields, see Table 4.

    • Simple printing
      msobjdump --dump-elf ${cmake_install_dir}/out/libascendc_kernels_npu.so

      After this command is executed, the basic device information is displayed on the device screen, as shown in the following:

      1
      2
      3
      4
      5
      6
      7
      8
      ===========================
      [VERSION]: 1
      [TYPE COUNT]: 1
      ===========================
      [ELF FILE 0]: ascendxxxb1_ascendc_kernels_npu_0_mix.o
      [KERNEL TYPE]: mix
      [KERNEL LEN]: 511560
      [ASCEND META]: None
      
    • Full printing
      msobjdump --dump-elf ${cmake_install_dir}/out/libascendc_kernels_npu.so --verbose

      After this command is executed, all device information is displayed on the device screen, as shown in the following:

       1
       2
       3
       4
       5
       6
       7
       8
       9
      10
      11
      12
      13
      14
      15
      16
      17
      18
      19
      20
      21
      22
      23
      24
      25
      26
      27
      28
      29
      30
      31
      32
      33
      34
      35
      36
      37
      38
      39
      40
      41
      42
      43
      44
      45
      46
      47
      48
      49
      ===========================
      [VERSION]: 1
      [TYPE COUNT]: 1
      ===========================
      [ELF FILE 0]: ascendxxxb1_ascendc_kernels_npu_0_mix.o
      [KERNEL TYPE]: mix
      [KERNEL LEN]: 511560
      [ASCEND META]: None
      ====== [elf heard infos] ======
      ELF Header:
        Magic:   7f 45 4c 46 02 01 01 00 00 00 00 00 00 00 00 00
        Class:                             ELF64
        Data:                              2's complement, little endian
        Version:                           1 (current)
        OS/ABI:                            UNIX - System V
        ABI Version:                       0
        Type:                              EXEC (Executable file)
        Machine:                           <unknown>: 0x1029
        Version:                           0x1
        Entry point address:               0x0
        Start of program headers:          64 (bytes into file)
        Start of section headers:          510280 (bytes into file)
        Flags:                             0x940000
        Size of this header:               64 (bytes)
        Size of program headers:           56 (bytes)
        Number of program headers:         2
        Size of section headers:           64 (bytes)
        Number of section headers:         20
        Section header string table index: 18
      
      Section Headers:
        [Nr] Name              Type            Address          Off    Size   ES Flg Lk Inf Al
        [ 0]                   NULL            0000000000000000 000000 000000 00      0   0  0
        [ 1] .text             PROGBITS        0000000000000000 0000b0 010a08 00  AX  0   0  4
         .....................................................................................
        [19] .strtab           STRTAB          0000000000000000 071278 00b6cb 00      0   0  1
      Key to Flags:
        W (write), A (alloc), X (execute), M (merge), S (strings), I (info),
        L (link order), O (extra OS processing required), G (group), T (TLS),
        C (compressed), x (unknown), o (OS specific), E (exclude),
        D (mbind), p (processor specific)
      
      There are no section groups in this file.
      
      Program Headers:
        Type           Offset   VirtAddr           PhysAddr           FileSiz  MemSiz   Flg Align
        LOAD           0x0000b0 0x0000000000000000 0x0000000000000000 0x010aa8 0x010aa8 R E 0x1000
        GNU_STACK      0x000000 0x0000000000000000 0x0000000000000000 0x000000 0x000000 RW  0
      ......
      
  • Decompressing the library file that contains device information and flushing the file to the disk
    msobjdump --extract-elf ${cmake_install_dir}/out/libascendc_kernels_npu.so

    After this command is executed, the ascendxxxb1_ascendc_kernels_npu_0_mix.o file is flushed to the disk in the current execution path by default.

  • Obtaining the list of library files that contain device information
    msobjdump --list-elf ${cmake_install_dir}/out/libascendc_kernels_npu.so

    After this command is executed, all files are displayed on the device screen, as shown in the following:

    1
    ELF file    0: ascendxxxb1_ascendc_kernels_npu_0_mix.o
    

Example (Standard/Simple Custom Operator Project)

Take the following operator project as an example (for reference only). Assume that ${cmake_install_dir} is the root directory of the operator's CMake build artifacts. The directory structure is as follows, in a style similar to that in Operator Building.

├── op_api
│   ├── include
│       ├── aclnn_acos_custom.h
│       ├── aclnn_matmul_leakyrelu_custom.h
│       ├── .........
│   ├── lib
│       ├── libcust_opapi.so

To parse and decompress the library files (such as *.so and *.a files) generated after compilation, run the following the commands:

  • Parsing the library file containing device information

    Two printing modes are supported. Select one as required. For details about the parsed fields, see Table 5.

    • Simple printing
      msobjdump --dump-elf ${cmake_install_dir}/op_api/lib/libcust_opapi.so 

      After this command is executed, the basic device information is displayed on the device screen, as shown in the following:

       1
       2
       3
       4
       5
       6
       7
       8
       9
      10
      11
      12
      13
      14
      15
      16
      17
      18
      19
      20
      21
      22
      23
      24
      25
      26
      27
      28
      29
      30
      31
      32
      33
      34
      35
      36
      37
      38
      39
      .ascend.meta META INFO
      VERSION: 1
      DEBUG: debugBufSize=0, debugOptions=0
      DYNAMIC_PARAM: dynamicParamMode=0
      OPTIONAL_PARAM: optionalInputMode=1, optionalOutputMode=1
      .ascend.meta. [0]: AcosCustom_dad9c8ca8fcbfd789010c8b1c0da8e26_1
      KERNEL_TYPE: AIV
      DETERMINISTIC_INFO: 1
      BLOCK_NUM: 0xFFFFFFFF
      FUNCTION_ENTRY: 1
      .ascend.meta. [0]: AcosCustom_dad9c8ca8fcbfd789010c8b1c0da8e26_2_mix_aiv
      KERNEL_TYPE: MIX_AIV_MAIN
      MIX_TASK_RATION: [0:1]
      DETERMINISTIC_INFO: 1
      BLOCK_NUM: 0xFFFFFFFF
      FUNCTION_ENTRY: 2
      .ascend.meta. [0]: AcosCustom_dad9c8ca8fcbfd789010c8b1c0da8e26_3_mix_aiv
      KERNEL_TYPE: MIX_AIV_MAIN
      MIX_TASK_RATION: [0:1]
      DETERMINISTIC_INFO: 1
      BLOCK_NUM: 0xFFFFFFFF
      FUNCTION_ENTRY: 3
      ....................................
      .ascend.meta. [0]: AcosCustom_da824ede53d7e754f85c14b9446ec2fc_1
      KERNEL_TYPE: AIV
      DETERMINISTIC_INFO: 1
      BLOCK_NUM: 0xFFFFFFFF
      FUNCTION_ENTRY: 1
      .ascend.meta. [0]: AcosCustom_da824ede53d7e754f85c14b9446ec2fc_2_mix_aiv
      KERNEL_TYPE: MIX_AIV_MAIN
      MIX_TASK_RATION: [0:1]
      DETERMINISTIC_INFO: 1
      BLOCK_NUM: 0xFFFFFFFF
      FUNCTION_ENTRY: 2
      .ascend.meta. [0]: AcosCustom_da824ede53d7e754f85c14b9446ec2fc_3_mix_aiv
      KERNEL_TYPE: MIX_AIV_MAIN
      DETERMINISTIC_INFO: 1
      BLOCK_NUM: 0xFFFFFFFF
      FUNCTION_ENTRY: 3
      
    • Full printing
      msobjdump --dump-elf ${cmake_install_dir}/op_api/lib/libcust_opapi.so --verbose

      After this command is executed, the basic device information is displayed on the device screen, as shown in the following:

       1
       2
       3
       4
       5
       6
       7
       8
       9
      10
      11
      12
      13
      14
      15
      16
      17
      18
      19
      20
      21
      22
      23
      24
      25
      26
      27
      28
      29
      30
      31
      32
      33
      34
      35
      36
      37
      38
      39
      .ascend.meta META INFO
      VERSION: 1
      DEBUG: debugBufSize=0, debugOptions=0
      DYNAMIC_PARAM: dynamicParamMode=0
      OPTIONAL_PARAM: optionalInputMode=1, optionalOutputMode=1
      .ascend.meta. [0]: AcosCustom_dad9c8ca8fcbfd789010c8b1c0da8e26_1
      KERNEL_TYPE: AIV
      DETERMINISTIC_INFO: 1
      BLOCK_NUM: 0xFFFFFFFF
      FUNCTION_ENTRY: 1
      .ascend.meta. [0]: AcosCustom_dad9c8ca8fcbfd789010c8b1c0da8e26_2_mix_aiv
      KERNEL_TYPE: MIX_AIV_MAIN
      MIX_TASK_RATION: [0:1]
      DETERMINISTIC_INFO: 1
      BLOCK_NUM: 0xFFFFFFFF
      FUNCTION_ENTRY: 2
      .ascend.meta. [0]: AcosCustom_dad9c8ca8fcbfd789010c8b1c0da8e26_3_mix_aiv
      KERNEL_TYPE: MIX_AIV_MAIN
      MIX_TASK_RATION: [0:1]
      DETERMINISTIC_INFO: 1
      BLOCK_NUM: 0xFFFFFFFF
      FUNCTION_ENTRY: 3
      ....................................
      .ascend.meta. [0]: AcosCustom_da824ede53d7e754f85c14b9446ec2fc_1
      KERNEL_TYPE: AIV
      DETERMINISTIC_INFO: 1
      BLOCK_NUM: 0xFFFFFFFF
      FUNCTION_ENTRY: 1
      .ascend.meta. [0]: AcosCustom_da824ede53d7e754f85c14b9446ec2fc_2_mix_aiv
      KERNEL_TYPE: MIX_AIV_MAIN
      MIX_TASK_RATION: [0:1]
      DETERMINISTIC_INFO: 1
      BLOCK_NUM: 0xFFFFFFFF
      FUNCTION_ENTRY: 2
      .ascend.meta. [0]: AcosCustom_da824ede53d7e754f85c14b9446ec2fc_3_mix_aiv
      KERNEL_TYPE: MIX_AIV_MAIN
      DETERMINISTIC_INFO: 1
      BLOCK_NUM: 0xFFFFFFFF
      FUNCTION_ENTRY: 3
      
       1
       2
       3
       4
       5
       6
       7
       8
       9
      10
      11
      12
      13
      14
      15
      16
      17
      18
      19
      20
      21
      22
      23
      24
      25
      26
      27
      28
      29
      30
      31
      32
      33
      34
      35
      36
      37
      38
      39
      40
      41
      42
      43
      44
      45
      ....................................
      ===== [elf heard infos] in ascendxxx_acos_custom_AcosCustom_da824ede53d7e754f85c14b9446ec2fc.o =====:
      ELF Header:
        Magic:   7f 45 4c 46 02 01 01 00 00 00 00 00 00 00 00 00
        Class:                             ELF64
        Data:                              2's complement, little endian
        Version:                           1 (current)
        OS/ABI:                            UNIX - System V
        ................................................
        Size of program headers:           56 (bytes)
        Number of program headers:         3
        Size of section headers:           64 (bytes)
        Number of section headers:         9
        Section header string table index: 7
      Section Headers:
        [Nr] Name              Type            Address          Off    Size   ES Flg Lk Inf Al
        [ 0]                   NULL            0000000000000000 000000 000000 00      0   0  0 
         .....................................................................................
        [ 8] .strtab           STRTAB          0000000000000000 00529b 000119 00      0   0  1
      Key to Flags:
        W (write), A (alloc), X (execute), M (merge), S (strings), I (info),
        L (link order), O (extra OS processing required), G (group), T (TLS),
        C (compressed), x (unknown), o (OS specific), E (exclude),
        D (mbind), p (processor specific)
      ................................................
      
      ===== [elf heard infos] in ascendxxx_matmul_leakyrelu_custom_MatmulLeakyreluCustom_e052bee3255764ac919095f3bdf83389.o =====:
      ELF Header:
        Magic:   7f 45 4c 46 02 01 01 00 00 00 00 00 00 00 00 00
        Class:                             ELF64
        Data:                              2's complement, little endian
        Version:                           1 (current)
        ................................................
        Section header string table index: 6
      Section Headers:
        [Nr] Name              Type            Address          Off    Size   ES Flg Lk Inf Al
        [ 0]                   NULL            0000000000000000 000000 000000 00      0   0  0
        [ 1] .text             PROGBITS        0000000000000000 0000e8 007ed8 00  AX  0   0  4
        [ 2] .data             PROGBITS        0000000000008000 0080e8 000008 00  WA  0   0 256
        [ 3] .comment          PROGBITS        0000000000000000 0080f0 000043 01  MS  0   0  1
        [ 4] .bl_uninit        NOBITS          0000000000000000 008133 000020 00      0   0  1
        [ 5] .symtab           SYMTAB          0000000000000000 008138 0000c0 18      7   1  8
        [ 6] .shstrtab         STRTAB          0000000000000000 0081f8 00003b 00      0   0  1
        [ 7] .strtab           STRTAB          0000000000000000 008233 0000ec 00      0   0  1
        ................................................
      
  • Decompressing the library file that contains device information and flushing the file to the disk
    msobjdump --extract-elf ${cmake_install_dir}/op_api/lib/libcust_opapi.so 

    After this command is executed, the decompressed file is saved in the current execution path by default. The directory is as follows:

    |-- config                                                               // Directory of the operator prototype configuration file
    |    ├── ${soc_version}   
    |        ├── acos_custom.json                                  
    |        ├── matmul_leakyrelu_custom.json                               
    |        ├── .......                                             
    |-- ${soc_version}                                                   // AI processor name
    |     ├── acos_custom                                               // Basic single-operator compilation file (*.o) and the corresponding *.json file
    |         ├── AcosCustom_da824ede53d7e754f85c14b9446ec2fc.json      // Naming rules: ${op_type}_${parm_info}.json or ${op_type}_${parm_info}.o, where ${parm_info} is the identifier generated based on the operator input/output information such as the data type and shape.
    |         ├── AcosCustom_da824ede53d7e754f85c14b9446ec2fc.o
    |         ├── AcosCustom_dad9c8ca8fcbfd789010c8b1c0da8e26.json
    |         ├── AcosCustom_dad9c8ca8fcbfd789010c8b1c0da8e26.o
    |     ├── matmul_leakyrelu_custom  
    |         ├── MatmulLeakyreluCustom_e052bee3255764ac919095f3bdf83389.json
    |         ├── MatmulLeakyreluCustom_e052bee3255764ac919095f3bdf83389.o
    |     ├── axpy_custom    
    |         ├── .....

    The following uses the decompression of the acos_custom operator compilation result as an example:

    • View the operator prototype (acos_custom.json).
        1
        2
        3
        4
        5
        6
        7
        8
        9
       10
       11
       12
       13
       14
       15
       16
       17
       18
       19
       20
       21
       22
       23
       24
       25
       26
       27
       28
       29
       30
       31
       32
       33
       34
       35
       36
       37
       38
       39
       40
       41
       42
       43
       44
       45
       46
       47
       48
       49
       50
       51
       52
       53
       54
       55
       56
       57
       58
       59
       60
       61
       62
       63
       64
       65
       66
       67
       68
       69
       70
       71
       72
       73
       74
       75
       76
       77
       78
       79
       80
       81
       82
       83
       84
       85
       86
       87
       88
       89
       90
       91
       92
       93
       94
       95
       96
       97
       98
       99
      100
      {
          "binList": [
              {
                  "implMode": "high_performance",
                  "int64Mode": false,
                  "simplifiedKeyMode": 0,
                  "simplifiedKey": [......],
                  "staticKey": "96b2b4bb2e3xxx,ee37ce8796ef139dexxxx",
                  "inputs": [
                      {
                          "name": "x",
                          "index": 0,
                          "dtype": "float32",
                          "format": "ND",
                          "paramType": "required",
                          "shape": [
                              -2
                          ],
                          "format_match_mode": "FormatAgnostic"
                      }
                  ],
                  "outputs": [
                      {
                          "name": "y",
                          "index": 0,
                          "dtype": "float32",
                          "format": "ND",
                          "paramType": "required",
                          "shape": [
                              -2
                          ],
                          "format_match_mode": "FormatAgnostic"
                      }
                  ],
                  "attrs": [
                      {
                          "name": "tmp",
                          "dtype": "int",
                          "value": 0
                      },
                      .........
                  ],
                  "opMode": "dynamic",
                  "optionalInputMode": "gen_placeholder",
                  "deterministic": "ignore",
                  "binInfo": {
                      "jsonFilePath": "ascendxxx/acos_custom/AcosCustom_da824ede53d7e754f85c14b9446ec2fc.json"
                  }
              },
              {
                  "implMode": "high_performance",
                  "int64Mode": false,
                  "simplifiedKeyMode": 0,
                  "simplifiedKey": [
        
                  ],
                  "staticKey": "27d6f997f2f3551axxxx,1385590c47affa578eb429xxx",
                  "inputs": [
                      {
                          "name": "x",
                          "index": 0,
                          "dtype": "float16",
                          "format": "ND",
                          "paramType": "required",
                          "shape": [
                              -2
                          ],
                          "format_match_mode": "FormatAgnostic"
                      }
                  ],
                  "outputs": [
                      {
                          "name": "y",
                          "index": 0,
                          "dtype": "float16",
                          "format": "ND",
                          "paramType": "required",
                          "shape": [
                              -2
                          ],
                          "format_match_mode": "FormatAgnostic"
                      }
                  ],
                  "attrs": [
                      {
                          "name": "tmp",
                          "dtype": "int",
                          "value": 0
                      },
                      .........
                  ],
                  "opMode": "dynamic",
                  "optionalInputMode": "gen_placeholder",
                  "deterministic": "ignore",
                  "binInfo": {
                      "jsonFilePath": "ascendxxx/acos_custom/AcosCustom_dad9c8ca8fcbfd789010c8b1c0da8e26.json"
                  }
              }
          ]
      }
      
    • To parse ${op_type}_${parm_info}.o to obtain the .ascend.meta section information, run the following command:
      msobjdump --dump-elf ./AcosCustom_da824ede53d7e754f85c14b9446ec2fc.o

      After this command is executed, the device screen displays the following information, with the fields similar to those in the library file. For details, see Table 5.

      1
      2
      3
      4
      5
      6
      7
      8
      .ascend.meta. [0]: AcosCustom_da824ede53d7e754f85c14b9446ec2fc_1
      KERNEL_TYPE: AIV
      .ascend.meta. [0]: AcosCustom_da824ede53d7e754f85c14b9446ec2fc_2_mix_aiv
      KERNEL_TYPE: MIX_AIV_MAIN
      MIX_TASK_RATION: [0:1]
      .ascend.meta. [0]: AcosCustom_da824ede53d7e754f85c14b9446ec2fc_3_mix_aiv
      KERNEL_TYPE: MIX_AIV_MAIN
      MIX_TASK_RATION: [0:1]
      
    • View ${op_type}_${parm_info}.json to obtain the operator information from the device file.
       1
       2
       3
       4
       5
       6
       7
       8
       9
      10
      11
      12
      13
      14
      15
      16
      17
      18
      19
      20
      21
      22
      23
      24
      25
      26
      27
      28
      29
      30
      31
      32
      33
      34
      35
      36
      37
      38
      39
      40
      41
      42
      43
      44
      45
      46
      47
      48
      49
      50
      51
      52
      53
      54
      55
      56
      57
      58
      59
      60
      61
      62
      63
      64
      65
      66
      67
      68
      69
      70
      71
      72
      73
      74
      75
      76
      77
      78
      79
      80
      81
      82
      {
          "binFileName": "AcosCustom_da824ede53d7e754f85c14b9446ec2fc",
          "binFileSuffix": ".o",
          "blockDim": -1,
          "coreType": "MIX",
          "intercoreSync": 1,
          "kernelName": "AcosCustom_da824ede53d7e754f85c14b9446ec2fc",
          "magic": "RT_DEV_BINARY_MAGIC_ELF",
          "memoryStamping": [],
          "opParaSize": 24,
          "parameters": [],
          "sha256": "94e32d04fcaf435411xxxxxxxx",
          "workspace": {
              "num": 1,
              "size": [
                  -1
              ],
              "type": [
                  0
              ]
          },
          "kernelList": [
              {
                  "tilingKey": 1,
                  "kernelType": "MIX_AIC",
                  "taskRation": "0:1",
                  "crossCoreSync": 0,
                  "kernelName": "AcosCustom_da824ede53d7e754f85c14b9446ec2fc_1"
              },
              .........
          ],
          "taskRation": "tilingKey",
          "optionalInputMode": "gen_placeholder",
          "debugOptions": "printf",
          "debugBufSize": 78643200,
          "compileInfo": {},
          "supportInfo": {                                                        // Operator prototype information
              "implMode": "high_performance",
              "int64Mode": false,
              "simplifiedKeyMode": 0,
              "simplifiedKey": [......],
              "staticKey": "96b2b4bb2e35fa3dxxx,ee37ce8796ef139dedxxxxxxxx",
              "inputs": [
                  {
                      "name": "x",
                      "index": 0,
                      "dtype": "float32",
                      "format": "ND",
                      "paramType": "required",
                      "shape": [
                          -2
                      ],
                      "format_match_mode": "FormatAgnostic"
                  }
              ],
              "outputs": [
                  {
                      "name": "y",
                      "index": 0,
                      "dtype": "float32",
                      "format": "ND",
                      "paramType": "required",
                      "shape": [
                          -2
                      ],
                      "format_match_mode": "FormatAgnostic"
                  }
              ],
              "attrs": [
                  {
                      "name": "tmp",
                      "dtype": "int",
                      "value": 0
                  },
                  .........
              ],
              "opMode": "dynamic",
              "optionalInputMode": "gen_placeholder",
              "deterministic": "ignore"
          },
          "filePath": "ascendxxx/acos_custom/AcosCustom_da824ede53d7e754f85c14b9446ec2fc.json"
      }
      
  • Obtaining the list of library files that contain device information
    msobjdump --list-elf ${cmake_install_dir}/op_api/lib/libcust_opapi.so 

    After this command is executed, all files are displayed on the device screen, as shown in the following:

    1
    2
    3
    4
    5
    ELF file    0: ascendxxx_acos_custom_AcosCustom_dad9c8ca8fcbfd789010c8b1c0da8e26.json
    ELF file    1: ascendxxx_acos_custom_AcosCustom_dad9c8ca8fcbfd789010c8b1c0da8e26.o
    ....................
    ELF file    2: ascendxxx_acos_custom_AcosCustom_da824ede53d7e754f85c14b9446ec2fc.json
    ELF file    3: ascendxxx_acos_custom_AcosCustom_da824ede53d7e754f85c14b9446ec2fc.o