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