Documentation
Rate This Document
Findability
Accuracy
Completeness
Readability
SubmitClose

Evaluating Software Porting Using Command Lines

Command Function

Scans and analyzes software packages (non-source packages) and installed software, and provides porting assessment reports.

Syntax

devkit porting pkg-mig -i,--input path-to-package [-o,--output path-to-output] [-r,--report-type {all/json/html/csv}] [-l,--log-level {0/1/2/3} ] [--set-timeout time-limit-for-task] [-t,--target-os target-os]

Parameter Description

Table 1 Parameter description

Argument

Parameter

Description

-i/--input

path-to-package

Path of the software package to be scanned. Use commas (,) to separate multiple paths. The supported software package formats include RPM, DEB, JAR/WAR, TAR, ZIP, and GZIP.

This parameter is mandatory.

Example: home/test1.jar, /home/test2.jar

-t/--target-os

target-os

Target OS to be scanned.

This parameter is optional.

-o/--output

path-to-output

Path for storing the report.

This parameter is optional.

By default, the report is saved in the current execution path and is named in the format of Feature name_Timestamp.

--set-timeout

time-limit-for-task

Task timeout period.

This parameter is optional.

By default, there is no timeout interval. The task will be executed until it is complete.

-l/--log-level

0,1,2,3

Task log level.

This parameter is optional. The options are 0 (DEBUG), 1 (INFO), 2 (WARNING), and 3 (ERROR). The default is 1 (INFO).

-r/--report-type

all,json,html,csv

Format of the scan report.

This parameter is optional.

The default value is all, indicating that JSON, HTML, and CSV reports are generated.

Example

Replace the path in the following example command with the actual path of the software package to be scanned.

devkit porting pkg-mig -i impala-2.9.0+cdh5.12.1+0-1.cdh5.12.1.p0.3.el7.x86_64.rpm

The following information is displayed and a report is generated:

Using the local system as target os: openeuler20.03sp1
Configuration:
    Task name: 20240229094505
    Scanned time: 2024-02-29 09:45:05
    Software package path: /opt/DevKit-CLI-24.0.RC1-Linux-Kunpeng/impala-2.9.0+cdh5.12.1+0-1.cdh5.12.1.p0.3.el7.x86_64.rpm
    Target OS: openeuler20.03sp1
    Target OS Kernel Version: 4.19.90
 
Summary:
    Compatible: 6, To be Verified: 25, Total Dependencies: 31
 
For the detailed information, please check: 
/opt/DevKit-CLI-24.0.RC1-Linux-Kunpeng/pkg-mig_20240229014505_dacb.csv
/opt/DevKit-CLI-24.0.RC1-Linux-Kunpeng/pkg-mig_20240229014505_dacb.html
/opt/DevKit-CLI-24.0.RC1-Linux-Kunpeng/pkg-mig_20240229014505_dacb.json

Output Description

Table 2 Output report parameters

Parameter

Description

Configuration

Displays the software package path, software package name, target OS, target OS kernel version, and assessment result.

Architecture-Related Dependencies

Displays the SO files.

  • You can click Download in the Handling Suggestions column to download the dynamic libraries, static library files, software packages, executable files, and JAR packages that are compatible with the Kunpeng platform. You can also download the source code of the Kunpeng version and compile it. For some non–open-source dependency files, the download URLs are not available. You need to obtain the files yourself and use them to replace the architecture-related dependency files.
  • If the compatibility with the Kunpeng platform is unknown, verify the compatibility on the Kunpeng platform first. If the software is not compatible with the Kunpeng platform, obtain a compatible version from the vendor, obtain the source code and compile it, or use alternative software.
    NOTE:

    If a message indicating that the file is compatible with the Kunpeng platform is displayed in the Handling Suggestions column, the object to be analyzed is a ported software package or source package, and the x86 dependency file has a corresponding Kunpeng dependency file on the Kunpeng platform.