GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  PVM_INSERT (3)

NAME

pvm_insert - store data in pvmd database
[In Version 3.4: Relaced by pvm_putinfo]

CONTENTS

Synopsis
Parameters
Description
Errors
See Also

SYNOPSIS


C       int cc = pvm_insert( char *name, int index, int data )

Fortran Not available

PARAMETERS

name The class name, a null-terminated string.
index The class index, >= 0 or -1 for first available.
data Data to store in the <name, index> entry.

DESCRIPTION

The master pvmd maintains a simple database, which can be used to store values such as tids and make them accessible anywhere within a virtual machine. This is useful when building an application such as the group server, which must advertise its task id so clients can register send messages to register.

The database stores integer data, indexed by <name, index> pairs. The name may be any null-terminated string and the index any non-negative integer. Database entries are grouped by name into classes; index may be specified as -1 to store or retrieve the first available instance in a class.

These functions are not part of the group library, but are the underlying mechanism used to implement it.

pvm_insert stores data at the given index. If index is -1, the data is stored at the first available index in the named class, starting at 0.

ERRORS

If successful, pvm_insert returns the index at which the data was stored, otherwise it returns a negative result. The following error conditions can be returned:
PvmBadParam giving an invalid argument value.
PvmDupEntry the requested <name, index> pair is already in use.

SEE ALSO

pvm_delete(3PVM), pvm_lookup(3PVM)
Search for    or go to Top of page |  Section 3 |  Main Index


INSERT (3PVM) 27 June, 1994

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.