.\" -*- coding: UTF-8 -*- .\" Copyright (C) 2006 Red Hat, Inc. All Rights Reserved. .\" Written by Marcela Maslanova .\" and Copyright 2013, Michael Kerrisk .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH getunwind 2 "10 ноября 2022 г." "Linux man\-pages 6.03" .SH ИМЯ getunwind \- копирует раскрученные данные в буфер вызывающего .SH LIBRARY Standard C library (\fIlibc\fP, \fI\-lc\fP) .SH СИНТАКСИС .nf \fB#include \fP \fB#include \fP /* определения констант \fBSYS_*\fP */ \fB#include \fP .PP \fB[[deprecated]] long syscall(SYS_getunwind, void \fP\fIbuf\fP\fB[.\fP\fIbuf_size\fP\fB],\fP \fB size_t \fP\fIbuf_size\fP\fB);\fP .fi .SH ОПИСАНИЕ \fINote: this system call is obsolete.\fP .PP Специальный системный вызов \fBgetunwind\fP() для IA\-64 копирует раскрученные данные кадра вызова ядра в буфер, указанный в \fIbuf\fP, и возвращает размер раскрученных данных; эти данные описывают шлюзовую страницу (gate page, код ядра, который отображается в адресное пространство пользователя). .PP Размер буфера \fIbuf\fP задаётся в \fIbuf_size\fP. Данные копируются только, если значение \fIbuf_size\fP больше или равно размеру раскрученных данных и значение \fIbuf\fP не равно NULL; в противном случае, данные не копируются и вызов завершается без ошибки, возвращая размер, который необходим для хранения раскрученных данных. .PP В начале раскрученных данных содержится таблица раскрутки. После неё хранится связанная с раскруткой информация в произвольном порядке. В таблице раскрутки содержатся записи в следующем виде: .PP .in +4n .EX u64 start; (64\-битный адрес начала функции) u64 end; (64\-битный адрес конца функции) u64 info; (смещение относительно BUF на раскрученную информацию) .EE .in .PP Запись, у которой значение \fIstart\fP равно нулю, указывает на конец таблицы. Подробности формата смотрите в руководстве \fIIA\-64 Software Conventions and Runtime Architecture\fP. .SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ" При успешном выполнении \fBgetunwind\fP() возвращает размер раскрученных данных. При ошибке возвращается \-1, а в \fIerrno\fP задаётся причина ошибки. .SH ОШИБКИ Вызов \fBgetunwind\fP() завершается с ошибкой \fBEFAULT\fP, если раскрученную информацию невозможно сохранить в пространство, указанное \fIbuf\fP. .SH ВЕРСИИ Данный системный вызов доступен в Linux начиная с версии 2.4. .SH СТАНДАРТЫ Данный системный вызов есть только в Linux и доступен только на архитектуре IA\-64. .SH ЗАМЕЧАНИЯ Данный системный вызов устарел. Современным способом получить раскрученные данные ядра является работа через \fBvdso\fP(7). .SH "СМ. ТАКЖЕ" \fBgetauxval\fP(3) .PP .SH ПЕРЕВОД Русский перевод этой страницы руководства был сделан Azamat Hackimov , Dmitry Bolkhovskikh , Vladislav , Yuri Kozlov и Иван Павлов . .PP Этот перевод является бесплатной документацией; прочитайте .UR https://www.gnu.org/licenses/gpl-3.0.html Стандартную общественную лицензию GNU версии 3 .UE или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ. .PP Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на .MT man-pages-ru-talks@lists.sourceforge.net .ME .