.kill (processus kill)

En mode utilisateur, la commande .kill arrête un processus en cours de débogage.

En mode noyau, la commande .kill arrête un processus sur l’ordinateur cible.

Syntaxe du mode utilisateur

.kill [ /h | /n ]

Syntaxe du mode noyau

.kill Process 

Paramètres

/h
(Mode utilisateur uniquement) Tout événement de débogage en attente sera poursuivi et marqué comme traité. Il s’agit de la valeur par défaut.

/n
(Mode utilisateur uniquement) Tout événement de débogage en attente sera poursuivi sans être marqué comme traité.

Processus
Indique l’adresse du processus à arrêter. Si la valeur Process est omise ou définie sur zéro, le processus par défaut pour l’état système actuel est arrêté.

Environnement

En mode noyau, cette commande est prise en charge sur Microsoft Windows Server 2003 et versions ultérieures de Windows.

Notes

En mode utilisateur, cette commande arrête un processus en cours de débogage. Si le débogueur est attaché à un processus enfant, vous pouvez utiliser .kill pour arrêter le processus enfant sans arrêter le processus parent. Pour plus d'informations, consultez les exemples.

En mode noyau, cette commande planifie le processus sélectionné sur l’ordinateur cible afin de l'arrêter. La prochaine fois que la cible peut s’exécuter, par exemple à l’aide d’une commande g (Go), le processus spécifié est arrêté.

Vous ne pouvez pas utiliser cette commande pendant le débogage du noyau local.

Exemples

Utilisation de .childdbg

Imaginons que vous attachez un débogueur au processus parent (Parent.exe) avant qu'il crée un processus enfant. Vous pouvez saisir la commande .childdbg 1 pour indiquer au débogueur de se joindre à n’importe quel processus enfant créé par le parent.

1:001> .childdbg 1
Processes created by the current process will be debugged

Exécutez le processus parent, puis intervenez une fois le processus enfant créé. Utilisez la commande | (État du processus) pour afficher les numéros de processus pour les processus parent et enfant.

0:002> |*
.  0    id: 7f8 attach  name: C:\Parent\x64\Debug\Parent.exe
   1    id: 2d4 child   name: notepad.exe

Dans la sortie précédente, le nombre du processus enfant (notepad.exe) est 1. Le point (.) au début de la première ligne indique que le processus parent est le processus actuel. Pour que le processus enfant soit le processus actuel, saisissez |1s.

0:002> |1s
...
1:001> |*
#  0    id: 7f8 attach  name: C:\Parent\x64\Debug\Parent.exe
.  1    id: 2d4 child   name: notepad.exe

Pour arrêter le processus enfant, saisissez la commande .kill. Le processus parent continue à s’exécuter.

1:001> .kill
Terminated.  Exit thread and process events will occur.
1:001> g

Utilisation du paramètre -o

Lorsque vous démarrez WinDbg ou CDB, vous pouvez utiliser le paramètre -o pour indiquer au débogueur qu’il doit être joint aux processus enfants. Par exemple, la commande suivante lance WinDbg, qui démarre et se joint à Parent.exe. Lorsque Parent.exe crée un processus enfant, WinDbg se joint au processus enfant.

windbg -g -G -o Parent.exe

Pour en savoir plus, consultez WinDbg Command-Line Options et CDB Command-Line Options.

Spécifications