하드웨어 성능 모니터 API 및 도구

bos.pmapi 파일 세트에는 일부 IBM® 마이크로프로세서에 포함된 성능 모니터 기능의 일부 카운팅 기능에 액세스할 수 있도록 설계된 라이브러리 및 도구가 포함되어 있습니다.

여기에는 다음과 같은 필드 가 포함됩니다.

  • 하위 레벨 API (Application Programming Interface) 세트를 포함하는 pmapi 라이브러리에는 다음이 포함됩니다.
    • 전체 시스템 또는 공통 상위가 있는 프로세스 세트의 활동 계수를 허용하는 시스템 레벨 API 세트입니다.
    • 스레드가 자체 활동을 계수할 수 있도록 허용하는 제1당사자 커널 스레드 레벨 API 세트입니다.
    • 디버그 프로그램이 대상 스레드의 활동을 계수할 수 있도록 하는 써드파티 커널 스레드 레벨 API 세트입니다.
  • pmcycle 명령은 프로세서 클럭 속도와 감분 속도를 리턴합니다.
  • pmlist 명령은 프로세서, 이벤트, 이벤트 그룹 및 세트, 지원되는 파생 메트릭에 대한 정보를 표시합니다.
  • 다음을 사용 가능하게 하는 상위 레벨 API 세트를 포함하는 hpm및 hpm_r 라이브러리.
    • 코드 섹션의 중첩 인스트루먼테이션
    • 원시 하드웨어 카운터 값 외에, 파생된 메트릭의 자동 계산 및 운영 체제 자원 소비 메트릭의 수집
  • hpmstat 명령은 기계의 총 시스템 활동과 관련하여 하드웨어 성능 모니터 원시 및 파생된 메트릭을 수집합니다.
  • hpmcount 명령은 어플리케이션을 실행하고 어플리케이션의 실행 벽시계 시간, 원시 및 파생된 하드웨어 성능 모니터 메트릭 및 운영 체제 자원 활용도 통계를 제공합니다.
참고: 지원되는 각 프로세서에서 사용 가능한 API및 이벤트는 설계에 의해 완전히 분리되었습니다. 사용 가능한 이벤트, 해당 설명 및 현재 테스트 상태 (각 프로세서마다 다름) 는 별도로 설치 가능한 테이블에 있으며 API 호출이 이벤트의 가용성 또는 상태에 의존하지 않기 때문에 여기에서 설명되지 않습니다.

pm_initialize API 초기화 루틴에 의해 리턴되는 이벤트의 상태는 확인됨, 확인되지 않음, 경고, 중단됨, 그룹 전용, 임계값 가능또는 공유 일 수 있습니다 (테스트 상태 및 이벤트 정확성에 대한 성능 모니터 정확성 참조).

이벤트 필터 (상태 비트의 조합) 를 pm_initialize 루틴으로 전달하여 필터와 일치하는 상태의 이벤트 리턴을 강제 실행해야 합니다. 필터가 pm_initialize 루틴으로 전달되지 않으면 이벤트가 리턴되지 않습니다.