pvm_halt

Scilab function
Last update : 12/01/2004

pvm_halt - stops the PVM daemon

### Calling Sequence

  `[info] = pvm_halt()`

### Parameters

- `info`: integer, status code returned by the routine. Values less than zero indicate an error.

### Description

`pvm_halt` kills all PVM tasks, all the remote daemons, and the local daemon. If the master pvmd is killed manually it should be sent a `SIGTERM` signal to allow it to kill the remote pvmds and clean up various files.

The pvmd can be killed in a manner that leaves the file `/tmp/pvmd.uid` behind on one or more hosts (the `uid` suffix is the numeric user ID from `/etc/passwd`) of the user. This will prevent PVM from restarting on that host. Deletion of this file will fix this problem and it can be done as follows: `rm `( grep $user /etc/passwd || ypmatch $user passwd )``| awk -F: '{print "/tmp/pvmd.";$3;exit}'``

For example:

    -->pvm_halt()
     ans  =

        0.

    -->pvm_halt()
     ans  =

      - 14.

Error -14 means: pvm_halt(): Can't contact local daemon

### See Also

`pvm_start`, `pvm_addhosts`, `pvm_config`,