НАЗВА

readprofile - витання даних профілювання ядра

КОРОТКИЙ ОПИС

readprofile [параметри]

ВЕРСІЯ

На цій сторінці підручника описано версію 2.0 програми.

ОПИС

Програма readprofile використовує відомості /proc/profile для виведення даних ascii до стандартного виведення. Виведені дані буде поділено між трьома стовпчиками: у першому буде виведено такти годинника, у другому - назву функції C у ядрі, у якій відбулася ця кількість тактів, а у третьому - нормалізоване «навантаження» процедури, обчислене, як відношення кількості тактів до довжини процедури. Виведені дані буде доповнено пробілами для полегшення читання.

ПАРАМЕТРИ

-a, --all

Вивести усі символи у файлі карти. Типово, процедури із повідомленими позначками виведено не буде.

-b, --histbin

Вивести окремі значення позначок гістограми .

-i, --info

Відомості. Наказує readprofile лише вивести крок профілювання, який використано ядром. Крок профілювання є роздільністю буфера профілювання. Його вибір відбувається під час налаштовування ядра (за допомогою make config) або у рядку команди ядра. Якщо використано перемикач -t (terse) разом із -i, буде виведено лише десяткове число.

-m, --mapfile файл-карти

Вказати файл карти, типовим є /usr/src/linux/System.map. Вам слід вказати файл карти у рядку команди, якщо ваше поточне ядро не є останнім ядром, яке ви зібрали, або якщо ви зберігаєте ваш System.map у якомусь нестандартному місці. Якщо назва файла карти завершується на .gz, його вміст буде розпаковано на льоту.

-M, --multiplier множник

На деяких архітектурах можна змінювати частоту, з якою ядро надсилає переривання профілювання до кожного з процесорів. За допомогою цього параметра ви можете встановити частоту, як коефіцієнт частоти годинника системи, у Гц. У Linux 2.6.16 відкинуто підтримку коефіцієнта у більшості систем. Цей параметр також скидає буфер профілювання. Його використання потребує привілеїв надкористувача.

-p, --profile файл-профілювання

Вказати інший буфер профілювання, типовим є /proc/profile. Використання іншого профілю є корисним, якщо ви хочете «заморозити» профілювання ядра у певний момент часу і прочитати його пізніше. Файл /proc/profile може бути скопійовано за допомогою cat(1) або cp(1). Підтримки стиснених буферів профілювання, подібних до передбачених у readprofile-1.1, не передбачено, оскільки програмі потрібно буде наперед знати розмір буфера.

-r, --reset

Скинути буфер профілювання. Цю команду може бути викликано лише від імені root, оскільки читання /proc/profile може здійснювати будь-який користувач, а запис - лише надкористувач. Втім, ви можете встановити для readprofile set-user-ID 0, щоб скинути буфер без набуття додаткових прав доступу.

-s, --counters

Вивести значення окремих лічильників у функціях.

-v, --verbose

Докладний режим. Виведені дані буде упорядковано за чотирма стовпчиками і доповнено пробілами. У першому стовпчику буде показано адресу функції ядра в оперативній пам’яті, у другому - назву функції, у третьому - кількість тактів годинника, а в останньому - нормалізоване навантаження.

-h, --help

Вивести текст довідки і завершити роботу.

-V, --version

Вивести дані щодо версії і завершити роботу.

ФАЙЛИ

/proc/profile

Двійковий знімок буфера профілювання.

/usr/src/linux/System.map

Таблиця символів для ядра.

/usr/src/linux/*

Програма, профілювання якої виконується :-)

ВАДИ

readprofile працює лише з ядром 1.3.x та новішими ядрами, оскільки /proc/profile було змінено десь між версіями 1.2 та 1.3.

Ця програма працює лише з ядрами ELF. Зміна для ядер a.out є тривіальною, її може без проблем виконати користувач a.out.

Щоб увімкнути профілювання, ядро має бути перезавантажено, оскільки не буде доступним модуль профілювання, а зібрати його не просто. Для вмикання профілювання ви можете вказати profile=2 (або інше число) у рядку команди ядра. Вказане вами число має бути степенем двійки, який буде використано як крок профілювання.

Профілювання вимкнено, якщо заборонено переривання. Це означає, що відбудеться багато тактів профілювання, коли переривання буде повторно увімкнено. Остерігайтеся помилкових даних.

ПРИКЛАД

Навігація буфером профілювання, який упорядковано за тактами годинника:

   readprofile | sort -nr | less

Вивести 20 найбільш завантажуваних процедур:

   readprofile | sort -nr +2 | head -20

Вивести лише профіль файлової системи:

   readprofile | grep _ext2

Шукати в усіх даних ядра із адресами в оперативній пам’яті:

   readprofile -av | less

Навігація «замороженим» буфером профілювання для ядра, відмінного від поточного:

   readprofile -p ~/profile.freeze -m /zImage.map.gz

Надіслати запит щодо профілювання при 2кГц на процесор і скинути вміст буфера профілювання:

   sudo readprofile -M 20

ЯК НАДІСЛАТИ ЗВІТ ПРО ВАДИ

Для звітування щодо вад скористайтеся системою стеження за вадами - <https://github.com/util-linux/util-linux/issues>.

ДОСТУП ДО ПРОГРАМИ

Програма readprofile є частиною пакунка util-linux, який можна отримати з архіву ядра Linux <https://www.kernel.org/pub/linux/utils/util-linux/>.