# <kill>

[This is preliminary documentation and subject to change.]

Immediately stops a given process.

When used in combination with the <exec> task, it allows processed to be spawned for a certain duration or task, and then stopped.

### Parameters

Attribute | Type | Description | Required
--- | --- | --- | ---
pid | int | The unique identifier of the process to stop. | True
machine | string | The name of the computer on the network on which the process must be stopped. The default is the local computer. | False
timeout | int | The maximum amount of time to wait until the process is stopped, expressed in milliseconds. The default is to wait indefinitely. | False
failonerror | bool | Determines if task failure stops the build, or is just reported. The default is true. | False
if | bool | If true then the task will be executed; otherwise, skipped. The default is true. | False
unless | bool | Opposite of `if`. If false then the task will be executed; otherwise, skipped. The default is false. | False
verbose | bool | Determines whether the task should report detailed build log messages. The default is false. | False

### Examples

- Starts a server and a client process on the local computer, and stops the server process once the client process has finished executing.

      <exec program="server.exe" pidproperty="server.pid" spawn="true" />
      <exec program="client.exe" />
      <kill pid="${server.pid}" />

### Requirements

Assembly: NAnt.Contrib.Tasks (0.93.5002.0)