Caminho do código-fonte

O caminho de origem especifica os diretórios em que os arquivos de origem C e C++ estão localizados.

Se você estiver depurando um processo de modo de usuário no computador em que o arquivo executável foi criado e se os arquivos de origem ainda estiverem em seu local original, o depurador poderá localizar automaticamente os arquivos de origem.

Na maioria das outras situações, você precisa definir o caminho de origem ou carregar os arquivos de origem individuais.

Quando você está executando a depuração remota por meio do depurador, o servidor de depuração usa o caminho de origem. Se você estiver usando o WinDbg como depurador, cada cliente de depuração também terá seu próprio caminho de origem local. Todos os comandos relacionados à origem acessam os arquivos de origem no computador local. Você precisa definir os caminhos adequados em qualquer cliente ou servidor que deseja usar comandos de origem.

Esse sistema de vários caminhos também permite que um cliente de depuração use comandos relacionados à origem sem realmente compartilhar os arquivos de origem com outros clientes ou com o servidor. Esse sistema será útil se houver arquivos de origem privados ou confidenciais aos quais um dos usuários tem acesso.

Você também pode carregar arquivos de origem a qualquer momento, independentemente do caminho de origem.

Sintaxe do caminho de origem

O caminho de origem do código-fonte do depurador é uma cadeia de caracteres que consiste em vários caminhos de diretório, separados por ponto-e-vírgula.

Caminhos relativos são compatíveis. No entanto, a menos que você sempre inicie o depurador a partir do mesmo diretório, deve adicionar uma letra de unidade ou um compartilhamento de rede antes de cada caminho. Também há suporte para compartilhamentos de rede.

Nota Se você estiver conectado a uma rede corporativa, a maneira mais eficiente de acessar arquivos de origem é usar um servidor de origem. Você pode usar um servidor de origem utilizando a cadeia de caracteres srv\* no caminho de origem. Para obter mais informações sobre servidores de origem, consulte Usando um servidor de origem.

Controlando o caminho de origem

Para controlar o caminho de origem e o caminho de origem local, você pode fazer um dos seguintes procedimentos:

• Antes de iniciar o depurador, use a variável de ambiente _NT_SOURCE_PATH para definir o caminho de origem. Se você tentar adicionar um diretório inválido por meio dessa variável de ambiente, o depurador ignorará esse diretório.

• Ao iniciar o depurador, use a opção de linha de comando-srcpath para definir o caminho de origem.

• Use o comando .srcpath (Definir Caminho de Origem) para exibir, definir, alterar ou acrescentar ao caminho de origem. Se você estiver usando um servidor de origem, .srcfix (Usar Servidor de Origem) será um pouco mais fácil.

• (Somente WinDbg) Use o comando .lsrcpath (Definir Caminho de Origem Local) para exibir, definir, alterar ou acrescentar ao caminho de origem local. Se você estiver usando um servidor de origem, .lsrcfix (usar o servidor de origem local) será um pouco mais fácil. Você também pode usar o WinDbg Command-Line com o parâmetro -lscrpath. Para obter mais informações, consulte Opções de linha de comando do WinDbg.

• (Somente WinDbg) Use o [Arquivo | Comando Caminho do Arquivo de Origem ou pressione CTRL+P para exibir, definir, alterar ou acrescentar ao caminho de origem ou ao caminho de origem local.

Você também pode abrir ou fechar diretamente um arquivo de origem fazendo um dos seguintes procedimentos:

• Use o comando lsf (Carregar ou Descarregar Arquivo de Origem) para abrir ou fechar um arquivo de origem.

• (Somente WinDbg) Use o comando .open (Arquivo de Software Livre) para abrir um arquivo de origem.

• (Somente WinDbg) Use o arquivo | comando de arquivo de software livre ou pressione ctrl+o para abrir um arquivo de origem. você também pode usar o botão de arquivo de software livre (ctrl+o) na barra de ferramentas.

  Nota Quando você usa Arquivo | Arquivo de software livre (ou seu menu de atalho ou equivalentes de botão) para abrir um arquivo de origem, o caminho desse arquivo é acrescentado automaticamente ao caminho de origem.

• (Somente WinDbg) Use o Arquivo | Arquivos Recentes para abrir um dos quatro arquivos de origem que você abriu mais recentemente no WinDbg.

• (Somente WinDbg) Use o comando File | Close Current Window ou selecione o botão Close no canto da janela de origem para fechar um arquivo de origem.

Consulte também

Para obter mais informações sobre como usar arquivos de origem, consulte Depuração no Modo de Origem.