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
8 #if defined(__cplusplus)
16 #define nil ((void*)0)
17 #define nelem(x) (sizeof(x)/sizeof((x)[0]))
20 #define offsetof(s, m) (ulong)(&(((s*)0)->m))
24 * mem routines (provided by system <string.h>)
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);
35 * string routines (provided by system <string.h>)
37 extern char* strcat(char*, char*);
38 extern char* strchr(char*, int);
39 extern int strcmp(char*, char*);
40 extern char* strcpy(char*, char*);
42 extern char* strecpy(char*, char*, char*);
43 extern char* p9strdup(char*);
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*);
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);
72 * rune routines (provided by <utf.h>
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*);
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*);
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);
110 * malloc (provied by system <stdlib.h>)
112 extern void* malloc(ulong);
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*);
124 extern void* malloctopoolblock(void*);
126 #ifndef NOPLAN9DEFINES
127 #define malloc p9malloc
128 #define realloc p9realloc
129 #define calloc p9calloc
132 #define strdup p9strdup
136 * print routines (provided by <fmt.h>)
138 typedef struct Fmt Fmt;
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,
169 FmtFlag = FmtByte << 1
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);
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);
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*);
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*);
209 * error string for %r
210 * supplied on per os basis, not part of fmt library
212 * (provided by lib9, but declared in fmt.h)
214 extern int errfmt(Fmt *f);
220 extern char *unquotestrdup(char*);
221 extern Rune *unquoterunestrdup(Rune*);
222 extern char *quotestrdup(char*);
223 extern Rune *quoterunestrdup(Rune*);
227 extern void quotefmtinstall(void);
228 extern int quotestrfmt(Fmt*);
229 extern int quoterunestrfmt(Fmt*);
231 #ifndef NOPLAN9DEFINES
232 #define doquote fmtdoquote
234 extern int needsrcquote(int);
239 extern void p9srand(long);
240 extern int p9rand(void);
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 */
249 #ifndef NOPLAN9DEFINES
250 #define srand p9srand
252 #define nrand p9nrand
253 #define lrand p9lrand
254 #define lnrand p9lnrand
255 #define frand p9frand
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);
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)
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);
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
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);
356 extern double atof(char*); <stdlib.h>
358 extern int p9atoi(char*);
359 extern long p9atol(char*);
360 extern vlong p9atoll(char*);
361 extern double charstod(int(*)(void*), void*);
362 extern char* cleanname(char*);
363 extern int p9decrypt(void*, void*, int);
364 extern int p9encrypt(void*, void*, int);
365 extern int dec64(uchar*, int, char*, int);
366 extern int enc64(char*, int, uchar*, int);
367 extern int dec32(uchar*, int, char*, int);
368 extern int enc32(char*, int, uchar*, int);
369 extern int dec16(uchar*, int, char*, int);
370 extern int enc16(char*, int, uchar*, int);
371 extern int encodefmt(Fmt*);
372 extern int dirmodefmt(Fmt*);
373 extern void exits(char*);
374 extern double frexp(double, int*);
375 extern ulong getcallerpc(void*);
376 extern char* p9getenv(char*);
377 extern int p9putenv(char*, char*);
378 extern int getfields(char*, char**, int, int, char*);
379 extern int gettokens(char *, char **, int, char *);
380 extern char* getuser(void);
381 extern char* p9getwd(char*, int);
382 extern int iounit(int);
383 /* extern long labs(long); <math.h> */
384 /* extern double ldexp(double, int); <math.h> */
385 extern void p9longjmp(p9jmp_buf, int);
386 extern char* mktemp(char*);
387 extern int opentemp(char*);
388 /* extern double modf(double, double*); <math.h> */
389 extern int netcrypt(void*, void*);
390 extern void p9notejmp(void*, p9jmp_buf, int);
391 extern void perror(const char*);
392 extern int postnote(int, int, char *);
393 extern double p9pow10(int);
394 /* extern int putenv(char*, char*); <stdlib.h. */
395 /* extern void qsort(void*, long, long, int (*)(void*, void*)); <stdlib.h> */
396 /* extern int p9setjmp(p9jmp_buf); */
397 #define p9setjmp(b) sigsetjmp((void*)(b), 1)
400 extern double strtod(char*, char**);
401 extern long strtol(char*, char**, int);
402 extern ulong strtoul(char*, char**, int);
403 extern vlong strtoll(char*, char**, int);
404 extern uvlong strtoull(char*, char**, int);
406 extern void sysfatal(char*, ...);
407 extern void p9syslog(int, char*, char*, ...);
408 extern long p9time(long*);
409 /* extern int tolower(int); <ctype.h> */
410 /* extern int toupper(int); <ctype.h> */
411 extern void needstack(int);
413 #ifndef NOPLAN9DEFINES
414 #define atexit p9atexit
415 #define atexitdont p9atexitdont
418 #define atoll p9atoll
419 #define encrypt p9encrypt
420 #define decrypt p9decrypt
421 #define getenv p9getenv
422 #define getwd p9getwd
423 #define longjmp p9longjmp
425 #define setjmp p9setjmp
426 #define putenv p9putenv
427 #define notejmp p9notejmp
428 #define jmp_buf p9jmp_buf
429 #define syslog p9syslog
431 #define pow10 p9pow10
435 * just enough information so that libc can be
436 * properly locked without dragging in all of libthread
438 typedef struct _Thread _Thread;
439 typedef struct _Threadlist _Threadlist;
446 extern _Thread *(*threadnow)(void);
451 typedef struct Lock Lock;
454 #ifdef PLAN9PORT_USING_PTHREADS
456 pthread_mutex_t mutex;
461 extern void lock(Lock*);
462 extern void unlock(Lock*);
463 extern int canlock(Lock*);
464 extern int (*_lock)(Lock*, int, ulong);
465 extern void (*_unlock)(Lock*, ulong);
467 typedef struct QLock QLock;
475 extern void qlock(QLock*);
476 extern void qunlock(QLock*);
477 extern int canqlock(QLock*);
478 extern int (*_qlock)(QLock*, int, ulong); /* do not use */
479 extern void (*_qunlock)(QLock*, ulong);
481 typedef struct Rendez Rendez;
488 extern void rsleep(Rendez*); /* unlocks r->l, sleeps, locks r->l again */
489 extern int rwakeup(Rendez*);
490 extern int rwakeupall(Rendez*);
491 extern void (*_rsleep)(Rendez*, ulong); /* do not use */
492 extern int (*_rwakeup)(Rendez*, int, ulong);
494 typedef struct RWLock RWLock;
500 _Threadlist rwaiting;
501 _Threadlist wwaiting;
504 extern void rlock(RWLock*);
505 extern void runlock(RWLock*);
506 extern int canrlock(RWLock*);
507 extern void wlock(RWLock*);
508 extern void wunlock(RWLock*);
509 extern int canwlock(RWLock*);
510 extern int (*_rlock)(RWLock*, int, ulong); /* do not use */
511 extern int (*_wlock)(RWLock*, int, ulong);
512 extern void (*_runlock)(RWLock*, ulong);
513 extern void (*_wunlock)(RWLock*, ulong);
516 * per-process private data
518 extern void** privalloc(void);
519 extern void privfree(void**);
524 #define NETPATHLEN 40
525 extern int p9accept(int, char*);
526 extern int p9announce(char*, char*);
527 extern int p9dial(char*, char*, char*, int*);
528 extern int p9dialparse(char *ds, char **net, char **unixa, u32int *ip, int *port);
529 extern void p9setnetmtpt(char*, int, char*);
530 extern int p9hangup(int);
531 extern int p9listen(char*, char*);
532 extern char* p9netmkaddr(char*, char*, char*);
533 extern int p9reject(int, char*, char*);
535 #ifndef NOPLAN9DEFINES
536 #define accept p9accept
537 #define announce p9announce
539 #define setnetmtpt p9setnetmtpt
540 #define hangup p9hangup
541 #define listen p9listen
542 #define netmkaddr p9netmkaddr
543 #define reject p9reject
549 extern int pushssl(int, char*, char*, char*, int*);
550 extern int pushtls(int, char*, char*, int, char*, char*);
555 typedef struct NetConnInfo NetConnInfo;
558 char *dir; /* connection directory */
559 char *root; /* network root */
560 char *spec; /* binding spec */
561 char *lsys; /* local system */
562 char *lserv; /* local service */
563 char *rsys; /* remote system */
564 char *rserv; /* remote service */
566 extern NetConnInfo* getnetconninfo(char*, int);
567 extern void freenetconninfo(NetConnInfo*);
573 #define STATMAX 65535U /* max length of machine-independent stat structure */
574 #define DIRMAX (sizeof(Dir)+STATMAX) /* max length of Dir structure */
575 #define ERRMAX 128 /* max length of error string */
577 #define MORDER 0x0003 /* mask for bits defining order of mounting */
578 #define MREPL 0x0000 /* mount replaces object */
579 #define MBEFORE 0x0001 /* mount goes before others in union directory */
580 #define MAFTER 0x0002 /* mount goes after others in union directory */
581 #define MCREATE 0x0004 /* permit creation in mounted directory */
582 #define MCACHE 0x0010 /* cache some data */
583 #define MMASK 0x0017 /* all bits on */
585 #define OREAD 0 /* open for read */
586 #define OWRITE 1 /* write */
587 #define ORDWR 2 /* read and write */
588 #define OEXEC 3 /* execute, == read but check execute permission */
589 #define OTRUNC 16 /* or'ed in (except for exec), truncate file first */
590 #define OCEXEC 32 /* or'ed in, close on exec */
591 #define ORCLOSE 64 /* or'ed in, remove on close */
592 #define ODIRECT 128 /* or'ed in, direct access */
593 #define ONONBLOCK 256 /* or'ed in, non-blocking call */
594 #define OEXCL 0x1000 /* or'ed in, exclusive use (create only) */
595 #define OLOCK 0x2000 /* or'ed in, lock after opening */
597 #define AEXIST 0 /* accessible: exists */
598 #define AEXEC 1 /* execute access */
599 #define AWRITE 2 /* write access */
600 #define AREAD 4 /* read access */
603 #define SG_RONLY 0040 /* read only */
604 #define SG_CEXEC 0100 /* detach on exec */
606 #define NCONT 0 /* continue after note */
607 #define NDFLT 1 /* terminate after note */
608 #define NSAVE 2 /* clear note but hold state */
609 #define NRSTR 3 /* restore saved state */
611 /* bits in Qid.type */
612 #define QTDIR 0x80 /* type bit for directories */
613 #define QTAPPEND 0x40 /* type bit for append only files */
614 #define QTEXCL 0x20 /* type bit for exclusive use files */
615 #define QTMOUNT 0x10 /* type bit for mounted channel */
616 #define QTAUTH 0x08 /* type bit for authentication file */
617 #define QTFILE 0x00 /* plain file */
619 /* bits in Dir.mode */
620 #define DMDIR 0x80000000 /* mode bit for directories */
621 #define DMAPPEND 0x40000000 /* mode bit for append only files */
622 #define DMEXCL 0x20000000 /* mode bit for exclusive use files */
623 #define DMMOUNT 0x10000000 /* mode bit for mounted channel */
624 #define DMAUTH 0x08000000 /* mode bit for authentication file */
625 #define DMREAD 0x4 /* mode bit for read permission */
626 #define DMWRITE 0x2 /* mode bit for write permission */
627 #define DMEXEC 0x1 /* mode bit for execute permission */
629 #if defined(__FreeBSD__)
655 /* RFREND = (1<<13), */
656 /* RFNOMNT = (1<<14) */
669 /* system-modified data */
670 ushort type; /* server type */
671 uint dev; /* server subtype */
673 Qid qid; /* unique id from server */
674 ulong mode; /* permissions */
675 ulong atime; /* last read time */
676 ulong mtime; /* last write time */
677 vlong length; /* file length */
678 char *name; /* last element of path */
679 char *uid; /* owner name */
680 char *gid; /* group name */
681 char *muid; /* last modifier name */
684 /* keep /sys/src/ape/lib/ap/plan9/sys9.h in sync with this -rsc */
688 int pid; /* of loved one */
689 ulong time[3]; /* of loved one & descendants */
700 extern void _exits(char*);
702 extern void abort(void);
703 /* extern int access(char*, int); */
704 extern long p9alarm(ulong);
705 extern int await(char*, int);
706 extern int awaitfor(int, char*, int);
707 extern int awaitnohang(char*, int);
708 /* extern int bind(char*, char*, int); give up */
709 /* extern int brk(void*); <unistd.h> */
710 extern int p9chdir(char*);
711 extern int close(int);
712 extern int p9create(char*, int, ulong);
713 extern int p9dup(int, int);
714 extern int errstr(char*, uint);
715 extern int p9exec(char*, char*[]);
716 extern int p9execl(char*, ...);
717 /* extern int p9fork(void); */
718 extern int p9rfork(int);
720 extern int fauth(int, char*);
721 extern int fstat(int, uchar*, int);
722 extern int fwstat(int, uchar*, int);
723 extern int fversion(int, int, char*, int);
724 extern int mount(int, int, char*, int, char*);
725 extern int unmount(char*, char*);
727 extern int noted(int);
728 extern int notify(void(*)(void*, char*));
729 extern void noteenable(char*);
730 extern void notedisable(char*);
731 extern void notifyon(char*);
732 extern void notifyoff(char*);
733 extern int p9open(char*, int);
734 extern int fd2path(int, char*, int);
735 extern int p9pipe(int*);
737 * use defs from <unistd.h>
738 extern long pread(int, void*, long, vlong);
739 extern long preadv(int, IOchunk*, int, vlong);
740 extern long pwrite(int, void*, long, vlong);
741 extern long pwritev(int, IOchunk*, int, vlong);
742 extern long read(int, void*, long);
744 extern long readn(int, void*, long);
745 /* extern long readv(int, IOchunk*, int); <unistd.h> */
746 extern int remove(const char*);
747 /* extern void* sbrk(ulong); <unistd.h> */
748 /* extern long oseek(int, long, int); */
749 extern vlong p9seek(int, vlong, int);
751 extern long segattach(int, char*, void*, ulong);
752 extern int segbrk(void*, void*);
753 extern int segdetach(void*);
754 extern int segflush(void*, ulong);
755 extern int segfree(void*, ulong);
757 extern int p9sleep(long);
758 /* extern int stat(char*, uchar*, int); give up */
759 extern Waitmsg* p9wait(void);
760 extern Waitmsg* p9waitfor(int);
761 extern Waitmsg* waitnohang(void);
762 extern int p9waitpid(void);
764 extern long write(int, void*, long);
765 extern long writev(int, IOchunk*, int);
767 /* extern int wstat(char*, uchar*, int); give up */
768 extern ulong rendezvous(ulong, ulong);
770 #ifndef NOPLAN9DEFINES
771 #define alarm p9alarm
774 #define execl p9execl
776 #define sleep p9sleep
778 #define waitpid p9waitpid
779 /* #define fork p9fork */
780 #define rfork p9rfork
781 /* #define access p9access */
782 #define create p9create
786 #define waitfor p9waitfor
789 extern Dir* dirstat(char*);
790 extern Dir* dirfstat(int);
791 extern int dirwstat(char*, Dir*);
792 extern int dirfwstat(int, Dir*);
793 extern long dirread(int, Dir**);
794 extern void nulldir(Dir*);
795 extern long dirreadall(int, Dir**);
796 /* extern int getpid(void); <unistd.h> */
797 /* extern int getppid(void); */
798 extern void rerrstr(char*, uint);
799 extern char* sysname(void);
800 extern void werrstr(char*, ...);
801 extern char* getns(void);
802 extern char* get9root(void);
803 extern char* unsharp(char*);
804 extern int sendfd(int, int);
805 extern int recvfd(int);
806 extern int post9pservice(int, char*);
808 /* external names that we don't want to step on */
809 #ifndef NOPLAN9DEFINES
813 /* compiler directives on plan 9 */
814 #define SET(x) ((x)=0)
815 #define USED(x) if(x){}else{}
819 # define USED(x) { ulong __y __attribute__ ((unused)); __y = (ulong)(x); }
825 extern void __fixargv0(void);
826 #define ARGBEGIN for((argv0?0:(argv0=(__fixargv0(),*argv))),argv++,argc--;\
827 argv[0] && argv[0][0]=='-' && argv[0][1];\
829 char *_args, *_argt;\
831 _args = &argv[0][1];\
832 if(_args[0]=='-' && _args[1]==0){\
833 argc--; argv++; break;\
836 while(*_args && (_args += chartorune(&_argc, _args)))\
838 #define ARGEND SET(_argt);USED(_argt);USED(_argc);USED(_args);}USED(argv);USED(argc);
839 #define ARGF() (_argt=_args, _args="",\
840 (*_argt? _argt: argv[1]? (argc--, *++argv): 0))
841 #define EARGF(x) (_argt=_args, _args="",\
842 (*_argt? _argt: argv[1]? (argc--, *++argv): ((x), abort(), (char*)0)))
846 #if defined(__cplusplus)
849 #endif /* _LIB9_H_ */