Skip to content

[SYCL] Deprecate legacy info::kernel descriptors#22520

Open
crystarm wants to merge 2 commits into
intel:syclfrom
crystarm:deprecate-legacy-kernel-info-descriptors
Open

[SYCL] Deprecate legacy info::kernel descriptors#22520
crystarm wants to merge 2 commits into
intel:syclfrom
crystarm:deprecate-legacy-kernel-info-descriptors

Conversation

@crystarm

@crystarm crystarm commented Jul 2, 2026

Copy link
Copy Markdown
Contributor

Fixes #22505.

Deprecate three undocumented legacy info::kernel descriptors that are not part of SYCL 2020:

  • info::kernel::function_name
  • info::kernel::reference_count
  • info::kernel::context

Each descriptor is now annotated with __SYCL_DEPRECATED(...) and guarded by #ifndef __INTEL_PREVIEW_BREAKING_CHANGES, following the same pattern as info::platform::profile and info::device::atomic64.

@crystarm crystarm requested a review from a team as a code owner July 2, 2026 11:38
@crystarm crystarm marked this pull request as draft July 2, 2026 11:57
Comment thread sycl/include/sycl/info/kernel.hpp Outdated
struct function_name : kernel_traits<UR_KERNEL_INFO_FUNCTION_NAME> {
#ifndef __INTEL_PREVIEW_BREAKING_CHANGES
struct __SYCL_DEPRECATED(
"info::kernel::function_name is a legacy descriptor not part of SYCL "

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I doubt we should explain that it is a legacy descriptor here. usually we just say that something is deprecated.

@dm-vodopyanov can you please guide us here?

@crystarm crystarm force-pushed the deprecate-legacy-kernel-info-descriptors branch from d6e8473 to 7af6a9c Compare July 2, 2026 12:15
@crystarm crystarm marked this pull request as ready for review July 2, 2026 12:25
Comment thread sycl/include/sycl/info/kernel.hpp

#ifndef __INTEL_PREVIEW_BREAKING_CHANGES
#include <sycl/detail/defines_elementary.hpp> // for __SYCL_DEPRECATED
#endif

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
#endif
#endif // __INTEL_PREVIEW_BREAKING_CHANGES

@KornevNikita

Copy link
Copy Markdown
Contributor

@crystarm could you please resolve format & pre-commit issues

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Remove undocumented kernel::info descriptors

3 participants