Caminho do código-fonte

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

Se você estiver depurando um processo de modo de usuário no computador onde 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 através do depurador, o servidor de depuração usa o caminho de origem. Se você estiver usando WinDbg como seu depurador, cada cliente de depuração também tem seu próprio caminho de origem local. Todos os comandos relacionados ao código-fonte acessam os arquivos de origem no computador local. Você tem que definir os caminhos adequados em qualquer cliente ou servidor que você deseja usar comandos de origem.

Esse sistema de vários caminhos também permite que um cliente de depuração use comandos relacionados ao código-fonte sem realmente compartilhar os arquivos de origem com outros clientes ou com o servidor. Este sistema é útil se existirem ficheiros de origem privados ou confidenciais a que um dos utilizadores tenha 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 depurador é uma cadeia de caracteres que consiste em vários caminhos de diretório, separados por ponto-e-vírgula.

Caminhos relativos são suportados. No entanto, a menos que inicies sempre o depurador a partir do mesmo diretório, deves adicionar uma letra de unidade de disco ou um caminho de partilha de rede antes de cada caminho. Compartilhamentos de rede também são suportados.

Observação 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 usando a cadeia de caracteres srv\* dentro do 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, siga um destes 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 (set Source Path) para exibir, definir, alterar ou acrescentar ao caminho de origem. Se você estiver usando um servidor de origem, .srcfix (Usar servidor de origem) é um pouco mais fácil.

• (Apenas WinDBG) Use o comando .lsrcpath (set Local Source Path) para exibir, definir, alterar ou acrescentar ao caminho de origem local. Se você estiver usando um servidor de origem, .lsrcfix (Usar servidor de origem local) é 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 Command-Line do WinDbg.

• (Apenas 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 seguindo um destes procedimentos:

• Use o comando lsf (Load or Unload Source File) para abrir ou fechar um arquivo de origem.

• (Apenas WinDBG) Use o comando .open (Open Source File) para abrir um arquivo de origem.

• (Apenas WinDBG) Use o comando file | open source file ou pressione ctrl+o para abrir um arquivo de origem. Você também pode usar o botão Arquivo de código aberto (Ctrl+O) na barra de ferramentas.

  Observação Quando utiliza o ficheiro | Arquivo de código-fonte aberto (ou seu menu de atalho ou equivalentes de botão) Para abrir um arquivo de origem, o caminho desse arquivo é automaticamente anexado ao caminho de origem.

• (Apenas WinDBG) Utilizar o ficheiro | Comando Arquivos recentes para abrir um dos quatro arquivos de origem que você abriu mais recentemente no WinDbg.

• (Apenas WinDbg) Utilize o comando Ficheiro | Fechar Janela Atual ou selecione o botão Fechar no canto da Janela de Origem para fechar um ficheiro de origem.

Ver também

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