.\" -*- coding: UTF-8 -*- .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43) .\" .\" Standard preamble: .\" ======================================================================== .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .de IX .. .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "ADDR2LINE 1" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH ADDR2LINE 1 "5 Agosto 2024" binutils\-2.43.0 "Herramientas de desarrollo de GNU" .if n .ad l .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .nh .SH NOMBRE addr2line \- convierte direcciones o smbolo+compensación a nombres de archivo y números de línea .SH SINOPSIS .IX Header SINOPSIS addr2line [\fB\-a\fP|\fB\-\-addresses\fP] [\fB\-b\fP \fIbfdnombre\fP|\fB\-\-target=\fP\fIbfdnombre\fP] [\fB\-C\fP|\fB\-\-demangle\fP[=\fIestilo\fP]] [\fB\-r\fP|\fB\-\-no\-recurse\-limit\fP] [\fB\-R\fP|\fB\-\-recurse\-limit\fP] [\fB\-e\fP \fIfilename\fP|\fB\-\-exe=\fP\fInombrearchivo\fP] [\fB\-f\fP|\fB\-\-functions\fP] [\fB\-s\fP|\fB\-\-basename\fP] [\fB\-i\fP|\fB\-\-inlines\fP] [\fB\-p\fP|\fB\-\-pretty\-print\fP] [\fB\-j\fP|\fB\-\-section=\fP\fInombre\fP] [\fB\-H\fP|\fB\-\-help\fP] [\fB\-V\fP|\fB\-\-version\fP] [addr addr ...] .SH DESCRIPCIÓN .IX Header DESCRIPCIÓN \&\fBaddr2line\fP traduce direcciones o símbolo+compensación a nombres de archivo y números de línea. Dada una dirección o un símbolo+compensación en un ejecutable o la compensación en una sección de un objeto reubicable, emplea la información de depuración para adivinar que nombre de archivo y número de línea están asociados a una dirección dada. .PP El objeto ejecutable o reubicable a utilizar se define mediante la opción \fB\-e\fP, por defecto será \fIa.out\fP. La sección del objeto reubicable a utilizar se define mediante la opción \fB\-j\fP. .PP \&\fBaddr2line\fP tiene dos modos de operación. .PP En el primero, se especifican en la línea de órdenes direcciones hexadecimales, y \fBaddr2line\fP muestra el nombre del archivo y el número de línea para cada dirección. .PP En el segundo, \fBaddr2line\fP lee direcciones hexadecimales o símbolo+compensación desde la entrada estándar, mostrando el nombre del archivo y el número de línea para cada dirección en la salida estándar. En este modo, \fBaddr2line\fP puede emplearse en una interconexión para convertir dinámicamente direcciones escogidas. .PP El formato de salida es \fBFILENAME:LINENO\fP. Por defecto, cada dirección de entrada genera una línea de salida. .PP Dos opciones pueden generar líneas adicionales antes de cada línea \&\fBFILENAME:LINENO\fP (en ese orden). .PP Si se emplea la opcin \fB\-a\fP, se mostrar una línea con la direccin de entrada. .PP Si se utiliza la opción \fB\-f\fP, se mostrará una línea con \&\fBFUNCTIONNAME\fP. Este es el nombre de la función que contiene la dirección. .PP Una opción puede generar líneas adicionales después de la línea \&\fBFILENAME:LINENO\fP. .PP Si se utiliza la opción \fB\-i\fP y está el código en la dirección insertada por el compilador, se mostrarán líneas adicionales. Se muestran una o dos líneas adicionales (si se usa la opción \&\fB\-f\fP) para cada función en línea. .PP Alternativamente, si se utiliza la opción \fB\-p\fP, cada dirección de entrada genera una línea de salida única y larga que contendrá la dirección, el nombre de la función, el nombre del archivo y el número de línea. Si también se ha utilizado la opción \&\fB\-i\fP, las funciones insertadas se mostrarán de la misma manera, pero en líneas separadas y con el prefijo \fB(inlined by)\fP. .PP Si el nombre de archivo o el de función no pueden determinarse, \&\fBaddr2line\fP mostrará dos signos de interrogación en su lugar. Si el número de línea no puede determinarse, \fBaddr2line\fP mostrará el número 0. .PP Cuando se utiliza símbolo+compensación, la compensación es opcional, excepto cuando el símbolo es ambiguo con un número hexadecimal. Los símbolos resueltos pueden estar recortados o no, salvo que no se permiten símbolos sin recortar con +. .SH OPCIONES .IX Header OPCIONES Las opciones largas y cortas, son equivalentes. .IP \fB\-a\fP 4 .IX Item \-a .PD 0 .IP \fB\-\-addresses\fP 4 .IX Item \-\-addresses .PD Muestra la dirección antes del nombre de la función, el archivo y la información del número de línea. La dirección se muestra con un prefijo \fB0x\fP para identificarla más fácilmente. .IP "\fB\-b\fP \fInombrebfd\fP" 4 .IX Item "\-b nombrebfd" .PD 0 .IP \fB\-\-target=\fP\fInombrebfd\fP 4 .IX Item \-\-target=nombrebfd .PD Indica que el formato del código objeto para los archivos objeto ser \&\fInombrebfd\fP. .IP \fB\-C\fP 4 .IX Item \-C .PD 0 .IP \fB\-\-demangle[=\fP\fIestilo\fP\fB]\fP 4 .IX Item \-\-demangle[=estilo] .PD Descodifica (\fIdemangle\fP) nombres de símbolos de bajo nivel en nombres entendibles por un usuario. Además de eliminar cualquier guión bajo inicial añadido por el sistema, esto hace que los nombres de las funciones de C++ sean legibles. Diferentes compiladores tienen diferentes estilos de manipulación. El argumento opcional para recorte se puede utilizar para elegir un estilo de recorte apropiado para su compilador. .IP "\fB\-e\fP \fInombrefichero\fP" 4 .IX Item "\-e nombrefichero" .PD 0 .IP \fB\-\-exe=\fP\fInombrefichero\fP 4 .IX Item \-\-exe=nombrefichero .PD Especifica el nombre del ejecutable para el que se debern traducir las direcciones. El nombre de fichero predeterminado es \fIa.out\fP. .IP \fB\-f\fP 4 .IX Item \-f .PD 0 .IP \fB\-\-functions\fP 4 .IX Item \-\-functions .PD Muestra nombres de funciones a la vez que información sobre archivos y números de línea. .IP \fB\-s\fP 4 .IX Item \-s .PD 0 .IP \fB\-\-basenames\fP 4 .IX Item \-\-basenames .PD Muestra solamente el nombre base de cada nombre de fichero. .IP \fB\-i\fP 4 .IX Item \-i .PD 0 .IP \fB\-\-inlines\fP 4 .IX Item \-\-inlines .PD Si la dirección pertenece a una función que estaba insertada, también se mostrará la información de origen para todos los ámbitos adjuntos hasta la primera función no insertada. Por ejemplo, si \f(CW\*(C`main\*(C'\fP inserta \&\f(CW\*(C`callee1\*(C'\fP que a su vez inserta \f(CW\*(C`callee2 \*(C'\fP la dirección es de \&\f(CW\*(C`callee2\*(C'\fP, la información fuente de \f(CW\*(C`callee1\*(C' \fP y \f(CW\*(C`main\*(C'\fP también se muestran. .IP \fB\-j\fP 4 .IX Item \-j .PD 0 .IP \fB\-\-section\fP 4 .IX Item \-\-section .PD Lee compensaciones relativas a la sección definida en lugar de direcciones absolutas. .IP \fB\-p\fP 4 .IX Item \-p .PD 0 .IP \fB\-\-pretty\-print\fP 4 .IX Item \-\-pretty\-print .PD Hace que el resultado sea más sencillo de interpretar para los humanos: cada ubicación se muestra en una línea. Si se define la opción \fB\-i\fP, las líneas para todos los ámbitos adjuntos tienen el prefijo \fB(inlined by)\fP. .IP \fB\-r\fP 4 .IX Item \-r .PD 0 .IP \fB\-R\fP 4 .IX Item \-R .IP \fB\-\-recurse\-limit\fP 4 .IX Item \-\-recurse\-limit .IP \fB\-\-no\-recurse\-limit\fP 4 .IX Item \-\-no\-recurse\-limit .IP \fB\-\-recursion\-limit\fP 4 .IX Item \-\-recursion\-limit .IP \fB\-\-no\-recursion\-limit\fP 4 .IX Item \-\-no\-recursion\-limit .PD Activa o desactiva el límite a la recursividad realizada mientras se decodifican las cadenas. Dado que los formatos de manipulación de nombres permiten un nivel infinito de recursividad, es posible crear cadenas cuya descodificación agotará la cantidad de espacio de pila disponible en el equipo, lo que provocará un error de memoria. Este límite intenta evitarlo restringiendo la recursividad a 2048 niveles de anidamiento. .Sp Por defecto, este límite está habilitado, pero puede ser necesario deshabilitarlo para descodificar nombres realmente complejos. Tenga en cuenta que si el límite de recursividad está deshabilitado, puede darse un agotamiento de la pila y que se rechace cualquier informe de error sobre el evento. .Sp La opción \fB\-r\fP es sinónimo de la opción \&\fB\-\-no\-recurse\-limit\fP. La opción \fB\-R\fP es sinónimo de la opción \fB\-\-recurse\-limit\fP. .Sp Tenga en cuenta que esta opción solo es efectiva si está habilitada la opción \fB\-C\fP o \&\fB\-\-demangle\fP. .IP \fB@\fP\fIarchivo\fP 4 .IX Item @archivo Lee las opciones de la línea de órdenes desde \fIarchivo\fP. Las opciones leídas se insertarán en lugar de la opción @\fIarchivo\fP original. Si \fIarchivo\fP no existe o no se puede leer, la opción se tratará literalmente y no se eliminará. .Sp Las opciones en \fIarchivo\fP están separadas por espacios en blanco. Se puede incluir un carácter de espacio en blanco en una opción encerrándola completamente entre comillas simples o dobles. Se puede incluir cualquier carácter (incluida una barra invertida) anteponiendo al carácter que se incluirá una barra invertida. El \fIarchivo\fP puede contener opciones @\fIarchivo\fP adicionales, procesándose éstas de manera recursiva. .SH "VÉASE TAMBIÉN" .IX Header "VÉASE TAMBIÉN" Página info de \fIbinutils\fP. .SH COPYRIGHT .IX Header COPYRIGHT Copyright (c) 1991\-2024 Free Software Foundation, Inc. .PP Se permite copiar, distribuir y/o modificar este documento bajo los términos de la Licencia de documentación libre GNU, Versión 1.3 o cualquier versión posterior publicada por la Free Software Foundation; sin secciones no varibales, sin textos de portada y sin textos de contraportada. Se incluye una copia de la licencia en la sección titulada 'Licencia de documentación libre GNU'. .PP .SH TRADUCCIÓN La traducción al español de esta página del manual fue creada por Marcos Fouces . .PP Esta traducción es documentación libre; lea la .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Version 3 .UE o posterior con respecto a las condiciones de copyright. No existe NINGUNA RESPONSABILIDAD. .PP Si encuentra algún error en la traducción de esta página del manual, envíe un correo electrónico a .MT debian-l10n-spanish@lists.debian.org .ME .