winedbg-development - Online na nuvem

PROGRAMA:

NOME

winedbg - depurador de vinho

SINOPSE

winebg [ opções ] [ nome do programa [ argumentos_programa ] wpid ]

winebg --gdb [ opções ] [ nome do programa [ argumentos_programa ] wpid ]

winebg --auto wpid

winebg --minidump [ arquivo.mdmp ] wpid

winebg arquivo.mdmp

DESCRIÇÃO

winebg é um depurador para Wine. Permite:
+ depuração de aplicativos Win32 nativos
+ depuração de aplicativos Winelib
+ sendo um substituto imediato para o Dr. Watson

MODOS

winebg pode ser usado em cinco modos. O primeiro argumento do programa determina o modo
winedbg será executado.

omissão
Sem qualquer modo explícito, este é o padrão winebg modo operacional. winebg precisarão
atuar como o front-end para o usuário.

--gdb winebg será usado como um proxy para gdb. gdb será o front-end para o comando
manuseio, e winebg fará proxy de todas as solicitações de depuração de gdb para as APIs do Win32.

--auto Este modo é usado quando winebg está configurado em AeDebugName entrada de registro como padrão
depurador. winebg irá então exibir informações básicas sobre uma falha. Isso é útil
para usuários que não desejam depurar uma falha, mas sim coletar informações relevantes
sobre a falha a ser enviada aos desenvolvedores.

--minidump
Este modo é semelhante ao --auto um, exceto que em vez de imprimir o
informações na tela (como --auto faz), é salvo em um arquivo de minidespejo. o
o nome do arquivo é passado na linha de comando ou gerado por WineDbgGenericName quando
nenhum é dado. Este arquivo pode ser recarregado posteriormente em winebg por mais
exame.

arquivo.mdmp
Neste modo winebg recarrega o estado de um depurado que foi salvo em um
arquivo de minidespejo. Veja o minidump comando abaixo, ou o --minidump modo.

OPÇÕES

Quando em omissão modo, as seguintes opções estão disponíveis:

--comando corda
winebg irá executar o comando corda como se fosse digitado na linha de comando do winedbg,
e então vai sair. Isso pode ser útil para obter o pid de processos em execução
(winedbg --command "info proc").

--Arquivo nome do arquivo
winebg irá executar a lista de comandos contidos no arquivo nome do arquivo como se eles
foram digitados na linha de comando winedbg e, em seguida, sairá.

Quando em gdb modo proxy, as seguintes opções estão disponíveis:

--não iniciar
gdb não será iniciado automaticamente. Informações relevantes para começar gdb is
impresso na tela. Isso é de alguma forma útil quando não está usando diretamente gdb mas alguns
front-ends gráficos, como ddd or kgbd.

--com-xterm
Isso vai rodar gdb em seu próprio xterm em vez de usar o console Unix atual para
exibição textual.

Em todos os modos, o resto da linha de comando, quando passado, é usado para identificar quais
programas, se houver, devem ser depurados:

nome do programa
Este é o nome de um executável a ser iniciado para uma sessão de depuração. winebg precisarão
realmente crie um processo com este executável. Se programas_argumentos são também
dados, eles serão usados ​​como argumentos para criar o processo a ser depurado.

wpid winebg irá anexar ao processo que o Windows pid é wpid. Use o info proc
comando dentro winebg para listar os processos em execução e seus pids do Windows.

omissão
Se nada for especificado, você entrará no depurador sem executar nem anexar
processo. Você terá que fazer o trabalho sozinho.

COMANDOS

Padrão Modo, e enquanto recarregando a minidump arquivo:
A maioria dos comandos usados ​​em winebg são semelhantes aos de gdb. Por favor, consulte o gdb
documentações para mais alguns detalhes. Veja o gdb diferenças seção mais tarde para obter um
lista de variações de gdb comandos.

Misc. comandos

abortar Aborta o depurador.

desistir Sai do depurador.

anexar N
Anexar a um processo Wine (N é o seu Windows ID, numérico ou hexadecimal). IDs podem ser
obtido usando o info processo comando. Note o info processo comando retorna
valores hexadecimais

desanexar Desanexar de um processo Wine.

Ajuda comandos

ajudar Imprime alguma ajuda sobre os comandos.

ajudar info
Imprime alguma ajuda sobre os comandos de informação

Fluxo ao controle comandos

conta Continue a execução até o próximo ponto de interrupção ou exceção.

passar Passe o evento de exceção para a cadeia de filtros.

passo Continue a execução até a próxima linha de código C (entra na chamada de função)

Próximo Continue a execução até a próxima linha de código C (não entra na chamada de função)

stepi Execute a próxima instrução de montagem (entra na chamada de função)

proximo eu Execute a próxima instrução de montagem (não entra na chamada de função)

acabamento Execute até que o retorno da função atual seja alcançado.

conta, passo, Próximo, stepi, proximo eu pode ser pós-fixado por um número (N), o que significa que o comando
deve ser executado N vezes antes que o controle seja retornado ao usuário.

Pontos de interrupção, pontos de controle

permitir N
Habilita (break | watch) -point N

desabiltar N
Desativa (pausa | ponto de observação) N

excluir N
Exclui (break | watch) -point N

cond N Remove qualquer condição existente para (break | watch) -point N

cond N expr
Adiciona condição expr para (quebrar | assistir) - ponto N. expr será avaliado cada vez que o
(break | watch) -point é atingido. Se o resultado for um valor zero, o ponto de interrupção não é
provocado.

quebrar * N
Adiciona um ponto de interrupção no endereço N

quebrar id
Adiciona um ponto de interrupção no endereço do símbolo id

quebrar id N
Adiciona um ponto de interrupção na linha N símbolo interno id.

quebrar N
Adiciona um ponto de interrupção na linha N do arquivo de origem atual.

quebrar Adiciona um ponto de interrupção no atual $ PC endereço.

Assistir * N
Adiciona um comando de observação (na gravação) no endereço N (em 4 bytes).

Assistir id
Adiciona um comando de observação (ao gravar) no endereço do símbolo id. O tamanho depende do tamanho
of id.

rwatch * N
Adiciona um comando de observação (na leitura) no endereço N (em 4 bytes).

rwatch id
Adiciona um comando de observação (na leitura) no endereço do símbolo id. O tamanho depende do tamanho de
id.

info quebrar
Lista todos os pontos (break | watch) (com seus estados).

Você pode usar o símbolo EntryPoint para representar o ponto de entrada da DLL.

Ao definir um (pausa | ponto de observação) por id, se o símbolo não puder ser encontrado (por exemplo, o
símbolo está contido em um módulo ainda não carregado), winebg vai lembrar o nome do
símbolo e tentará definir o ponto de interrupção cada vez que um novo módulo for carregado (até que
sucesso).

Pilha manipulação

bt Imprime a pilha de chamadas do thread atual.

bt N Imprimir pilha de chamadas de thread de ID N. Nota: isso não muda a posição de
o quadro atual conforme manipulado pelo up & dn comandos).

up Sobe um quadro na pilha do thread atual

up N Sobe N frames na pilha do thread atual

dn Desce um quadro na pilha do thread atual

dn N Vai para baixo N frames na pilha do thread atual

quadro N
Conjuntos N como o quadro atual para a pilha do segmento atual.

info locais
Imprime informações sobre variáveis ​​locais para o quadro de função atual.

Diretório & fonte lima manipulação

mostrar dir
Imprime a lista de diretórios onde os arquivos de origem são procurados.

dir pathname
Adiciona pathname à lista de diretórios onde procurar os arquivos fonte

dir Exclui a lista de diretórios onde procurar os arquivos de origem

simbolismo pathname
Carrega arquivo de definição de símbolo externo pathname

simbolismo pathname N
Carrega arquivo de definição de símbolo externo pathname (aplicando um deslocamento de N para
endereços)

Lista Lista 10 linhas de origem a partir da posição atual.

Lista - Lista 10 linhas de origem para trás a partir da posição atual

Lista N Lista 10 linhas de origem da linha N no arquivo atual

Lista pathname:N
Lista 10 linhas de origem da linha N no arquivo pathname

Lista id
Lista 10 linhas de função de origem id

Lista * N
Lista 10 linhas de origem do endereço N

Você pode especificar o destino final (para alterar o valor de 10 linhas) usando o separador ','. Para
exemplo:

Lista 123, 234
lista as linhas de origem da linha 123 até a linha 234 no arquivo atual

Lista foo.c: 1,56
lista as linhas de origem da linha 1 até 56 no arquivo foo.c

Exibindo

Uma exibição é uma expressão avaliada e impressa após a execução de qualquer winebg
comando.

exibição

info exibição
Lista as telas ativas

exibição expr
Adiciona uma exibição para a expressão expr

exibição /fmt expr
Adiciona uma exibição para a expressão expr. Impressão avaliada expr é feito usando o dado
formato (ver impressão comando para saber mais sobre formatos)

De exibição N

não mostrar N
Exclui display N

desmontagem

desastres Desmonte da posição atual

desastres expr
Desmonte do endereço expr

desastres expr,expr
Desmonta o código entre os endereços especificados pelas duas expressões

Memória (lendo, escrita, digitando)

x expr Examina a memória no endereço expr

x /fmt expr
Examina a memória no endereço expr usando formato fmt

impressão expr
Imprime o valor de expr (possivelmente usando seu tipo)

impressão /fmt expr
Imprime o valor de expr (possivelmente usando seu tipo)

conjunto var = expr
Escreve o valor de expr in var variável

o que é expr
Imprime o tipo C de expressão expr

fmt é também carta or contar carta, Onde carta pode ser:

é uma string ASCII

ua string Unicode UTF16

i instruções (desmontar)

x inteiro hexadecimal sem sinal de 32 bits

d inteiro decimal com sinal de 32 bits

w inteiro hexadecimal sem sinal de 16 bits

caractere c (apenas 0x20-0x7f imprimíveis são realmente impressos)

b inteiro hexadecimal sem sinal de 8 bits

g GUID Win32

Expressões

As expressões no Wine Debugger são geralmente escritas em uma forma C. No entanto, existem alguns
discrepâncias:

Os identificadores podem demorar um '!' em seus nomes. Isso permite principalmente especificar um módulo
de onde procurar o ID, por exemplo USER32! CreateWindowExA.

Em uma operação de conversão, ao especificar uma estrutura ou união, você deve usar a estrutura
ou palavra-chave union (mesmo se o seu programa usar um typedef).

Ao especificar um identificador, se existirem vários símbolos com este nome, o depurador irá
solicitar o símbolo que deseja usar. Escolha o que você deseja de seu número.

Misc.

minidump arquivo.mdmp salva o contexto de depuração do depurado em um arquivo minidespejo chamado
arquivo.mdmp.

Dados Pessoais on Vinhos internos

info classe
Lista todas as classes do Windows registradas no Wine

info classe id
Imprime informações na aula de Windows id

info share
Lista todas as bibliotecas dinâmicas carregadas no programa depurado (incluindo .so
arquivos, DLLs NE e PE)

info share N
Imprime informações sobre o módulo no endereço N

info regs
Imprime o valor dos registros da CPU

info todos os registros
Imprime o valor dos registros de CPU e Ponto Flutuante

info segmento
Lista todos os segmentos alocados (apenas i386)

info segmento N
Imprime informações no segmento N (apenas i386)

info pilha
Imprime os valores no topo da pilha

info mapa,
Lista todos os mapeamentos virtuais usados ​​pelo programa depurado

info mapa, N
Lista todos os mapeamentos virtuais usados ​​pelo programa do Windows pid N

info wnd
Exibe a hierarquia da janela a partir da janela da área de trabalho

info wnd N
Imprime informações da janela do manípulo N

info processo
Lista todos os processos w na sessão Wine

info fio
Lista todos os tópicos w na sessão Wine

info quadro
Lista os quadros de exceção (começando do quadro de pilha atual). Você também pode passar,
como argumento opcional, um id de thread (em vez do thread atual) para examinar seu
quadros de exceção.

As mensagens de depuração podem ser ligadas e desligadas enquanto você depura usando o conjunto comando, mas
apenas para canais inicializados com o percevejo variável de ambiente.

conjunto avisar + ganhar
Liga avisar ganhar canal

conjunto + ganhar
Liga warn / fixme / err / trace ganhar canal

conjunto - ganhar
Desativa warn / fixme / err / trace ativado ganhar canal

conjunto me consertar - todos os
Desativa a classe fixme em todos os canais

Gdb modo:
veja a gdb documentação para todos os gdb comandos.

No entanto, algumas extensões do Wine estão disponíveis, por meio do monitor comando:

monitor wnd
Lista todas as janelas na sessão Wine

monitor proc
Lista todos os processos na sessão Wine

monitor mem
Exibe o mapeamento de memória do processo depurado

Auto e minidump modos:
Visto que nenhuma entrada do usuário é possível, nenhum comando está disponível.

MEIO AMBIENTE

WINE_GDB
Quando usado em gdb modo proxy, WINE_GDB especifica o nome (e o caminho) do
executável a ser usado para gdb. "gdb" é usado por padrão.

AUTORES

A primeira versão foi escrita por Eric Youngdale.

Veja a lista de desenvolvedores do Wine para o resto dos contribuidores.

Use winedbg-development online usando serviços onworks.net