Provided by:
manpages-es-extra_0.8a-17_all 
NOMBRE
objcopy - copia y traduce ficheros objeto
SINOPSIS
objcopy
[-F nombrebfd | --target=nombrebfd]
[-I nombrebfd | --input-target=nombrebfd]
[-O nombrebfd | --output-target=nombrebfd]
[-R nombresecci'on | --remove-section=nombresecci'on]
[-S | --strip-all] [-g | --strip-debug] [--strip-unneeded]
[-K nombres'imbolo | --keep-symbol=nombres'imbolo]
[-N nombres'imbolo | --strip-symbol=nombres'imbolo]
[-L nombres'imbolo | --localize-symbol=nombres'imbolo]
[-W nombres'imbolo | --weaken-symbol=nombres'imbolo]
[-x | --discard-all] [-X | --discard-locals]
[-b byte | --byte=byte]
[-i entrelazamiento | --interleave=entrelazamiento]
[-p | --preserve-dates] [--debugging] [--gap-fill=val]
[--pad-to=direcci'on] [--set-start=val] [--adjust-start=incr]
[--adjust-vma=incr] [--adjust-section-vma=secci'on{=,+,-}val]
[--adjust-warnings] [--no-adjust-warnings]
[--set-section-flags=secci'on=flags]
[--add-section=nombresecci'on=nombrefichero]
[--change-leading-char] [--remove-leading-char] [--weaken]
[-v | --verbose] [-V | --version] [--help] fichin [fichsal]
DESCRIPCI'ON
El programa de utilidad de GNU objcopy copia los contenidos de un
fichero objeto a otro. objcopy emplea la Biblioteca BFD de GNU para
leer y escribir los ficheros objeto. Puede escribir el fichero objeto
de destino en un formato diferente del fichero objeto origen. El
comportamiento exacto de objcopy se controla mediante opciones en la
linea de ordenes.
objcopy crea ficheros temporales para hacer sus traducciones y los
borra despues. objcopy emplea BFD para hacer todo su trabajo de
traduccion; conoce todos los formatos que BFD entiende y por lo tanto
es capaz de reconocer la mayoria de formatos sin tener que decirselo
explicitamente.
objcopy puede emplearse para generar registros-S mediante el empleo de
un objetivo de salida srec (p.e., use -O srec).
objcopy puede emplearse para generar un fichero binario crudo empleando
un objetivo de salida binary (p.e., use -O binary). Cuando objcopy
genera un fichero binario crudo, produce esencialmente un volcado de
memoria de los contenidos del fichero objeto de entrada. Todos los
simbolos y la informacion de reubicacion se perderan. El volcado de
memoria comenzara en la direccion virtual de la seccion mas baja
copiada en el fichero de salida.
Cuando se genere un registro-S o un fichero binario crudo, puede ser de
ayuda emplear -S para quitar la seccion que contiene informacion de
depuracion. En algunos casos sera util -R para quitar secciones que
contienen informacion que no necesita el fichero binario.
fichin y fichsal son los ficheros fuente y destino respectivamente. Si
uno no especifica fichsal, objcopy crea un fichero temporal y renombra
destructivamente el resultado con el nombre del fichero de entrada.
OPCIONES
-I nombrebfd, --input-target=nombrebfd
Considera que el formato del objeto del fichero fuente es
nombrebfd, en vez de intentar deducirlo.
-O nombrebfd, --output-target=nombrebfd
Escribe el fichero de salida usando el formato de objeto
nombrebfd.
-F nombrebfd, --target=nombrebfd
Usa nombrebfd como el formato objeto para los ficheros de
entrada y salida; esto es, simplemente transfiere datos desde el
fuente al destino sin ninguna traduccion.
-R nombresecci'on, --remove-section=nombresecci'on
Borra la seccion nombrada del fichero. Esta opcion puede darse
mas de una vez. Observe que emplear esta opcion inapropiadamente
puede hacer inservible al fichero de salida.
-S, --strip-all
No copia informacion de simbolos ni reubicacion del fichero
fuente.
-g, --strip-debug
No copia simbolos de depuracion del fichero fuente.
--strip-unneeded
Quita todos los simbolos que no se necesiten para el
procesamiento de la reubicacion.
-K nombres'imbolo, --keep-symbol=nombres'imbolo
Copia solo el simbolo nombres'imbolo del fichero fuente. Esta
opcion puede darse mas de una vez.
-N nombres'imbolo, --strip-symbol=nombres'imbolo
No copia el simbolo nombres'imbolo del fichero fuente. Esta
opcion puede darse mas de una vez.
-L nombres'imbolo, --localize-symbol=nombres'imbolo
Hace al simbolo nombres'imbolo local al fichero, de forma que no
sea visible externamente. Esta opcion puede darse mas de una
vez.
-W nombres'imbolo, --weaken-symbol=nombres'imbolo
Hace al simbolo nombres'imbolo debil. Esta opcion puede darse mas
de una vez.
-x, --discard-all
No copia simbolos no globales del fichero fuente.
-X, --discard-locals
No copia simbolos locales generados por el compilador. (Estos
empiezan usualmente por "L" o ".").
-b byte, --byte=byte
Solo guarda cada byte-simo byte del fichero de entrada (los
datos de cabecera no se ven afectados). byte puede estar en el
rango desde 0 hasta el entrelazamiento - 1. Esta opcion es util
para crear ficheros para programar ROMs. Se usa tipicamente con
un objetivo de salida srec.
-i entrelazamiento, --interleave=entrelazamiento
Solo copia uno de cada entrelazamiento bytes. Cual de ellos
copiar se selecciona mediante la opcion -b o --byte. El
predeterminado es 4. El entrelazamiento no se tiene en cuenta si
no se da ni -b ni --byte.
-p, --preserve-dates
Establece las fechas de acceso y modificacion del fichero de
salida como las mismas que las del de entrada.
--debugging
Convierte informacion de depuracion, si es posible. Esto no es
lo predeterminado puesto que solo ciertos formatos de depuracion
se soportan, y el proceso de conversion puede consumir bastante
tiempo.
--gap-fill=val
Llena huecos entre las secciones con val. Esta operacion se
aplica a la direcci'on de carga (LMA) de las secciones. Se hace
incrementando el tamano de la seccion con la direccion mas baja,
y llenando el espacio extra creado con val.
--pad-to=direcci'on
Rellena el fichero de salida hasta la direccion de carga
direcci'on. Esto se hace incrementando el tamano de la ultima
seccion. El espacio extra se rellena con el valor especificado
por --gap-fill (por omision, cero).
--set-start=val
Establece la direccion de comienzo del nuevo fichero a val. No
todos los formatos de fichero objeto admiten el establecimiento
de la direccion de comienzo.
--adjust-start=incr
Ajusta la direccion de comienzo anadiendo incr. No todos los
formatos de fichero objeto admiten el establecimiento de la
direccion de comienzo.
--adjust-vma=incr
Ajusta la direccion de todas las secciones, asi como la
direccion de comienzo, anadiendo incr. Algunos formatos de
ficheros objeto no permiten cambiar arbitrariamente las
direcciones de seccion. Observe que esto no reubica las
secciones; si el programa espera que las secciones se carguen en
ciertas direcciones, y esta opcion se emplea para cambiar las
secciones de forma que se carguen en direcciones diferentes, el
programa puede fallar.
--adjust-section-vma=secci'on{=,+,-}val
Establece o ajusta la direccion de la secci'on nombrada. Si se
emplea =, la direccion de la seccion se establece a val. Si no,
se anade o sustrae val de la direccion de la seccion. Vea los
comentarios en --adjust-vma, arriba. Si no existe secci'on en el
fichero de entrada, se emite un aviso, a menos que se haya dado
la opcion --no-adjust-warnings.
--adjust-warnings
Si se ha dado la opcion --adjust-section-vma, y la seccion
nombrada no existe, emite un aviso. Esto es el comportamiento
predeterminado.
--no-adjust-warnings
No emite un aviso si se emplea la opcion --adjust-section-vma,
aunque la seccion nombrada no exista.
--set-section-flags=secci'on=flags
Establece las opciones para la seccion nombrada. El argumento
flags es una cadena de nombres de opciones separadas por comas.
Los nombres reconocidos son alloc, load, readonly, code, data y
rom. No todos tienen sentido para todos los formatos de
ficheros objeto.
--add-section=nombresecci'on=nombrefichero
Anade una nueva seccion llamada nombresecci'on mientras copia el
fichero. Los contenidos de la nueva seccion se toman del fichero
nombrefichero. El tamano de la seccion sera el tamano del
fichero. Esta opcion solo funciona en formatos de fichero que
puedan admitir secciones con nombres arbitrarios.
--change-leading-char
Algunos formatos de ficheros objeto emplean caracteres
especiales al principio de los simbolos. El mas comun de estos
caracteres es el subrayado, que los compiladores suelen anadir
antes de cada simbolo. Esta opcion le dice a objcopy que cambie
el caracter inicial de cada simbolo cuando convierta entre
formatos de ficheros objeto. Si los formatos de los ficheros
objeto emplean el mismo caracter inicial, esta opcion no tiene
efecto. De otro modo, anadira un caracter, o lo quitara, o lo
cambiara, segun sea apropiado.
--remove-leading-char
Si el primer caracter de un simbolo global es un simbolo
especial empleado por el formato del fichero objeto, quita el
caracter. El caracter inicial como simbolo mas comun es el
subrayado. Esta opcion quitara un subrayado inicial de todos los
simbolos globales. Esto puede ser util si uno quiere enlazar
juntos objetos con formatos de fichero diferentes, con
diferentes convenios para los nombres de simbolos. Esto es
diferente de --change-leading-char porque siempre cambia el
nombre del simbolo cuando es apropiado, sin tener en cuenta el
formato del fichero objeto de la salida.
--weaken
Cambia todos los simbolos globales en el fichero a debiles.
-v, --verbose
Salida prolija: lista todos los ficheros objeto modificados. En
el caso de archivos, objcopy -v lista todos los miembros del
archivo.
-V, --version
Muestra el numero de version de objcopy y acaba.
--help Muestra un resumen de las opciones de objcopy y acaba.
V'EASE TAMBI'EN
La entrada de menu `binutils' en Info; Las Utilidades de Binarios de
GNU, Roland H. Pesch (Junio de 1993).
DERECHOS DE COPIA
Copyright (c) 1993, 94, 95, 96, 1997 Free Software Foundation, Inc.
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
preserved on all copies.
Permission is granted to copy and distribute modified versions of this
manual under the conditions for verbatim copying, provided that the
entire resulting derived work is distributed under the terms of a
permission notice identical to this one.
Permission is granted to copy and distribute translations of this
manual into another language, under the above conditions for modified
versions, except that this permission notice may be included in
translations approved by the Free Software Foundation instead of in the
original English.
N. del T.: Solo tiene validez legal el aviso de copyright original.