Página de Manual de strip
Algum tempo atrás precisei usar o comando strip, e procurei ver se existia algum help para ele em português e não encontrei. Assim, eu fiz uma tradução do texto do help que é exibido quando usamos o comando de página de manual (man strip) na console do Linux. Como uma contribuição à comunidade Linux, segue o help em português como ele aparece na saída de # man strip:
STRIP(1) GNU Development Tools STRIP(1)
NOME
strip - Descarta símbolos dos arquivos objetos.
SINOPSE
strip [-F bfdname |--target=bfdname]
[-I bfdname |--input-target=bfdname]
[-O bfdname |--output-target=bfdname]
[-s|--strip-all]
[-S|-g|-d|--strip-debug]
[-K symbolname |--keep-symbol=symbolname]
[-N symbolname |--strip-symbol=symbolname]
[-w|--wildcard]
[-x|--discard-all] [-X |--discard-locals]
[-R sectionname |--remove-section=sectionname]
[-o file] [-p|--preserve-dates]
[--keep-file-symbols]
[--only-keep-debug]
[-v |--verbose] [-V|--version]
[--help] [--info]
objfile...
DESCRIÇÃO
O comando strip GNU descarta todos os símbolos dos arquivos objeto objfile. A lista de arquivos objeto pode incluir arquivamentos. Pelo menos um arquivo objeto precisa ser fornecido. O comando strip modifica os arquivos mencionados em seus argumentos, em vez de escrever cópias modificadas sob nomes diferentes.
OPÇÕES
-F bfdname / --target=bfdname
Trata o objfile original como um arquivo com o formato de código objeto bfdname, e o reescreve no mesmo formato.
--help
Mostra um sumário das opções de strip e sai.
--info
Exibe uma lista mostrando todas as arquiteturas e formatos objeto disponíveis.
-I bfdname / --input-target=bfdname
Trata o objfile original como um arquivo com o formato do código objeto bfdname.
-O bfdname / --output-target=bfdname
Substitui o objfile por um arquivo no formato de saída bfdname.
-R sectionname / --remove-section=sectionname
Remove qualquer seção chamada sectionname do arquivo de saída. Essa opção pode ser fornecida mais de uma vez. Note que usando essa opção inapropriadamente pode tornar o arquivo de saída inutilizável.
-s / --strip-all
Remove todos os símbolos.
-g / -S / -d / --strip-debug
Remove somente símbolos de debug.
--strip-unneeded
Remove todos os símbolos que não são necessários no processamento de realocação.
-K symbolname / --keep-symbol=symbolname
Quando sugando símbolos, mantém o símbolo symbolname mesmo que esse seja normalmente retirado. Essa opção pode ser fornecida mais de uma vez.
-N symbolname / --strip-symbol=symbolname
Remove o símbolo symbolname do arquivo fonte. Essa opção pode ser fornecida mais de uma vez, e pode ser combinado com as opções de strip exceto a opção ‘-K’.
-o file
Coloca a saída enxugada em file, em vez de substituir o arquivo existente. Quando esse argumento for usado, somente um argumento objfile pode ser especificado.
-p / --preserve-dates
Preserva as datas de acesso e modificação do arquivo.
-w / --wildcard
Permite expressões regulares em symbolnames usadas em outras opções de linha de comando. As marcas dos operadores interrogação (?), asterisco (*), barra invertida (\) e colchetes ([]) podem ser usados em qualquer lugar no nome de símbolo. Se o primeiro caractere do nome do símbolo for exclamação (!) então o sentido da troca será invertido para esse símbolo. Por exemplo:
-w -K !foo -K fo*
fará strip manter somente os símbolos que começa com as letras "fo", mas descarta o símbolo "foo".
-x / --discard-all
Remove os símbolos não globais.
-X / --discard-locals
Remove os símbolos locais gerados pelo compilador. (Eles normalmente começam com L ou ..)
--keep-file-symbols
Quando enxugando um arquivo, talvez com a opção --strip-debug ou --strip-unneeded, retém quaisquer símbolos que especificam nomes de arquivos fonte, que do contrário poderia ser sugado.
--only-keep-debug
Enxuga um arquivo, removendo quaisquer seções que seria enxugada pela opção --strip-debug e deixando as seções de debug.
A intenção é que essa opção será usada em conjunção com --add-gnu-debuglink para criar um executável de duas partes. Uma parte é um binário enxugado que ocupará menos espaço na RAM e numa distribuição e a segunda parte um arquivo de com informação de debug que será necessário somente se as capacidades de debug são requeridas. O procedimento sugerido para criar esses arquivos é como segue:
1.<Link o executável como normal. Supondo que é chamado"foo"> depois ...
1.Rode <"objcopy --only-keep-debug foo foo.dbg"> para criar um arquivo que contenha a informação de debug.
1. Rode <"objcopy --strip-debug foo" > para criar um executável enxugado.
1. Rode <"objcopy --add-gnu-debuglink=foo.dbg foo"> para adicionar um link para a informação de debug no executável enxugado.
Observação: a escolha de ‘.dbg’ como uma extensão para a arquivo com a informação de debug é arbitrário. Também o passo "--only-keep-debug" é opcional. Você pode no lugar fazer isso:
1.<Link o executável como normal.>
1. Copia <"foo" para "foo.full">
1. Roda <"strip --strip-debug foo">
1. Roda <"objcopy --add-gnu-debuglink=foo.full foo">
ou seja, o arquivo apontado pela opção --add-gnu-debuglink pode ser o executável totalmente. Ele não precisa ser um arquivo criado pela troca de --only-keep-debug.
-V / --version
Mostra o número de versão de strip.
-v / --verbose
Saída de verbose: lista todos os arquivos objetos modificados. No caso de arquivados, strip -v lista todos os membros do arquivado.
@file
Lê opções de linha de comando de file. As opções lidas são inseridas no lugar da opção original @file. Se o arquivo não existir, ou não puder ser lido, então a opção será tratado literalmente, e não será removida.
Opções em file são separados por espaço em branco. Um caractere espaço em branco pode ser incluído em uma opção delimitando a opção inteira tanto em aspas simples ou duplas. Qualquer caractere (incluindo uma barra invertida) pode ser incluído prefixando o caractere a ser incluído com uma barra invertida. O arquivo pode conter opções @file adicionais por si mesmo; quaisquer de tais opções serão processadas recursivamente.
VEJA TAMBÉM
As entradas de Informação para binutils.
DIREITOS
Copyright (c) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
Permissão é concedida para copiar, distribuir e/ou modificar esse documento sob os termos da GNU Free Documentation License, Versão 1.1 ou qualquer versão posterior publicada pela Free Software Foundation; sem Seções Invariantes, sem Textos Front-Cover, e sem Textos Back-Cover. Uma cópia da licença é incluída na seção intitulada "GNU Free Documentation License".
binutils-2.17 23-06-2006 STRIP(1)
Nenhum comentário:
Postar um comentário