ByTrace

/developtools/bytrace
├── bin           # Код ByTrace
│   └── include   # Заголовочные файлы
│   └── src       # Исходные файлы
│   └── test      # Тестовые случаи
├── interfaces    # API
│   └── innerkits # Заголовочные файлы внутренних подсистем
│   └── kits      # Внешние заголовочные файлы
├── script        # Скрипты
```## Использование <a name="section18684185975017"></a>

Следующая таблица показывает команды, поддерживаемые ByTrace.

**Таблица 1** Команды, поддерживаемые ByTrace

| **Опция**            | **Описание**                                                                                   |
|----------------------|-------------------------------------------------------------------------------------------------|
| `-h`, `--help`       | Отображает информацию о справке.                                                               |
| `-b n`, `--buffer_size n` | Устанавливает размер буфера (КБ) для хранения и чтения трасс. По умолчанию размер буфера составляет 2048 КБ. |
| `-t n`, `--time n`   | Устанавливает время работы ByTrace в секундах, которое зависит от времени анализа.             |
| `--trace_clock clock` | Устанавливает тип часов для добавления метки времени к трассе. Это может быть часы загрузки (по умолчанию), глобальные, монотонные, uptime или perf. |
| `--trace_begin`      | Начинает запись трасс.                                                                          |
| `--trace_dump`       | Выгружает данные трассировки в указанное место (по умолчанию консоль).                          |
| `--trace_finish`     | Останавливает захват трасс и выгружает данные трассировки в указанное место (по умолчанию консоль). |
| `-l`, `--list_categories` | Выводит список поддерживаемых устройствами категорий ByTrace.                             |
| `--overwrite`        | Устанавливает действие при заполнении буфера. При использовании этой опции последние данные трассировки будут удалены. |
| `-o filename`, `--output filename` | Выводит данные трассировки в указанный файл.                                      |
| `-z`                 | Сжимает данные трассировки.                                                                    |

Ниже приведены некоторые примеры команд ByTrace:

- Выполните следующую команду для запроса поддерживаемых меток:

    ```
    bytrace -l
    ```или

- Выполните следующую команду для захвата трассировки с меткой **ability**, размер буфера установлен в 4096 КБ, а время работы ByTrace — в 10 секунд:

    ````
    bytrace -b 4096 -t 10 --overwrite ability > /data/mytrace.ftrace
    ````
    
- Выполните следующую команду для установки типа часов для трассировки в **mono**:

    ````
    bytrace --trace_clock mono -b 4096 -t 10 --overwrite ability > /data/mytrace.ftrace
    ````
    
- Выполните следующую команду для сжатия захваченных данных:

    ````
    bytrace -z -b 4096 -t 10 --overwrite ability > /data/mytrace.ftrace
    ````
    
## Вовлечённые репозитории<a name="section1849151125618"></a>

[Подсистема средств разработки](https://gitee.com/openharmony/docs/blob/master/en/readme/development-toolchain.md)

**developtools_bytrace_standard**