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