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
9 #if defined(__cplusplus)
14 #define _SVID_SOURCE 1
15 #define _XOPEN_SOURCE 1000
16 #define _XOPEN_SOURCE_EXTENDED 1
17 #define _LARGEFILE64_SOURCE 1
18 #define _FILE_OFFSET_BITS 64
40 /* better to assume we have these and then be proved wrong */
44 #define _HAVETMTZOFF 1
45 #define _HAVEFUTIMESAT 1
46 #define _HAVEFUTIMES 1
47 #define _HAVEGETDENTS 1
48 #define _HAVEGETDIRENTRIES 1
50 typedef long p9jmp_buf[sizeof(sigjmp_buf)/sizeof(long)];
52 #if defined(__linux__)
53 # include <sys/types.h>
54 # if defined(__USE_MISC)
62 # undef _HAVEFUTIMESAT
66 # include <sys/types.h>
77 #if defined(__FreeBSD__)
78 # include <sys/types.h>
79 # if !defined(_POSIX_SOURCE)
83 # define _HAVEDISKLABEL 1
85 #if defined(__APPLE__)
86 # include <sys/types.h>
91 typedef signed char schar;
92 typedef unsigned int u32int;
94 typedef unsigned char uchar;
97 typedef unsigned short ushort;
100 typedef unsigned int uint;
103 typedef unsigned long ulong;
105 typedef unsigned long long uvlong;
106 typedef long long vlong;
107 typedef uvlong u64int;
109 typedef ushort u16int;
115 #define nil ((void*)0)
116 #define nelem(x) (sizeof(x)/sizeof((x)[0]))
119 #define offsetof(s, m) (ulong)(&(((s*)0)->m))
123 * mem routines (provided by system <string.h>)
125 extern void* memccpy(void*, void*, int, ulong);
126 extern void* memset(void*, int, ulong);
127 extern int memcmp(void*, void*, ulong);
128 extern void* memcpy(void*, void*, ulong);
129 extern void* memmove(void*, void*, ulong);
130 extern void* memchr(void*, int, ulong);
134 * string routines (provided by system <string.h>)
136 extern char* strcat(char*, char*);
137 extern char* strchr(char*, int);
138 extern int strcmp(char*, char*);
139 extern char* strcpy(char*, char*);
141 extern char* strecpy(char*, char*, char*);
143 extern char* strdup(char*);
144 extern char* strncat(char*, char*, long);
145 extern char* strncpy(char*, char*, long);
146 extern int strncmp(char*, char*, long);
147 extern char* strpbrk(char*, char*);
148 extern char* strrchr(char*, int);
149 extern char* strtok(char*, char*);
150 extern long strlen(char*);
151 extern long strspn(char*, char*);
152 extern long strcspn(char*, char*);
153 extern char* strstr(char*, char*);
155 extern int cistrncmp(char*, char*, int);
156 extern int cistrcmp(char*, char*);
157 extern char* cistrstr(char*, char*);
158 extern int tokenize(char*, char**, int);
171 * rune routines (provided by <utf.h>
173 extern int runetochar(char*, Rune*);
174 extern int chartorune(Rune*, char*);
175 extern int runelen(long);
176 extern int runenlen(Rune*, int);
177 extern int fullrune(char*, int);
178 extern int utflen(char*);
179 extern int utfnlen(char*, long);
180 extern char* utfrune(char*, long);
181 extern char* utfrrune(char*, long);
182 extern char* utfutf(char*, char*);
183 extern char* utfecpy(char*, char*, char*);
185 extern Rune* runestrcat(Rune*, Rune*);
186 extern Rune* runestrchr(Rune*, Rune);
187 extern int runestrcmp(Rune*, Rune*);
188 extern Rune* runestrcpy(Rune*, Rune*);
189 extern Rune* runestrncpy(Rune*, Rune*, long);
190 extern Rune* runestrecpy(Rune*, Rune*, Rune*);
191 extern Rune* runestrdup(Rune*);
192 extern Rune* runestrncat(Rune*, Rune*, long);
193 extern int runestrncmp(Rune*, Rune*, long);
194 extern Rune* runestrrchr(Rune*, Rune);
195 extern long runestrlen(Rune*);
196 extern Rune* runestrstr(Rune*, Rune*);
198 extern Rune tolowerrune(Rune);
199 extern Rune totitlerune(Rune);
200 extern Rune toupperrune(Rune);
201 extern int isalpharune(Rune);
202 extern int islowerrune(Rune);
203 extern int isspacerune(Rune);
204 extern int istitlerune(Rune);
205 extern int isupperrune(Rune);
209 * malloc (provied by system <stdlib.h>)
211 extern void* malloc(ulong);
213 extern void* mallocz(ulong, int);
215 extern void free(void*);
216 extern ulong msize(void*);
217 extern void* calloc(ulong, ulong);
218 extern void* realloc(void*, ulong);
220 extern void setmalloctag(void*, ulong);
221 extern void setrealloctag(void*, ulong);
222 extern ulong getmalloctag(void*);
223 extern ulong getrealloctag(void*);
225 extern void* malloctopoolblock(void*);
229 * print routines (provided by <fmt.h>)
231 typedef struct Fmt Fmt;
249 FmtLeft = FmtWidth << 1,
250 FmtPrec = FmtLeft << 1,
251 FmtSharp = FmtPrec << 1,
252 FmtSpace = FmtSharp << 1,
253 FmtSign = FmtSpace << 1,
254 FmtZero = FmtSign << 1,
255 FmtUnsigned = FmtZero << 1,
256 FmtShort = FmtUnsigned << 1,
257 FmtLong = FmtShort << 1,
258 FmtVLong = FmtLong << 1,
259 FmtComma = FmtVLong << 1,
260 FmtByte = FmtComma << 1,
262 FmtFlag = FmtByte << 1
265 extern int print(char*, ...);
266 extern char* seprint(char*, char*, char*, ...);
267 extern char* vseprint(char*, char*, char*, va_list);
268 extern int snprint(char*, int, char*, ...);
269 extern int vsnprint(char*, int, char*, va_list);
270 extern char* smprint(char*, ...);
271 extern char* vsmprint(char*, va_list);
272 extern int sprint(char*, char*, ...);
273 extern int fprint(int, char*, ...);
274 extern int vfprint(int, char*, va_list);
276 extern int runesprint(Rune*, char*, ...);
277 extern int runesnprint(Rune*, int, char*, ...);
278 extern int runevsnprint(Rune*, int, char*, va_list);
279 extern Rune* runeseprint(Rune*, Rune*, char*, ...);
280 extern Rune* runevseprint(Rune*, Rune*, char*, va_list);
281 extern Rune* runesmprint(char*, ...);
282 extern Rune* runevsmprint(char*, va_list);
284 extern int fmtfdinit(Fmt*, int, char*, int);
285 extern int fmtfdflush(Fmt*);
286 extern int fmtstrinit(Fmt*);
287 extern char* fmtstrflush(Fmt*);
288 extern int runefmtstrinit(Fmt*);
289 extern Rune* runefmtstrflush(Fmt*);
291 extern int fmtinstall(int, int (*)(Fmt*));
292 extern int dofmt(Fmt*, char*);
293 extern int dorfmt(Fmt*, Rune*);
294 extern int fmtprint(Fmt*, char*, ...);
295 extern int fmtvprint(Fmt*, char*, va_list);
296 extern int fmtrune(Fmt*, int);
297 extern int fmtstrcpy(Fmt*, char*);
298 extern int fmtrunestrcpy(Fmt*, Rune*);
302 * error string for %r
303 * supplied on per os basis, not part of fmt library
305 * (provided by lib9, but declared in fmt.h)
307 extern int errfmt(Fmt *f);
313 extern char *unquotestrdup(char*);
314 extern Rune *unquoterunestrdup(Rune*);
315 extern char *quotestrdup(char*);
316 extern Rune *quoterunestrdup(Rune*);
320 extern void quotefmtinstall(void);
321 extern int quotestrfmt(Fmt*);
322 extern int quoterunestrfmt(Fmt*);
324 #ifndef NOPLAN9DEFINES
325 #define doquote fmtdoquote
327 extern int needsrcquote(int);
330 * random number (in <stdlib.h>)
332 extern void srand(long);
333 extern int rand(void);
335 extern int nrand(int);
336 extern long lrand(void);
337 extern long lnrand(long);
338 extern double frand(void);
339 extern ulong truerand(void); /* uses /dev/random */
340 extern ulong ntruerand(ulong); /* uses /dev/random */
345 extern ulong getfcr(void);
346 extern void setfsr(ulong);
347 extern ulong getfsr(void);
348 extern void setfcr(ulong);
349 extern double NaN(void);
350 extern double Inf(int);
351 extern int isNaN(double);
352 extern int isInf(double, int);
353 extern ulong umuldiv(ulong, ulong, ulong);
354 extern long muldiv(long, long, long);
359 extern double pow(double, double);
360 extern double atan2(double, double);
361 extern double fabs(double);
362 extern double atan(double);
363 extern double log(double);
364 extern double log10(double);
365 extern double exp(double);
366 extern double floor(double);
367 extern double ceil(double);
368 extern double hypot(double, double);
369 extern double sin(double);
370 extern double cos(double);
371 extern double tan(double);
372 extern double asin(double);
373 extern double acos(double);
374 extern double sinh(double);
375 extern double cosh(double);
376 extern double tanh(double);
377 extern double sqrt(double);
378 extern double fmod(double, double);
379 #define HUGE 3.4028234e38
380 #define PIO2 1.570796326794896619231e0
381 #define PI (PIO2+PIO2)
405 extern Tm* p9gmtime(long);
406 extern Tm* p9localtime(long);
407 extern char* p9asctime(Tm*);
408 extern char* p9ctime(long);
409 extern double p9cputime(void);
410 extern long p9times(long*);
411 extern long p9tm2sec(Tm*);
412 extern vlong p9nsec(void);
414 #ifndef NOPLAN9DEFINES
415 #define gmtime p9gmtime
416 #define localtime p9localtime
417 #define asctime p9asctime
418 #define ctime p9ctime
419 #define cputime p9cputime
420 #define times p9times
421 #define tm2sec p9tm2sec
434 /* extern int abs(int); <stdlib.h> */
435 extern int atexit(void(*)(void));
436 extern void atexitdont(void(*)(void));
437 extern int atnotify(int(*)(void*, char*), int);
440 extern double atof(char*); <stdlib.h>
441 extern int atoi(char*);
442 extern long atol(char*);
444 extern vlong atoll(const char*);
445 extern double charstod(int(*)(void*), void*);
446 extern char* cleanname(char*);
447 extern int p9decrypt(void*, void*, int);
448 extern int p9encrypt(void*, void*, int);
449 extern int dec64(uchar*, int, char*, int);
450 extern int enc64(char*, int, uchar*, int);
451 extern int dec32(uchar*, int, char*, int);
452 extern int enc32(char*, int, uchar*, int);
453 extern int dec16(uchar*, int, char*, int);
454 extern int enc16(char*, int, uchar*, int);
455 extern int encodefmt(Fmt*);
456 extern int dirmodefmt(Fmt*);
457 extern void exits(char*);
458 extern double frexp(double, int*);
459 extern ulong getcallerpc(void*);
460 extern char* p9getenv(char*);
461 extern int getfields(char*, char**, int, int, char*);
462 extern int gettokens(char *, char **, int, char *);
463 extern char* getuser(void);
464 extern char* p9getwd(char*, int);
465 extern int iounit(int);
466 /* extern long labs(long); <math.h> */
467 /* extern double ldexp(double, int); <math.h> */
468 extern void p9longjmp(p9jmp_buf, int);
469 extern char* mktemp(char*);
470 /* extern double modf(double, double*); <math.h> */
471 extern int netcrypt(void*, void*);
472 extern void p9notejmp(void*, p9jmp_buf, int);
473 extern void perror(const char*);
474 extern int postnote(int, int, char *);
475 extern double pow10(int);
476 /* extern int putenv(char*, char*); <stdlib.h. */
477 /* extern void qsort(void*, long, long, int (*)(void*, void*)); <stdlib.h> */
478 extern int p9setjmp(p9jmp_buf);
481 extern double strtod(char*, char**);
482 extern long strtol(char*, char**, int);
483 extern ulong strtoul(char*, char**, int);
484 extern vlong strtoll(char*, char**, int);
485 extern uvlong strtoull(char*, char**, int);
487 extern void sysfatal(char*, ...);
488 extern void syslog(int, char*, char*, ...);
489 extern long time(long*);
490 /* extern int tolower(int); <ctype.h> */
491 /* extern int toupper(int); <ctype.h> */
492 #ifndef NOPLAN9DEFINES
493 #define getenv p9getenv
494 #define getwd p9getwd
495 #define longjmp p9longjmp
497 #define setjmp p9setjmp
498 #define notejmp p9notejmp
499 #define jmp_buf p9jmp_buf
510 extern int _tas(int*);
512 extern void lock(Lock*);
513 extern void unlock(Lock*);
514 extern int canlock(Lock*);
516 typedef struct QLp QLp;
533 extern void qlock(QLock*);
534 extern void qunlock(QLock*);
535 extern int canqlock(QLock*);
536 extern void _qlockinit(ulong (*)(ulong, ulong)); /* called only by the thread library */
542 int readers; /* number of readers */
543 int writer; /* number of writers */
544 QLp *head; /* list of waiting processes */
548 extern void rlock(RWLock*);
549 extern void runlock(RWLock*);
550 extern int canrlock(RWLock*);
551 extern void wlock(RWLock*);
552 extern void wunlock(RWLock*);
553 extern int canwlock(RWLock*);
563 extern void rsleep(Rendez*); /* unlocks r->l, sleeps, locks r->l again */
564 extern int rwakeup(Rendez*);
565 extern int rwakeupall(Rendez*);
566 extern void** privalloc(void);
567 extern void privfree(void**);
572 #define NETPATHLEN 40
573 extern int p9accept(int, char*);
574 extern int p9announce(char*, char*);
575 extern int p9dial(char*, char*, char*, int*);
576 extern void p9setnetmtpt(char*, int, char*);
577 extern int p9hangup(int);
578 extern int p9listen(char*, char*);
579 extern char* p9netmkaddr(char*, char*, char*);
580 extern int p9reject(int, char*, char*);
582 #ifndef NOPLAN9DEFINES
583 #define accept p9accept
584 #define announce p9announce
586 #define setnetmtpt p9setnetmtpt
587 #define hangup p9hangup
588 #define listen p9listen
589 #define netmkaddr p9netmkaddr
590 #define reject p9reject
596 extern int pushssl(int, char*, char*, char*, int*);
597 extern int pushtls(int, char*, char*, int, char*, char*);
602 typedef struct NetConnInfo NetConnInfo;
605 char *dir; /* connection directory */
606 char *root; /* network root */
607 char *spec; /* binding spec */
608 char *lsys; /* local system */
609 char *lserv; /* local service */
610 char *rsys; /* remote system */
611 char *rserv; /* remote service */
613 extern NetConnInfo* getnetconninfo(char*, int);
614 extern void freenetconninfo(NetConnInfo*);
620 #define STATMAX 65535U /* max length of machine-independent stat structure */
621 #define DIRMAX (sizeof(Dir)+STATMAX) /* max length of Dir structure */
622 #define ERRMAX 128 /* max length of error string */
624 #define MORDER 0x0003 /* mask for bits defining order of mounting */
625 #define MREPL 0x0000 /* mount replaces object */
626 #define MBEFORE 0x0001 /* mount goes before others in union directory */
627 #define MAFTER 0x0002 /* mount goes after others in union directory */
628 #define MCREATE 0x0004 /* permit creation in mounted directory */
629 #define MCACHE 0x0010 /* cache some data */
630 #define MMASK 0x0017 /* all bits on */
632 #define OREAD 0 /* open for read */
633 #define OWRITE 1 /* write */
634 #define ORDWR 2 /* read and write */
635 #define OEXEC 3 /* execute, == read but check execute permission */
636 #define OTRUNC 16 /* or'ed in (except for exec), truncate file first */
637 #define OCEXEC 32 /* or'ed in, close on exec */
638 #define ORCLOSE 64 /* or'ed in, remove on close */
639 #define OEXCL 0x1000 /* or'ed in, exclusive use (create only) */
641 #define AEXIST 0 /* accessible: exists */
642 #define AEXEC 1 /* execute access */
643 #define AWRITE 2 /* write access */
644 #define AREAD 4 /* read access */
647 #define SG_RONLY 0040 /* read only */
648 #define SG_CEXEC 0100 /* detach on exec */
650 #define NCONT 0 /* continue after note */
651 #define NDFLT 1 /* terminate after note */
652 #define NSAVE 2 /* clear note but hold state */
653 #define NRSTR 3 /* restore saved state */
655 /* bits in Qid.type */
656 #define QTDIR 0x80 /* type bit for directories */
657 #define QTAPPEND 0x40 /* type bit for append only files */
658 #define QTEXCL 0x20 /* type bit for exclusive use files */
659 #define QTMOUNT 0x10 /* type bit for mounted channel */
660 #define QTAUTH 0x08 /* type bit for authentication file */
661 #define QTFILE 0x00 /* plain file */
663 /* bits in Dir.mode */
664 #define DMDIR 0x80000000 /* mode bit for directories */
665 #define DMAPPEND 0x40000000 /* mode bit for append only files */
666 #define DMEXCL 0x20000000 /* mode bit for exclusive use files */
667 #define DMMOUNT 0x10000000 /* mode bit for mounted channel */
668 #define DMAUTH 0x08000000 /* mode bit for authentication file */
669 #define DMREAD 0x4 /* mode bit for read permission */
670 #define DMWRITE 0x2 /* mode bit for write permission */
671 #define DMEXEC 0x1 /* mode bit for execute permission */
673 #if defined(__FreeBSD__)
684 /* RFNAMEG = (1<<0), */
685 /* RFENVG = (1<<1), */
691 /* RFCNAMEG = (1<<10), */
692 /* RFCENVG = (1<<11), */
694 /* RFREND = (1<<13), */
695 /* RFNOMNT = (1<<14) */
698 extern int ffork(int, void(*)(void*), void*);
710 /* system-modified data */
711 ushort type; /* server type */
712 uint dev; /* server subtype */
714 Qid qid; /* unique id from server */
715 ulong mode; /* permissions */
716 ulong atime; /* last read time */
717 ulong mtime; /* last write time */
718 vlong length; /* file length */
719 char *name; /* last element of path */
720 char *uid; /* owner name */
721 char *gid; /* group name */
722 char *muid; /* last modifier name */
725 /* keep /sys/src/ape/lib/ap/plan9/sys9.h in sync with this -rsc */
729 int pid; /* of loved one */
730 ulong time[3]; /* of loved one & descendants */
741 extern void _exits(char*);
743 extern void abort(void);
744 /* extern int access(char*, int); <unistd.h> */
745 extern long p9alarm(ulong);
746 extern int await(char*, int);
747 /* extern int bind(char*, char*, int); give up */
748 /* extern int brk(void*); <unistd.h> */
749 /* extern int chdir(char*); <unistd.h> */
750 extern int close(int);
751 extern int create(char*, int, ulong);
752 extern int p9dup(int, int);
753 extern int errstr(char*, uint);
754 extern int p9exec(char*, char*[]);
755 /* extern int execl(char*, ...); <unistd.h> */
756 /* extern int fork(void); <unistd.h> */
757 extern int p9rfork(int);
759 extern int fauth(int, char*);
760 extern int fstat(int, uchar*, int);
761 extern int fwstat(int, uchar*, int);
762 extern int fversion(int, int, char*, int);
763 extern int mount(int, int, char*, int, char*);
764 extern int unmount(char*, char*);
766 extern int noted(int);
767 extern int notify(void(*)(void*, char*));
768 /* extern int open(char*, int); <unistd.h> */
769 extern int fd2path(int, char*, int);
770 extern int pipe(int*);
772 * use defs from <unistd.h>
773 extern long pread(int, void*, long, vlong);
774 extern long preadv(int, IOchunk*, int, vlong);
775 extern long pwrite(int, void*, long, vlong);
776 extern long pwritev(int, IOchunk*, int, vlong);
777 extern long read(int, void*, long);
779 extern long readn(int, void*, long);
780 /* extern long readv(int, IOchunk*, int); <unistd.h> */
781 extern int remove(const char*);
782 /* extern void* sbrk(ulong); <unistd.h> */
783 /* extern long oseek(int, long, int); */
784 extern vlong p9seek(int, vlong, int);
786 extern long segattach(int, char*, void*, ulong);
787 extern int segbrk(void*, void*);
788 extern int segdetach(void*);
789 extern int segflush(void*, ulong);
790 extern int segfree(void*, ulong);
792 extern int p9sleep(long);
793 /* extern int stat(char*, uchar*, int); give up */
794 extern Waitmsg* p9wait(void);
795 extern int p9waitpid(void);
797 extern long write(int, void*, long);
798 extern long writev(int, IOchunk*, int);
800 /* extern int wstat(char*, uchar*, int); give up */
801 extern ulong rendezvous(ulong, ulong);
803 #ifndef NOPLAN9DEFINES
804 #define alarm p9alarm
808 #define sleep p9sleep
810 #define waitpid p9waitpid
811 #define rfork p9rfork
814 extern Dir* dirstat(char*);
815 extern Dir* dirfstat(int);
816 extern int dirwstat(char*, Dir*);
817 extern int dirfwstat(int, Dir*);
818 extern long dirread(int, Dir**);
819 extern void nulldir(Dir*);
820 extern long dirreadall(int, Dir**);
821 /* extern int getpid(void); <unistd.h> */
822 /* extern int getppid(void); */
823 extern void rerrstr(char*, uint);
824 extern char* sysname(void);
825 extern void werrstr(char*, ...);
827 /* external names that we don't want to step on */
828 #ifndef NOPLAN9DEFINES
832 /* compiler directives on plan 9 */
833 #define USED(x) if(x){}else{}
834 #define SET(x) ((x)=0)
838 extern void __fixargv0(void);
839 #define ARGBEGIN for((argv0?0:(argv0=(__fixargv0(),*argv))),argv++,argc--;\
840 argv[0] && argv[0][0]=='-' && argv[0][1];\
842 char *_args, *_argt;\
844 _args = &argv[0][1];\
845 if(_args[0]=='-' && _args[1]==0){\
846 argc--; argv++; break;\
849 while(*_args && (_args += chartorune(&_argc, _args)))\
851 #define ARGEND SET(_argt);USED(_argt);USED(_argc);USED(_args);}USED(argv);USED(argc);
852 #define ARGF() (_argt=_args, _args="",\
853 (*_argt? _argt: argv[1]? (argc--, *++argv): 0))
854 #define EARGF(x) (_argt=_args, _args="",\
855 (*_argt? _argt: argv[1]? (argc--, *++argv): ((x), abort(), (char*)0)))
859 #if defined(__cplusplus)