1 f7012583 2003-11-25 devnull #ifndef _THREAD_H_
  2 f7012583 2003-11-25 devnull #define _THREAD_H_ 1
  3 f7012583 2003-11-25 devnull #if defined(__cplusplus)
  4 f7012583 2003-11-25 devnull extern "C" { 
  5 f7012583 2003-11-25 devnull #endif
  6 b2cfc4e2 2003-09-30 devnull 
  7 1a0954ab 2005-01-04 devnull AUTOLIB(thread)
  8 1a0954ab 2005-01-04 devnull 
  9 3286afda 2004-12-25 devnull /*
 10 3286afda 2004-12-25 devnull  * basic procs and threads
 11 3286afda 2004-12-25 devnull  */
 12 3286afda 2004-12-25 devnull int		proccreate(void (*f)(void *arg), void *arg, unsigned int stacksize);
 13 3286afda 2004-12-25 devnull int		threadcreate(void (*f)(void *arg), void *arg, unsigned int stacksize);
 14 3286afda 2004-12-25 devnull void		threadexits(char *);
 15 3286afda 2004-12-25 devnull void		threadexitsall(char *);
 16 3286afda 2004-12-25 devnull void		threadsetname(char*, ...);
 17 3286afda 2004-12-25 devnull void		threadsetstate(char*, ...);
 18 9d407753 2005-02-11 devnull char		*threadgetname(void);
 19 1d011ae2 2004-12-27 devnull int			threadyield(void);
 20 3286afda 2004-12-25 devnull void		_threadready(_Thread*);
 21 3286afda 2004-12-25 devnull void		_threadswitch(void);
 22 3286afda 2004-12-25 devnull void		_threadsetsysproc(void);
 23 3286afda 2004-12-25 devnull void		_threadsleep(Rendez*);
 24 3286afda 2004-12-25 devnull _Thread	*_threadwakeup(Rendez*);
 25 678ede7e 2004-12-27 devnull #define	yield		threadyield
 26 b2cfc4e2 2003-09-30 devnull 
 27 3286afda 2004-12-25 devnull /*
 28 38c10d1a 2005-01-17 devnull  * I am tired of making this mistake.
 29 38c10d1a 2005-01-17 devnull  */
 30 38c10d1a 2005-01-17 devnull #define	exits	do_not_call_exits_in_threaded_programs
 31 38c10d1a 2005-01-17 devnull #define	_exits	do_not_call__exits_in_threaded_programs
 32 38c10d1a 2005-01-17 devnull 
 33 38c10d1a 2005-01-17 devnull 
 34 38c10d1a 2005-01-17 devnull 
 35 38c10d1a 2005-01-17 devnull /*
 36 8fd25698 2005-01-04 devnull  * signals
 37 8fd25698 2005-01-04 devnull  */
 38 8fd25698 2005-01-04 devnull void		threadnotify(int(*f)(void*,char*), int);
 39 8fd25698 2005-01-04 devnull 
 40 8fd25698 2005-01-04 devnull /*
 41 2c87dda8 2004-12-28 devnull  * daemonize
 42 1a0954ab 2005-01-04 devnull  *
 43 2c87dda8 2004-12-28 devnull void	threaddaemonize(void);
 44 1a0954ab 2005-01-04 devnull  */
 45 2c87dda8 2004-12-28 devnull 
 46 2c87dda8 2004-12-28 devnull /*
 47 3286afda 2004-12-25 devnull  * per proc and thread data
 48 3286afda 2004-12-25 devnull  */
 49 3286afda 2004-12-25 devnull void		**procdata(void);
 50 b2cfc4e2 2003-09-30 devnull 
 51 3286afda 2004-12-25 devnull /*
 52 3286afda 2004-12-25 devnull  * supplied by user instead of main.
 53 3286afda 2004-12-25 devnull  * mainstacksize is size of stack allocated to run threadmain
 54 b2cfc4e2 2003-09-30 devnull  */
 55 3286afda 2004-12-25 devnull void		threadmain(int argc, char *argv[]);
 56 3286afda 2004-12-25 devnull extern	int	mainstacksize;
 57 b2cfc4e2 2003-09-30 devnull 
 58 3286afda 2004-12-25 devnull /*
 59 3286afda 2004-12-25 devnull  * channel communication
 60 3286afda 2004-12-25 devnull  */
 61 3286afda 2004-12-25 devnull typedef struct Alt Alt;
 62 3286afda 2004-12-25 devnull typedef struct _Altarray _Altarray;
 63 3286afda 2004-12-25 devnull typedef struct Channel Channel;
 64 b2cfc4e2 2003-09-30 devnull 
 65 3286afda 2004-12-25 devnull enum
 66 3286afda 2004-12-25 devnull {
 67 b2cfc4e2 2003-09-30 devnull 	CHANEND,
 68 b2cfc4e2 2003-09-30 devnull 	CHANSND,
 69 b2cfc4e2 2003-09-30 devnull 	CHANRCV,
 70 b2cfc4e2 2003-09-30 devnull 	CHANNOP,
 71 b2cfc4e2 2003-09-30 devnull 	CHANNOBLK,
 72 3286afda 2004-12-25 devnull };
 73 b2cfc4e2 2003-09-30 devnull 
 74 3286afda 2004-12-25 devnull struct Alt
 75 3286afda 2004-12-25 devnull {
 76 3286afda 2004-12-25 devnull 	void		*v;
 77 3286afda 2004-12-25 devnull 	Channel		*c;
 78 3286afda 2004-12-25 devnull 	uint		op;
 79 3286afda 2004-12-25 devnull 	_Thread		*thread;
 80 3286afda 2004-12-25 devnull 	Alt			*xalt;
 81 3286afda 2004-12-25 devnull };
 82 b2cfc4e2 2003-09-30 devnull 
 83 3286afda 2004-12-25 devnull struct _Altarray
 84 3286afda 2004-12-25 devnull {
 85 3286afda 2004-12-25 devnull 	Alt			**a;
 86 3286afda 2004-12-25 devnull 	uint		n;
 87 3286afda 2004-12-25 devnull 	uint		m;
 88 b2cfc4e2 2003-09-30 devnull };
 89 b2cfc4e2 2003-09-30 devnull 
 90 3286afda 2004-12-25 devnull struct Channel
 91 3286afda 2004-12-25 devnull {
 92 3286afda 2004-12-25 devnull 	uint			bufsize;
 93 3286afda 2004-12-25 devnull 	uint			elemsize;
 94 3286afda 2004-12-25 devnull 	uchar		*buf;
 95 3286afda 2004-12-25 devnull 	uint			nbuf;
 96 3286afda 2004-12-25 devnull 	uint			off;
 97 3286afda 2004-12-25 devnull 	_Altarray	asend;
 98 3286afda 2004-12-25 devnull 	_Altarray	arecv;
 99 3286afda 2004-12-25 devnull 	char			*name;
100 b2cfc4e2 2003-09-30 devnull };
101 b2cfc4e2 2003-09-30 devnull 
102 3286afda 2004-12-25 devnull /* [Edit .+1,./^$/ |cfn -h $PLAN9/src/libthread/channel.c] */
103 3286afda 2004-12-25 devnull int		chanalt(Alt *alts);
104 3286afda 2004-12-25 devnull Channel*	chancreate(int elemsize, int elemcnt);
105 b2cfc4e2 2003-09-30 devnull void		chanfree(Channel *c);
106 3286afda 2004-12-25 devnull int		chaninit(Channel *c, int elemsize, int elemcnt);
107 3286afda 2004-12-25 devnull int		channbrecv(Channel *c, void *v);
108 3286afda 2004-12-25 devnull void*		channbrecvp(Channel *c);
109 3286afda 2004-12-25 devnull ulong		channbrecvul(Channel *c);
110 3286afda 2004-12-25 devnull int		channbsend(Channel *c, void *v);
111 3286afda 2004-12-25 devnull int		channbsendp(Channel *c, void *v);
112 3286afda 2004-12-25 devnull int		channbsendul(Channel *c, ulong v);
113 3286afda 2004-12-25 devnull int		chanrecv(Channel *c, void *v);
114 3286afda 2004-12-25 devnull void*		chanrecvp(Channel *c);
115 3286afda 2004-12-25 devnull ulong		chanrecvul(Channel *c);
116 3286afda 2004-12-25 devnull int		chansend(Channel *c, void *v);
117 3286afda 2004-12-25 devnull int		chansendp(Channel *c, void *v);
118 3286afda 2004-12-25 devnull int		chansendul(Channel *c, ulong v);
119 e317e374 2004-12-27 devnull void		chansetname(Channel *c, char *fmt, ...);
120 a3ad5254 2004-06-09 devnull 
121 3286afda 2004-12-25 devnull #define	alt		chanalt
122 3286afda 2004-12-25 devnull #define	nbrecv	channbrecv
123 3286afda 2004-12-25 devnull #define	nbrecvp	channbrecvp
124 de9e3ca7 2005-02-08 devnull #define	nbrecvul	channbrecvul
125 3286afda 2004-12-25 devnull #define	nbsend	channbsend
126 3286afda 2004-12-25 devnull #define	nbsendp	channbsendp
127 3286afda 2004-12-25 devnull #define	nbsendul	channbsendul
128 3286afda 2004-12-25 devnull #define	recv		chanrecv
129 3286afda 2004-12-25 devnull #define	recvp	chanrecvp
130 3286afda 2004-12-25 devnull #define	recvul	chanrecvul
131 3286afda 2004-12-25 devnull #define	send		chansend
132 3286afda 2004-12-25 devnull #define	sendp	chansendp
133 3286afda 2004-12-25 devnull #define	sendul	chansendul
134 b2cfc4e2 2003-09-30 devnull 
135 3286afda 2004-12-25 devnull /*
136 3286afda 2004-12-25 devnull  * reference counts
137 3286afda 2004-12-25 devnull  */
138 3286afda 2004-12-25 devnull typedef struct Ref	Ref;
139 b2cfc4e2 2003-09-30 devnull 
140 3286afda 2004-12-25 devnull struct Ref {
141 3286afda 2004-12-25 devnull 	Lock lock;
142 3286afda 2004-12-25 devnull 	long ref;
143 3286afda 2004-12-25 devnull };
144 b2cfc4e2 2003-09-30 devnull 
145 3286afda 2004-12-25 devnull long		decref(Ref *r);
146 3286afda 2004-12-25 devnull long		incref(Ref *r);
147 3286afda 2004-12-25 devnull 
148 3286afda 2004-12-25 devnull /*
149 3286afda 2004-12-25 devnull  * slave i/o processes
150 3286afda 2004-12-25 devnull  */
151 b2cfc4e2 2003-09-30 devnull typedef struct Ioproc Ioproc;
152 b2cfc4e2 2003-09-30 devnull 
153 3286afda 2004-12-25 devnull /* [Edit .+1,/^$/ |cfn -h $PLAN9/src/libthread/io*.c] */
154 3286afda 2004-12-25 devnull void		closeioproc(Ioproc *io);
155 3286afda 2004-12-25 devnull long		iocall(Ioproc *io, long (*op)(va_list*), ...);
156 3286afda 2004-12-25 devnull int		ioclose(Ioproc *io, int fd);
157 3286afda 2004-12-25 devnull int		iodial(Ioproc *io, char *addr, char *local, char *dir, int *cdfp);
158 3286afda 2004-12-25 devnull void		iointerrupt(Ioproc *io);
159 3286afda 2004-12-25 devnull int		ioopen(Ioproc *io, char *path, int mode);
160 3286afda 2004-12-25 devnull Ioproc*		ioproc(void);
161 3286afda 2004-12-25 devnull long		ioread(Ioproc *io, int fd, void *a, long n);
162 3286afda 2004-12-25 devnull int		ioread9pmsg(Ioproc*, int, void*, int);
163 3286afda 2004-12-25 devnull long		ioreadn(Ioproc *io, int fd, void *a, long n);
164 3286afda 2004-12-25 devnull int		iorecvfd(Ioproc *, int);
165 3286afda 2004-12-25 devnull int		iosendfd(Ioproc*, int, int);
166 3286afda 2004-12-25 devnull int		iosleep(Ioproc *io, long n);
167 3286afda 2004-12-25 devnull long		iowrite(Ioproc *io, int fd, void *a, long n);
168 b2cfc4e2 2003-09-30 devnull 
169 3286afda 2004-12-25 devnull /*
170 3286afda 2004-12-25 devnull  * exec external programs
171 3286afda 2004-12-25 devnull  */
172 3286afda 2004-12-25 devnull void		threadexec(Channel*, int[3], char*, char *[]);
173 3286afda 2004-12-25 devnull void		threadexecl(Channel*, int[3], char*, ...);
174 3286afda 2004-12-25 devnull int		threadspawn(int[3], char*, char*[]);
175 80f510c8 2005-01-18 devnull int		threadspawnl(int[3], char*, ...);
176 3286afda 2004-12-25 devnull Channel*	threadwaitchan(void);
177 b2cfc4e2 2003-09-30 devnull 
178 f7012583 2003-11-25 devnull #if defined(__cplusplus)
179 f7012583 2003-11-25 devnull }
180 f7012583 2003-11-25 devnull #endif
181 b2cfc4e2 2003-09-30 devnull #endif	/* _THREADH_ */