---
name: "pvm_lvgroup"
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_lvgroup"
---

# pvm\_lvgroup(3)

Unenrolls the calling process from a named group.

## NAME

pvm\_lvgroup - Unenrolls the calling process from a named group.

## SYNOPSIS

```
C	int info = pvm_lvgroup( char *group )
Fortran	call pvmflvgroup( group, info )
```

## PARAMETERS

- group

  **Character string group name of an existing group.**\

- info

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

## DESCRIPTION

**The routine** *pvm\_lvgroup* **unenrolls the calling process from** **the group named** *group.* **If there is an error** *info* **will be negative.**

**If a process leaves a group by calling either pvm\_lvgroup** **or pvm\_exit, and later rejoins the same group, the process** **may be assigned a new instance number. Old instance** **numbers are reassigned to processes calling pvm\_joingroup.**

## EXAMPLES

```
C:
	info = pvm_lvgroup( "worker" );

Fortran:
	CALL PVMFLVGROUP( 'group2', INFO )
```

## ERRORS

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

- PvmSysErr

  **pvmd not responding.**

- PvmBadParam

  **giving a NULL group name.**

- PvmNoGroup

  **giving a non-existent group name.**

- PvmNotInGroup

  **asking to leave a group you are not a member of.**

## SEE ALSO

**pvm\_joingroup(3PVM)**