[aem-devel] aem-11r0 - API major update

[Frederic R. (LMC) <Fre...@er...>]

There has been some changes in the user API for the
patch linux-2.4.19-aem-11r0.


* evctl calling convention:

   unsigned long evctl (parent_id, flags, jid);


* When requesting a memory pool inside the brk area,
  the application has to populate the change to the
  glibc library. The way of doing it is:

  #define TBL_UZONE   0

  void *new_brk;

  new_brk = (void *)evctl (0, EVTBLINIT, TBL_UZONE);
  brk (new_brk);


* Events are disabled now after their registration. This
  means that the application must start them explicitly.

  - EVJOBSTART: start/enable a job monitoring an
    event.

    ex: evctl (parent_id, EVJOBSTART, jid);
    where jid is the job to enable.   

    ex: evctl (parent_id, EVJOBSTART, -1);
    enables all jobs belonging to the current process.

  - EVJOBSTOP: stop/disbale a job monitoring an
    event.

    ex: evctl (parent_id, EVJOBSTOP, jid);
    where jid is the job to disable.

    ex: evctl (parent_id, EVJOBSTOP, -1);
    disables all jobs belonging to the current process.


* There is some moification regarding the calling convention for
  the flag EVJOBSHTDN.
   
  - EVJOBSHTDN: shutdown a job.

    ex: evctl (parent_id, EVJOBSHTDN, jid);
    where jid is the job to shutdown.

    ex: evctl (parent_id, EVJOBSHTDN, -1);
    shutdown all jobs belonging to the current process.