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 #ifdef UCONTEXT
  26 #include <ucontext.h>
  27 #else  /* UCONTEXT */
  28 #include <setjmp.h>
  29 #endif /* UCONTEXT */
  30 #include <sys/time.h>
  31 #include "misc.h"
  32 #define LWP_STACKCHECK  0x1
  33 #define LWP_PRINT       0x2
  34
  35 /* process control block.  do *not* change the position of context */
  36 struct lwpProc {
  37 #ifdef UCONTEXT
  38     ucontext_t context;         /* context structure */
  39 #else                           /* UCONTEXT */
  40     jmp_buf context;            /* processor context area */
  41 #endif                          /* UCONTEXT */
  42     void *sbtm;                 /* bottom of stack attached to it */
  43     int size;                   /* size of stack */
  44     void (*entry)(void *);      /* entry point */
  45     int dead;                   /* whether the process can be rescheduled */
  46     int pri;                    /* which scheduling queue we're on */
  47     long runtime;               /* time at which process is restarted */
  48     int fd;                     /* fd we're blocking on */
  49     int argc;                   /* initial arguments */
  50     char **argv;
  51     void *ud;                   /* user data */
  52     void *lowmark;              /* start of low buffer around stack */
  53     void *himark;               /* start of upper buffer around stack */
  54     char *name;                 /* process name and description */
  55     char *desc;
  56     int flags;
  57     struct lwpProc *next;
  58 };
  59
  60 /* queue */
  61 struct lwpQueue {
  62     struct lwpProc *head;
  63     struct lwpProc *tail;
  64 };
  65
  66 /* semaphore */
  67 struct lwpSem {
  68     int count;
  69     struct lwpQueue q;
  70     char *name;
  71 };
  72
  73 #define LWP_FD_READ     0x1
  74 #define LWP_FD_WRITE    0x2
  75
  76 #define LWP_MAX_PRIO    8
  77
  78 struct lwpProc *lwpInitSystem(int prio, char **ctxp, int flags);
  79 struct lwpProc *lwpCreate(int prio, void (*)(void *), int size,
  80                           int flags, char *name, char *desc,
  81                           int argc, char **argv, void *ud);
  82 void lwpExit(void);
  83 void lwpTerminate(struct lwpProc * p);
  84 void lwpYield(void);
  85 void lwpSleepFd(int fd, int flags);
  86 void lwpSleepUntil(long until);
  87 void lwpWakeupFd(struct lwpProc * p);
  88 void *lwpGetUD(struct lwpProc * p);
  89 void lwpSetUD(struct lwpProc * p, char *ud);
  90 void lwpSetDesc(struct lwpProc * p, char *name, char *desc);
  91 int lwpSetPriority(int prio);
  92 void lwpReschedule(void);
  93
  94 struct lwpSem *lwpCreateSem(char *name, int count);
  95 void lwpSignal(struct lwpSem *);
  96 void lwpWait(struct lwpSem *);
  97 void lwpSelect(void *);
  98 void lwpStatus(struct lwpProc *proc, char *format, ...)
  99     ATTRIBUTE((format (printf, 2, 3)));
 100
 101 extern struct lwpProc *LwpCurrent;
 102
 103 #include "prototypes.h"         /* must come at end, after defines and typedefs */
 104
 105 #endif /* _LWP_H_ */