Arquivo trace.h

Propósito

Define o rastreio de implementação que o IEEE POSIX 1003 identifica.

Descrição

O cabeçalho <trace.h> define a estrutura posix_trace_event_info que inclui os seguintes membros:

trace_event_id_t posix_event_id pid_t posix_pid void *posix_prog_address int posix_truncation_status struct timespec posix_timestamp pthread_t posix_thread_id

O cabeçalho <trace.h> define a estrutura posix_trace_status_info que inclui os membros a seguir:

int posix_stream_status int posix_stream_full_status int posix_stream_overrun_status int posix_stream_flush_status int posix_stream_flush_error int posix_log_overrun_status int posix_log_full_status

O cabeçalho <trace.h> define os seguintes símbolos:

Tabela 1. Símbolos para o cabeçalho trace.h
Símbolo	Uso	Descrição
POSIX_TRACE_ADD_EVENTSET	`how`argumento do`posix_trace_set_filter()`função	O conjunto resultante de tipos de eventos de rastreio a serem filtrados é a união do conjunto atual e do tipo de evento de rastreio definido que o argumento conjunto aponta.
POSIX_TRACE_ALL_EVENTS	`what`argumento do`posix_trace_eventset_fill()`função	Todos os tipos de eventos de rastreio definidos, tanto do sistema como do utilizador, estão incluídos no conjunto.
POSIX_TRACE_APPEND	`logpolicy`argumento do`posix_trace_attr_setlogfullpolicy()`função	O fluxo de rastreio associado é fluscado para o log de rastreio sem limitação de tamanho de log.
POSIX_TRACE_CLOSE_FOR_CRIANÇA	`inheritancepolicy`argumento do`posix_trace_eventset_fill()`função	Depois de uma operação garfo () ou de uma operação spawn () , a criança não é rastreada e o rastreio do pai continua.
FILTRO POSIX_TRACE		Este evento é registrado no fluxo quando um filtro do tipo trace-event-type é alterado.
POSIX_TRACE_FLUSH	`streampolicy`argumento do`posix_trace_attr_setstreamfullpolicy()`função	Esta política é idêntica à política completa de rastreio POSIX_TRACE_UNTIL_FULL, exceto que o fluxo de rastreio é fluscado regularmente como se a operação posix_trace_flush () tenha sido explicitamente chamada.
POSIX_TRACE_FLUSH_START		Este evento é registrado no fluxo marcando o início de uma operação de descarga.
POSIX_TRACE_FLUSH_STOP		Este evento é registrado no fluxo marcando o fim de uma operação de descarga.
POSIX_TRACE_FLUSHING	`posix_stream_flush_status`membro do`posix_trace_status_info`estrutura	O fluxo de rastreio está sendo fluscado para o log de rastreio.
POSIX_TRACE_FULL	`posix_stream_full_status`membro do`posix_trace_status_info`estrutura	O espaço no fluxo de rastreio para eventos de rastreio está esgotado.
POSIX_TRACE_FULL	`posix_log_full_status`membro do`posix_trace_status_info`estrutura	O espaço no log de rastreio está esgotado.
POSIX_TRACE_LOOP	`streampolicy`argumento do`posix_trace_attr_setstreamfullpolicy()`função	O trace stream loops até que a subroutine posix_trace_stop () pare explicitamente.
POSIX_TRACE_LOOP	`logpolicy`argumento do`posix_trace_attr_setlogfullpolicy()`função	Os loops de logs de rastreio até que o fluxo de rastreio associado seja interrompido.
POSIX_TRACE_NO_OVERRUN	`posix_stream_overrun_status`membro do`posix_trace_status_info`estrutura	Nenhum evento de rastreio é perdido no fluxo.
POSIX_TRACE_NO_OVERRUN	`posix_log_overrun_status`membro do`posix_trace_status_info`estrutura	Nenhum evento de rastreio está perdido no log de rastreio.
POSIX_TRACE_NOT_FLUSHING	`posix_stream_flush_status`membro do`posix_trace_status_info`estrutura	Nenhuma operação de descarga está em andamento.
POSIX_TRACE_NOT_FULL	`posix_stream_full_status`membro do`posix_trace_status_info`estrutura	Há espaço disponível no fluxo de rastreio.
POSIX_TRACE_NOT_FULL	`posix_log_full_status`membro do`posix_trace_status_info`estrutura	Há espaço disponível no log de rastreio.
POSIX_TRACE_HERDADO	`inheritancepolicy`argumento do`posix_trace_attr_setinherited()`função	Após uma operação garfo () ou uma operação spawn () , se o pai for rastreado, sua criança é rastreada simultaneamente usando o mesmo fluxo de rastreio.
POSIX_TRACE_NOT_TRUNCATED	`posix_truncation_status`membro do`posix_trace_event_info`estrutura	Todos os dados rastreados estão disponíveis.
POSIX_TRACE_OVERFLOW		Este evento é registrado no fluxo marcando o início de uma condição de estouro de traço.
POSIX_TRACE_OVERRUN	`posix_stream_overrun_status`membro do`posix_trace_status_info`estrutura	Pelo menos um evento de rastreio é perdido e não registrado no fluxo de rastreio.
POSIX_TRACE_OVERRUN	`posix_log_overrun_status`membro do`posix_trace_status_info`estrutura	Pelo menos um evento de rastreio está perdido no log de rastreio.
POSIX_TRACE_RESUME		Este evento é registrado no fluxo marcando o fim de uma condição de estouro de traço.
POSIX_TRACE_RUNNING	`posix_stream_status`membro do`posix_trace_status_info`estrutura	O rastreio está em andamento.
POSIX_TRACE_SET_EVENTSET	`how`argumento do`posix_trace_set_filter()`função	O conjunto resultante de tipos de eventos de rastreio a serem filtrados é o tipo de evento de rastreio configurado que o argumento configure pontos para.
POSIX_TRACE_START		Este evento é registrado no fluxo em uma operação de início de rastreio.
POSIX_TRACE_STOP		Este evento é registrado no fluxo em uma operação de parada de rastreio.
POSIX_TRACE_SUB_EVENTSET	`how`argumento do`posix_trace_set_filter()`função	O conjunto resultante de tipos de eventos de rastreio a serem filtrados inclui todos os tipos de eventos de rastreio no conjunto atual. Esses tipos de eventos de rastreio não estão no conjunto apontado pelo conjunto de argumentos. Cada elemento do conjunto atual de tipos de eventos de rastreio é removido do filtro atual.
POSIX_TRACE_SUSPENSO	`posix_stream_status`membro do`posix_trace_status_info`estrutura	A operação de rastreio não começou, ou parou.
POSIX_TRACE_SYSTEM_EVENTS	`what`argumento do`posix_trace_eventset_fill()`função	Todos os tipos de eventos de traço do sistema estão incluídos no conjunto.
POSIX_TRACE_TRUNCATED_READ	`posix_truncation_status`membro do`posix_trace_event_info`estrutura	Os dados são truncados no momento em que o evento de rastreio é lido a partir de um fluxo de rastreio ou de um log de rastreio porque o buffer do leitor é muito pequeno.
POSIX_TRACE_TRUNCATED_RECORD	`posix_truncation_status`membro do`posix_trace_event_info`estrutura	Os dados são truncados no momento em que o evento de rastreio é gerado.
POSIX_TRACE_UNNAMED_USER_EVENT		Se o nome de usuário por processo do evento de rastreio for alcançado, o evento de rastreio do usuário POSIX_TRACE_UNNAMED_USEREVENT será retornado em posix_trace_eventid_open () ou posix_trace_trid_eventid_open ().
POSIX_TRACE_UNTIL_FULL	`streampolicy`argumento do`posix_trace_attr_getstreamfullpolicy()`função	O fluxo de rastreio é executado até que os recursos do fluxo de rastreio estejam esgotados; em seguida, o fluxo de rastreio pára.
POSIX_TRACE_UNTIL_FULL	`logpolicy`argumento do`posix_trace_attr_getlogfullpolicy()`função	O fluxo de rastreio é fluscado para o log de rastreio até que o log de rastreio esteja cheio.
POSIX_TRACE_WOPID_EVENTS	`what`argumento do`posix_trace_eventset_fill()`função	Todos os tipos de eventos independentes do processo, do sistema-trace, estão incluídos no conjunto.

Os tipos a seguir são definidos conforme descrito no arquivo types.h do cabeçalho:

trace_attr_t
trace_id_t
trace_event_id_t
trace_event_event_set_t

int posix_trace_attr_destroy(trace_attr_t *); int posix_trace_attr_getclockres(const trace_attr_t *, struct timespec *); int posix_trace_attr_getcreatetime(const trace_attr_t *, struct timespec *); int posix_trace_attr_getgenversion(const trace_attr_t *, char *); int posix_trace_attr_getinherited(const trace_attr_t *restrict, int *restrict); int posix_trace_attr_getlogfullpolicy(const trace_attr_t *restrict, int *restrict); int posix_trace_attr_getlogsize(const trace_attr_t *restrict, size_t *restrict); int posix_trace_attr_getmaxdatasize(const trace_attr_t *restrict, size_t *restrict); int posix_trace_attr_getmaxsystemeventsize(const trace_attr_t *restrict, size_t *restrict); int posix_trace_attr_getmaxusereventsize(const trace_attr_t *restrict, size_t, size_t *restrict); int posix_trace_attr_getname(const trace_attr_t *, char *); int posix_trace_attr_getstreamfullpolicy(const trace_attr_t *restrict, int *restrict); int posix_trace_attr_getstreamsize(const trace_attr_t *restrict, size_t *restrict); int posix_trace_attr_init(trace_attr_t *); int posix_trace_attr_setinherited(trace_attr_t *, int); int posix_trace_attr_setlogfullpolicy(trace_attr_t *, int); int posix_trace_attr_setlogsize(trace_attr_t *, size_t); int posix_trace_attr_setmaxdatasize(trace_attr_t *, size_t); int posix_trace_attr_setname(trace_attr_t *, const char *); int posix_trace_attr_setstreamsize(trace_attr_t *, size_t); int posix_trace_attr_setstreamfullpolicy(trace_attr_t *, int); int posix_trace_clear(trace_id_t); int posix_trace_close(trace_id_t); int posix_trace_create(pid_t, const trace_attr_t *restrict, trace_id_t *restrict); int posix_trace_create_withlog(pid_t, const trace_attr_t *restrict, int, trace_id_t *restrict); void posix_trace_event(trace_event_id_t, const void *restrict, size_t); int posix_trace_eventid_equal(trace_id_t, trace_event_id_t, trace_event_id_t); int posix_trace_eventid_get_name(trace_id_t, trace_event_id_t, char *); int posix_trace_eventid_open(const char *restrict, trace_event_id_t *restrict); int posix_trace_eventset_add(trace_event_id_t, trace_event_set_t *); int posix_trace_eventset_del(trace_event_id_t, trace_event_set_t *); int posix_trace_eventset_empty(trace_event_set_t *); int posix_trace_eventset_fill(trace_event_set_t *, int); int posix_trace_eventset_ismember(trace_event_id_t, const trace_event_set_t *restrict, int *restrict); int posix_trace_eventtypelist_getnext_id(trace_id_t, trace_event_id_t *restrict, int *restrict); int posix_trace_eventtypelist_rewind(trace_id_t); int posix_trace_flush(trace_id_t); int posix_trace_get_attr(trace_id_t, trace_attr_t *); int posix_trace_get_filter(trace_id_t, trace_event_set_t *); int posix_trace_get_status(trace_id_t, struct posix_trace_status_info *); int posix_trace_getnext_event(trace_id_t, struct posix_trace_event_info *restrict , void *restrict, size_t, size_t *restrict, int *restrict); int posix_trace_open(int, trace_id_t *); int posix_trace_rewind(trace_id_t); int posix_trace_set_filter(trace_id_t, const trace_event_set_t *, int); int posix_trace_shutdown(trace_id_t); int posix_trace_start(trace_id_t); int posix_trace_stop(trace_id_t); int posix_trace_timedgetnext_event(trace_id_t, struct posix_trace_event_info *restrict, void *restrict, size_t, size_t *restrict, int *restrict, const struct timespec *restrict); int posix_trace_trid_eventid_open(trace_id_t, const char *restrict, trace_event_id_t *restrict); int posix_trace_trygetnext_event(trace_id_t, struct posix_trace_event_info *restrict, void *restrict, size_t, size_t *restrict, int *restrict);