*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> EvmEventDestroy (3)              



NAME    [Toc]    [Back]

       EvmEventCreate, EvmEventCreateVa, EvmEventDup, EvmEventDestroy
 - Creates and destroys events

SYNOPSIS    [Toc]    [Back]

       #include <evm/evm.h>

       EvmStatus_t EvmEventCreate(
               EvmEvent_t *event ); EvmStatus_t EvmEventCreateVa(
               EvmEvent_t *event,
               [EvmItemId_t item_id,
               const EvmItemValue_t item_value]...,
               EvmITEM_NONE ); EvmStatus_t EvmEventDup(
               EvmEvent_t *dupev,
               EvmEvent_t event ); EvmStatus_t EvmEventDestroy(
               EvmEvent_t event );

OPERANDS    [Toc]    [Back]

       The  event to be created, copied, or destroyed.  The identifier
 for the Event Data Item to be set. See the EvmItemSet(3)   reference  page  for  possible  values  for  this
       operand, and the data contained by  the  data  item.   The
       value  to  be  stored  in the associated item indicated by
       item_id.  The return location where  the  duplicate  (new)
       event is stored.

DESCRIPTION    [Toc]    [Back]

       The  EvmEventCreate()  routine creates an empty event. The
       newly created event is returned  in  the  event  reference

       The  EvmEventCreateVa()  routine creates an event and adds
       the supplied items in a single call. The item list is terminated
  by  an  instance  of  the  item_id operand set to
       EvmITEM_NONE. The newly created event is returned  in  the
       event reference argument.

       The  EvmEventDup()  routine creates a copy of the supplied
       event and returns the new event  in  the  dupev  reference

       The  EvmEventDestroy()  routine destroys a previously created
 event, freeing its memory. This function must be used
       if it is necessary to destroy an event, to ensure that all
       associated memory is freed.

RESTRICTIONS    [Toc]    [Back]

       To avoid memory leakage, all structures that are  supplied
       to  the  caller  from  API routines must be freed with the
       appropriate EVM API free routine.

RETURN VALUES    [Toc]    [Back]

       The operation was completed without  error.   One  of  the
       arguments  to  the  function  was  invalid.   A value in a
       structure member is invalid.  An operation failed  because
       an attempt to acquire heap memory failed.

ERRORS    [Toc]    [Back]


LIBRARY    [Toc]    [Back]

       EVM Support Library (libevm.so, libevm.a)

FILES    [Toc]    [Back]


SEE ALSO    [Toc]    [Back]

       Commands: evmpost(1)

       Routines:  EvmConnCreate(3)  EvmEventPost(3) EvmItemSet(3)

       Files: kevm(7)

       Event Management: EVM(5)

       EVM Events: EvmEvent(5)

[ Back ]
 Similar pages
Name OS Title
pset_destroy Tru64 Destroys a processor set
pthread_mutex_destroy Tru64 Destroys a mutex
destroy_pset Tru64 Destroys a processor set
tis_mutex_destroy Tru64 Destroys the specified mutex object
pthread_rwlockattr_destroy Tru64 Destroys a previously initialized
pthread_cond_destroy Tru64 Destroys a condition variable
tis_cond_destroy Tru64 Destroys the specified condition variable
BUF_LOCKFREE FreeBSD destroys a buffer's lock
dmColorDestroy IRIX destroys the color converter.
sem_destroy Tru64 Destroys an unnamed semaphore (P1003.1b)
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service