PAPI_derive_event_files - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

PAPI_derived_event_files - Mô tả cú pháp tệp định nghĩa sự kiện dẫn xuất.

Nguồn gốc Sự kiện

PAPI cung cấp khả năng xác định các sự kiện có giá trị được lấy từ nhiều
sự kiện bản địa. Danh sách các sự kiện gốc được sử dụng trong một sự kiện phái sinh và một công thức
mô tả cách sử dụng chúng được cung cấp trong tệp định nghĩa sự kiện. Nhóm PAPI cung cấp
tệp định nghĩa sự kiện mô tả tất cả các sự kiện đặt trước PAPI được hỗ trợ. PAPI
cũng cho phép người dùng cung cấp tệp định nghĩa sự kiện mô tả một tập hợp người dùng
các sự kiện được xác định có thể mở rộng các sự kiện mà PAPI thường hỗ trợ.

Trang này ghi lại cú pháp của các lệnh có thể xuất hiện trong định nghĩa sự kiện
tập tin.

Tổng quan Quy tắc:
· Các dòng trống bị bỏ qua.
· Các dòng bắt đầu bằng '#' là các chú thích (chúng cũng bị bỏ qua).
· Tên hiển thị bên trong < > bên dưới thể hiện các giá trị mà người dùng phải cung cấp.
· Nếu giá trị do người dùng cung cấp có chứa khoảng trắng thì nó phải được bảo vệ bằng dấu ngoặc kép.
lệnh:
CPU,
Chỉ định tên PMU để kiểm soát nếu các lệnh PRESET và EVENT tuân theo điều này
dòng cần được xử lý. Có thể nhập nhiều lệnh CPU mà không cần PRESET hoặc EVENT
các lệnh giữa chúng để cung cấp danh sách tên PMU mà các sự kiện bắt nguồn từ đó
làm theo sẽ được áp dụng. Khi tên PMU được cung cấp trong danh sách khớp với tên PMU đã biết
hệ thống đang chạy, các sự kiện tiếp theo sẽ được tạo. Nếu không có tên PMU nào
được cung cấp trong danh sách khớp với tên PMU trên hệ thống đang chạy, các sự kiện tiếp theo
sẽ bị bỏ qua. Khi lệnh CPU mới tuân theo lệnh PRESET hoặc EVENT,
Danh sách PMU được xây dựng lại.

ĐẶT TRƯỚC, , , ,LDESC," ",SDESC," ",GHI CHÚ," "
Khai báo một sự kiện bắt nguồn từ PAPI được đặt trước.

SỰ KIỆN, , , ,LDESC," ",SDESC," ",GHI CHÚ," "
Khai báo một sự kiện dẫn xuất do người dùng xác định.

Trong đó:

pmuTên:
PMU mà các sự kiện sau đây sẽ được áp dụng. Danh sách tên PMU được hỗ trợ bởi
hệ thống của bạn có thể có được bằng cách chạy papi_comComponent_avail trên hệ thống của bạn.

tên sự kiện:
Chỉ định tên được sử dụng để xác định sự kiện phát sinh này. Tên này phải là duy nhất
trong các sự kiện trên hệ thống của bạn.

loại dẫn xuất:
Chỉ định loại sự kiện phái sinh đang được xác định (xem 'Loại sự kiện phái sinh' bên dưới).

sự kiệnAttr:
Chỉ định một công thức và danh sách các sự kiện cơ sở được sử dụng để tính toán kết quả
giá trị sự kiện. Cú pháp của trường này phụ thuộc vào 'Loại dẫn xuất' được chỉ định ở trên
(xem 'Các loại có nguồn gốc' bên dưới).

longDesc:
Cung cấp mô tả dài về sự kiện.

shortDesc:
Cung cấp mô tả ngắn gọn về sự kiện.

ghi chú:
Cung cấp một ghi chú sự kiện.

cơ sởSự kiện (đã sử dụng phía dưới):
Xác định một sự kiện mà sự kiện dẫn xuất này dựa vào. Đây có thể là một sự kiện bản địa
(có thể với mặt nạ sự kiện), một sự kiện đặt trước đã biết hoặc người dùng đã biết
biến cố.
Ghi chú:
Lệnh PRESET theo truyền thống được sử dụng trong định nghĩa đặt trước do PAPI cung cấp
tài liệu. Lệnh EVENT dự định sẽ được sử dụng trong các tệp định nghĩa sự kiện do người dùng xác định. Các
mã xử lý chúng giống nhau nên chúng có thể hoán đổi cho nhau và cả hai đều có thể được sử dụng trong cả hai trường hợp
tập tin định nghĩa sự kiện.
Nguồn gốc Các loại:
Phần này mô tả các giá trị được phép trong trường 'derivedType' của các lệnh PRESET và EVENT.
Nó cũng hiển thị cú pháp của trường 'eventAttr' cho từng loại dẫn xuất được hỗ trợ bởi các trường này
lệnh. Tất cả các sự kiện dẫn xuất cung cấp một danh sách một hoặc nhiều sự kiện mà sự kiện dẫn xuất
sự kiện dựa trên (baseEvent). Một số sự kiện dẫn xuất cung cấp một công thức chỉ rõ cách thực hiện
tính toán giá trị sự kiện dẫn xuất bằng cách sử dụng baseEvents trong danh sách. Những điều sau đây bắt nguồn
các loại được hỗ trợ, cú pháp của tham số 'eventAttr' cho từng loại sự kiện dẫn xuất
được hiển thị trong ngoặc đơn.

KHÔNG_DERIVED ( ):
Kiểu dẫn xuất này xác định bí danh cho sự kiện hiện có 'baseEvent'.

DERIVED_ADD ( , ):
Kiểu dẫn xuất này xác định một sự kiện mới sẽ là tổng của hai sự kiện khác. Nó có
giá trị của 'baseEvent1' cộng với 'baseEvent2'.

DERIVED_PS (PAPI_TOT_CYC, ):
Kiểu dẫn xuất này xác định một sự kiện mới sẽ báo cáo số lượng 'baseEvent1'
sự kiện xảy ra mỗi giây. Nó có giá trị là ((('baseEvent1' * cpu_max_mhz) *
1000000 ) / PAPI_TOT_CYC). Người dùng phải cung cấp PAPI_TOT_CYC làm sự kiện đầu tiên của
hai sự kiện trong danh sách sự kiện để sự kiện này hoạt động chính xác.

DERIVED_ADD_PS (PAPI_TOT_CYC, , ):
Kiểu dẫn xuất này xác định một sự kiện mới sẽ cộng hai bộ đếm sự kiện lại với nhau và
sau đó báo cáo số lượng xảy ra mỗi giây. Nó có giá trị là (((('baseEvent1' +
baseEvent2) * cpu_max_mhz) * 1000000 ) / PAPI_TOT_CYC). Người dùng phải cung cấp
PAPI_TOT_CYC là sự kiện đầu tiên trong ba sự kiện trong danh sách sự kiện để sự kiện này hoạt động
đúng.

DERIVED_CMPD ( ,
Kiểu dẫn xuất này hoạt động giống như kiểu NOT_DERIVED. Nó hiếm khi được sử dụng và có vẻ
giống như mã chỉ trả về một giá trị duy nhất được trả về từ kernel. Không có
tính toán được thực hiện để tính giá trị sự kiện này. Không chắc chắn tại sao có nhiều sự kiện đầu vào
cần thiết để sử dụng loại sự kiện này.

DERIVED_SUB ( , ):
Kiểu dẫn xuất này định nghĩa một sự kiện mới sẽ là sự khác biệt giữa hai sự kiện khác
sự kiện. Nó có giá trị 'baseEvent1' trừ 'baseEvent2'.

DERIVED_POSTFIX ( , , , ... , ):
Kiểu dẫn xuất này định nghĩa một sự kiện mới có giá trị được tính từ một số sự kiện gốc
sự kiện sử dụng công thức hậu tố (ký hiệu đánh bóng ngược). Giá trị của nó là kết quả của
xử lý công thức hậu tố. 'pfFormula' có dạng 'N0|N1|N2|5|*|+|-|'
ở đâu '|' hoạt động như một dấu phân cách mã thông báo và các mã thông báo N0, N1 và N2 được đặt
chủ sở hữu đại diện cho baseEvent0, baseEvent1 và baseEvent2 tương ứng.

DERIVED_INFIX ( , , , ... , ):
Kiểu dẫn xuất này định nghĩa một sự kiện mới có giá trị được tính từ một số sự kiện gốc
sự kiện bằng cách sử dụng công thức trung tố (ký hiệu đại số). Giá trị của nó là kết quả của
xử lý công thức trung tố. 'ifFormula' có dạng 'N0-(N1+(N2*5))' trong đó
các mã thông báo N0, N1 và N2 là các phần giữ chỗ đại diện cho baseEvent0, baseEvent1 và
baseEvent2 tương ứng.
Ví dụ:
Trong ví dụ sau, các sự kiện PAPI_SP_OPS, USER_SP_OPS và ALIAS_SP_OPS đều sẽ
đo lường các sự kiện giống nhau và trả về cùng một giá trị. Họ chỉ thể hiện những cách khác nhau để
sử dụng các lệnh định nghĩa sự kiện PRESET và EVENT.

· # Các dòng sau xác định tên pmu đều có chung các sự kiện sau
· CPU nhm
· CPU nhm-ex
· # Sự kiện cần được xác định cho một trong các loại pmu ở trên
· ĐẶT TRƯỚC,PAPI_TOT_CYC,NOT_DERIVED,UNHALTED_CORE_CYCLES
· ĐẶT TRƯỚC,PAPI_REF_CYC,NOT_DERIVED,UNHALTED_REFERENCE_CYCLES
· PRESET,PAPI_SP_OPS,DERIVED_POSTFIX,N0|N1|3|*|+|,FP_COMP_OPS_EXE:SSE_SINGLE_PRECISION,FP_COMP_OPS_EXE:SSE_FP_PACKED,NOTE,'Đang sử dụng
một công thức hậu tố'
· SỰ KIỆN,USER_SP_OPS,DERIVED_INFIX,N0+(N1*3),FP_COMP_OPS_EXE:SSE_SINGLE_PRECISION,FP_COMP_OPS_EXE:SSE_FP_PACKED,NOTE,'Sử dụng
công thức tương tự ở định dạng infix'
· SỰ KIỆN,ALIAS_SP_OPS,NOT_DERIVED,PAPI_SP_OPS,LDESC,'Bí danh cho sự kiện đặt trước PAPI_SP_OPS'
· # Kết thúc định nghĩa sự kiện cho tên pmu ở trên và bắt đầu một phần cho pmu mới
tên.
· Mã CPU

Sử dụng PAPI_der_event_files trực tuyến bằng dịch vụ onworks.net