git.pond.sub.org Git - empserver/blob - include/lwp.h

   1 /*
   2  * lwp.h -- prototypes and structures for lightweight processes
   3  * Copyright (C) 1991-3 Stephen Crane.
   4  *
   5  * This library is free software; you can redistribute it and/or
   6  * modify it under the terms of the GNU Library General Public
   7  * License as published by the Free Software Foundation; either
   8  * version 2 of the License, or (at your option) any later version.
   9  *
  10  * This library is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13  * Library General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU Library General Public
  16  * License along with this library; if not, write to the Free
  17  * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  18  *
  19  * author: Stephen Crane, (jsc@doc.ic.ac.uk), Department of Computing,
  20  * Imperial College of Science, Technology and Medicine, 180 Queen's
  21  * Gate, London SW7 2BZ, England.
  22  */
  23 #ifndef _LWP_H_
  24 #define _LWP_H_
  25 #include "prototype.h"
  26 #ifdef UCONTEXT
  27 #include <ucontext.h>
  28 #else  /* UCONTEXT */
  29 #include <setjmp.h>
  30 #endif /* UCONTEXT */
  31 #include <sys/time.h>
  32 #include "misc.h"
  33 #define LWP_STACKCHECK  0x1
  34 #define LWP_PRINT       0x2
  35
  36 /* process control block.  do *not* change the position of context */
  37 struct lwpProc {
  38 #ifdef UCONTEXT
  39     ucontext_t context;         /* context structure */
  40 #else                           /* UCONTEXT */
  41     jmp_buf context;            /* processor context area */
  42 #endif                          /* UCONTEXT */
  43     void *sbtm;                 /* bottom of stack attached to it */
  44     int size;                   /* size of stack */
  45     void (*entry) ();           /* entry point */
  46     int dead;                   /* whether the process can be rescheduled */
  47     int pri;                    /* which scheduling queue we're on */
  48     long runtime;               /* time at which process is restarted */
  49     int fd;                     /* fd we're blocking on */
  50     int argc;                   /* initial arguments */
  51     char **argv;
  52     void *ud;                   /* user data */
  53     void *lowmark;              /* start of low buffer around stack */
  54     void *himark;               /* start of upper buffer around stack */
  55     char *name;                 /* process name and description */
  56     char *desc;
  57     int flags;
  58     struct lwpProc *next;
  59 };
  60
  61 /* queue */
  62 struct lwpQueue {
  63     struct lwpProc *head;
  64     struct lwpProc *tail;
  65 };
  66
  67 /* semaphore */
  68 struct lwpSem {
  69     int count;
  70     struct lwpQueue q;
  71     char *name;
  72 };
  73
  74 #define LWP_FD_READ     0x1
  75 #define LWP_FD_WRITE    0x2
  76
  77 #define LWP_MAX_PRIO    8
  78
  79 struct lwpProc *lwpInitSystem _PROTO((int prio, char **ctxp, int flags));
  80 struct lwpProc *lwpCreate _PROTO((int prio, void (*)(), int size,
  81                                   int flags, char *name, char *desc,
  82                                   int argc, char **argv, void *ud));
  83 void lwpExit _PROTO((void));
  84 void lwpTerminate _PROTO((struct lwpProc * p));
  85 void lwpYield _PROTO((void));
  86 void lwpSleepFd _PROTO((int fd, int flags));
  87 void lwpSleepUntil _PROTO((long until));
  88 void lwpWakeupFd _PROTO((struct lwpProc * p));
  89 void *lwpGetUD _PROTO((struct lwpProc * p));
  90 void lwpSetUD _PROTO((struct lwpProc * p, char *ud));
  91 void lwpSetDesc _PROTO((struct lwpProc * p, char *name, char *desc));
  92 int lwpSetPriority _PROTO((int prio));
  93 void lwpReschedule _PROTO((void));
  94
  95 struct lwpSem *lwpCreateSem _PROTO((char *name, int count));
  96 void lwpSignal _PROTO((struct lwpSem *));
  97 void lwpWait _PROTO((struct lwpSem *));
  98 void lwpSelect _PROTO((int argc, char **argv));
  99 void lwpStatus _PROTO((struct lwpProc * proc, char *format, ...));
 100
 101 extern struct lwpProc *LwpCurrent;
 102
 103 #include "prototypes.h"         /* must come at end, after defines and typedefs */
 104
 105 #endif /* _LWP_H_ */