نام (NAME)

clinfo - نمایش پلتفرم‌ها و دستگاه‌های OpenCL

خلاصه دستور (SYNOPSIS)

clinfo [گزینه‌ها ...]

توضیحات (DESCRIPTION)

clinfo تمام اطلاعات موجود درباره تمام پلتفرم‌های OpenCL موجود در سیستم و دستگاه‌هایی که ارائه می‌دهند را چاپ می‌کند.

گزینه‌ها (OPTIONS)

clinfo گزینه‌های زیر را می‌پذیرد:

-a, --all-props

تلاش برای دریافت تمام ویژگی‌ها، حتی مواردی که به طور رسمی پشتیبانی نمی‌شوند (برای مثال به این دلیل که به افزونه‌های خاصی نیاز دارند)، اما فقط در صورتی نمایش داده می‌شوند که ویژگی با موفقیت دریافت شده باشد؛ همچنین بخش محدودیت‌ها (LIMITATIONS) در زیر را ببینید؛ توجه داشته باشید با وجود اینکه این کار ممکن است ویژگی‌های پنهان را آشکار کند، هیچ تضمینی وجود ندارد که مقادیر بازگردانده‌شده معنادار باشند یا قابلیت مربوطه در عمل اصلاً در دسترس باشد؛

-A, --always-all-props

مانند -a، اما خطاها را نیز نشان می‌دهد؛

--human

تولید خروجی خوانا برای انسان؛ این حالت پیش‌فرض است (به‌جز موارد ذکرشده در زیر)؛

--raw

تولید خروجی مناسب ماشین؛ این حالت پیش‌فرض است اگر clinfo با نامی فراخوانی شود که حاوی رشته “raw” باشد؛

--json

داده‌های خام را در قالب JSON خروجی می‌دهد (مقایسه کنید با گزینه --raw)؛ پشتیبانی از این گزینه آزمایشی است، زیرا نحوه نمایش برخی از مقادیر هنوز نهایی نشده است؛

--offline

دستگاه‌های آفلاین را نیز برای پلتفرم‌هایی که این قابلیت را ارائه می‌دهند نشان می‌دهد؛

--null-platform

تلاش می‌کند با پلتفرم NULL مانند یک پلتفرم عادی رفتار کند، و ویژگی‌ها و دستگاه‌های آن را دریافت کرده و نشان دهد؛ این علاوه بر آزمایش‌های رفتاری پلتفرم NULL است که در انتها انجام می‌شود، و می‌تواند در سیستم‌هایی که هیچ پلتفرم ICD در آن‌ها وجود ندارد، اما یک پلتفرم درون خود کتابخانه OpenCL به صورت مستقیم کدنویسی شده است، مفید باشد؛

-l, --list

فهرست کردن پلتفرم‌ها و دستگاه‌ها بر اساس نام، بدون ویژگی‌های (دیگر)؛

-d platform_index:device_index

--device platform_index:device_index

فقط ویژگی‌های دستگاه مشخص‌شده در پلتفرم مشخص‌شده را نشان می‌دهد؛ می‌توان چندین مشخصه دستگاه را در خط فرمان مشخص کرد؛

--prop property-name

فقط ویژگی‌هایی را نشان می‌دهد که نام نمادین آن‌ها با property-name داده‌شده مطابقت داشته باشد (آن را به عنوان یک زیررشته شامل شود)؛ نام به صورت حروف بزرگ و با جایگزینی خط فاصله (-) با خط زیر (_) نرمال‌سازی می‌شود؛ می‌توان چندین مشخصه ویژگی را در خط فرمان مشخص کرد؛ وقتی این فلگ مشخص شود، حالت خام (raw) اجباری می‌شود؛

--help, -?, -h

نمایش راهنمای استفاده؛

--version, -v

نمایش نسخه برنامه.

سازگاری با استانداردها (CONFORMING TO)

OpenCL 1.1, OpenCL 1.2, OpenCL 2.0, OpenCL 2.1, OpenCL 2.2, OpenCL 3.0.

افزونه‌ها (EXTENSIONS)

افزونه‌های پشتیبانی‌شده OpenCL:

cl_khr_device_uuid

برای UUID، LUID و ماسک گره (node mask) دستگاه؛

cl_khr_extended_versioning

برای ویژگی‌های نسخه‌بندی‌شده گسترش‌یافته پلتفرم، دستگاه، افزونه و IL که از OpenCL 3.0 به نسخه‌های پیشین OpenCL منتقل شده‌اند؛

cl_khr_fp16, cl_khr_fp64, cl_amd_fp64, cl_APPLE_fp64_basic_ops

برای اطلاعات درباره پشتیبانی از انواع داده‌های ممیز شناور با دقت نیمه (half-precision) و دقت مضاعف (double-precision)؛

cl_khr_image2d_from_buffer

برای اطلاعات درباره الزامات هم‌ترازی آدرس پایه و گام (pitch) بافرهایی که به عنوان پایه برای تصاویر دوبعدی استفاده می‌شوند؛

cl_khr_il_program

برای اطلاعات درباره نمایش‌های پشتیبانی‌شده زبان میانی (IL)؛

cl_khr_spir

برای اطلاعات درباره نسخه‌های پشتیبانی‌شده نمایش میانی استاندارد قابل حمل (SPIR)؛

cl_khr_icd

برای پسوند توابع افزونه‌های عرضه‌کننده؛

cl_khr_subgroup_named_barrier

برای حداکثر تعداد سدهای نام‌گذاری‌شده زیرگروه؛

cl_khr_terminate_context, cl_arm_controlled_kernel_termination

برای قابلیت‌های خاتمه دادن به دستگاه؛

cl_ext_device_fission

برای پشتیبانی از تقسیم دستگاه (device fission) در دستگاه‌های OpenCL 1.1؛

cl_khr_pci_bus_info

برای اطلاعات گذرگاه PCI (همچنین cl_nv_device_attribute_query و cl_amd_device_attribute_query را ببینید)؛

cl_ext_atomic_counters_32

cl_ext_atomic_counters_64

برای افزونه شمارنده‌های اتمیک؛

cl_ext_float_atomics

برای قابلیت‌های اتمیک ممیز شناور برای دقت نیمه، یگانه و مضاعف (بسته به پشتیبانی سخت‌افزار از اندازه ممیز شناور)؛

cl_ext_cxx_for_opencl

برای نسخه زبان C++ for OpenCL که توسط کامپایلر دستگاه پشتیبانی می‌شود؛

cl_amd_device_attribute_query

برای ویژگی‌های دستگاه اختصاصی AMD؛

cl_amd_object_metadata

برای نمایش حداکثر تعداد کلیدهای پشتیبانی‌شده توسط پلتفرم؛

cl_amd_offline_devices

برای نمایش دستگاه‌های آفلاین ارائه‌شده توسط پلتفرم، در صورت درخواست (گزینه --offline را ببینید)؛

cl_amd_copy_buffer_p2p

برای نمایش تعداد و شناسه‌های دستگاه‌های P2P موجود؛

cl_amd_svm

cl_arm_shared_virtual_memory

برای قابلیت‌های حافظه مجازی مشترک (SVM) در دستگاه‌های OpenCL 1.2؛

cl_arm_core_id

برای نمایش فهرست (احتمالاً تنک) شناسه‌های هسته‌ای که ممکن است دستگاه بازگرداند؛

cl_arm_job_slot_selection

برای نمایش فهرست (احتمالاً تنک) اسلات‌های کاری در دسترس برای ارسال دستورات؛

cl_arm_scheduling_controls

برای نمایش کنترل‌های زمان‌بندی کار پشتیبانی‌شده و مجموعه‌های موجود برای تخصیص ثبات‌ها؛

cl_nv_device_attribute_query

برای ویژگی‌های دستگاه اختصاصی NVIDIA؛

cl_intel_device_attribute_query

برای ویژگی‌های دستگاه اختصاصی Intel؛

cl_intel_exec_by_local_thread

برای افزونه Intel که به دستگاه‌های پردازنده (CPU) اجازه می‌دهد کرنل‌ها را به عنوان بخشی از نخ میزبان جاری اجرا کنند؛

cl_intel_advanced_motion_estimation

برای نسخه شتاب‌دهنده تخمین حرکت پیشرفته Intel؛

cl_intel_device_side_avc_motion_estimation

برای نسخه و قابلیت‌های پشتیبانی‌شده از تخمین حرکت AVC سمت دستگاه Intel؛

cl_intel_planar_yuv

برای حداکثر ابعاد تصاویر مسطح YUV؛

cl_intel_simultaneous_sharing

برای اشتراک‌گذاری همزمان کانتکست‌های CL/GL/DirectX (فقط پشتیبانی جزئی)؛

cl_intel_required_subgroup_size

برای شمارش اندازه‌های مجاز زیرگروه؛

cl_intel_command_queue_families

برای شمارش صف‌های دستور موجود و ویژگی‌ها و قابلیت‌های آن‌ها؛

cl_altera_device_temperature

برای افزونه Altera جهت پرس‌وجوی دمای هسته دستگاه؛

cl_qcom_ext_host_ptr

برای افزونه QUALCOMM جهت پرس‌وجوی اندازه صفحه و فاصله‌گذاری (padding) مورد نیاز در تخصیص حافظه خارجی.

نکات (NOTES)

برخی اطلاعات در صورتی که از چندین منبع در دسترس باشند، تکرار می‌شوند. مثال‌ها:

• انواع پارتیشن و دامنه‌های پشتیبانی‌شده دستگاه که با استفاده از افزونه cl_ext_device_fission به دست می‌آیند، معمولاً با موارد به‌دست‌آمده با استفاده از قابلیت پارتیشن دستگاه در هسته OpenCL 1.2 مطابقت دارند؛
• مضرب اندازه ترجیحی گروه کاری با اندازه warp انویدیا (روی دستگاه‌های NVIDIA) یا پهنای wavefront در AMD (روی دستگاه‌های AMD) مطابقت دارد.

برخی از فلگ‌های پیکربندی ممیز شناور ممکن است فقط برای دقت‌های خاص یا نسخه‌های خاصی از OpenCL معنادار باشند. به عنوان مثال، CL_FP_CORRECTLY_ROUNDED_DIVIDE_SQRT فقط برای دقت یگانه در دستگاه‌های OpenCL 1.2 مرتبط است.

رفتار تعریف‌شده توسط پیاده‌سازی برای پلتفرم NULL یا ویژگی‌های کانتکست، برای فراخوانی‌های API زیر آزمایش می‌شود:

clGetPlatformInfo()

با تلاش برای نمایش نام پلتفرم؛

clGetDeviceIDs()

با تلاش برای شمارش دستگاه‌ها؛ سپس پلتفرم مربوطه (در صورت وجود) با پرس‌وجوی پلتفرم دستگاه از نخستین دستگاه شناسایی می‌شود؛

clCreateteContext()

با تلاش برای ساخت یک کانتکست از یک دستگاه از فهرست قبلی (در صورت وجود)، و یک کانتکست از یک دستگاه از پلتفرمی دیگر؛

clCreateteContextFromType()

با تلاش برای ساخت کانتکست‌ها برای هر نوع دستگاه (به‌جز DEFAULT).

قابلیت‌های آزمایشی (EXPERIMENTAL FEATURES)

پشتیبانی از ویژگی‌های OpenCL 2.x به طور کامل آزمایش نشده است.

پشتیبانی از cl_khr_subgroup_named_barrier به دلیل نبود تعاریف در هدرهای رسمی OpenCL، آزمایشی است.

خروجی خام (قابل تجزیه توسط ماشین) آزمایشی در نظر گرفته می‌شود؛ قالب خروجی ممکن است همچنان دستخوش تغییرات شود.

ویژگی‌های بارگذار ICD نیز در صورتی که تابع افزونه clGetICDLoaderInfoOCLICD یافت شود، مورد پرس‌وجو قرار خواهند گرفت.

پشتیبانی از ویژگی‌های ارائه‌شده توسط cl_amd_copy_buffer_p2p آزمایشی است.

پشتیبانی از برخی ویژگی‌های (مستندشده و مستندنشده) ارائه‌شده توسط cl_amd_device_attribute_query آزمایشی است (همچنین بخش محدودیت‌ها (LIMITATIONS) را ببینید).

پشتیبانی از فهرست‌های تعامل‌پذیری (interop) ارائه‌شده توسط cl_intel_simultaneous_sharing آزمایشی است.

بالاترین نسخه OpenCL پشتیبانی‌شده توسط بارگذار ICD با برخی روش‌های اکتشافی ساده (نمادهای یافت‌شده) شناسایی می‌شود؛ در صورتی که این نسخه از بالاترین نسخه OpenCL پلتفرم کمتر باشد، یا اگر نسخه شناسایی‌شده با نسخه اعلام‌شده توسط خود بارگذار ICD مطابقت نداشته باشد، پیامی نمایش داده می‌شود.

محدودیت‌ها (LIMITATIONS)

OpenCL تا نسخه 3.0 روش صریحی برای تشخیص نسخه پشتیبانی‌شده از هر افزونه ارائه‌شده توسط یک دستگاه ارائه نکرده بود. این امر در بسیاری از شرایط، تعیین پیشینی این موضوع را که آیا پرس‌وجوی موفقیت‌آمیز یک ویژگی خاص از دستگاه امکان‌پذیر است یا خیر، غیرممکن می‌سازد، حتی اگر دستگاه پشتیبانی از یک افزونه معین را اعلام کرده باشد. علاوه بر این، اندازه و مفهوم واقعی برخی از ویژگی‌ها به طور رسمی در هیچ کجا اعلام نشده است.

به‌ویژه این موضوع بر افزونه‌هایی مانند cl_amd_device_attribute_query، cl_nv_device_attribute_query و cl_arm_core_id تأثیر می‌گذارد. روش‌های اکتشافی مبتنی بر پشتیبانی از نسخه استاندارد تا حدی در کد استفاده می‌شوند تا مشخص شود کدام نسخه ممکن است پشتیبانی شود.

ویژگی‌هایی که مشخص شده است تحت تأثیر این محدودیت‌ها قرار دارند عبارتند از:

CL_DEVICE_GLOBAL_FREE_MEMORY_AMD

که در نسخه 3 از مشخصات افزونه cl_amd_device_attribute_query به عنوان حافظه آزاد سراسری بر حسب کیلوبایت مستند شده است، بدون اینکه توضیحی درباره علت وجود دو مقدار ارائه شده باشد؛ هرچند در کد منبع استک ROCm مقدار دوم به عنوان بزرگ‌ترین بلوک آزاد مستند شده است؛

CL_DEVICE_AVAILABLE_ASYNC_QUEUES_AMD

که در نسخه 3 از مشخصات افزونه cl_amd_device_attribute_query مستند شده است، اما توسط درایورهایی که از سایر ویژگی‌های نسخه 3 پشتیبانی می‌کنند گزارش نمی‌شود. این مورد اکنون برای درایورهایی که فرض می‌شود از نسخه 4 همین افزونه پشتیبانی می‌کنند فعال شده است؛

CL_DEVICE_TERMINATE_CAPABILITY_KHR

ارائه‌شده توسط cl_khr_terminate_context که مقدار آن میان OpenCL 1.x و 2.x تغییر کرده است، و ظاهراً یک میدان بیتی (bitfield) است که با این حال مقادیر آن در هیچ کجا تعریف نشده‌اند.

اشکالات (BUGS)

: CommandLine Error: Option '(some option name)' registered more than once!
LLVM ERROR: inconsistency in registered CommandLine options