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
238  */
239 extern	void	p9srand(long);
240 extern	int	p9rand(void);
241 
242 extern	int	p9nrand(int);
243 extern	long	p9lrand(void);
244 extern	long	p9lnrand(long);
245 extern	double	p9frand(void);
246 extern	ulong	truerand(void);			/* uses /dev/random */
247 extern	ulong	ntruerand(ulong);		/* uses /dev/random */
248 
249 #ifndef NOPLAN9DEFINES
250 #define	srand	p9srand
251 #define	rand	p9rand
252 #define	nrand	p9nrand
253 #define	lrand	p9lrand
254 #define	lnrand	p9lnrand
255 #define	frand	p9frand
256 #endif
257 
258 /*
259  * math
260  */
261 extern	ulong	getfcr(void);
262 extern	void	setfsr(ulong);
263 extern	ulong	getfsr(void);
264 extern	void	setfcr(ulong);
265 extern	double	NaN(void);
266 extern	double	Inf(int);
267 extern	int	isNaN(double);
268 extern	int	isInf(double, int);
269 extern	ulong	umuldiv(ulong, ulong, ulong);
270 extern	long	muldiv(long, long, long);
271 
272 /*
273  * provided by math.h
274  *
275 extern	double	pow(double, double);
276 extern	double	atan2(double, double);
277 extern	double	fabs(double);
278 extern	double	atan(double);
279 extern	double	log(double);
280 extern	double	log10(double);
281 extern	double	exp(double);
282 extern	double	floor(double);
283 extern	double	ceil(double);
284 extern	double	hypot(double, double);
285 extern	double	sin(double);
286 extern	double	cos(double);
287 extern	double	tan(double);
288 extern	double	asin(double);
289 extern	double	acos(double);
290 extern	double	sinh(double);
291 extern	double	cosh(double);
292 extern	double	tanh(double);
293 extern	double	sqrt(double);
294 extern	double	fmod(double, double);
295 #define	HUGE	3.4028234e38
296 #define	PIO2	1.570796326794896619231e0
297 #define	PI	(PIO2+PIO2)
298  */
299 #define PI	M_PI
300 #define	PIO2	M_PI_2
301 
302 /*
303  * Time-of-day
304  */
305 
306 typedef
307 struct Tm
308 {
309 	int	sec;
310 	int	min;
311 	int	hour;
312 	int	mday;
313 	int	mon;
314 	int	year;
315 	int	wday;
316 	int	yday;
317 	char	zone[4];
318 	int	tzoff;
319 } Tm;
320 
321 extern	Tm*	p9gmtime(long);
322 extern	Tm*	p9localtime(long);
323 extern	char*	p9asctime(Tm*);
324 extern	char*	p9ctime(long);
325 extern	double	p9cputime(void);
326 extern	long	p9times(long*);
327 extern	long	p9tm2sec(Tm*);
328 extern	vlong	p9nsec(void);
329 
330 #ifndef NOPLAN9DEFINES
331 #define	gmtime		p9gmtime
332 #define	localtime	p9localtime
333 #define	asctime		p9asctime
334 #define	ctime		p9ctime
335 #define	cputime		p9cputime
336 #define	times		p9times
337 #define	tm2sec		p9tm2sec
338 #define	nsec		p9nsec
339 #endif
340 
341 /*
342  * one-of-a-kind
343  */
344 enum
345 {
346 	PNPROC		= 1,
347 	PNGROUP		= 2,
348 };
349 
350 /* extern	int	abs(int); <stdlib.h> */
351 extern	int	p9atexit(void(*)(void));
352 extern	void	p9atexitdont(void(*)(void));
353 extern	int	atnotify(int(*)(void*, char*), int);
354 /* 
355  * <stdlib.h>
356 extern	double	atof(char*); <stdlib.h>
357  */
358 extern	int	p9atoi(char*);
359 extern	long	p9atol(char*);
360 extern	vlong	p9atoll(char*);
361 extern	double	fmtcharstod(int(*)(void*), void*);
362 extern	char*	cleanname(char*);
363 extern	int	dec64(uchar*, int, char*, int);
364 extern	int	enc64(char*, int, uchar*, int);
365 extern	int	dec32(uchar*, int, char*, int);
366 extern	int	enc32(char*, int, uchar*, int);
367 extern	int	dec16(uchar*, int, char*, int);
368 extern	int	enc16(char*, int, uchar*, int);
369 extern	int	encodefmt(Fmt*);
370 extern	int	dirmodefmt(Fmt*);
371 extern	void	exits(char*);
372 extern	double	frexp(double, int*);
373 extern	ulong	getcallerpc(void*);
374 extern	char*	p9getenv(char*);
375 extern	int	p9putenv(char*, char*);
376 extern	int	getfields(char*, char**, int, int, char*);
377 extern	int	gettokens(char *, char **, int, char *);
378 extern	char*	getuser(void);
379 extern	char*	p9getwd(char*, int);
380 extern	int	iounit(int);
381 /* extern	long	labs(long); <math.h> */
382 /* extern	double	ldexp(double, int); <math.h> */
383 extern	void	p9longjmp(p9jmp_buf, int);
384 extern	char*	mktemp(char*);
385 extern	int		opentemp(char*);
386 /* extern	double	modf(double, double*); <math.h> */
387 extern	void	p9notejmp(void*, p9jmp_buf, int);
388 extern	void	perror(const char*);
389 extern	int	postnote(int, int, char *);
390 extern	double	p9pow10(int);
391 /* extern	int	putenv(char*, char*); <stdlib.h. */
392 /* extern	void	qsort(void*, long, long, int (*)(void*, void*)); <stdlib.h> */
393 /* extern	int	p9setjmp(p9jmp_buf); */
394 #define p9setjmp(b)	sigsetjmp((void*)(b), 1)
395 /*
396  * <stdlib.h>
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	long	p9time(long*);
404 /* extern	int	tolower(int); <ctype.h> */
405 /* extern	int	toupper(int); <ctype.h> */
406 extern	void	needstack(int);
407 
408 #ifndef NOPLAN9DEFINES
409 #define atexit		p9atexit
410 #define atexitdont	p9atexitdont
411 #define atoi		p9atoi
412 #define atol		p9atol
413 #define atoll		p9atoll
414 #define encrypt		p9encrypt
415 #define decrypt		p9decrypt
416 #define getenv		p9getenv
417 #define	getwd		p9getwd
418 #define	longjmp		p9longjmp
419 #undef  setjmp
420 #define setjmp		p9setjmp
421 #define putenv		p9putenv
422 #define notejmp		p9notejmp
423 #define jmp_buf		p9jmp_buf
424 #define time		p9time
425 #define pow10		p9pow10
426 #define strtod		fmtstrtod
427 #define charstod	fmtcharstod
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	p9listen(char*, char*);
527 extern	char*	p9netmkaddr(char*, char*, char*);
528 extern	int	p9reject(int, char*, char*);
529 
530 #ifndef NOPLAN9DEFINES
531 #define	accept		p9accept
532 #define	announce	p9announce
533 #define	dial		p9dial
534 #define	setnetmtpt	p9setnetmtpt
535 #define	listen		p9listen
536 #define	netmkaddr	p9netmkaddr
537 #define	reject		p9reject
538 #endif
539 
540 /*
541  *  encryption
542  */
543 extern	int	pushssl(int, char*, char*, char*, int*);
544 extern	int	pushtls(int, char*, char*, int, char*, char*);
545 
546 /*
547  *  network services
548  */
549 typedef struct NetConnInfo NetConnInfo;
550 struct NetConnInfo
551 {
552 	char	*dir;		/* connection directory */
553 	char	*root;		/* network root */
554 	char	*spec;		/* binding spec */
555 	char	*lsys;		/* local system */
556 	char	*lserv;		/* local service */
557 	char	*rsys;		/* remote system */
558 	char	*rserv;		/* remote service */
559 };
560 extern	NetConnInfo*	getnetconninfo(char*, int);
561 extern	void		freenetconninfo(NetConnInfo*);
562 
563 /*
564  * system calls
565  *
566  */
567 #define	STATMAX	65535U	/* max length of machine-independent stat structure */
568 #define	DIRMAX	(sizeof(Dir)+STATMAX)	/* max length of Dir structure */
569 #define	ERRMAX	128	/* max length of error string */
570 
571 #define	MORDER	0x0003	/* mask for bits defining order of mounting */
572 #define	MREPL	0x0000	/* mount replaces object */
573 #define	MBEFORE	0x0001	/* mount goes before others in union directory */
574 #define	MAFTER	0x0002	/* mount goes after others in union directory */
575 #define	MCREATE	0x0004	/* permit creation in mounted directory */
576 #define	MCACHE	0x0010	/* cache some data */
577 #define	MMASK	0x0017	/* all bits on */
578 
579 #define	OREAD	0	/* open for read */
580 #define	OWRITE	1	/* write */
581 #define	ORDWR	2	/* read and write */
582 #define	OEXEC	3	/* execute, == read but check execute permission */
583 #define	OTRUNC	16	/* or'ed in (except for exec), truncate file first */
584 #define	OCEXEC	32	/* or'ed in, close on exec */
585 #define	ORCLOSE	64	/* or'ed in, remove on close */
586 #define	ODIRECT	128	/* or'ed in, direct access */
587 #define ONONBLOCK 256	/* or'ed in, non-blocking call */
588 #define	OEXCL	0x1000	/* or'ed in, exclusive use (create only) */
589 #define	OLOCK	0x2000	/* or'ed in, lock after opening */
590 
591 #define	AEXIST	0	/* accessible: exists */
592 #define	AEXEC	1	/* execute access */
593 #define	AWRITE	2	/* write access */
594 #define	AREAD	4	/* read access */
595 
596 /* Segattch */
597 #define	SG_RONLY	0040	/* read only */
598 #define	SG_CEXEC	0100	/* detach on exec */
599 
600 #define	NCONT	0	/* continue after note */
601 #define	NDFLT	1	/* terminate after note */
602 #define	NSAVE	2	/* clear note but hold state */
603 #define	NRSTR	3	/* restore saved state */
604 
605 /* bits in Qid.type */
606 #define QTDIR		0x80		/* type bit for directories */
607 #define QTAPPEND	0x40		/* type bit for append only files */
608 #define QTEXCL		0x20		/* type bit for exclusive use files */
609 #define QTMOUNT		0x10		/* type bit for mounted channel */
610 #define QTAUTH		0x08		/* type bit for authentication file */
611 #define QTLINK		0x04		/* symbolic link */
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 DMLINK		0x04000000	/* mode bit for symbolic link */
621 #define DMREAD		0x4		/* mode bit for read permission */
622 #define DMWRITE		0x2		/* mode bit for write permission */
623 #define DMEXEC		0x1		/* mode bit for execute permission */
624 
625 #if defined(__FreeBSD__)
626 #undef RFFDG
627 #undef RFNOTEG
628 #undef RFPROC
629 #undef RFMEM
630 #undef RFNOWAIT
631 #undef RFCFDG
632 #undef RFNAMEG
633 #undef RFENVG
634 #undef RFCENVG
635 #undef RFCFDG
636 #undef RFCNAMEG
637 #endif
638 
639 enum
640 {
641 	RFNAMEG		= (1<<0), 
642 	RFENVG		= (1<<1), 
643 	RFFDG		= (1<<2),
644 	RFNOTEG		= (1<<3),
645 	RFPROC		= (1<<4),
646 	RFMEM		= (1<<5),
647 	RFNOWAIT	= (1<<6),
648 	RFCNAMEG	= (1<<10), 
649 	RFCENVG		= (1<<11), 
650 	RFCFDG		= (1<<12),
651 /*	RFREND		= (1<<13), */
652 /*	RFNOMNT		= (1<<14) */
653 };
654 
655 typedef
656 struct Qid
657 {
658 	uvlong	path;
659 	ulong	vers;
660 	uchar	type;
661 } Qid;
662 
663 typedef
664 struct Dir {
665 	/* system-modified data */
666 	ushort	type;	/* server type */
667 	uint	dev;	/* server subtype */
668 	/* file data */
669 	Qid	qid;	/* unique id from server */
670 	ulong	mode;	/* permissions */
671 	ulong	atime;	/* last read time */
672 	ulong	mtime;	/* last write time */
673 	vlong	length;	/* file length */
674 	char	*name;	/* last element of path */
675 	char	*uid;	/* owner name */
676 	char	*gid;	/* group name */
677 	char	*muid;	/* last modifier name */
678 } Dir;
679 
680 /* keep /sys/src/ape/lib/ap/plan9/sys9.h in sync with this -rsc */
681 typedef
682 struct Waitmsg
683 {
684 	int pid;	/* of loved one */
685 	ulong time[3];	/* of loved one & descendants */
686 	char	*msg;
687 } Waitmsg;
688 
689 typedef
690 struct IOchunk
691 {
692 	void	*addr;
693 	ulong	len;
694 } IOchunk;
695 
696 extern	void	_exits(char*);
697 
698 extern	void	abort(void);
699 /* extern	int	access(char*, int); */
700 extern	long	p9alarm(ulong);
701 extern	int	await(char*, int);
702 extern	int	awaitfor(int, char*, int);
703 extern	int	awaitnohang(char*, int);
704 /* extern	int	bind(char*, char*, int); give up */
705 /* extern	int	brk(void*); <unistd.h> */
706 extern	int	p9chdir(char*);
707 extern	int	close(int);
708 extern	int	p9create(char*, int, ulong);
709 extern	int	p9dup(int, int);
710 extern	int	errstr(char*, uint);
711 extern	int	p9exec(char*, char*[]);
712 extern	int	p9execl(char*, ...);
713 /* extern	int	p9fork(void); */
714 extern	int	p9rfork(int);
715 /* not implemented 
716 extern	int	fauth(int, char*);
717 extern	int	fstat(int, uchar*, int);
718 extern	int	fwstat(int, uchar*, int);
719 extern	int	fversion(int, int, char*, int);
720 extern	int	mount(int, int, char*, int, char*);
721 extern	int	unmount(char*, char*);
722 */
723 extern	int	noted(int);
724 extern	int	notify(void(*)(void*, char*));
725 extern	void	noteenable(char*);
726 extern	void	notedisable(char*);
727 extern	void	notifyon(char*);
728 extern	void	notifyoff(char*);
729 extern	int	p9open(char*, int);
730 extern	int	fd2path(int, char*, int);
731 extern	int	p9pipe(int*);
732 /* 
733  * use defs from <unistd.h>
734 extern	long	pread(int, void*, long, vlong);
735 extern	long	preadv(int, IOchunk*, int, vlong);
736 extern	long	pwrite(int, void*, long, vlong);
737 extern	long	pwritev(int, IOchunk*, int, vlong);
738 extern	long	read(int, void*, long);
739  */
740 extern	long	readn(int, void*, long);
741 /* extern	long	readv(int, IOchunk*, int); <unistd.h> */
742 extern	int	remove(const char*);
743 /* extern	void*	sbrk(ulong); <unistd.h> */
744 /* extern	long	oseek(int, long, int); */
745 extern	vlong	p9seek(int, vlong, int);
746 /* give up
747 extern	long	segattach(int, char*, void*, ulong);
748 extern	int	segbrk(void*, void*);
749 extern	int	segdetach(void*);
750 extern	int	segflush(void*, ulong);
751 extern	int	segfree(void*, ulong);
752 */
753 extern	int	p9sleep(long);
754 /* extern	int	stat(char*, uchar*, int); give up */
755 extern	Waitmsg*	p9wait(void);
756 extern	Waitmsg*	p9waitfor(int);
757 extern	Waitmsg*	waitnohang(void);
758 extern	int	p9waitpid(void);
759 /* <unistd.h>
760 extern	long	write(int, void*, long);
761 extern	long	writev(int, IOchunk*, int);
762 */
763 /* extern	int	wstat(char*, uchar*, int); give up */
764 extern	ulong	rendezvous(ulong, ulong);
765 
766 #ifndef NOPLAN9DEFINES
767 #define alarm		p9alarm
768 #define	dup		p9dup
769 #define	exec		p9exec
770 #define	execl	p9execl
771 #define	seek		p9seek
772 #define sleep		p9sleep
773 #define wait		p9wait
774 #define waitpid		p9waitpid
775 /* #define fork		p9fork */
776 #define rfork		p9rfork
777 /* #define access		p9access */
778 #define create		p9create
779 #undef open
780 #define open		p9open
781 #define pipe		p9pipe
782 #define	waitfor		p9waitfor
783 #endif
784 
785 extern	Dir*	dirstat(char*);
786 extern	Dir*	dirfstat(int);
787 extern	int	dirwstat(char*, Dir*);
788 extern	int	dirfwstat(int, Dir*);
789 extern	long	dirread(int, Dir**);
790 extern	void	nulldir(Dir*);
791 extern	long	dirreadall(int, Dir**);
792 /* extern	int	getpid(void); <unistd.h> */
793 /* extern	int	getppid(void); */
794 extern	void	rerrstr(char*, uint);
795 extern	char*	sysname(void);
796 extern	void	werrstr(char*, ...);
797 extern	char*	getns(void);
798 extern	char*	get9root(void);
799 extern	char*	unsharp(char*);
800 extern	int	sendfd(int, int);
801 extern	int	recvfd(int);
802 extern	int	post9pservice(int, char*);
803 
804 /* external names that we don't want to step on */
805 #ifndef NOPLAN9DEFINES
806 #define main	p9main
807 #endif
808 
809 /* compiler directives on plan 9 */
810 #define	SET(x)	((x)=0)
811 #define	USED(x)	if(x){}else{}
812 #ifdef __GNUC__
813 #	if __GNUC__ >= 3
814 #		undef USED
815 #		define USED(x) { ulong __y __attribute__ ((unused)); __y = (ulong)(x); }
816 #	endif
817 #endif
818 
819 /* command line */
820 extern char	*argv0;
821 extern void __fixargv0(void);
822 #define	ARGBEGIN	for((argv0?0:(argv0=(__fixargv0(),*argv))),argv++,argc--;\
823 			    argv[0] && argv[0][0]=='-' && argv[0][1];\
824 			    argc--, argv++) {\
825 				char *_args, *_argt;\
826 				Rune _argc;\
827 				_args = &argv[0][1];\
828 				if(_args[0]=='-' && _args[1]==0){\
829 					argc--; argv++; break;\
830 				}\
831 				_argc = 0;\
832 				while(*_args && (_args += chartorune(&_argc, _args)))\
833 				switch(_argc)
834 #define	ARGEND		SET(_argt);USED(_argt);USED(_argc);USED(_args);}USED(argv);USED(argc);
835 #define	ARGF()		(_argt=_args, _args="",\
836 				(*_argt? _argt: argv[1]? (argc--, *++argv): 0))
837 #define	EARGF(x)	(_argt=_args, _args="",\
838 				(*_argt? _argt: argv[1]? (argc--, *++argv): ((x), abort(), (char*)0)))
839 
840 #define	ARGC()		_argc
841 
842 #if defined(__cplusplus)
843 }
844 #endif
845 #endif	/* _LIB9_H_ */