Операционная система ЗОСРВ «Нейтрино» > Руководство разработчика > Программные интерфейсы общего назначения > Системные библиотеки > Системные библиотеки > Системная библиотека > T > trace_nlogf()

trace_nlogf()

Вставить пользовательское событие трассировки, указывающее максимальную дину строки

Прототип:

#include <sys/neutrino.h>
#include <sys/trace.h>
                                       
int trace_nlogf( int code,
                 int max,
                 const char *format,
                 ... );

Аргументы:

code

Код события, который должен быть в диапазоне от _NTO_TRACE_USERFIRST до _NTO_TRACE_USERLAST.

max

Максимальная длина строки, включаемой в событие, в байтах, или 0 для снятия ограничения.

format

Строка форматирования printf(). Должна сопровождаться дополнительными аргументами в соответствии с форматом, указанным в format строке.

Библиотека:

libc

Описание:

Функция trace_nlogf() вызывает TraceEvent() для помещения пользовательского события класса _NTO_TRACE_USER и типа, определяемого аргументом code, в лог трассировки.

Возвращаемое значение:

0

Успешное завершение.

-1

Возникла ошибка. Код ошибки записан в errno.

Коды ошибок:

ECANCELED

Запрошенное действие было отменено.

EFAULT

Некорректный адрес внутреннего буфера трассировки. Запрошенное действие было указано не по порядку.

ENOMEM

Недостаточно памяти для выделения буферов трассировки.

ENOTSUP

Запрошенное действие не поддерживается.

EPERM

У приложения недостаточно прав для исполнения этого действия.

Примеры:

Классификация:

ЗОСРВ «Нейтрино»

Безопасность использования

Точка остановки потока

Нет

Обработчик прерываний

Да

Обработчик сигналов

Да

В потоке

Да

Тематические ссылки:

printf(), trace_func_enter(), trace_func_exit(), trace_here(), trace_logb(), trace_logbc(), trace_logf(), trace_logi(), trace_vnlogf(), TraceEvent()

tracelogger

Предыдущий раздел: Описание API системной библиотеки