---
name: "pvm_start_pvmd"
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_start_pvmd"
---

# pvm\_start\_pvmd(3)

Starts new PVM daemon.

## NAME

pvm\_start\_pvmd - Starts new PVM daemon.

## SYNOPSIS

```
C	int info = pvm_start_pvmd( int argc, char **argv, int block )
Fortran	call pvmfstartpvmd( args, block, info )
```

## PARAMETERS

- argc

  **Number of arguments in argv.**\

- argv

  **An array of arguments to the executable.**\

- args

  **A character string containing the arguments to the executable.**\

- args

  **A character string containing the arguments to the executable.**\

- block

  **Integer specifying whether to block until startup of all hosts complete** **or return immediately.**\

- info

  **Integer returning the error code.**

## DESCRIPTION

**The routine** *pvm\_start\_pvmd* **starts up a pvmd3 process,** **the master of a new virtual machine.** **It returns as soon as the pvmd is started and ready for work.** **If the block parameter is nonzero and a hostfile is passed to the** **pvmd as a parameter,** **it returns when all hosts marked to start have been added.** **pvm\_start\_pvmd returns zero on success.**

**If PVM is compiled to allow running more than one pvmd per host,** **a task calling pvm\_start\_pvmd before any other pvm functions** **will connect to the pvmd that it starts.** **pvm\_start\_pvmd sets environment variable** *PVMSOCK* to the address printed by the pvmd as it starts up.

## EXAMPLES

```
C:
	static char *argv[] = {
	    "-d41",
	    "/u/jones/pvmd_hosts",
	};
	argc = 2
	info = pvm_start_pvmd( argc, argv, block );

Fortran:
	CALL PVMFSTART_PVMD( '-d41 /u/jones/pvmd_hosts', BLOCK, INFO )
```

## EXAMPLES

```
C:
	static char *argv[] = {
	    "-d41",
	    "/u/jones/pvmd_hosts",
	};
	argc = 2
	info = pvm_start_pvmd( argc, argv, block );

Fortran:
	CALL PVMFSTART_PVMD( '-d41 /u/jones/pvmd_hosts', BLOCK, INFO )
```

## ERRORS

The following error conditions can be returned

- PvmDupHost

  A pvmd is already running.

- PvmSysErr

  The local pvmd is not responding.

## SEE ALSO

pvm\_addhosts(3PVM), pvmd3(1PVM) pvmd3(1PVM)