1 /*
2  * Lib9 is miscellany from the Plan 9 C library that doesn't
3  * fit into libutf or into libfmt, but is still missing from traditional
4  * Unix C libraries.
5  */
6 #ifndef _LIBC_H_
7 #define _LIBC_H_ 1
8 #if defined(__cplusplus)
9 extern "C" {
10 #endif                                                                
11 
12 /*
13  * Begin usual libc.h 
14  */
15 
16 #ifndef nil
17 #define	nil	((void*)0)
18 #endif
19 #define	nelem(x)	(sizeof(x)/sizeof((x)[0]))
20 
21 #ifndef offsetof
22 #define offsetof(s, m)	(ulong)(&(((s*)0)->m))
23 #endif
24 
25 /*
26  * mem routines (provided by system <string.h>)
27  *
28 extern	void*	memccpy(void*, void*, int, ulong);
29 extern	void*	memset(void*, int, ulong);
30 extern	int	memcmp(void*, void*, ulong);
31 extern	void*	memcpy(void*, void*, ulong);
32 extern	void*	memmove(void*, void*, ulong);
33 extern	void*	memchr(void*, int, ulong);
34  */
35 
36 /*
37  * string routines (provided by system <string.h>)
38  *
39 extern	char*	strcat(char*, char*);
40 extern	char*	strchr(char*, int);
41 extern	int	strcmp(char*, char*);
42 extern	char*	strcpy(char*, char*);
43  */
44 extern	char*	strecpy(char*, char*, char*);
45 extern	char*	p9strdup(char*);
46 /*
47 extern	char*	strncat(char*, char*, long);
48 extern	char*	strncpy(char*, char*, long);
49 extern	int	strncmp(char*, char*, long);
50 extern	char*	strpbrk(char*, char*);
51 extern	char*	strrchr(char*, int);
52 extern	char*	strtok(char*, char*);
53 extern	long	strlen(char*);
54 extern	long	strspn(char*, char*);
55 extern	long	strcspn(char*, char*);
56 extern	char*	strstr(char*, char*);
57  */
58 extern	int	cistrncmp(char*, char*, int);
59 extern	int	cistrcmp(char*, char*);
60 extern	char*	cistrstr(char*, char*);
61 extern	int	tokenize(char*, char**, int);
62 
63 /*
64 enum
65 {
66 	UTFmax		= 3,
67 	Runesync	= 0x80,
68 	Runeself	= 0x80,
69 	Runeerror	= 0x80,
70 };
71 */
72 
73 /*
74  * rune routines (provided by <utf.h>
75  *
76 extern	int	runetochar(char*, Rune*);
77 extern	int	chartorune(Rune*, char*);
78 extern	int	runelen(long);
79 extern	int	runenlen(Rune*, int);
80 extern	int	fullrune(char*, int);
81 extern	int	utflen(char*);
82 extern	int	utfnlen(char*, long);
83 extern	char*	utfrune(char*, long);
84 extern	char*	utfrrune(char*, long);
85 extern	char*	utfutf(char*, char*);
86 extern	char*	utfecpy(char*, char*, char*);
87 
88 extern	Rune*	runestrcat(Rune*, Rune*);
89 extern	Rune*	runestrchr(Rune*, Rune);
90 extern	int	runestrcmp(Rune*, Rune*);
91 extern	Rune*	runestrcpy(Rune*, Rune*);
92 extern	Rune*	runestrncpy(Rune*, Rune*, long);
93 extern	Rune*	runestrecpy(Rune*, Rune*, Rune*);
94 extern	Rune*	runestrdup(Rune*);
95 extern	Rune*	runestrncat(Rune*, Rune*, long);
96 extern	int	runestrncmp(Rune*, Rune*, long);
97 extern	Rune*	runestrrchr(Rune*, Rune);
98 extern	long	runestrlen(Rune*);
99 extern	Rune*	runestrstr(Rune*, Rune*);
100 
101 extern	Rune	tolowerrune(Rune);
102 extern	Rune	totitlerune(Rune);
103 extern	Rune	toupperrune(Rune);
104 extern	int	isalpharune(Rune);
105 extern	int	islowerrune(Rune);
106 extern	int	isspacerune(Rune);
107 extern	int	istitlerune(Rune);
108 extern	int	isupperrune(Rune);
109  */
110 
111 /*
112  * malloc (provied by system <stdlib.h>)
113  *
114 extern	void*	malloc(ulong);
115  */
116 extern	void*	p9malloc(ulong);
117 extern	void*	mallocz(ulong, int);
118 extern	void	p9free(void*);
119 extern	void*	p9calloc(ulong, ulong);
120 extern	void*	p9realloc(void*, ulong);
121 extern	void		setmalloctag(void*, ulong);
122 extern	void		setrealloctag(void*, ulong);
123 extern	ulong	getmalloctag(void*);
124 extern	ulong	getrealloctag(void*);
125 /*
126 extern	void*	malloctopoolblock(void*);
127 */
128 #ifndef NOPLAN9DEFINES
129 #define	malloc	p9malloc
130 #define	realloc	p9realloc
131 #define	calloc	p9calloc
132 #define	free	p9free
133 #undef strdup
134 #define	strdup	p9strdup
135 #endif
136 
137 /*
138  * print routines (provided by <fmt.h>)
139  *
140 typedef struct Fmt	Fmt;
141 struct Fmt{
142 	uchar	runes;
143 	void	*start;
144 	void	*to;
145 	void	*stop;
146 	int	(*flush)(Fmt *);
147 	void	*farg;
148 	int	nfmt;
149 	va_list	args;
150 	int	r;
151 	int	width;
152 	int	prec;
153 	ulong	flags;
154 };
155 
156 enum{
157 	FmtWidth	= 1,
158 	FmtLeft		= FmtWidth << 1,
159 	FmtPrec		= FmtLeft << 1,
160 	FmtSharp	= FmtPrec << 1,
161 	FmtSpace	= FmtSharp << 1,
162 	FmtSign		= FmtSpace << 1,
163 	FmtZero		= FmtSign << 1,
164 	FmtUnsigned	= FmtZero << 1,
165 	FmtShort	= FmtUnsigned << 1,
166 	FmtLong		= FmtShort << 1,
167 	FmtVLong	= FmtLong << 1,
168 	FmtComma	= FmtVLong << 1,
169 	FmtByte	= FmtComma << 1,
170 
171 	FmtFlag		= FmtByte << 1
172 };
173 
174 extern	int	print(char*, ...);
175 extern	char*	seprint(char*, char*, char*, ...);
176 extern	char*	vseprint(char*, char*, char*, va_list);
177 extern	int	snprint(char*, int, char*, ...);
178 extern	int	vsnprint(char*, int, char*, va_list);
179 extern	char*	smprint(char*, ...);
180 extern	char*	vsmprint(char*, va_list);
181 extern	int	sprint(char*, char*, ...);
182 extern	int	fprint(int, char*, ...);
183 extern	int	vfprint(int, char*, va_list);
184 
185 extern	int	runesprint(Rune*, char*, ...);
186 extern	int	runesnprint(Rune*, int, char*, ...);
187 extern	int	runevsnprint(Rune*, int, char*, va_list);
188 extern	Rune*	runeseprint(Rune*, Rune*, char*, ...);
189 extern	Rune*	runevseprint(Rune*, Rune*, char*, va_list);
190 extern	Rune*	runesmprint(char*, ...);
191 extern	Rune*	runevsmprint(char*, va_list);
192 
193 extern	int	fmtfdinit(Fmt*, int, char*, int);
194 extern	int	fmtfdflush(Fmt*);
195 extern	int	fmtstrinit(Fmt*);
196 extern	char*	fmtstrflush(Fmt*);
197 extern	int	runefmtstrinit(Fmt*);
198 extern	Rune*	runefmtstrflush(Fmt*);
199 
200 extern	int	fmtinstall(int, int (*)(Fmt*));
201 extern	int	dofmt(Fmt*, char*);
202 extern	int	dorfmt(Fmt*, Rune*);
203 extern	int	fmtprint(Fmt*, char*, ...);
204 extern	int	fmtvprint(Fmt*, char*, va_list);
205 extern	int	fmtrune(Fmt*, int);
206 extern	int	fmtstrcpy(Fmt*, char*);
207 extern	int	fmtrunestrcpy(Fmt*, Rune*);
208  */
209 
210 /*
211  * error string for %r
212  * supplied on per os basis, not part of fmt library
213  *
214  * (provided by lib9, but declared in fmt.h)
215  *
216 extern	int	errfmt(Fmt *f);
217  */
218 
219 /*
220  * quoted strings
221  */
222 extern	char	*unquotestrdup(char*);
223 extern	Rune	*unquoterunestrdup(Rune*);
224 extern	char	*quotestrdup(char*);
225 extern	Rune	*quoterunestrdup(Rune*);
226 /*
227  * in fmt.h
228  *
229 extern	void	quotefmtinstall(void);
230 extern	int	quotestrfmt(Fmt*);
231 extern	int	quoterunestrfmt(Fmt*);
232  */
233 #ifndef NOPLAN9DEFINES
234 #define doquote fmtdoquote
235 #endif
236 extern	int	needsrcquote(int);
237 
238 /*
239  * random number
240  */
241 extern	void	p9srand(long);
242 extern	int	p9rand(void);
243 
244 extern	int	p9nrand(int);
245 extern	long	p9lrand(void);
246 extern	long	p9lnrand(long);
247 extern	double	p9frand(void);
248 extern	ulong	truerand(void);			/* uses /dev/random */
249 extern	ulong	ntruerand(ulong);		/* uses /dev/random */
250 
251 #ifndef NOPLAN9DEFINES
252 #define	srand	p9srand
253 #define	rand	p9rand
254 #define	nrand	p9nrand
255 #define	lrand	p9lrand
256 #define	lnrand	p9lnrand
257 #define	frand	p9frand
258 #endif
259 
260 /*
261  * math
262  */
263 extern	ulong	getfcr(void);
264 extern	void	setfsr(ulong);
265 extern	ulong	getfsr(void);
266 extern	void	setfcr(ulong);
267 extern	double	NaN(void);
268 extern	double	Inf(int);
269 extern	int	isNaN(double);
270 extern	int	isInf(double, int);
271 extern	ulong	umuldiv(ulong, ulong, ulong);
272 extern	long	muldiv(long, long, long);
273 
274 /*
275  * provided by math.h
276  *
277 extern	double	pow(double, double);
278 extern	double	atan2(double, double);
279 extern	double	fabs(double);
280 extern	double	atan(double);
281 extern	double	log(double);
282 extern	double	log10(double);
283 extern	double	exp(double);
284 extern	double	floor(double);
285 extern	double	ceil(double);
286 extern	double	hypot(double, double);
287 extern	double	sin(double);
288 extern	double	cos(double);
289 extern	double	tan(double);
290 extern	double	asin(double);
291 extern	double	acos(double);
292 extern	double	sinh(double);
293 extern	double	cosh(double);
294 extern	double	tanh(double);
295 extern	double	sqrt(double);
296 extern	double	fmod(double, double);
297 #define	HUGE	3.4028234e38
298 #define	PIO2	1.570796326794896619231e0
299 #define	PI	(PIO2+PIO2)
300  */
301 #define PI	M_PI
302 #define	PIO2	M_PI_2
303 
304 /*
305  * Time-of-day
306  */
307 
308 typedef
309 struct Tm
310 {
311 	int	sec;
312 	int	min;
313 	int	hour;
314 	int	mday;
315 	int	mon;
316 	int	year;
317 	int	wday;
318 	int	yday;
319 	char	zone[4];
320 	int	tzoff;
321 } Tm;
322 
323 extern	Tm*	p9gmtime(long);
324 extern	Tm*	p9localtime(long);
325 extern	char*	p9asctime(Tm*);
326 extern	char*	p9ctime(long);
327 extern	double	p9cputime(void);
328 extern	long	p9times(long*);
329 extern	long	p9tm2sec(Tm*);
330 extern	vlong	p9nsec(void);
331 
332 #ifndef NOPLAN9DEFINES
333 #define	gmtime		p9gmtime
334 #define	localtime	p9localtime
335 #define	asctime		p9asctime
336 #define	ctime		p9ctime
337 #define	cputime		p9cputime
338 #define	times		p9times
339 #define	tm2sec		p9tm2sec
340 #define	nsec		p9nsec
341 #endif
342 
343 /*
344  * one-of-a-kind
345  */
346 enum
347 {
348 	PNPROC		= 1,
349 	PNGROUP		= 2,
350 };
351 
352 /* extern	int	abs(int); <stdlib.h> */
353 extern	int	p9atexit(void(*)(void));
354 extern	void	p9atexitdont(void(*)(void));
355 extern	int	atnotify(int(*)(void*, char*), int);
356 /* 
357  * <stdlib.h>
358 extern	double	atof(char*); <stdlib.h>
359  */
360 extern	int	p9atoi(char*);
361 extern	long	p9atol(char*);
362 extern	vlong	p9atoll(char*);
363 extern	double	fmtcharstod(int(*)(void*), void*);
364 extern	char*	cleanname(char*);
365 extern	int	p9decrypt(void*, void*, int);
366 extern	int	p9encrypt(void*, void*, int);
367 extern	int	netcrypt(void*, void*);
368 extern	int	dec64(uchar*, int, char*, int);
369 extern	int	enc64(char*, int, uchar*, int);
370 extern	int	dec32(uchar*, int, char*, int);
371 extern	int	enc32(char*, int, uchar*, int);
372 extern	int	dec16(uchar*, int, char*, int);
373 extern	int	enc16(char*, int, uchar*, int);
374 extern	int	encodefmt(Fmt*);
375 extern	int	dirmodefmt(Fmt*);
376 extern	void	exits(char*);
377 extern	double	frexp(double, int*);
378 extern	ulong	getcallerpc(void*);
379 extern	char*	p9getenv(char*);
380 extern	int	p9putenv(char*, char*);
381 extern	int	getfields(char*, char**, int, int, char*);
382 extern	int	gettokens(char *, char **, int, char *);
383 extern	char*	getuser(void);
384 extern	char*	p9getwd(char*, int);
385 extern	int	iounit(int);
386 /* extern	long	labs(long); <math.h> */
387 /* extern	double	ldexp(double, int); <math.h> */
388 extern	void	p9longjmp(p9jmp_buf, int);
389 extern	char*	mktemp(char*);
390 extern	int		opentemp(char*);
391 /* extern	double	modf(double, double*); <math.h> */
392 extern	void	p9notejmp(void*, p9jmp_buf, int);
393 extern	void	perror(const char*);
394 extern	int	postnote(int, int, char *);
395 extern	double	p9pow10(int);
396 /* extern	int	putenv(char*, char*); <stdlib.h. */
397 /* extern	void	qsort(void*, long, long, int (*)(void*, void*)); <stdlib.h> */
398 extern	char*	searchpath(char*);
399 /* extern	int	p9setjmp(p9jmp_buf); */
400 #define p9setjmp(b)	sigsetjmp((void*)(b), 1)
401 /*
402  * <stdlib.h>
403 extern	long	strtol(char*, char**, int);
404 extern	ulong	strtoul(char*, char**, int);
405 extern	vlong	strtoll(char*, char**, int);
406 extern	uvlong	strtoull(char*, char**, int);
407  */
408 extern	void	sysfatal(char*, ...);
409 extern	void	p9syslog(int, char*, char*, ...);
410 extern	long	p9time(long*);
411 /* extern	int	tolower(int); <ctype.h> */
412 /* extern	int	toupper(int); <ctype.h> */
413 extern	void	needstack(int);
414 extern	char*	readcons(char*, char*, int);
415 
416 #ifndef NOPLAN9DEFINES
417 #define atexit		p9atexit
418 #define atexitdont	p9atexitdont
419 #define atoi		p9atoi
420 #define atol		p9atol
421 #define atoll		p9atoll
422 #define encrypt		p9encrypt
423 #define decrypt		p9decrypt
424 #define getenv		p9getenv
425 #define	getwd		p9getwd
426 #define	longjmp		p9longjmp
427 #undef  setjmp
428 #define setjmp		p9setjmp
429 #define putenv		p9putenv
430 #define notejmp		p9notejmp
431 #define jmp_buf		p9jmp_buf
432 #define time		p9time
433 #define pow10		p9pow10
434 #define strtod		fmtstrtod
435 #define charstod	fmtcharstod
436 #define syslog		p9syslog
437 #endif
438 
439 /*
440  *  just enough information so that libc can be
441  *  properly locked without dragging in all of libthread
442  */
443 typedef struct _Thread _Thread;
444 typedef struct _Threadlist _Threadlist;
445 struct _Threadlist
446 {
447 	_Thread	*head;
448 	_Thread	*tail;
449 };
450 
451 extern	_Thread	*(*threadnow)(void);
452 
453 /*
454  *  synchronization
455  */
456 typedef struct Lock Lock;
457 struct Lock
458 {
459 #ifdef PLAN9PORT_USING_PTHREADS
460 	int init;
461 	pthread_mutex_t mutex;
462 #endif
463 	int held;
464 };
465 
466 extern	void	lock(Lock*);
467 extern	void	unlock(Lock*);
468 extern	int	canlock(Lock*);
469 extern	int	(*_lock)(Lock*, int, ulong);
470 extern	void	(*_unlock)(Lock*, ulong);	
471 
472 typedef struct QLock QLock;
473 struct QLock
474 {
475 	Lock		l;
476 	_Thread	*owner;
477 	_Threadlist	waiting;
478 };
479 
480 extern	void	qlock(QLock*);
481 extern	void	qunlock(QLock*);
482 extern	int	canqlock(QLock*);
483 extern	int	(*_qlock)(QLock*, int, ulong);	/* do not use */
484 extern	void	(*_qunlock)(QLock*, ulong);
485 
486 typedef struct Rendez Rendez;
487 struct Rendez
488 {
489 	QLock	*l;
490 	_Threadlist	waiting;
491 };
492 
493 extern	void	rsleep(Rendez*);	/* unlocks r->l, sleeps, locks r->l again */
494 extern	int	rwakeup(Rendez*);
495 extern	int	rwakeupall(Rendez*);
496 extern	void	(*_rsleep)(Rendez*, ulong);	/* do not use */
497 extern	int	(*_rwakeup)(Rendez*, int, ulong);
498 
499 typedef struct RWLock RWLock;
500 struct RWLock
501 {
502 	Lock		l;
503 	int	readers;
504 	_Thread	*writer;
505 	_Threadlist	rwaiting;
506 	_Threadlist	wwaiting;
507 };
508 
509 extern	void	rlock(RWLock*);
510 extern	void	runlock(RWLock*);
511 extern	int		canrlock(RWLock*);
512 extern	void	wlock(RWLock*);
513 extern	void	wunlock(RWLock*);
514 extern	int		canwlock(RWLock*);
515 extern	int	(*_rlock)(RWLock*, int, ulong);	/* do not use */
516 extern	int	(*_wlock)(RWLock*, int, ulong);
517 extern	void	(*_runlock)(RWLock*, ulong);
518 extern	void	(*_wunlock)(RWLock*, ulong);
519 
520 /*
521  * per-process private data
522  */
523 extern	void**	privalloc(void);
524 extern	void	privfree(void**);
525 
526 /*
527  *  network dialing
528  */
529 #define NETPATHLEN 40
530 extern	int	p9accept(int, char*);
531 extern	int	p9announce(char*, char*);
532 extern	int	p9dial(char*, char*, char*, int*);
533 extern	int	p9dialparse(char *ds, char **net, char **unixa, u32int *ip, int *port);
534 extern	void	p9setnetmtpt(char*, int, char*);
535 extern	int	p9listen(char*, char*);
536 extern	char*	p9netmkaddr(char*, char*, char*);
537 extern	int	p9reject(int, char*, char*);
538 
539 #ifndef NOPLAN9DEFINES
540 #define	accept		p9accept
541 #define	announce	p9announce
542 #define	dial		p9dial
543 #define	setnetmtpt	p9setnetmtpt
544 #define	listen		p9listen
545 #define	netmkaddr	p9netmkaddr
546 #define	reject		p9reject
547 #endif
548 
549 /*
550  *  encryption
551  */
552 extern	int	pushssl(int, char*, char*, char*, int*);
553 extern	int	pushtls(int, char*, char*, int, char*, char*);
554 
555 /*
556  *  network services
557  */
558 typedef struct NetConnInfo NetConnInfo;
559 struct NetConnInfo
560 {
561 	char	*dir;		/* connection directory */
562 	char	*root;		/* network root */
563 	char	*spec;		/* binding spec */
564 	char	*lsys;		/* local system */
565 	char	*lserv;		/* local service */
566 	char	*rsys;		/* remote system */
567 	char	*rserv;		/* remote service */
568 	char *laddr;
569 	char *raddr;
570 };
571 extern	NetConnInfo*	getnetconninfo(char*, int);
572 extern	void		freenetconninfo(NetConnInfo*);
573 
574 /*
575  * system calls
576  *
577  */
578 #define	STATMAX	65535U	/* max length of machine-independent stat structure */
579 #define	DIRMAX	(sizeof(Dir)+STATMAX)	/* max length of Dir structure */
580 #define	ERRMAX	128	/* max length of error string */
581 
582 #define	MORDER	0x0003	/* mask for bits defining order of mounting */
583 #define	MREPL	0x0000	/* mount replaces object */
584 #define	MBEFORE	0x0001	/* mount goes before others in union directory */
585 #define	MAFTER	0x0002	/* mount goes after others in union directory */
586 #define	MCREATE	0x0004	/* permit creation in mounted directory */
587 #define	MCACHE	0x0010	/* cache some data */
588 #define	MMASK	0x0017	/* all bits on */
589 
590 #define	OREAD	0	/* open for read */
591 #define	OWRITE	1	/* write */
592 #define	ORDWR	2	/* read and write */
593 #define	OEXEC	3	/* execute, == read but check execute permission */
594 #define	OTRUNC	16	/* or'ed in (except for exec), truncate file first */
595 #define	OCEXEC	32	/* or'ed in, close on exec */
596 #define	ORCLOSE	64	/* or'ed in, remove on close */
597 #define	ODIRECT	128	/* or'ed in, direct access */
598 #define ONONBLOCK 256	/* or'ed in, non-blocking call */
599 #define	OEXCL	0x1000	/* or'ed in, exclusive use (create only) */
600 #define	OLOCK	0x2000	/* or'ed in, lock after opening */
601 #define	OAPPEND	0x4000	/* or'ed in, append only */
602 
603 #define	AEXIST	0	/* accessible: exists */
604 #define	AEXEC	1	/* execute access */
605 #define	AWRITE	2	/* write access */
606 #define	AREAD	4	/* read access */
607 
608 /* Segattch */
609 #define	SG_RONLY	0040	/* read only */
610 #define	SG_CEXEC	0100	/* detach on exec */
611 
612 #define	NCONT	0	/* continue after note */
613 #define	NDFLT	1	/* terminate after note */
614 #define	NSAVE	2	/* clear note but hold state */
615 #define	NRSTR	3	/* restore saved state */
616 
617 /* bits in Qid.type */
618 #define QTDIR		0x80		/* type bit for directories */
619 #define QTAPPEND	0x40		/* type bit for append only files */
620 #define QTEXCL		0x20		/* type bit for exclusive use files */
621 #define QTMOUNT		0x10		/* type bit for mounted channel */
622 #define QTAUTH		0x08		/* type bit for authentication file */
623 #define QTLINK		0x04		/* symbolic link */
624 #define QTFILE		0x00		/* plain file */
625 
626 /* bits in Dir.mode */
627 #define DMDIR		0x80000000	/* mode bit for directories */
628 #define DMAPPEND	0x40000000	/* mode bit for append only files */
629 #define DMEXCL		0x20000000	/* mode bit for exclusive use files */
630 #define DMMOUNT		0x10000000	/* mode bit for mounted channel */
631 #define DMAUTH		0x08000000	/* mode bit for authentication file */
632 #define DMDEVICE		0x00800000	/* mode bit for device files (Unix) */
633 #define DMSYMLINK	0x00400000	/* mode bit for symbolic links (Unix) */
634 #define DMNAMEDPIPE	0x00200000	/* mode bit for named pipes (Unix) */
635 #define DMSOCKET		0x00100000	/* mode bit for sockets (Unix) */
636 
637 #define DMREAD		0x4		/* mode bit for read permission */
638 #define DMWRITE		0x2		/* mode bit for write permission */
639 #define DMEXEC		0x1		/* mode bit for execute permission */
640 
641 #if defined(__FreeBSD__)
642 #undef RFFDG
643 #undef RFNOTEG
644 #undef RFPROC
645 #undef RFMEM
646 #undef RFNOWAIT
647 #undef RFCFDG
648 #undef RFNAMEG
649 #undef RFENVG
650 #undef RFCENVG
651 #undef RFCFDG
652 #undef RFCNAMEG
653 #endif
654 
655 enum
656 {
657 	RFNAMEG		= (1<<0), 
658 	RFENVG		= (1<<1), 
659 	RFFDG		= (1<<2),
660 	RFNOTEG		= (1<<3),
661 	RFPROC		= (1<<4),
662 	RFMEM		= (1<<5),
663 	RFNOWAIT	= (1<<6),
664 	RFCNAMEG	= (1<<10), 
665 	RFCENVG		= (1<<11), 
666 	RFCFDG		= (1<<12),
667 /*	RFREND		= (1<<13), */
668 /*	RFNOMNT		= (1<<14) */
669 };
670 
671 typedef
672 struct Qid
673 {
674 	uvlong	path;
675 	ulong	vers;
676 	uchar	type;
677 } Qid;
678 
679 typedef
680 struct Dir {
681 	/* system-modified data */
682 	ushort	type;	/* server type */
683 	uint	dev;	/* server subtype */
684 	/* file data */
685 	Qid	qid;	/* unique id from server */
686 	ulong	mode;	/* permissions */
687 	ulong	atime;	/* last read time */
688 	ulong	mtime;	/* last write time */
689 	vlong	length;	/* file length */
690 	char	*name;	/* last element of path */
691 	char	*uid;	/* owner name */
692 	char	*gid;	/* group name */
693 	char	*muid;	/* last modifier name */
694 } Dir;
695 
696 /* keep /sys/src/ape/lib/ap/plan9/sys9.h in sync with this -rsc */
697 typedef
698 struct Waitmsg
699 {
700 	int pid;	/* of loved one */
701 	ulong time[3];	/* of loved one & descendants */
702 	char	*msg;
703 } Waitmsg;
704 
705 typedef
706 struct IOchunk
707 {
708 	void	*addr;
709 	ulong	len;
710 } IOchunk;
711 
712 extern	void	_exits(char*);
713 
714 extern	void	abort(void);
715 /* extern	int	access(char*, int); */
716 extern	long	p9alarm(ulong);
717 extern	int	await(char*, int);
718 extern	int	awaitfor(int, char*, int);
719 extern	int	awaitnohang(char*, int);
720 /* extern	int	bind(char*, char*, int); give up */
721 /* extern	int	brk(void*); <unistd.h> */
722 extern	int	p9chdir(char*);
723 extern	int	close(int);
724 extern	int	p9create(char*, int, ulong);
725 extern	int	p9dup(int, int);
726 extern	int	errstr(char*, uint);
727 extern	int	p9exec(char*, char*[]);
728 extern	int	p9execl(char*, ...);
729 /* extern	int	p9fork(void); */
730 extern	int	p9rfork(int);
731 /* not implemented 
732 extern	int	fauth(int, char*);
733 extern	int	fstat(int, uchar*, int);
734 extern	int	fwstat(int, uchar*, int);
735 extern	int	fversion(int, int, char*, int);
736 extern	int	mount(int, int, char*, int, char*);
737 extern	int	unmount(char*, char*);
738 */
739 extern	int	noted(int);
740 extern	int	notify(void(*)(void*, char*));
741 extern	int	noteenable(char*);
742 extern	int	notedisable(char*);
743 extern	int	notifyon(char*);
744 extern	int	notifyoff(char*);
745 extern	int	p9open(char*, int);
746 extern	int	fd2path(int, char*, int);
747 extern	int	p9pipe(int*);
748 /* 
749  * use defs from <unistd.h>
750 extern	long	pread(int, void*, long, vlong);
751 extern	long	preadv(int, IOchunk*, int, vlong);
752 extern	long	pwrite(int, void*, long, vlong);
753 extern	long	pwritev(int, IOchunk*, int, vlong);
754 extern	long	read(int, void*, long);
755  */
756 extern	long	readn(int, void*, long);
757 /* extern	long	readv(int, IOchunk*, int); <unistd.h> */
758 extern	int	remove(const char*);
759 /* extern	void*	sbrk(ulong); <unistd.h> */
760 /* extern	long	oseek(int, long, int); */
761 extern	vlong	p9seek(int, vlong, int);
762 /* give up
763 extern	long	segattach(int, char*, void*, ulong);
764 extern	int	segbrk(void*, void*);
765 extern	int	segdetach(void*);
766 extern	int	segflush(void*, ulong);
767 extern	int	segfree(void*, ulong);
768 */
769 extern	int	p9sleep(long);
770 /* extern	int	stat(char*, uchar*, int); give up */
771 extern	Waitmsg*	p9wait(void);
772 extern	Waitmsg*	p9waitfor(int);
773 extern	Waitmsg*	waitnohang(void);
774 extern	int	p9waitpid(void);
775 /* <unistd.h>
776 extern	long	write(int, void*, long);
777 extern	long	writev(int, IOchunk*, int);
778 */
779 /* extern	int	wstat(char*, uchar*, int); give up */
780 extern	ulong	rendezvous(ulong, ulong);
781 
782 #ifndef NOPLAN9DEFINES
783 #define alarm		p9alarm
784 #define	dup		p9dup
785 #define	exec		p9exec
786 #define	execl	p9execl
787 #define	seek		p9seek
788 #define sleep		p9sleep
789 #define wait		p9wait
790 #define waitpid		p9waitpid
791 /* #define fork		p9fork */
792 #define rfork		p9rfork
793 /* #define access		p9access */
794 #define create		p9create
795 #undef open
796 #define open		p9open
797 #define pipe		p9pipe
798 #define	waitfor		p9waitfor
799 #endif
800 
801 extern	Dir*	dirstat(char*);
802 extern	Dir*	dirfstat(int);
803 extern	int	dirwstat(char*, Dir*);
804 extern	int	dirfwstat(int, Dir*);
805 extern	long	dirread(int, Dir**);
806 extern	void	nulldir(Dir*);
807 extern	long	dirreadall(int, Dir**);
808 /* extern	int	getpid(void); <unistd.h> */
809 /* extern	int	getppid(void); */
810 extern	void	rerrstr(char*, uint);
811 extern	char*	sysname(void);
812 extern	void	werrstr(char*, ...);
813 extern	char*	getns(void);
814 extern	char*	get9root(void);
815 extern	char*	unsharp(char*);
816 extern	int	sendfd(int, int);
817 extern	int	recvfd(int);
818 extern	int	post9pservice(int, char*);
819 
820 /* external names that we don't want to step on */
821 #ifndef NOPLAN9DEFINES
822 #define main	p9main
823 #endif
824 
825 /* compiler directives on plan 9 */
826 #define	SET(x)	((x)=0)
827 #define	USED(x)	if(x){}else{}
828 #ifdef __GNUC__
829 #	if __GNUC__ >= 3
830 #		undef USED
831 #		define USED(x) { ulong __y __attribute__ ((unused)); __y = (ulong)(x); }
832 #	endif
833 #endif
834 
835 /* command line */
836 extern char	*argv0;
837 extern void __fixargv0(void);
838 #define	ARGBEGIN	for((argv0?0:(argv0=(__fixargv0(),*argv))),argv++,argc--;\
839 			    argv[0] && argv[0][0]=='-' && argv[0][1];\
840 			    argc--, argv++) {\
841 				char *_args, *_argt;\
842 				Rune _argc;\
843 				_args = &argv[0][1];\
844 				if(_args[0]=='-' && _args[1]==0){\
845 					argc--; argv++; break;\
846 				}\
847 				_argc = 0;\
848 				while(*_args && (_args += chartorune(&_argc, _args)))\
849 				switch(_argc)
850 #define	ARGEND		SET(_argt);USED(_argt);USED(_argc);USED(_args);}USED(argv);USED(argc);
851 #define	ARGF()		(_argt=_args, _args="",\
852 				(*_argt? _argt: argv[1]? (argc--, *++argv): 0))
853 #define	EARGF(x)	(_argt=_args, _args="",\
854 				(*_argt? _argt: argv[1]? (argc--, *++argv): ((x), abort(), (char*)0)))
855 
856 #define	ARGC()		_argc
857 
858 #if defined(__cplusplus)
859 }
860 #endif
861 #endif	/* _LIB9_H_ */