pm_get_program_pthread 서브루틴
용도
대상 pthread에 대한 성능 모니터 설정을 검색합니다.
라이브러리
성능 모니터 API 라이브러리 (libpmapi.a)
구문
설명
pm_get_program_pthread 서브루틴은 대상 pthread에 대한 성능 모니터 설정을 검색합니다. pthread가 중지되어야 하며 호출 프로세스의 제어 하에 디버그 대상 프로세스의 일부여야 합니다. 여기에는 이벤트 ID 목록에 있는 계수 중인 이벤트 및 모드 정보가 포함됩니다. ID는 pm_inititialize 서브루틴에서 리턴한 리스트에서 선택해야 합니다.
pthread가 1: 1모드에서 실행 중인 경우 tid 매개변수만 지정해야 합니다. pthread가 m: n 모드에서 실행 중인 경우 ptid 매개변수만 지정해야 합니다. ptid 및 tid 매개변수가 둘 다 지정된 경우, 이들은 ptid 매개변수가 지정된 단일 pthread를 참조해야 하며 현재 tid 매개변수가 지정된 커널 스레드에서 실행 중이어야 합니다.
카운팅 모드는 사용자 모드 및 커널 모드와 현재 카운팅 상태를 포함합니다.
목록에 임계값 ( pm_initialize 서브루틴에 표시된 대로) 과 함께 사용할 수 있는 이벤트가 포함된 경우 임계값도 리턴됩니다.
매개변수
| 항목 | 설명 |
|---|---|
| pid | 대상 pthread의 프로세스 ID입니다. 대상 프로세스는 디버그 프로세스의 인수여야 합니다. |
| tid | 대상 pthread의 스레드 ID. 이 매개변수를 무시하려면 0으로 설정하십시오. |
| ptid | 대상 pthread의 Pthread ID. 이 매개변수를 무시하려면 0으로 설정하십시오. |
| * 프로그램 | 설정된 성능 모니터 이벤트 및 모드를 리턴합니다. 다음 모드가 지원됩니다.
|
리턴 값
| 항목 | 설명 |
|---|---|
| 0 | 오류가 발생하지 않았습니다. |
| Positive error code | 오류 코드를 디코드하려면 pm_error 서브루틴 을 참조하십시오. |
오류 코드
pm_error 서브루틴을 참조하십시오.
파일
| 항목 | 설명 |
|---|---|
| /usr/include/pmapi.h | 표준 매크로, 데이터 유형 및 서브루틴을 정의합니다. |