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, int argc,
  82                         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_ */