sys/include/libc.h

   1 #pragma lib     "libc.a"
   2 #pragma src     "/sys/src/libc"
   3
   4 #define nelem(x)        (sizeof(x)/sizeof((x)[0]))
   5 #define offsetof(s, m)  (ulong)(&(((s*)0)->m))
   6 #define assert(x)       if(x){}else _assert("x")
   7
   8 /*
   9  * mem routines
  10  */
  11 extern  void*   memccpy(void*, void*, int, usize);
  12 extern  void*   memset(void*, int, usize);
  13 extern  int     memcmp(void*, void*, usize);
  14 extern  void*   memcpy(void*, void*, usize);
  15 extern  void*   memmove(void*, void*, usize);
  16 extern  void*   memchr(void*, int, usize);
  17
  18 /*
  19  * string routines
  20  */
  21 extern  char*   strcat(char*, char*);
  22 extern  char*   strchr(char*, int);
  23 extern  int     strcmp(char*, char*);
  24 extern  char*   strcpy(char*, char*);
  25 extern  char*   strecpy(char*, char*, char*);
  26 extern  char*   strdup(char*);
  27 extern  char*   strncat(char*, char*, long);
  28 extern  char*   strncpy(char*, char*, long);
  29 extern  int     strncmp(char*, char*, long);
  30 extern  char*   strpbrk(char*, char*);
  31 extern  char*   strrchr(char*, int);
  32 extern  char*   strtok(char*, char*);
  33 extern  long    strlen(char*);
  34 extern  long    strspn(char*, char*);
  35 extern  long    strcspn(char*, char*);
  36 extern  char*   strstr(char*, char*);
  37 extern  int     cistrncmp(char*, char*, int);
  38 extern  int     cistrcmp(char*, char*);
  39 extern  char*   cistrstr(char*, char*);
  40 extern  int     tokenize(char*, char**, int);
  41
  42 enum
  43 {
  44         UTFmax          = 4,            /* maximum bytes per rune */
  45         Runesync        = 0x80,         /* cannot represent part of a UTF sequence (<) */
  46         Runeself        = 0x80,         /* rune and UTF sequences are the same (<) */
  47         Runeerror       = 0xFFFD,       /* decoding error in UTF */
  48         Runemax         = 0x10FFFF,     /* 21 bit rune */
  49         Runemask        = 0x1FFFFF,     /* bits used by runes (see grep) */
  50 };
  51
  52 /*
  53  * rune routines
  54  */
  55 extern  int     runetochar(char*, Rune*);
  56 extern  int     chartorune(Rune*, char*);
  57 extern  int     runelen(long);
  58 extern  int     runenlen(Rune*, int);
  59 extern  int     fullrune(char*, int);
  60 extern  int     utflen(char*);
  61 extern  int     utfnlen(char*, long);
  62 extern  char*   utfrune(char*, long);
  63 extern  char*   utfrrune(char*, long);
  64 extern  char*   utfutf(char*, char*);
  65 extern  char*   utfecpy(char*, char*, char*);
  66
  67 extern  Rune*   runestrcat(Rune*, Rune*);
  68 extern  Rune*   runestrchr(Rune*, Rune);
  69 extern  int     runestrcmp(Rune*, Rune*);
  70 extern  Rune*   runestrcpy(Rune*, Rune*);
  71 extern  Rune*   runestrncpy(Rune*, Rune*, long);
  72 extern  Rune*   runestrecpy(Rune*, Rune*, Rune*);
  73 extern  Rune*   runestrdup(Rune*);
  74 extern  Rune*   runestrncat(Rune*, Rune*, long);
  75 extern  int     runestrncmp(Rune*, Rune*, long);
  76 extern  Rune*   runestrrchr(Rune*, Rune);
  77 extern  long    runestrlen(Rune*);
  78 extern  Rune*   runestrstr(Rune*, Rune*);
  79
  80 extern  Rune    tolowerrune(Rune);
  81 extern  Rune    totitlerune(Rune);
  82 extern  Rune    toupperrune(Rune);
  83 extern  int     isalpharune(Rune);
  84 extern  int     islowerrune(Rune);
  85 extern  int     isspacerune(Rune);
  86 extern  int     istitlerune(Rune);
  87 extern  int     isupperrune(Rune);
  88 extern  int     isdigitrune(Rune);
  89
  90 /*
  91  * malloc
  92  */
  93 extern  void*   malloc(ulong);
  94 extern  void*   mallocz(ulong, int);
  95 extern  void    free(void*);
  96 extern  ulong   msize(void*);
  97 extern  void*   mallocalign(ulong, ulong, long, ulong);
  98 extern  void*   calloc(ulong, ulong);
  99 extern  void*   realloc(void*, ulong);
 100 extern  void    setmalloctag(void*, uintptr);
 101 extern  void    setrealloctag(void*, uintptr);
 102 extern  uintptr getmalloctag(void*);
 103 extern  uintptr getrealloctag(void*);
 104 extern  void*   malloctopoolblock(void*);
 105
 106 /*
 107  * print routines
 108  */
 109 typedef struct Fmt      Fmt;
 110 struct Fmt{
 111         uchar   runes;                  /* output buffer is runes or chars? */
 112         void    *start;                 /* of buffer */
 113         void    *to;                    /* current place in the buffer */
 114         void    *stop;                  /* end of the buffer; overwritten if flush fails */
 115         int     (*flush)(Fmt *);        /* called when to == stop */
 116         void    *farg;                  /* to make flush a closure */
 117         int     nfmt;                   /* num chars formatted so far */
 118         va_list args;                   /* args passed to dofmt */
 119         int     r;                      /* % format Rune */
 120         int     width;
 121         int     prec;
 122         ulong   flags;
 123 };
 124
 125 enum{
 126         FmtWidth        = 1,
 127         FmtLeft         = FmtWidth << 1,
 128         FmtPrec         = FmtLeft << 1,
 129         FmtSharp        = FmtPrec << 1,
 130         FmtSpace        = FmtSharp << 1,
 131         FmtSign         = FmtSpace << 1,
 132         FmtZero         = FmtSign << 1,
 133         FmtUnsigned     = FmtZero << 1,
 134         FmtShort        = FmtUnsigned << 1,
 135         FmtLong         = FmtShort << 1,
 136         FmtVLong        = FmtLong << 1,
 137         FmtComma        = FmtVLong << 1,
 138         FmtByte         = FmtComma << 1,
 139
 140         FmtFlag         = FmtByte << 1
 141 };
 142
 143 extern  int     print(char*, ...);
 144 extern  char*   seprint(char*, char*, char*, ...);
 145 extern  char*   vseprint(char*, char*, char*, va_list);
 146 extern  int     snprint(char*, int, char*, ...);
 147 extern  int     vsnprint(char*, int, char*, va_list);
 148 extern  char*   smprint(char*, ...);
 149 extern  char*   vsmprint(char*, va_list);
 150 extern  int     sprint(char*, char*, ...);
 151 extern  int     fprint(int, char*, ...);
 152 extern  int     vfprint(int, char*, va_list);
 153
 154 extern  int     runesprint(Rune*, char*, ...);
 155 extern  int     runesnprint(Rune*, int, char*, ...);
 156 extern  int     runevsnprint(Rune*, int, char*, va_list);
 157 extern  Rune*   runeseprint(Rune*, Rune*, char*, ...);
 158 extern  Rune*   runevseprint(Rune*, Rune*, char*, va_list);
 159 extern  Rune*   runesmprint(char*, ...);
 160 extern  Rune*   runevsmprint(char*, va_list);
 161
 162 extern  int     fmtfdinit(Fmt*, int, char*, int);
 163 extern  int     fmtfdflush(Fmt*);
 164 extern  int     fmtstrinit(Fmt*);
 165 extern  char*   fmtstrflush(Fmt*);
 166 extern  int     runefmtstrinit(Fmt*);
 167 extern  Rune*   runefmtstrflush(Fmt*);
 168
 169 #pragma varargck        argpos  fmtprint        2
 170 #pragma varargck        argpos  fprint          2
 171 #pragma varargck        argpos  print           1
 172 #pragma varargck        argpos  runeseprint     3
 173 #pragma varargck        argpos  runesmprint     1
 174 #pragma varargck        argpos  runesnprint     3
 175 #pragma varargck        argpos  runesprint      2
 176 #pragma varargck        argpos  seprint         3
 177 #pragma varargck        argpos  smprint         1
 178 #pragma varargck        argpos  snprint         3
 179 #pragma varargck        argpos  sprint          2
 180
 181 #pragma varargck        type    "lld"   vlong
 182 #pragma varargck        type    "llo"   vlong
 183 #pragma varargck        type    "llx"   vlong
 184 #pragma varargck        type    "llb"   vlong
 185 #pragma varargck        type    "lld"   uvlong
 186 #pragma varargck        type    "llo"   uvlong
 187 #pragma varargck        type    "llx"   uvlong
 188 #pragma varargck        type    "llb"   uvlong
 189 #pragma varargck        type    "ld"    long
 190 #pragma varargck        type    "lo"    long
 191 #pragma varargck        type    "lx"    long
 192 #pragma varargck        type    "lb"    long
 193 #pragma varargck        type    "ld"    ulong
 194 #pragma varargck        type    "lo"    ulong
 195 #pragma varargck        type    "lx"    ulong
 196 #pragma varargck        type    "lb"    ulong
 197 #pragma varargck        type    "zd"    intptr
 198 #pragma varargck        type    "zo"    intptr
 199 #pragma varargck        type    "zx"    intptr
 200 #pragma varargck        type    "zb"    intptr
 201 #pragma varargck        type    "zd"    uintptr
 202 #pragma varargck        type    "zo"    uintptr
 203 #pragma varargck        type    "zx"    uintptr
 204 #pragma varargck        type    "zb"    uintptr
 205 #pragma varargck        type    "d"     int
 206 #pragma varargck        type    "o"     int
 207 #pragma varargck        type    "x"     int
 208 #pragma varargck        type    "c"     int
 209 #pragma varargck        type    "C"     int
 210 #pragma varargck        type    "b"     int
 211 #pragma varargck        type    "d"     uint
 212 #pragma varargck        type    "x"     uint
 213 #pragma varargck        type    "c"     uint
 214 #pragma varargck        type    "C"     uint
 215 #pragma varargck        type    "b"     uint
 216 #pragma varargck        type    "f"     double
 217 #pragma varargck        type    "e"     double
 218 #pragma varargck        type    "g"     double
 219 #pragma varargck        type    "s"     char*
 220 #pragma varargck        type    "q"     char*
 221 #pragma varargck        type    "S"     Rune*
 222 #pragma varargck        type    "Q"     Rune*
 223 #pragma varargck        type    "r"     void
 224 #pragma varargck        type    "%"     void
 225 #pragma varargck        type    "n"     int*
 226 #pragma varargck        type    "p"     uintptr
 227 #pragma varargck        type    "p"     void*
 228 #pragma varargck        flag    ','
 229 #pragma varargck        flag    ' '
 230 #pragma varargck        flag    'h'
 231 #pragma varargck        type    "<"     void*
 232 #pragma varargck        type    "["     void*
 233 #pragma varargck        type    "H"     void*
 234 #pragma varargck        type    "lH"    void*
 235
 236 extern  int     fmtinstall(int, int (*)(Fmt*));
 237 extern  int     dofmt(Fmt*, char*);
 238 extern  int     dorfmt(Fmt*, Rune*);
 239 extern  int     fmtprint(Fmt*, char*, ...);
 240 extern  int     fmtvprint(Fmt*, char*, va_list);
 241 extern  int     fmtrune(Fmt*, int);
 242 extern  int     fmtstrcpy(Fmt*, char*);
 243 extern  int     fmtrunestrcpy(Fmt*, Rune*);
 244 /*
 245  * error string for %r
 246  * supplied on per os basis, not part of fmt library
 247  */
 248 extern  int     errfmt(Fmt *f);
 249
 250 /*
 251  * quoted strings
 252  */
 253 extern  char    *unquotestrdup(char*);
 254 extern  Rune    *unquoterunestrdup(Rune*);
 255 extern  char    *quotestrdup(char*);
 256 extern  Rune    *quoterunestrdup(Rune*);
 257 extern  int     quotestrfmt(Fmt*);
 258 extern  int     quoterunestrfmt(Fmt*);
 259 extern  void    quotefmtinstall(void);
 260 extern  int     (*doquote)(int);
 261 extern  int     needsrcquote(int);
 262
 263 /*
 264  * random number
 265  */
 266 extern  void    srand(long);
 267 extern  int     rand(void);
 268 extern  int     nrand(int);
 269 extern  long    lrand(void);
 270 extern  long    lnrand(long);
 271 extern  double  frand(void);
 272 extern  ulong   truerand(void);                 /* uses /dev/random */
 273 extern  ulong   ntruerand(ulong);               /* uses /dev/random */
 274
 275 /*
 276  * math
 277  */
 278 extern  ulong   getfcr(void);
 279 extern  void    setfsr(ulong);
 280 extern  ulong   getfsr(void);
 281 extern  void    setfcr(ulong);
 282 extern  double  NaN(void);
 283 extern  double  Inf(int);
 284 extern  int     isNaN(double);
 285 extern  int     isInf(double, int);
 286 extern  ulong   umuldiv(ulong, ulong, ulong);
 287 extern  long    muldiv(long, long, long);
 288
 289 extern  double  pow(double, double);
 290 extern  double  atan2(double, double);
 291 extern  double  fabs(double);
 292 extern  double  atan(double);
 293 extern  double  log(double);
 294 extern  double  log10(double);
 295 extern  double  exp(double);
 296 extern  double  floor(double);
 297 extern  double  ceil(double);
 298 extern  double  hypot(double, double);
 299 extern  double  sin(double);
 300 extern  double  cos(double);
 301 extern  double  tan(double);
 302 extern  double  asin(double);
 303 extern  double  acos(double);
 304 extern  double  sinh(double);
 305 extern  double  cosh(double);
 306 extern  double  tanh(double);
 307 extern  double  sqrt(double);
 308 extern  double  fmod(double, double);
 309
 310 #define HUGE    3.4028234e38
 311 #define PIO2    1.570796326794896619231e0
 312 #define PI      (PIO2+PIO2)
 313
 314 /*
 315  * Time-of-day
 316  */
 317 typedef struct Tzone Tzone;
 318 #pragma incomplete Tzone
 319
 320
 321 typedef
 322 struct Tm
 323 {
 324         int     nsec;           /* nseconds (range 0...1e9) */
 325         int     sec;            /* seconds (range 0..60) */
 326         int     min;            /* minutes (0..59) */
 327         int     hour;           /* hours (0..23) */
 328         int     mday;           /* day of the month (1..31) */
 329         int     mon;            /* month of the year (0..11) */
 330         int     year;           /* year A.D. */
 331         int     wday;           /* day of week (0..6, Sunday = 0) */
 332         int     yday;           /* day of year (0..365) */
 333         char    zone[16];       /* time zone name */
 334         int     tzoff;          /* time zone delta from GMT */
 335         Tzone   *tz;            /* time zone associated with this date */
 336 } Tm;
 337
 338 typedef
 339 struct Tmfmt {
 340         char    *fmt;
 341         Tm      *tm;
 342 } Tmfmt;
 343
 344 #pragma varargck        type    "τ"    Tmfmt
 345
 346 extern  Tzone*  tzload(char *name);
 347 extern  Tm*     tmnow(Tm*, Tzone*);
 348 extern  Tm*     tmtime(Tm*, vlong, Tzone*);
 349 extern  Tm*     tmtimens(Tm*, vlong, int, Tzone*);
 350 extern  Tm*     tmparse(Tm*, char*, char*, Tzone*, char **ep);
 351 extern  vlong   tmnorm(Tm*);
 352 extern  Tmfmt   tmfmt(Tm*, char*);
 353 extern  void    tmfmtinstall(void);
 354
 355 extern  Tm*     gmtime(long);
 356 extern  Tm*     localtime(long);
 357 extern  char*   asctime(Tm*);
 358 extern  char*   ctime(long);
 359 extern  double  cputime(void);
 360 extern  long    times(long*);
 361 extern  long    tm2sec(Tm*);
 362 extern  vlong   nsec(void);
 363
 364 extern  void    cycles(uvlong*);        /* 64-bit value of the cycle counter if there is one, 0 if there isn't */
 365
 366 /*
 367  * one-of-a-kind
 368  */
 369 enum
 370 {
 371         PNPROC          = 1,
 372         PNGROUP         = 2,
 373 };
 374
 375 extern  void    _assert(char*);
 376 extern  int     abs(int);
 377 extern  int     atexit(void(*)(void));
 378 extern  void    atexitdont(void(*)(void));
 379 extern  int     atnotify(int(*)(void*, char*), int);
 380 extern  double  atof(char*);
 381 extern  int     atoi(char*);
 382 extern  long    atol(char*);
 383 extern  vlong   atoll(char*);
 384 extern  double  charstod(int(*)(void*), void*);
 385 extern  char*   cleanname(char*);
 386 extern  int     decrypt(void*, void*, int);
 387 extern  int     encrypt(void*, void*, int);
 388
 389 extern  int     dec64(uchar*, int, char*, int);
 390 extern  int     enc64(char*, int, uchar*, int);
 391 extern  int     dec64x(uchar*, int, char*, int, int (*)(int));
 392 extern  int     enc64x(char*, int, uchar*, int, int (*)(int));
 393 extern  int     dec32(uchar*, int, char*, int);
 394 extern  int     enc32(char*, int, uchar*, int);
 395 extern  int     dec32x(uchar*, int, char*, int, int (*)(int));
 396 extern  int     enc32x(char*, int, uchar*, int, int (*)(int));
 397 extern  int     dec16(uchar*, int, char*, int);
 398 extern  int     enc16(char*, int, uchar*, int);
 399 extern  int     dec64chr(int);
 400 extern  int     enc64chr(int);
 401 extern  int     dec32chr(int);
 402 extern  int     enc32chr(int);
 403 extern  int     dec16chr(int);
 404 extern  int     enc16chr(int);
 405
 406 extern  int     encodefmt(Fmt*);
 407 extern  void    exits(char*);
 408 extern  double  frexp(double, int*);
 409 extern  uintptr getcallerpc(void*);
 410 extern  char*   getenv(char*);
 411 extern  int     getfields(char*, char**, int, int, char*);
 412 extern  int     gettokens(char *, char **, int, char *);
 413 extern  char*   getuser(void);
 414 extern  char*   getwd(char*, int);
 415 extern  int     iounit(int);
 416 extern  long    labs(long);
 417 extern  double  ldexp(double, int);
 418 extern  void    longjmp(jmp_buf, int);
 419 extern  char*   mktemp(char*);
 420 extern  double  modf(double, double*);
 421 extern  int     netcrypt(void*, void*);
 422 extern  void    notejmp(void*, jmp_buf, int);
 423 extern  void    perror(char*);
 424 extern  int     postnote(int, int, char *);
 425 extern  double  pow10(int);
 426 extern  int     putenv(char*, char*);
 427 extern  void    qsort(void*, long, long, int (*)(void*, void*));
 428 extern  int     setjmp(jmp_buf);
 429 extern  double  strtod(char*, char**);
 430 extern  long    strtol(char*, char**, int);
 431 extern  ulong   strtoul(char*, char**, int);
 432 extern  vlong   strtoll(char*, char**, int);
 433 extern  uvlong  strtoull(char*, char**, int);
 434 extern  void    sysfatal(char*, ...);
 435 #pragma varargck        argpos  sysfatal        1
 436 extern  void    syslog(int, char*, char*, ...);
 437 #pragma varargck        argpos  syslog  3
 438 extern  long    time(long*);
 439 extern  int     tolower(int);
 440 extern  int     toupper(int);
 441
 442 /*
 443  *  profiling
 444  */
 445 enum {
 446         Profoff,                /* No profiling */
 447         Profuser,               /* Measure user time only (default) */
 448         Profkernel,             /* Measure user + kernel time */
 449         Proftime,               /* Measure total time */
 450         Profsample,             /* Use clock interrupt to sample (default when there is no cycle counter) */
 451 }; /* what */
 452 extern  void    prof(void (*fn)(void*), void *arg, int entries, int what);
 453
 454 /*
 455  *  synchronization
 456  */
 457 typedef
 458 struct Lock {
 459         int     val;
 460 } Lock;
 461
 462 extern int      _tas(int*);
 463
 464 extern  void    lock(Lock*);
 465 extern  void    unlock(Lock*);
 466 extern  int     canlock(Lock*);
 467
 468 typedef struct QLp QLp;
 469 struct QLp
 470 {
 471         int     inuse;
 472         int     state;
 473         QLp     *next;
 474 };
 475
 476 typedef
 477 struct QLock
 478 {
 479         Lock    lock;
 480         int     locked;
 481         QLp     *head;
 482         QLp     *tail;
 483 } QLock;
 484
 485 extern  void    qlock(QLock*);
 486 extern  void    qunlock(QLock*);
 487 extern  int     canqlock(QLock*);
 488 extern  void    _qlockinit(void* (*)(void*, void*));    /* called only by the thread library */
 489
 490 typedef
 491 struct RWLock
 492 {
 493         Lock    lock;
 494         int     readers;        /* number of readers */
 495         int     writer;         /* number of writers */
 496         QLp     *head;          /* list of waiting processes */
 497         QLp     *tail;
 498 } RWLock;
 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
 507 typedef
 508 struct Rendez
 509 {
 510         QLock   *l;
 511         QLp     *head;
 512         QLp     *tail;
 513 } Rendez;
 514
 515 extern  void    rsleep(Rendez*);        /* unlocks r->l, sleeps, locks r->l again */
 516 extern  int     rwakeup(Rendez*);
 517 extern  int     rwakeupall(Rendez*);
 518 extern  void**  privalloc(void);
 519
 520 extern void     procsetname(char*, ...);
 521 #pragma varargck argpos procsetname 1
 522
 523 /*
 524  *  network dialing
 525  */
 526 #define NETPATHLEN 40
 527 extern  int     accept(int, char*);
 528 extern  int     announce(char*, char*);
 529 extern  int     dial(char*, char*, char*, int*);
 530 extern  void    setnetmtpt(char*, int, char*);
 531 extern  int     hangup(int);
 532 extern  int     listen(char*, char*);
 533 extern  char*   netmkaddr(char*, char*, char*);
 534 extern  int     reject(int, char*, char*);
 535
 536 /*
 537  *  encryption
 538  */
 539 extern  int     pushssl(int, char*, char*, char*, int*);
 540 extern  int     pushtls(int, char*, char*, int, char*, char*);
 541
 542 /*
 543  *  network services
 544  */
 545 typedef struct NetConnInfo NetConnInfo;
 546 struct NetConnInfo
 547 {
 548         char    *dir;           /* connection directory */
 549         char    *root;          /* network root */
 550         char    *spec;          /* binding spec */
 551         char    *lsys;          /* local system */
 552         char    *lserv;         /* local service */
 553         char    *rsys;          /* remote system */
 554         char    *rserv;         /* remote service */
 555         char    *laddr;         /* local address */
 556         char    *raddr;         /* remote address */
 557 };
 558 extern  NetConnInfo*    getnetconninfo(char*, int);
 559 extern  void            freenetconninfo(NetConnInfo*);
 560
 561 extern  int     idn2utf(char*, char*, int);
 562 extern  int     utf2idn(char*, char*, int);
 563
 564 /*
 565  * system calls
 566  *
 567  */
 568 #define STATMAX 65535U  /* max length of machine-independent stat structure */
 569 #define DIRMAX  (sizeof(Dir)+STATMAX)   /* max length of Dir structure */
 570 #define ERRMAX  128     /* max length of error string */
 571
 572 #define MORDER  0x0003  /* mask for bits defining order of mounting */
 573 #define MREPL   0x0000  /* mount replaces object */
 574 #define MBEFORE 0x0001  /* mount goes before others in union directory */
 575 #define MAFTER  0x0002  /* mount goes after others in union directory */
 576 #define MCREATE 0x0004  /* permit creation in mounted directory */
 577 #define MCACHE  0x0010  /* cache some data */
 578 #define MMASK   0x0017  /* all bits on */
 579
 580 #define OREAD   0       /* open for read */
 581 #define OWRITE  1       /* write */
 582 #define ORDWR   2       /* read and write */
 583 #define OEXEC   3       /* execute, == read but check execute permission */
 584 #define OTRUNC  16      /* or'ed in (except for exec), truncate file first */
 585 #define OCEXEC  32      /* or'ed in, close on exec */
 586 #define ORCLOSE 64      /* or'ed in, remove on close */
 587 #define OEXCL   0x1000  /* or'ed in, exclusive use (create only) */
 588
 589 #define AEXIST  0       /* accessible: exists */
 590 #define AEXEC   1       /* execute access */
 591 #define AWRITE  2       /* write access */
 592 #define AREAD   4       /* read access */
 593
 594 /* Segattch */
 595 #define SG_RONLY        0040    /* read only */
 596 #define SG_CEXEC        0100    /* detach on exec */
 597
 598 #define NCONT   0       /* continue after note */
 599 #define NDFLT   1       /* terminate after note */
 600 #define NSAVE   2       /* clear note but hold state */
 601 #define NRSTR   3       /* restore saved state */
 602
 603 /* bits in Qid.type */
 604 #define QTDIR           0x80            /* type bit for directories */
 605 #define QTAPPEND        0x40            /* type bit for append only files */
 606 #define QTEXCL          0x20            /* type bit for exclusive use files */
 607 #define QTMOUNT         0x10            /* type bit for mounted channel */
 608 #define QTAUTH          0x08            /* type bit for authentication file */
 609 #define QTTMP           0x04            /* type bit for not-backed-up file */
 610 #define QTFILE          0x00            /* plain file */
 611
 612 /* bits in Dir.mode */
 613 #define DMDIR           0x80000000      /* mode bit for directories */
 614 #define DMAPPEND        0x40000000      /* mode bit for append only files */
 615 #define DMEXCL          0x20000000      /* mode bit for exclusive use files */
 616 #define DMMOUNT         0x10000000      /* mode bit for mounted channel */
 617 #define DMAUTH          0x08000000      /* mode bit for authentication file */
 618 #define DMTMP           0x04000000      /* mode bit for non-backed-up files */
 619 #define DMREAD          0x4             /* mode bit for read permission */
 620 #define DMWRITE         0x2             /* mode bit for write permission */
 621 #define DMEXEC          0x1             /* mode bit for execute permission */
 622
 623 /* rfork */
 624 enum
 625 {
 626         RFNAMEG         = (1<<0),
 627         RFENVG          = (1<<1),
 628         RFFDG           = (1<<2),
 629         RFNOTEG         = (1<<3),
 630         RFPROC          = (1<<4),
 631         RFMEM           = (1<<5),
 632         RFNOWAIT        = (1<<6),
 633         RFCNAMEG        = (1<<10),
 634         RFCENVG         = (1<<11),
 635         RFCFDG          = (1<<12),
 636         RFREND          = (1<<13),
 637         RFNOMNT         = (1<<14)
 638 };
 639
 640 typedef
 641 struct Qid
 642 {
 643         uvlong  path;
 644         ulong   vers;
 645         uchar   type;
 646 } Qid;
 647
 648 typedef
 649 struct Dir {
 650         /* system-modified data */
 651         ushort  type;   /* server type */
 652         uint    dev;    /* server subtype */
 653         /* file data */
 654         Qid     qid;    /* unique id from server */
 655         ulong   mode;   /* permissions */
 656         ulong   atime;  /* last read time */
 657         ulong   mtime;  /* last write time */
 658         vlong   length; /* file length */
 659         char    *name;  /* last element of path */
 660         char    *uid;   /* owner name */
 661         char    *gid;   /* group name */
 662         char    *muid;  /* last modifier name */
 663 } Dir;
 664
 665 /* keep /sys/src/ape/lib/ap/plan9/sys9.h in sync with this -rsc */
 666 typedef
 667 struct Waitmsg
 668 {
 669         int     pid;            /* of loved one */
 670         ulong   time[3];        /* of loved one & descendants */
 671         char    *msg;
 672 } Waitmsg;
 673
 674 typedef
 675 struct IOchunk
 676 {
 677         void    *addr;
 678         ulong   len;
 679 } IOchunk;
 680
 681 extern  void    _exits(char*);
 682
 683 extern  void    abort(void);
 684 extern  int     access(char*, int);
 685 extern  long    alarm(ulong);
 686 extern  int     await(char*, int);
 687 extern  int     bind(char*, char*, int);
 688 extern  int     brk(void*);
 689 extern  int     chdir(char*);
 690 extern  int     close(int);
 691 extern  int     create(char*, int, ulong);
 692 extern  int     dup(int, int);
 693 extern  int     errstr(char*, uint);
 694 extern  int     exec(char*, char*[]);
 695 extern  int     execl(char*, ...);
 696 extern  int     fork(void);
 697 extern  int     rfork(int);
 698 extern  int     fauth(int, char*);
 699 extern  int     fstat(int, uchar*, int);
 700 extern  int     fwstat(int, uchar*, int);
 701 extern  int     fversion(int, int, char*, int);
 702 extern  int     mount(int, int, char*, int, char*);
 703 extern  int     unmount(char*, char*);
 704 extern  int     noted(int);
 705 extern  int     notify(void(*)(void*, char*));
 706 extern  int     open(char*, int);
 707 extern  int     fd2path(int, char*, int);
 708 extern  int     pipe(int*);
 709 extern  long    pread(int, void*, long, vlong);
 710 extern  long    preadv(int, IOchunk*, int, vlong);
 711 extern  long    pwrite(int, void*, long, vlong);
 712 extern  long    pwritev(int, IOchunk*, int, vlong);
 713 extern  long    read(int, void*, long);
 714 extern  long    readn(int, void*, long);
 715 extern  long    readv(int, IOchunk*, int);
 716 extern  int     remove(char*);
 717 extern  void*   sbrk(ulong);
 718 extern  long    oseek(int, long, int);
 719 extern  vlong   seek(int, vlong, int);
 720 extern  void*   segattach(int, char*, void*, ulong);
 721 extern  void*   segbrk(void*, void*);
 722 extern  int     segdetach(void*);
 723 extern  int     segflush(void*, ulong);
 724 extern  int     segfree(void*, ulong);
 725 extern  int     semacquire(long*, int);
 726 extern  long    semrelease(long*, long);
 727 extern  int     sleep(long);
 728 extern  int     stat(char*, uchar*, int);
 729 extern  int     tsemacquire(long*, ulong);
 730 extern  Waitmsg*        wait(void);
 731 extern  int     waitpid(void);
 732 extern  long    write(int, void*, long);
 733 extern  long    writev(int, IOchunk*, int);
 734 extern  int     wstat(char*, uchar*, int);
 735 extern  void*   rendezvous(void*, void*);
 736
 737 extern  Dir*    dirstat(char*);
 738 extern  Dir*    dirfstat(int);
 739 extern  int     dirwstat(char*, Dir*);
 740 extern  int     dirfwstat(int, Dir*);
 741 extern  long    dirread(int, Dir**);
 742 extern  void    nulldir(Dir*);
 743 extern  long    dirreadall(int, Dir**);
 744 extern  int     getpid(void);
 745 extern  int     getppid(void);
 746 extern  void    rerrstr(char*, uint);
 747 extern  char*   sysname(void);
 748 extern  void    werrstr(char*, ...);
 749 #pragma varargck        argpos  werrstr 1
 750
 751 extern  long    ainc(long*);
 752 extern  long    adec(long*);
 753
 754 extern char *argv0;
 755 #define ARGBEGIN        for((argv0||(argv0=*argv)),argv++,argc--;\
 756                             argv[0] && argv[0][0]=='-' && argv[0][1];\
 757                             argc--, argv++) {\
 758                                 char *_args, *_argt;\
 759                                 Rune _argc;\
 760                                 _args = &argv[0][1];\
 761                                 if(_args[0]=='-' && _args[1]==0){\
 762                                         argc--; argv++; break;\
 763                                 }\
 764                                 _argc = 0;\
 765                                 while(*_args && (_args += chartorune(&_argc, _args)))\
 766                                 switch(_argc)
 767 #define ARGEND          SET(_argt);USED(_argt,_argc,_args);}USED(argv, argc);
 768 #define ARGF()          (_argt=_args, _args="",\
 769                                 (*_argt? _argt: argv[1]? (argc--, *++argv): 0))
 770 #define EARGF(x)        (_argt=_args, _args="",\
 771                                 (*_argt? _argt: argv[1]? (argc--, *++argv): ((x), abort(), (char*)0)))
 772
 773 #define ARGC()          _argc
 774
 775 /* this is used by sbrk and brk,  it's a really bad idea to redefine it */
 776 extern  char    end[];