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