Активация клиента отладки

После активации сервера отладки можно запустить клиент отладки на другом компьютере и подключиться к сеансу отладки.

Существует два способа запуска клиента отладки: с помощью параметра командной строки -remote или с помощью графического интерфейса WinDbg.

Протокол клиента должен соответствовать протоколу сервера. Общий синтаксис для запуска клиента отладки зависит от используемого протокола. Имеются следующие варианты:

Debugger -remote npipe:server=Server,pipe=PipeName[,password=Password] 

Debugger -remote tcp:server=Server,port=Socket[,password=Password][,ipversion=6] 

Debugger -remote tcp:clicon=Server,port=Socket[,password=Password][,ipversion=6] 

Debugger -remote com:port=COMPort,baud=BaudRate,channel=COMChannel[,password=Password] 

Debugger -remote spipe:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,pipe=PipeName[,password=Password] 

Debugger -remote ssl:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,port=Socket[,password=Password] 

Debugger -remote ssl:proto=Protocol,{certuser=Cert|machuser=Cert},clicon=Server,port=Socket[,password=Password] 

Чтобы использовать графический интерфейс для подключения к удаленному сеансу отладки, WinDbg должен находиться в неактивном режиме. Он должен быть запущен без параметров командной строки или должен завершить предыдущий сеанс отладки. Выберите файл | Подключитесь к команде меню удаленного сеанса или нажмите сочетание клавиш CTRL+R. При появлении диалогового окна "Подключение к удаленному сеансу отладчика" введите одну из следующих строк в текстовое поле строки подключения:

npipe:server=Server,pipe=PipeName[,password=Password] 

tcp:server=Server,port=Socket[,password=Password][,ipversion=6] 

tcp:clicon=Server,port=Socket[,password=Password][,ipversion=6] 

com:port=COMPort,baud=BaudRate,channel=COMChannel[,password=Password] 

spipe:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,pipe=PipeName[,password=Password] 

ssl:proto=Protocol,{certuser=Cert|machuser=Cert},server=Server,port=Socket[,password=Password] 

ssl:proto=Protocol,{certuser=Cert|machuser=Cert},clicon=Server,port=Socket[,password=Password] 

Кроме того, можно использовать кнопку "Обзор", чтобы найти активные серверы отладки.

Параметры в предыдущих командах имеют следующие возможные значения:

Отладчик
Это не обязательно должен быть тот же отладчик, что и тот, который используется клиентом отладки. WinDbg, KD и CDB являются взаимозаменяемыми для целей удаленной отладки через отладчик.

Сервер
Это сетевое имя или IP-адрес компьютера, на котором был создан сервер отладки. Две начальные обратные косые черты (\) являются необязательными в командной строке, но не разрешены в диалоговом окне WinDbg.

pipe= Имя канала
Если используется протокол NPIPE или SPIPE, PipeName — это имя, которое было присвоено каналу при создании сервера.

Если вы не вошли на клиентский компьютер с учетной записью с доступом к серверу, необходимо указать имя пользователя и пароль. На клиентском компьютере в окне командной строки введите следующую команду.

net use \\Server\ipc$ /user:UserName

где сервер — это имя сервера, а Имя пользователя — имя учетной записи, которая имеет доступ к серверу.

При появлении запроса введите пароль для UserName.

После успешного выполнения этой команды можно активировать клиент отладки с помощью параметра командной строки -remote или с помощью графического интерфейса WinDbg.

Обратите внимание , что может потребоваться включить общий доступ к файлам и принтерам на серверном компьютере. В панель управления перейдите в раздел "Сеть" и "Сеть Интернета>" и "Расширенный общий доступ к Центру> общего доступа". Выберите "Включить общий доступ к файлам и принтерам".

port= Розетка
Если используется протокол TCP или SSL, сокет является тем же номером порта сокета , который использовался при создании сервера.

clicon
Указывает, что сервер отладки попытается подключиться к клиенту через обратное подключение. Клиент должен использовать clicon, только если сервер использует clicon. В большинстве случаев клиент отладки запускается перед сервером отладки при использовании обратного подключения.

port= Вести
Если используется протокол COM, COMPort указывает используемый com-порт. Префикс COM является необязательным. Например, допустимы как com2, так и "2".

baud= BaudRate
Если используется com-протокол, BaudRate должен соответствовать скорости baud, выбранной при создании сервера.

channel= COMChannel
Если используется протокол COM, COMChannel должен соответствовать номеру канала, выбранному при создании сервера.

proto= Протокол
Если используется протокол SSL или SPIPE, протокол должен соответствовать безопасному протоколу, используемому при создании сервера.

Сертификат
Если используется протокол SSL или SPIPE, следует использовать идентичный параметр certuser=Cert или machuser= Cert, который использовался при создании сервера.

password= Пароль
Если при создании сервера использовался пароль, необходимо указать пароль , чтобы создать клиент отладки. Он должен соответствовать исходному паролю. В паролях учитывается регистр символов. Если указан неправильный пароль, сообщение об ошибке будет указывать "Ошибка 0x80004005". Пароли должны быть двенадцатью символами или меньшей длиной.

ipversion=6
(Только средства отладки для Windows 6.6.07 и более ранних версий) Принудительно отладчик использовать IP-адрес версии 6, а не версию 4 при использовании TCP для подключения к Интернету. В Windows Vista и более поздних версиях отладчик пытается автоматически использовать IP-версию 6, что делает этот параметр ненужным.

Параметры командной строки, используемые для запуска новых сеансов отладки (например , P), не могут использоваться клиентом отладки, но только сервером. Параметры конфигурации (например , -n) будут работать с клиента или сервера.