---
name: "pvm_kill"
section: "3"
platform: "linux"
package: "pvm-dev"
version: "3.4.2-8"
release: "Debian 3.0 (Woody)"
platforms: ["linux"]
url: "https://new.carta.tech/pvm_kill"
---

# pvm\_kill(3)

Terminates a specified PVM process.

## NAME

pvm\_kill - Terminates a specified PVM process.

## SYNOPSIS

```
C	int info = pvm_kill( int tid )
Fortran	call pvmfkill( tid, info )
```

## PARAMETERS

- tid

  **Integer task identifier of the PVM process to be killed** **(not yourself).**\

- info

  **Integer status code returned by the routine.** **Values less than zero indicate an error.**

## DESCRIPTION

**The routine** *pvm\_kill* **sends a terminate (SIGTERM) signal** **to the PVM process identified by** *tid.* **In the case of multiprocessors the terminate signal is replaced** **with a host dependent method for killing a process.** **If pvm\_kill is successful,** *info* **will be 0. If some error occurs then** *info* **will be \< 0.**

**pvm\_kill is not designed to kill the calling process.** **To kill yourself in C call pvm\_exit() followed by exit().** **To kill yourself in Fortran call pvmfexit followed by stop.**

## EXAMPLES

```
C:
	info = pvm_kill( tid );

Fortran:
	CALL PVMFKILL( TID, INFO )
```

## ERRORS

**These error conditions can be returned by** *pvm\_kill*

- PvmBadParam

  **giving an invalid tid value.**

- PvmSysErr

  **pvmd not responding.**

## SEE ALSO

**pvm\_exit(3PVM),** **pvm\_halt(3PVM)**