Bug 2316806 - Review Request: arm-compute-library - ARM compute library
Summary: Review Request: arm-compute-library - ARM compute library
Keywords:
Status: CLOSED RAWHIDE
Alias: None
Product: Fedora
Classification: Fedora
Component: Package Review
Version: rawhide
Hardware: Unspecified
OS: Linux
unspecified
medium
Target Milestone: ---
Assignee: Jeremy Linton
QA Contact: Fedora Extras Quality Assurance
URL: https://github.com/arm-software/Compu...
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2024-10-06 12:29 UTC by Ali Erdinc Koroglu
Modified: 2024-11-05 18:13 UTC (History)
2 users (show)

Fixed In Version:
Clone Of:
Environment:
Last Closed: 2024-11-05 18:13:03 UTC
Type: ---
Embargoed:
jeremy.linton: fedora-review+


Attachments (Terms of Use)
The .spec file difference from Copr build 8111692 to 8113317 (652 bytes, patch)
2024-10-07 11:29 UTC, Fedora Review Service
no flags Details | Diff

Description Ali Erdinc Koroglu 2024-10-06 12:29:08 UTC
SPEC Url: https://download.copr.fedorainfracloud.org/results/aekoroglu/fedora/fedora-rawhide-x86_64/08111630-ComputeLibrary/ComputeLibrary.spec
SRPM Url: https://download.copr.fedorainfracloud.org/results/aekoroglu/fedora/fedora-rawhide-x86_64/08111630-ComputeLibrary/ComputeLibrary-24.09-1.fc42.src.rpm

Description:
The Compute Library is a collection of low-level machine learning functions
optimized for Arm Cortex-A, Arm Neoverse and Arm Mali GPUs architectures.

The library provides superior performance to other open source alternatives
and immediate support for new Arm® technologies e.g. SVE2.

Reproducible: Always

Comment 1 Fedora Review Service 2024-10-06 12:58:27 UTC
Copr build:
https://copr.fedorainfracloud.org/coprs/build/8111692
(succeeded)

Review template:
https://download.copr.fedorainfracloud.org/results/@fedora-review/fedora-review-2316806-computelibrary/fedora-rawhide-x86_64/08111692-ComputeLibrary/fedora-review/review.txt

Found issues:

- License file LICENSE.txt is not marked as %license
  Read more: https://docs.fedoraproject.org/en-US/packaging-guidelines/LicensingGuidelines/#_license_text

Please know that there can be false-positives.

---
This comment was created by the fedora-review-service
https://github.com/FrostyX/fedora-review-service

If you want to trigger a new Copr build, add a comment containing new
Spec and SRPM URLs or [fedora-review-service-build] string.

Comment 3 Fedora Review Service 2024-10-07 11:29:56 UTC
Created attachment 2050829 [details]
The .spec file difference from Copr build 8111692 to 8113317

Comment 4 Fedora Review Service 2024-10-07 11:29:59 UTC
Copr build:
https://copr.fedorainfracloud.org/coprs/build/8113317
(succeeded)

Review template:
https://download.copr.fedorainfracloud.org/results/@fedora-review/fedora-review-2316806-computelibrary/fedora-rawhide-x86_64/08113317-ComputeLibrary/fedora-review/review.txt

Please take a look if any issues were found.


---
This comment was created by the fedora-review-service
https://github.com/FrostyX/fedora-review-service

If you want to trigger a new Copr build, add a comment containing new
Spec and SRPM URLs or [fedora-review-service-build] string.

Comment 5 Jeremy Linton 2024-10-07 16:40:20 UTC
At first glance, I think you also need excludeArch tracker bugs for s390x and ppc64.

Should you ship a pkgconf file in the -devel package?

%check stanza?

Comment 6 Jeremy Linton 2024-10-07 22:16:31 UTC
Package Review
==============

Legend:
[x] = Pass, [!] = Fail, [-] = Not applicable, [?] = Not evaluated

===== Reviewer Added =====

# Per https://docs.fedoraproject.org/en-US/packaging-guidelines/#_devel_packages
[!] Should probably have a pkgconf .pc file in -devel
[!] Subpackages need to require base package
    JL: The -devel needs to require the exact package version, per above link, or just
    the main guidelines which mention 'Requires: %{name}%{?_isa} = %{version}-%{release}`
    for subpackages.
[!] The manual .so symlinking can probably be avoided by using scons's InstallVesionedLib() call
    JL: I think some of this falls out once that is fixed to install directly to %buildroot
        which will further simplify some of the %install linking/moving going on.
        I'm going to mark the macro usage below ok, but I suspect the build/buildroot/lib
	hardcodings can/should go away.

===== MUST items =====

C/C++:
[X]: Package does not contain kernel modules.
[x]: If your application is a C or C++ application you must list a
     BuildRequires against gcc, gcc-c++ or clang.
[x]: Header files in -devel subpackage, if present.
[x]: ldconfig not called in %post and %postun for Fedora 28 and later.
[x]: Package does not contain any libtool archives (.la)
[x]: Package contains no static executables.
[x]: Rpath absent or only used for internal libs.
[x]: Development (unversioned) .so files in -devel subpackage, if present.

Generic:
[X]: Package is licensed with an open-source compatible license and meets
     other legal requirements as defined in the legal section of Packaging
     Guidelines.
[!]: License field in the package spec file matches the actual license.
     Note: Checking patched sources after %prep for licenses. Licenses
     found: "MIT License", "Unknown or generated", "*No copyright* Apache
     License 2.0 and/or MIT License", "Apache License 2.0", "*No copyright*
     MIT License", "MIT License and/or The Unlicense". 29 files have
     unknown license. Detailed output of licensecheck in
     /home/jlinton/2316806-ComputeLibrary/licensecheck.txt

     JL: I think this probably deserves a apache AND mit clause, especially
         for the -devel package? INAL..
     
[X]: License file installed when any subpackage combination is installed.
[!]: Package does not own files or directories owned by other packages.
     Note: Dirs in package are owned also by: /usr/include/CL(opencl-
     headers), /usr/include/stb(stb_image-devel, stb_hexwave-devel,
     stb_connected_components-devel, stb_leakcheck-devel,
     stb_herringbone_wang_tile-devel, stb_sprintf-devel, stb_truetype-
     devel, stb_easy_font-devel, stb_image_write-devel,
     stb_image_resize2-devel, stb_vorbis-devel, stb_textedit-devel,
     stb_rect_pack-devel, stb_tilemap_editor-devel, stb_ds-devel,
     stb_perlin-devel, stb_voxel_render-devel, stb_divide-devel,
     stb_image_resize-devel, stb_dxt-devel, stb_c_lexer-devel)

     JL: I think this is going to force the includes to be installed in
     ex: include/ArmCompute/* and updated with the pkgconf for utilities utilizing
     this library? Per: https://docs.fedoraproject.org/en-US/packaging-guidelines/Conflicts/#_header_name_conflicts
     
[X]: %build honors applicable compiler flags or justifies otherwise.
[X]: Package contains no bundled libraries without FPC exception.
[X]: Changelog in prescribed format.
[X]: Sources contain only permissible code or content.
[-]: Package contains desktop file if it is a GUI application.
[X]: Development files must be in a -devel package
[X]: Package uses nothing in %doc for runtime.
[X]: Package consistently uses macros (instead of hard-coded directory
     names).
   ->JL: If the %install section is cleaned up by the package this
         will remove all the duplicate build/buildroot/lib pathing
[-]: Package is named according to the Package Naming Guidelines.
     JL: Mixed case is allowed but the guidelines state:
         "Package names SHOULD be in lower case and use dashes in preference to underscores."
	 and
	 "While case sensitivity is not a mandatory requirement, case SHOULD only be used where necessary."
	 At the same time Fedora should follow other distro's naming conventions.
	 Suse uses "ComputeLibrary", upstream is using "arm_compute", debian is
	 "arm-compute-library". Its that latter case which is closest to the fedora
	 guidelines. So, I think that is probably a reasonable choice too.
	 
	 The full guideslines: https://docs.fedoraproject.org/en-US/packaging-guidelines/Naming/

[X]: Package does not generate any conflict.
[X]: Package obeys FHS, except libexecdir and /usr/target.
[-]: If the package is a rename of another package, proper Obsoletes and
     Provides are present.
[!]: Requires correct, justified where necessary.
[X]: Spec file is legible and written in American English.
[-]: Package contains systemd file(s) if in need.
[X]: Useful -debuginfo package or justification otherwise.
[!]: Package is not known to require an ExcludeArch tag.
     JL: This is probably OK since the upstream doesn't support
         PPC64/S390X but appropriate ExcludeArch defects need to
	 be opened again those architectures and included in .spec
	 comment.
[!]: Package complies to the Packaging Guidelines
     JL: missing man pages in upstream, there appears to be doxygen pages
         so it may be useful to generate man pages from that.
	 Its also noteworthy that it seems the default optimization flag is
	 overridden by upstream, but that isn't something I think needs changing
	 since other flags continue to be carried (-mbranch-protection, etc).
[x]: Package successfully compiles and builds into binary rpms on at least
     one supported primary architecture.
[x]: Package installs properly.
[x]: Rpmlint is run on all rpms the build produces.
     Note: There are rpmlint messages (see attachment).
[x]: If (and only if) the source package includes the text of the
     license(s) in its own file, then that file, containing the text of the
     license(s) for the package is included in %license.
[x]: The License field must be a valid SPDX expression.
[x]: Package requires other packages for directories it uses.
[x]: Package must own all directories that it creates.
[x]: Package uses either %{buildroot} or $RPM_BUILD_ROOT
[x]: Package does not run rm -rf %{buildroot} (or $RPM_BUILD_ROOT) at the
     beginning of %install.
[x]: Macros in Summary, %description expandable at SRPM build time.
[x]: Dist tag is present.
[x]: Package does not contain duplicates in %files.
[x]: Permissions on files are set properly.
[x]: Package must not depend on deprecated() packages.
[x]: Package use %makeinstall only when make install DESTDIR=... doesn't
     work.
[x]: Package is named using only allowed ASCII characters.
[x]: Package does not use a name that already exists.
[x]: Package is not relocatable.
[x]: Sources used to build the package match the upstream source, as
     provided in the spec URL.
[x]: Spec file name must match the spec package %{name}, in the format
     %{name}.spec.
[x]: File names are valid UTF-8.
[x]: Large documentation must go in a -doc subpackage. Large could be size
     (~1MB) or number of files.
     Note: Documentation size is 9596 bytes in 1 files.
[x]: Packages must not store files under /srv, /opt or /usr/local

===== SHOULD items =====

Generic:
[X]: If the source package does not include license text(s) as a separate
     file from upstream, the packager SHOULD query upstream to include it.
[!]: Final provides and requires are sane (see attachments).
     JL: Where did the ocl-icd library go? Should that be required?    
[X]: Package functions as described.
[X]: Latest version is packaged.
[X]: Package does not include license text files separate from upstream.
[-]: Sources are verified with gpgverify first in %prep if upstream
     publishes signatures.
     Note: gpgverify is not used.
     JL: No apparent upstream signature
[!]: %check is present and all tests pass.
     JL: Package should probably build with `validation_tests=1` and
         then run `build/buildroot/bin/arm_compute_validation --tests`
	 which will work better once the install sets up the correct
	 soname symlinks. If the buildroot path is fixed too that avoids
	 needing to set a custom LD_LIBRARY_PATH to run them.
[X]: Packages should try to preserve timestamps of original installed
     files.
[x]: Reviewer should test that the package builds in mock.
[x]: Buildroot is not present
[x]: Package has no %clean section with rm -rf %{buildroot} (or
     $RPM_BUILD_ROOT)
[x]: No file requires outside of /etc, /bin, /sbin, /usr/bin, /usr/sbin.
[x]: Fully versioned dependency in subpackages if applicable.
[x]: Packager, Vendor, PreReq, Copyright tags should not be in spec file
[x]: Sources can be downloaded from URI in Source: tag
[x]: SourceX is a working URL.
[x]: Package should compile and build into binary rpms on all supported
     architectures.
[x]: Spec use %global instead of %define unless justified.

===== EXTRA items =====

Generic:
[x]: Rpmlint is run on debuginfo package(s).
     Note: No rpmlint messages.
[x]: Rpmlint is run on all installed packages.
     Note: There are rpmlint messages (see attachment).
[x]: Large data in /usr/share should live in a noarch subpackage if package
     is arched.
[x]: Spec file according to URL is the same as in SRPM.


Rpmlint
-------
Checking: ComputeLibrary-24.09-1.fc42.aarch64.rpm
          ComputeLibrary-devel-24.09-1.fc42.aarch64.rpm
          ComputeLibrary-debuginfo-24.09-1.fc42.aarch64.rpm
          ComputeLibrary-debugsource-24.09-1.fc42.aarch64.rpm
          ComputeLibrary-24.09-1.fc42.src.rpm
============================================================================ rpmlint session starts ============================================================================
rpmlint: 2.5.0
configuration:
    /usr/lib/python3.12/site-packages/rpmlint/configdefaults.toml
    /etc/xdg/rpmlint/fedora-legacy-licenses.toml
    /etc/xdg/rpmlint/fedora-spdx-licenses.toml
    /etc/xdg/rpmlint/fedora.toml
    /etc/xdg/rpmlint/scoring.toml
    /etc/xdg/rpmlint/users-groups.toml
    /etc/xdg/rpmlint/warn-on-functions.toml
rpmlintrc: [PosixPath('/tmp/tmphj6nw6we')]
checks: 32, packages: 5

ComputeLibrary-devel.aarch64: W: no-documentation
====================================== 5 packages and 0 specfiles checked; 0 errors, 1 warnings, 35 filtered, 0 badness; has taken 8.1 s =======================================




Rpmlint (debuginfo)
-------------------
Checking: ComputeLibrary-debuginfo-24.09-1.fc42.aarch64.rpm
============================================================================ rpmlint session starts ============================================================================
rpmlint: 2.5.0
configuration:
    /usr/lib/python3.12/site-packages/rpmlint/configdefaults.toml
    /etc/xdg/rpmlint/fedora-legacy-licenses.toml
    /etc/xdg/rpmlint/fedora-spdx-licenses.toml
    /etc/xdg/rpmlint/fedora.toml
    /etc/xdg/rpmlint/scoring.toml
    /etc/xdg/rpmlint/users-groups.toml
    /etc/xdg/rpmlint/warn-on-functions.toml
rpmlintrc: [PosixPath('/tmp/tmpey7cv_1l')]
checks: 32, packages: 1

======================================= 1 packages and 0 specfiles checked; 0 errors, 0 warnings, 7 filtered, 0 badness; has taken 1.8 s =======================================





Rpmlint (installed packages)
----------------------------
============================ rpmlint session starts ============================
rpmlint: 2.5.0
configuration:
    /usr/lib/python3.13/site-packages/rpmlint/configdefaults.toml
    /etc/xdg/rpmlint/fedora-spdx-licenses.toml
    /etc/xdg/rpmlint/fedora.toml
    /etc/xdg/rpmlint/scoring.toml
    /etc/xdg/rpmlint/users-groups.toml
    /etc/xdg/rpmlint/warn-on-functions.toml
checks: 32, packages: 4

ComputeLibrary-devel.aarch64: W: no-documentation
 4 packages and 0 specfiles checked; 0 errors, 1 warnings, 32 filtered, 0 badness; has taken 6.2 s 



Source checksums
----------------
https://github.com/arm-software/ComputeLibrary/archive/v24.09/ComputeLibrary-24.09.tar.gz :
  CHECKSUM(SHA256) this package     : 49b8620f21cbbe49e825a131d9eacd548532646289b50e070b83860bd88087fe
  CHECKSUM(SHA256) upstream package : 49b8620f21cbbe49e825a131d9eacd548532646289b50e070b83860bd88087fe


Requires
--------
ComputeLibrary (rpmlib, GLIBC filtered):
    ld-linux-aarch64.so.1()(64bit)
    libarm_compute.so.42()(64bit)
    libc.so.6()(64bit)
    libgcc_s.so.1()(64bit)
    libgcc_s.so.1(GCC_3.0)(64bit)
    libgcc_s.so.1(GCC_3.3.1)(64bit)
    libm.so.6()(64bit)
    libstdc++.so.6()(64bit)
    libstdc++.so.6(CXXABI_1.3)(64bit)
    libstdc++.so.6(CXXABI_1.3.13)(64bit)
    libstdc++.so.6(CXXABI_1.3.15)(64bit)
    libstdc++.so.6(CXXABI_1.3.3)(64bit)
    libstdc++.so.6(CXXABI_1.3.5)(64bit)
    libstdc++.so.6(CXXABI_1.3.9)(64bit)
    rtld(GNU_HASH)

ComputeLibrary-devel (rpmlib, GLIBC filtered):
    ComputeLibrary(aarch-64)

ComputeLibrary-debuginfo (rpmlib, GLIBC filtered):

ComputeLibrary-debugsource (rpmlib, GLIBC filtered):



Provides
--------
ComputeLibrary:
    ComputeLibrary
    ComputeLibrary(aarch-64)
    libarm_compute.so.42()(64bit)
    libarm_compute_graph.so.42()(64bit)

ComputeLibrary-devel:
    ComputeLibrary-devel
    ComputeLibrary-devel(aarch-64)

ComputeLibrary-debuginfo:
    ComputeLibrary-debuginfo
    ComputeLibrary-debuginfo(aarch-64)
    debuginfo(build-id)
    libarm_compute.so.42.0.0-24.09-1.fc42.aarch64.debug()(64bit)
    libarm_compute_graph.so.42.0.0-24.09-1.fc42.aarch64.debug()(64bit)

ComputeLibrary-debugsource:
    ComputeLibrary-debugsource
    ComputeLibrary-debugsource(aarch-64)



Generated by fedora-review 0.10.0 (e79b66b) last change: 2023-07-24
Command line :/usr/bin/fedora-review -b 2316806
Buildroot used: fedora-rawhide-aarch64
Active plugins: C/C++, Generic, Shell-api
Disabled plugins: PHP, Java, fonts, Python, SugarActivity, R, Perl, Ocaml, Haskell
Disabled flags: EXARCH, EPEL6, EPEL7, DISTTAG, BATCH

Comment 7 Jeremy Linton 2024-10-10 21:11:33 UTC
There isn't any need to reopen a new defects for the 'failure' cases, just fix them and post new SPEC and SRPM Url's here.

Then when we agree everything is good, I can approve it here.

Comment 9 Jeremy Linton 2024-10-18 15:57:40 UTC
Its looking  pretty good, but i don't see:

1)
Should probably have a pkgconf .pc file in -devel?

This is helpful since the include directories now need to be explicitly overwritten by users of the library since its not directly in /usr/include.

2) 

The excludearch bugs/comment. Ex open two bugs. One against:

https://bugzilla.redhat.com/show_bug.cgi?id=238953

and another against:

https://bugzilla.redhat.com/show_bug.cgi?id=485231

Note the bug numbers in the ExcludeArch comment in the .spec file.

3)

And sorry about this one, but I was thinking about this after I posted the review template, but the OpenCL, Half, etc headers being shipped in the -devel package here
should probably be stripped since they duplicate existing packages in fedora, and unless it won't build/work without them this probably partially falls under 
" Package contains no bundled libraries without FPC exception."

See: https://docs.fedoraproject.org/en-US/packaging-guidelines/#bundling

Comment 10 Jeremy Linton 2024-10-24 19:18:49 UTC
I think in the case of the exclude arch bugs, there is a bit of a chicken/egg problem with the lack of a component to open them against. So just acknowledging they will be opened and added to the .spec once the repo/etc is created can/will be sufficient.

Comment 12 Fedora Review Service 2024-10-29 18:56:08 UTC
Copr build:
https://copr.fedorainfracloud.org/coprs/build/8187225
(succeeded)

Review template:
https://download.copr.fedorainfracloud.org/results/@fedora-review/fedora-review-2316806-arm-compute-library/fedora-rawhide-x86_64/08187225-arm-compute-library/fedora-review/review.txt

Please take a look if any issues were found.


---
This comment was created by the fedora-review-service
https://github.com/FrostyX/fedora-review-service

If you want to trigger a new Copr build, add a comment containing new
Spec and SRPM URLs or [fedora-review-service-build] string.

Comment 13 Jeremy Linton 2024-11-04 20:20:33 UTC
I'm going to mark it approved, but AFAIK there is an error in your .pc files. They should be:

includedir=/usr/include/ArmCompute/

which is the reason for including them.

Also, don't forget the exclude arch defects.

Comment 14 Fedora Admin user for bugzilla script actions 2024-11-05 14:33:18 UTC
The Pagure repository was created at https://src.fedoraproject.org/rpms/arm-compute-library

Comment 15 Ali Erdinc Koroglu 2024-11-05 18:13:03 UTC
Thank you Jeremy.

https://koji.fedoraproject.org/koji/buildinfo?buildID=2579279


Note You need to log in before you can comment on or make changes to this bug.