popen.c

   1 /*@ S-nail - a mail user agent derived from Berkeley Mail.
   2  *@ Handling of pipes, child processes, temporary files, file enwrapping.
   3  *
   4  * Copyright (c) 2000-2004 Gunnar Ritter, Freiburg i. Br., Germany.
   5  * Copyright (c) 2012 - 2018 Steffen (Daode) Nurpmeso <steffen@sdaoden.eu>.
   6  */
   7 /*
   8  * Copyright (c) 1980, 1993
   9  *      The Regents of the University of California.  All rights reserved.
  10  *
  11  * Redistribution and use in source and binary forms, with or without
  12  * modification, are permitted provided that the following conditions
  13  * are met:
  14  * 1. Redistributions of source code must retain the above copyright
  15  *    notice, this list of conditions and the following disclaimer.
  16  * 2. Redistributions in binary form must reproduce the above copyright
  17  *    notice, this list of conditions and the following disclaimer in the
  18  *    documentation and/or other materials provided with the distribution.
  19  * 3. Neither the name of the University nor the names of its contributors
  20  *    may be used to endorse or promote products derived from this software
  21  *    without specific prior written permission.
  22  *
  23  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  24  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  25  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  26  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  27  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  28  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  29  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  30  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  31  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  32  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  33  * SUCH DAMAGE.
  34  */
  35 #undef n_FILE
  36 #define n_FILE popen
  37
  38 #ifndef HAVE_AMALGAMATION
  39 # include "nail.h"
  40 #endif
  41
  42 #define READ               0
  43 #define WRITE              1
  44
  45 struct fp {
  46    struct fp   *link;
  47    int         omode;
  48    int         pid;
  49    enum {
  50       FP_RAW,
  51
  52 FP_IMAP = 1u<<3,
  53       FP_MAILDIR = 1u<<4,
  54       FP_HOOK = 1u<<5,
  55       FP_PIPE = 1u<<6,
  56       FP_MASK = (1u<<7) - 1,
  57       /* TODO FP_UNLINK: should be in a separated process so that unlinking
  58        * TODO the temporary "garbage" is "safe"(r than it is like that) */
  59       FP_UNLINK = 1u<<9,
  60       FP_TERMIOS = 1u<<10
  61    }           flags;
  62    long        offset;
  63    FILE        *fp;
  64    char        *realfile;
  65    char        *save_cmd;
  66    struct termios *fp_tios;
  67    n_sighdl_t fp_osigint;     /* Only if FP_TERMIOS */
  68 };
  69
  70 struct child {
  71    int         pid;
  72    char        done;
  73    char        free;
  74    int         status;
  75    struct child *link;
  76 };
  77
  78 static struct fp     *fp_head;
  79 static struct child  *_popen_child;
  80
  81 /* TODO Rather temporary: deal with job control with FD_PASS */
  82 static struct termios a_popen_tios;
  83 static sighandler_type a_popen_otstp, a_popen_ottin, a_popen_ottou;
  84 static volatile int a_popen_hadsig;
  85
  86 static int a_popen_scan_mode(char const *mode, int *omode);
  87 static void          register_file(FILE *fp, int omode, int pid,
  88                         int flags, char const *realfile, long offset,
  89                         char const *save_cmd, struct termios *tiosp,
  90                         n_sighdl_t osigint);
  91 static enum okay _file_save(struct fp *fpp);
  92 static int a_popen_file_load(int flags, int infd, int outfd,
  93             char const *load_cmd);
  94 static enum okay     unregister_file(FILE *fp, struct termios **tiosp,
  95                         n_sighdl_t *osigint);
  96 static int           file_pid(FILE *fp);
  97
  98 /* TODO Rather temporary: deal with job control with FD_PASS */
  99 static void a_popen_jobsigs_up(void);
 100 static void a_popen_jobsigs_down(void);
 101 static void a_popen_jobsig(int sig);
 102
 103 /* Handle SIGCHLD */
 104 static void a_popen_sigchld(int signo);
 105
 106 static struct child *a_popen_child_find(int pid, bool_t create);
 107 static void a_popen_child_del(struct child *cp);
 108
 109 static int
 110 a_popen_scan_mode(char const *mode, int *omode){
 111    static struct{
 112       char const mode[4];
 113       int omode;
 114    } const maps[] = {
 115       {"r", O_RDONLY},
 116       {"w", O_WRONLY | O_CREAT | n_O_NOXY_BITS | O_TRUNC},
 117       {"wx", O_WRONLY | O_CREAT | O_EXCL},
 118       {"a", O_WRONLY | O_APPEND | O_CREAT | n_O_NOXY_BITS},
 119       {"a+", O_RDWR | O_APPEND | O_CREAT | n_O_NOXY_BITS},
 120       {"r+", O_RDWR},
 121       {"w+", O_RDWR | O_CREAT | O_EXCL}
 122    };
 123    int i;
 124    NYD2_ENTER;
 125
 126    for(i = 0; UICMP(z, i, <, n_NELEM(maps)); ++i)
 127       if(!strcmp(maps[i].mode, mode)){
 128          *omode = maps[i].omode;
 129          i = 0;
 130          goto jleave;
 131       }
 132
 133    DBG( n_alert(_("Internal error: bad stdio open mode %s"), mode); )
 134    n_err_no = n_ERR_INVAL;
 135    *omode = 0; /* (silence CC) */
 136    i = -1;
 137 jleave:
 138    NYD2_LEAVE;
 139    return i;
 140 }
 141
 142 static void
 143 register_file(FILE *fp, int omode, int pid, int flags,
 144    char const *realfile, long offset, char const *save_cmd,
 145    struct termios *tiosp, n_sighdl_t osigint)
 146 {
 147    struct fp *fpp;
 148    NYD_ENTER;
 149
 150    assert(!(flags & FP_UNLINK) || realfile != NULL);
 151    assert(!(flags & FP_TERMIOS) || tiosp != NULL);
 152
 153    fpp = smalloc(sizeof *fpp);
 154    fpp->fp = fp;
 155    fpp->omode = omode;
 156    fpp->pid = pid;
 157    fpp->link = fp_head;
 158    fpp->flags = flags;
 159    fpp->realfile = (realfile != NULL) ? sstrdup(realfile) : NULL;
 160    fpp->save_cmd = (save_cmd != NULL) ? sstrdup(save_cmd) : NULL;
 161    fpp->fp_tios = tiosp;
 162    fpp->fp_osigint = osigint;
 163    fpp->offset = offset;
 164    fp_head = fpp;
 165    NYD_LEAVE;
 166 }
 167
 168 static enum okay
 169 _file_save(struct fp *fpp)
 170 {
 171    char const *cmd[3];
 172    int outfd;
 173    enum okay rv;
 174    NYD_ENTER;
 175
 176    if (fpp->omode == O_RDONLY) {
 177       rv = OKAY;
 178       goto jleave;
 179    }
 180    rv = STOP;
 181
 182    fflush(fpp->fp);
 183    clearerr(fpp->fp);
 184
 185    /* Ensure the I/O library doesn't optimize the fseek(3) away! */
 186    if(!n_real_seek(fpp->fp, fpp->offset, SEEK_SET)){
 187       outfd = n_err_no;
 188       n_err(_("Fatal: cannot restore file position and save %s: %s\n"),
 189          n_shexp_quote_cp(fpp->realfile, FAL0), n_err_to_doc(outfd));
 190       goto jleave;
 191    }
 192
 193 #ifdef HAVE_IMAP
 194    if ((fpp->flags & FP_MASK) == FP_IMAP) {
 195       rv = imap_append(fpp->realfile, fpp->fp, fpp->offset);
 196       goto jleave;
 197    }
 198 #endif
 199
 200    if ((fpp->flags & FP_MASK) == FP_MAILDIR) {
 201       rv = maildir_append(fpp->realfile, fpp->fp, fpp->offset);
 202       goto jleave;
 203    }
 204
 205    outfd = open(fpp->realfile,
 206          ((fpp->omode | O_CREAT | (fpp->omode & O_APPEND ? 0 : O_TRUNC) |
 207             n_O_NOXY_BITS) & ~O_EXCL), 0666);
 208    if (outfd == -1) {
 209       outfd = n_err_no;
 210       n_err(_("Fatal: cannot create %s: %s\n"),
 211          n_shexp_quote_cp(fpp->realfile, FAL0), n_err_to_doc(outfd));
 212       goto jleave;
 213    }
 214
 215    cmd[2] = NULL;
 216    switch(fpp->flags & FP_MASK){
 217    case FP_HOOK:
 218       if(n_poption & n_PO_D_V)
 219          n_err(_("Using `filetype' handler %s to save %s\n"),
 220             n_shexp_quote_cp(fpp->save_cmd, FAL0),
 221             n_shexp_quote_cp(fpp->realfile, FAL0));
 222       cmd[0] = ok_vlook(SHELL);
 223       cmd[1] = "-c";
 224       cmd[2] = fpp->save_cmd;
 225       break;
 226    default:
 227       cmd[0] = "cat";
 228       cmd[1] = NULL;
 229       break;
 230    }
 231    if (n_child_run(cmd[0], 0, fileno(fpp->fp), outfd,
 232          cmd[1], cmd[2], NULL, NULL, NULL) >= 0)
 233       rv = OKAY;
 234
 235    close(outfd);
 236 jleave:
 237    NYD_LEAVE;
 238    return rv;
 239 }
 240
 241 static int
 242 a_popen_file_load(int flags, int infd, int outfd, char const *load_cmd){
 243    char const *cmd[3];
 244    int rv;
 245    NYD2_ENTER;
 246
 247    cmd[2] = NULL;
 248    switch(flags & FP_MASK){
 249    case FP_IMAP:
 250    case FP_MAILDIR:
 251       rv = 0;
 252       goto jleave;
 253    case FP_HOOK:
 254       cmd[0] = ok_vlook(SHELL);
 255       cmd[1] = "-c";
 256       cmd[2] = load_cmd;
 257       break;
 258    default:
 259       cmd[0] = "cat";
 260       cmd[1] = NULL;
 261       break;
 262    }
 263
 264    rv = n_child_run(cmd[0], 0, infd, outfd, cmd[1], cmd[2], NULL, NULL, NULL);
 265 jleave:
 266    NYD2_LEAVE;
 267    return rv;
 268 }
 269
 270 static enum okay
 271 unregister_file(FILE *fp, struct termios **tiosp, n_sighdl_t *osigint)
 272 {
 273    struct fp **pp, *p;
 274    enum okay rv = OKAY;
 275    NYD_ENTER;
 276
 277    if (tiosp)
 278       *tiosp = NULL;
 279
 280    for (pp = &fp_head; (p = *pp) != NULL; pp = &p->link)
 281       if (p->fp == fp) {
 282          switch (p->flags & FP_MASK) {
 283          case FP_RAW:
 284          case FP_PIPE:
 285             break;
 286          default:
 287             rv = _file_save(p);
 288             break;
 289          }
 290          if ((p->flags & FP_UNLINK) && unlink(p->realfile))
 291             rv = STOP;
 292
 293          *pp = p->link;
 294          if (p->save_cmd != NULL)
 295             free(p->save_cmd);
 296          if (p->realfile != NULL)
 297             free(p->realfile);
 298          if (p->flags & FP_TERMIOS) {
 299             if (tiosp != NULL) {
 300                *tiosp = p->fp_tios;
 301                *osigint = p->fp_osigint;
 302             } else
 303                free(p->fp_tios);
 304          }
 305          free(p);
 306          goto jleave;
 307       }
 308    DBGOR(n_panic, n_alert)(_("Invalid file pointer"));
 309    rv = STOP;
 310 jleave:
 311    NYD_LEAVE;
 312    return rv;
 313 }
 314
 315 static int
 316 file_pid(FILE *fp)
 317 {
 318    int rv;
 319    struct fp *p;
 320    NYD2_ENTER;
 321
 322    rv = -1;
 323    for (p = fp_head; p; p = p->link)
 324       if (p->fp == fp) {
 325          rv = p->pid;
 326          break;
 327       }
 328    NYD2_LEAVE;
 329    return rv;
 330 }
 331
 332 static void
 333 a_popen_jobsigs_up(void){
 334    sigset_t nset, oset;
 335    NYD2_ENTER;
 336
 337    sigfillset(&nset);
 338
 339    sigprocmask(SIG_BLOCK, &nset, &oset);
 340    a_popen_otstp = safe_signal(SIGTSTP, &a_popen_jobsig);
 341    a_popen_ottin = safe_signal(SIGTTIN, &a_popen_jobsig);
 342    a_popen_ottou = safe_signal(SIGTTOU, &a_popen_jobsig);
 343
 344    /* This assumes oset contains nothing but SIGCHLD, so to say */
 345    sigdelset(&oset, SIGTSTP);
 346    sigdelset(&oset, SIGTTIN);
 347    sigdelset(&oset, SIGTTOU);
 348    sigprocmask(SIG_SETMASK, &oset, NULL);
 349    NYD2_LEAVE;
 350 }
 351
 352 static void
 353 a_popen_jobsigs_down(void){
 354    sigset_t nset, oset;
 355    NYD2_ENTER;
 356
 357    sigfillset(&nset);
 358
 359    sigprocmask(SIG_BLOCK, &nset, &oset);
 360    safe_signal(SIGTSTP, a_popen_otstp);
 361    safe_signal(SIGTTIN, a_popen_ottin);
 362    safe_signal(SIGTTOU, a_popen_ottou);
 363
 364    sigaddset(&oset, SIGTSTP);
 365    sigaddset(&oset, SIGTTIN);
 366    sigaddset(&oset, SIGTTOU);
 367    sigprocmask(SIG_SETMASK, &oset, NULL);
 368    NYD2_LEAVE;
 369 }
 370
 371 static void
 372 a_popen_jobsig(int sig){
 373    sighandler_type oldact;
 374    sigset_t nset;
 375    bool_t hadsig;
 376    NYD_X; /* Signal handler */
 377
 378    hadsig = (a_popen_hadsig != 0);
 379    a_popen_hadsig = 1;
 380    if(!hadsig)
 381       n_TERMCAP_SUSPEND(TRU1);
 382
 383    oldact = safe_signal(sig, SIG_DFL);
 384
 385    sigemptyset(&nset);
 386    sigaddset(&nset, sig);
 387    sigprocmask(SIG_UNBLOCK, &nset, NULL);
 388    n_raise(sig);
 389    sigprocmask(SIG_BLOCK, &nset, NULL);
 390
 391    safe_signal(sig, oldact);
 392 }
 393
 394 static void
 395 a_popen_sigchld(int signo){
 396    pid_t pid;
 397    int status;
 398    struct child *cp;
 399    NYD_X; /* Signal handler */
 400    n_UNUSED(signo);
 401
 402    for (;;) {
 403       pid = waitpid(-1, &status, WNOHANG);
 404       if (pid <= 0) {
 405          if (pid == -1 && n_err_no == n_ERR_INTR)
 406             continue;
 407          break;
 408       }
 409
 410       if ((cp = a_popen_child_find(pid, FAL0)) != NULL) {
 411          cp->done = 1;
 412          if (cp->free)
 413             cp->pid = -1; /* XXX Was _delchild(cp);# */
 414          else {
 415             cp->status = status;
 416          }
 417       }
 418    }
 419 }
 420
 421 static struct child *
 422 a_popen_child_find(int pid, bool_t create){
 423    struct child **cpp, *cp;
 424    NYD2_ENTER;
 425
 426    for(cpp = &_popen_child; (cp = *cpp) != NULL && cp->pid != pid;
 427          cpp = &(*cpp)->link)
 428       ;
 429
 430    if(cp == NULL && create)
 431       (*cpp = cp = scalloc(1, sizeof *cp))->pid = pid;
 432    NYD2_LEAVE;
 433    return cp;
 434 }
 435
 436 static void
 437 a_popen_child_del(struct child *cp){
 438    struct child **cpp;
 439    NYD2_ENTER;
 440
 441    cpp = &_popen_child;
 442
 443    for(;;){
 444       if(*cpp == cp){
 445          *cpp = cp->link;
 446          free(cp);
 447          break;
 448       }
 449       if(*(cpp = &(*cpp)->link) == NULL){
 450          DBG( n_err("! a_popen_child_del(): implementation error\n"); )
 451          break;
 452       }
 453    }
 454    NYD2_LEAVE;
 455 }
 456
 457 FL void
 458 n_child_manager_start(void)
 459 {
 460    struct sigaction nact, oact;
 461    NYD_ENTER;
 462
 463    nact.sa_handler = &a_popen_sigchld;
 464    sigemptyset(&nact.sa_mask);
 465    nact.sa_flags = SA_RESTART
 466 #ifdef SA_NOCLDSTOP
 467          | SA_NOCLDSTOP
 468 #endif
 469          ;
 470    if (sigaction(SIGCHLD, &nact, &oact) != 0)
 471       n_panic(_("Cannot install signal handler for child process management"));
 472    NYD_LEAVE;
 473 }
 474
 475 FL FILE *
 476 safe_fopen(char const *file, char const *oflags, int *xflags)
 477 {
 478    int osflags, fd;
 479    FILE *fp = NULL;
 480    NYD2_ENTER; /* (only for Fopen() and once in go.c) */
 481
 482    if (a_popen_scan_mode(oflags, &osflags) < 0)
 483       goto jleave;
 484    osflags |= _O_CLOEXEC;
 485    if (xflags != NULL)
 486       *xflags = osflags;
 487
 488    if ((fd = open(file, osflags, 0666)) == -1)
 489       goto jleave;
 490    _CLOEXEC_SET(fd);
 491
 492    fp = fdopen(fd, oflags);
 493 jleave:
 494    NYD2_LEAVE;
 495    return fp;
 496 }
 497
 498 FL FILE *
 499 Fopen(char const *file, char const *oflags)
 500 {
 501    FILE *fp;
 502    int osflags;
 503    NYD_ENTER;
 504
 505    if ((fp = safe_fopen(file, oflags, &osflags)) != NULL)
 506       register_file(fp, osflags, 0, FP_RAW, NULL, 0L, NULL, NULL,NULL);
 507    NYD_LEAVE;
 508    return fp;
 509 }
 510
 511 FL FILE *
 512 Fdopen(int fd, char const *oflags, bool_t nocloexec)
 513 {
 514    FILE *fp;
 515    int osflags;
 516    NYD_ENTER;
 517
 518    a_popen_scan_mode(oflags, &osflags);
 519    if (!nocloexec)
 520       osflags |= _O_CLOEXEC; /* Ensured to be set by caller as documented! */
 521
 522    if ((fp = fdopen(fd, oflags)) != NULL)
 523       register_file(fp, osflags, 0, FP_RAW, NULL, 0L, NULL, NULL,NULL);
 524    NYD_LEAVE;
 525    return fp;
 526 }
 527
 528 FL int
 529 Fclose(FILE *fp)
 530 {
 531    int i = 0;
 532    NYD_ENTER;
 533
 534    if (unregister_file(fp, NULL, NULL) == OKAY)
 535       i |= 1;
 536    if (fclose(fp) == 0)
 537       i |= 2;
 538    NYD_LEAVE;
 539    return (i == 3 ? 0 : EOF);
 540 }
 541
 542 FL FILE *
 543 n_fopen_any(char const *file, char const *oflags, /* TODO should take flags */
 544       enum n_fopen_state *fs_or_null){ /* TODO as bits, return state */
 545    /* TODO Support file locking upon open time */
 546    long offset;
 547    enum protocol p;
 548    enum oflags rof;
 549    int osflags, flags, omode, infd;
 550    char const *cload, *csave;
 551    enum n_fopen_state fs;
 552    FILE *rv;
 553    NYD_ENTER;
 554
 555    rv = NULL;
 556    fs = n_FOPEN_STATE_NONE;
 557    cload = csave = NULL;
 558
 559    if(a_popen_scan_mode(oflags, &osflags) < 0)
 560       goto jleave;
 561
 562    flags = 0;
 563    rof = OF_RDWR | OF_UNLINK;
 564    if(osflags & O_APPEND)
 565       rof |= OF_APPEND;
 566    omode = (osflags == O_RDONLY) ? R_OK : R_OK | W_OK;
 567
 568    /* We don't want to find mbox.bz2 when doing "copy * mbox", but only for
 569     * "file mbox", so don't try hooks when writing */
 570    p = which_protocol(csave = file, TRU1, ((omode & W_OK) == 0), &file);
 571    fs = (enum n_fopen_state)p;
 572    switch(p){
 573    default:
 574       goto jleave;
 575    case n_PROTO_IMAP:
 576 #ifdef HAVE_IMAP
 577       file = csave;
 578       flags |= FP_IMAP;
 579       osflags = O_RDWR | O_APPEND | O_CREAT | n_O_NOXY_BITS;
 580       infd = -1;
 581       break;
 582 #else
 583       n_err_no = n_ERR_OPNOTSUPP;
 584       goto jleave;
 585 #endif
 586    case n_PROTO_MAILDIR:
 587       if(fs_or_null != NULL && !access(file, F_OK))
 588          fs |= n_FOPEN_STATE_EXISTS;
 589       flags |= FP_MAILDIR;
 590       osflags = O_RDWR | O_APPEND | O_CREAT | n_O_NOXY_BITS;
 591       infd = -1;
 592       break;
 593    case n_PROTO_FILE:{
 594       struct n_file_type ft;
 595
 596       if(!(osflags & O_EXCL) && fs_or_null != NULL && !access(file, F_OK))
 597          fs |= n_FOPEN_STATE_EXISTS;
 598
 599       if(n_filetype_exists(&ft, file)){
 600          flags |= FP_HOOK;
 601          cload = ft.ft_load_dat;
 602          csave = ft.ft_save_dat;
 603          /* Cause truncation for compressor/hook output files */
 604          osflags &= ~O_APPEND;
 605          rof &= ~OF_APPEND;
 606          if((infd = open(file, (omode & W_OK ? O_RDWR : O_RDONLY))) != -1){
 607             fs |= n_FOPEN_STATE_EXISTS;
 608             if(n_poption & n_PO_D_V)
 609                n_err(_("Using `filetype' handler %s to load %s\n"),
 610                   n_shexp_quote_cp(cload, FAL0), n_shexp_quote_cp(file, FAL0));
 611          }else if(!(osflags & O_CREAT) || n_err_no != n_ERR_NOENT)
 612             goto jleave;
 613       }else{
 614          /*flags |= FP_RAW;*/
 615          rv = Fopen(file, oflags);
 616          if((osflags & O_EXCL) && rv == NULL)
 617             fs |= n_FOPEN_STATE_EXISTS;
 618          goto jleave;
 619       }
 620       }break;
 621    }
 622
 623    /* Note rv is not yet register_file()d, fclose() it in error path! */
 624    if((rv = Ftmp(NULL, "fopenany", rof)) == NULL){
 625       n_perr(_("tmpfile"), 0);
 626       goto jerr;
 627    }
 628
 629    if(flags & (FP_IMAP | FP_MAILDIR))
 630       ;
 631    else if(infd >= 0){
 632       if(a_popen_file_load(flags, infd, fileno(rv), cload) < 0){
 633 jerr:
 634          if(rv != NULL)
 635             fclose(rv);
 636          rv = NULL;
 637          if(infd >= 0)
 638             close(infd);
 639          goto jleave;
 640       }
 641    }else{
 642       if((infd = creat(file, 0666)) == -1){
 643          fclose(rv);
 644          rv = NULL;
 645          goto jleave;
 646       }
 647    }
 648
 649    if(infd >= 0)
 650       close(infd);
 651    fflush(rv);
 652
 653    if(!(osflags & O_APPEND))
 654       rewind(rv);
 655    if((offset = ftell(rv)) == -1){
 656       Fclose(rv);
 657       rv = NULL;
 658       goto jleave;
 659    }
 660
 661    register_file(rv, osflags, 0, flags, file, offset, csave, NULL,NULL);
 662 jleave:
 663    if(fs_or_null != NULL)
 664       *fs_or_null = fs;
 665    NYD_LEAVE;
 666    return rv;
 667 }
 668
 669 FL FILE *
 670 Ftmp(char **fn, char const *namehint, enum oflags oflags)
 671 {
 672    /* The 8 is arbitrary but leaves room for a six character suffix (the
 673     * POSIX minimum path length is 14, though we don't check that XXX).
 674     * 8 should be more than sufficient given that we use base64url encoding
 675     * for our random string */
 676    enum {_RANDCHARS = 8u};
 677
 678    char *cp_base, *cp;
 679    size_t maxname, xlen, i;
 680    char const *tmpdir;
 681    int osoflags, fd, e;
 682    bool_t relesigs;
 683    FILE *fp;
 684    NYD_ENTER;
 685
 686    assert(namehint != NULL);
 687    assert((oflags & OF_WRONLY) || (oflags & OF_RDWR));
 688    assert(!(oflags & OF_RDONLY));
 689    assert(!(oflags & OF_REGISTER_UNLINK) || (oflags & OF_REGISTER));
 690
 691    fp = NULL;
 692    relesigs = FAL0;
 693    e = 0;
 694    tmpdir = ok_vlook(TMPDIR);
 695    maxname = NAME_MAX;
 696 #ifdef HAVE_PATHCONF
 697    {  long pc;
 698
 699       if ((pc = pathconf(tmpdir, _PC_NAME_MAX)) != -1)
 700          maxname = (size_t)pc;
 701    }
 702 #endif
 703
 704    if ((oflags & OF_SUFFIX) && *namehint != '\0') {
 705       if ((xlen = strlen(namehint)) > maxname - _RANDCHARS) {
 706          n_err_no = n_ERR_NAMETOOLONG;
 707          goto jleave;
 708       }
 709    } else
 710       xlen = 0;
 711
 712    /* Prepare the template string once, then iterate over the random range */
 713    cp_base =
 714    cp = smalloc(strlen(tmpdir) + 1 + maxname +1);
 715    cp = sstpcpy(cp, tmpdir);
 716    *cp++ = '/';
 717    {
 718       char *x = sstpcpy(cp, VAL_UAGENT);
 719       *x++ = '-';
 720       if (!(oflags & OF_SUFFIX))
 721          x = sstpcpy(x, namehint);
 722
 723       i = PTR2SIZE(x - cp);
 724       if (i > maxname - xlen - _RANDCHARS) {
 725          size_t j = maxname - xlen - _RANDCHARS;
 726          x -= i - j;
 727       }
 728
 729       if ((oflags & OF_SUFFIX) && xlen > 0)
 730          memcpy(x + _RANDCHARS, namehint, xlen);
 731
 732       x[xlen + _RANDCHARS] = '\0';
 733       cp = x;
 734    }
 735
 736    osoflags = O_CREAT | O_EXCL | _O_CLOEXEC;
 737    osoflags |= (oflags & OF_WRONLY) ? O_WRONLY : O_RDWR;
 738    if (oflags & OF_APPEND)
 739       osoflags |= O_APPEND;
 740
 741    for(relesigs = TRU1, i = 0;; ++i){
 742       memcpy(cp, n_random_create_cp(_RANDCHARS, NULL), _RANDCHARS);
 743
 744       hold_all_sigs();
 745
 746       if((fd = open(cp_base, osoflags, 0600)) != -1){
 747          _CLOEXEC_SET(fd);
 748          break;
 749       }
 750       if(i >= FTMP_OPEN_TRIES){
 751          e = n_err_no;
 752          goto jfree;
 753       }
 754       rele_all_sigs();
 755    }
 756
 757    if (oflags & OF_REGISTER) {
 758       char const *osflags = (oflags & OF_RDWR ? "w+" : "w");
 759       int osflagbits;
 760
 761       a_popen_scan_mode(osflags, &osflagbits); /* TODO osoflags&xy ?!!? */
 762       if ((fp = fdopen(fd, osflags)) != NULL)
 763          register_file(fp, osflagbits | _O_CLOEXEC, 0,
 764             (FP_RAW | (oflags & OF_REGISTER_UNLINK ? FP_UNLINK : 0)),
 765             cp_base, 0L, NULL, NULL,NULL);
 766    } else
 767       fp = fdopen(fd, (oflags & OF_RDWR ? "w+" : "w"));
 768
 769    if (fp == NULL || (oflags & OF_UNLINK)) {
 770       e = n_err_no;
 771       unlink(cp_base);
 772       goto jfree;
 773    }
 774
 775    if (fn != NULL)
 776       *fn = cp_base;
 777    else
 778       free(cp_base);
 779 jleave:
 780    if (relesigs && (fp == NULL || !(oflags & OF_HOLDSIGS)))
 781       rele_all_sigs();
 782    if (fp == NULL)
 783       n_err_no = e;
 784    NYD_LEAVE;
 785    return fp;
 786 jfree:
 787    if ((cp = cp_base) != NULL)
 788       free(cp);
 789    goto jleave;
 790 }
 791
 792 FL void
 793 Ftmp_release(char **fn)
 794 {
 795    char *cp;
 796    NYD_ENTER;
 797
 798    cp = *fn;
 799    *fn = NULL;
 800    if (cp != NULL) {
 801       unlink(cp);
 802       rele_all_sigs();
 803       free(cp);
 804    }
 805    NYD_LEAVE;
 806 }
 807
 808 FL void
 809 Ftmp_free(char **fn) /* TODO DROP: OF_REGISTER_FREEPATH! */
 810 {
 811    char *cp;
 812    NYD_ENTER;
 813
 814    cp = *fn;
 815    *fn = NULL;
 816    if (cp != NULL)
 817       free(cp);
 818    NYD_LEAVE;
 819 }
 820
 821 FL bool_t
 822 pipe_cloexec(int fd[2]){
 823    bool_t rv;
 824    NYD_ENTER;
 825
 826    rv = FAL0;
 827
 828 #ifdef HAVE_PIPE2
 829    if(pipe2(fd, O_CLOEXEC) != -1)
 830       rv = TRU1;
 831 #else
 832    if(pipe(fd) != -1){
 833       n_fd_cloexec_set(fd[0]);
 834       n_fd_cloexec_set(fd[1]);
 835       rv = TRU1;
 836    }
 837 #endif
 838    NYD_LEAVE;
 839    return rv;
 840 }
 841
 842 FL FILE *
 843 Popen(char const *cmd, char const *mode, char const *sh,
 844    char const **env_addon, int newfd1)
 845 {
 846    int p[2], myside, hisside, fd0, fd1, pid;
 847    sigset_t nset;
 848    char mod[2];
 849    n_sighdl_t osigint;
 850    struct termios *tiosp;
 851    FILE *rv;
 852    NYD_ENTER;
 853
 854    /* First clean up child structures */
 855    /* C99 */{
 856       struct child **cpp, *cp;
 857
 858       hold_all_sigs();
 859       for (cpp = &_popen_child; *cpp != NULL;) {
 860          if ((*cpp)->pid == -1) {
 861             cp = *cpp;
 862             *cpp = cp->link;
 863             free(cp);
 864          } else
 865             cpp = &(*cpp)->link;
 866       }
 867       rele_all_sigs();
 868    }
 869
 870    rv = NULL;
 871    tiosp = NULL;
 872    n_UNINIT(osigint, SIG_ERR);
 873    mod[0] = '0', mod[1] = '\0';
 874
 875    if (!pipe_cloexec(p))
 876       goto jleave;
 877
 878    if (*mode == 'r') {
 879       myside = p[READ];
 880       fd0 = n_CHILD_FD_PASS;
 881       hisside = fd1 = p[WRITE];
 882       mod[0] = *mode;
 883    } else if (*mode == 'W') {
 884       myside = p[WRITE];
 885       hisside = fd0 = p[READ];
 886       fd1 = newfd1;
 887       mod[0] = 'w';
 888    } else {
 889       myside = p[WRITE];
 890       hisside = fd0 = p[READ];
 891       fd1 = n_CHILD_FD_PASS;
 892       mod[0] = 'w';
 893    }
 894
 895    /* In interactive mode both STDIN and STDOUT point to the terminal.  If we
 896     * pass through the TTY restore terminal attributes after pipe returns.
 897     * XXX It shouldn't matter which FD we actually use in this case */
 898    if ((n_psonce & n_PSO_INTERACTIVE) && (fd0 == n_CHILD_FD_PASS ||
 899          fd1 == n_CHILD_FD_PASS)) {
 900       osigint = n_signal(SIGINT, SIG_IGN);
 901       tiosp = smalloc(sizeof *tiosp);
 902       tcgetattr(STDIN_FILENO, tiosp);
 903       n_TERMCAP_SUSPEND(TRU1);
 904    }
 905
 906    sigemptyset(&nset);
 907
 908    if (cmd == (char*)-1) {
 909       if ((pid = n_child_fork()) == -1)
 910          n_perr(_("fork"), 0);
 911       else if (pid == 0) {
 912          union {char const *ccp; int (*ptf)(void); int es;} u;
 913          n_child_prepare(&nset, fd0, fd1);
 914          close(p[READ]);
 915          close(p[WRITE]);
 916          /* TODO should close all other open FDs except stds and reset memory */
 917          /* Standard I/O drives me insane!  All we need is a sync operation
 918           * that causes n_stdin to forget about any read buffer it may have.
 919           * We cannot use fflush(3), this works with Musl and Solaris, but not
 920           * with GlibC.  (For at least pipes.)  We cannot use fdreopen(),
 921           * because this function does not exist!  Luckily (!!!) we only use
 922           * n_stdin not stdin in our child, otherwise all bets were off!
 923           * TODO (Unless we would fiddle around with FILE* directly:
 924           * TODO #ifdef __GLIBC__
 925           * TODO   n_stdin->_IO_read_ptr = n_stdin->_IO_read_end;
 926           * TODO #elif *BSD*
 927           * TODO   n_stdin->_r = 0;
 928           * TODO #elif n_OS_SOLARIS || n_OS_SUNOS
 929           * TODO   n_stdin->_cnt = 0;
 930           * TODO #endif
 931           * TODO ) which should have additional config test for sure! */
 932          n_stdin = fdopen(STDIN_FILENO, "r");
 933          /*n_stdout = fdopen(STDOUT_FILENO, "w");*/
 934          /*n_stderr = fdopen(STDERR_FILENO, "w");*/
 935          u.ccp = sh;
 936          u.es = (*u.ptf)();
 937          /*fflush(NULL);*/
 938          _exit(u.es);
 939       }
 940    } else if (sh == NULL) {
 941       pid = n_child_start(cmd, &nset, fd0, fd1, NULL, NULL, NULL, env_addon);
 942    } else {
 943       pid = n_child_start(sh, &nset, fd0, fd1, "-c", cmd, NULL, env_addon);
 944    }
 945    if (pid < 0) {
 946       close(p[READ]);
 947       close(p[WRITE]);
 948       goto jleave;
 949    }
 950    close(hisside);
 951    if ((rv = fdopen(myside, mod)) != NULL)
 952       register_file(rv, 0, pid,
 953          (tiosp == NULL ? FP_PIPE : FP_PIPE | FP_TERMIOS),
 954          NULL, 0L, NULL, tiosp, osigint);
 955    else
 956       close(myside);
 957 jleave:
 958    if(rv == NULL && tiosp != NULL){
 959       n_TERMCAP_RESUME(TRU1);
 960       tcsetattr(STDIN_FILENO, TCSAFLUSH, tiosp);
 961       n_free(tiosp);
 962       n_signal(SIGINT, osigint);
 963    }
 964    NYD_LEAVE;
 965    return rv;
 966 }
 967
 968 FL bool_t
 969 Pclose(FILE *ptr, bool_t dowait)
 970 {
 971    n_sighdl_t osigint;
 972    struct termios *tiosp;
 973    int pid;
 974    bool_t rv = FAL0;
 975    NYD_ENTER;
 976
 977    pid = file_pid(ptr);
 978    if(pid < 0)
 979       goto jleave;
 980
 981    unregister_file(ptr, &tiosp, &osigint);
 982    fclose(ptr);
 983
 984    if(dowait){
 985       hold_all_sigs();
 986       rv = n_child_wait(pid, NULL);
 987       if(tiosp != NULL){
 988          n_TERMCAP_RESUME(TRU1);
 989          tcsetattr(STDIN_FILENO, TCSAFLUSH, tiosp);
 990          n_signal(SIGINT, osigint);
 991       }
 992       rele_all_sigs();
 993    }else{
 994       n_child_free(pid);
 995       rv = TRU1;
 996    }
 997
 998    if(tiosp != NULL)
 999       free(tiosp);
1000 jleave:
1001    NYD_LEAVE;
1002    return rv;
1003 }
1004
1005 VL int
1006 n_psignal(FILE *fp, int sig){
1007    int rv;
1008    NYD2_ENTER;
1009
1010    if((rv = file_pid(fp)) >= 0){
1011       struct child *cp;
1012
1013       if((cp = a_popen_child_find(rv, FAL0)) != NULL){
1014          if((rv = kill(rv, sig)) != 0)
1015             rv = n_err_no;
1016       }else
1017          rv = -1;
1018    }
1019    NYD2_LEAVE;
1020    return rv;
1021 }
1022
1023 FL FILE *
1024 n_pager_open(void)
1025 {
1026    char const *env_add[2], *pager;
1027    FILE *rv;
1028    NYD_ENTER;
1029
1030    assert(n_psonce & n_PSO_INTERACTIVE);
1031
1032    pager = n_pager_get(env_add + 0);
1033    env_add[1] = NULL;
1034
1035    if ((rv = Popen(pager, "w", NULL, env_add, n_CHILD_FD_PASS)) == NULL)
1036       n_perr(pager, 0);
1037    NYD_LEAVE;
1038    return rv;
1039 }
1040
1041 FL bool_t
1042 n_pager_close(FILE *fp)
1043 {
1044    sighandler_type sh;
1045    bool_t rv;
1046    NYD_ENTER;
1047
1048    sh = safe_signal(SIGPIPE, SIG_IGN);
1049    rv = Pclose(fp, TRU1);
1050    safe_signal(SIGPIPE, sh);
1051    NYD_LEAVE;
1052    return rv;
1053 }
1054
1055 FL void
1056 close_all_files(void)
1057 {
1058    NYD_ENTER;
1059    while (fp_head != NULL)
1060       if ((fp_head->flags & FP_MASK) == FP_PIPE)
1061          Pclose(fp_head->fp, TRU1);
1062       else
1063          Fclose(fp_head->fp);
1064    NYD_LEAVE;
1065 }
1066
1067 /* TODO The entire n_child_ series should be replaced with an object, but
1068  * TODO at least have carrier arguments.  We anyway need a command manager
1069  * TODO that keeps track and knows how to handle job control ++++! */
1070
1071 FL int
1072 n_child_run(char const *cmd, sigset_t *mask_or_null, int infd, int outfd,
1073    char const *a0_or_null, char const *a1_or_null, char const *a2_or_null,
1074    char const **env_addon_or_null, int *wait_status_or_null)
1075 {
1076    sigset_t nset, oset;
1077    sighandler_type soldint;
1078    int rv, e;
1079    enum {a_NONE = 0, a_INTIGN = 1<<0, a_TTY = 1<<1} f;
1080    NYD_ENTER;
1081
1082    f = a_NONE;
1083    n_UNINIT(soldint, SIG_ERR);
1084
1085    /* TODO Of course this is a joke given that during a "p*" the PAGER may
1086     * TODO be up and running while we play around like this... but i guess
1087     * TODO this can't be helped at all unless we perform complete and true
1088     * TODO process group separation and ensure we don't deadlock us out
1089     * TODO via TTY jobcontrol signal storms (could this really happen?).
1090     * TODO Or have a built-in pager.  Or query any necessity BEFORE we start
1091     * TODO any action, and shall we find we need to run programs dump it
1092     * TODO all into a temporary file which is then passed through to the
1093     * TODO PAGER.  Ugh.  That still won't help for "needsterminal" anyway */
1094    if(infd == n_CHILD_FD_PASS || outfd == n_CHILD_FD_PASS){
1095       soldint = safe_signal(SIGINT, SIG_IGN);
1096       f = a_INTIGN;
1097
1098       if(n_psonce & n_PSO_INTERACTIVE){
1099          f |= a_TTY;
1100          tcgetattr((n_psonce & n_PSO_TTYIN ? STDIN_FILENO : STDOUT_FILENO),
1101             &a_popen_tios);
1102          n_TERMCAP_SUSPEND(FAL0);
1103          sigfillset(&nset);
1104          sigdelset(&nset, SIGCHLD);
1105          sigdelset(&nset, SIGINT);
1106          /* sigdelset(&nset, SIGPIPE); TODO would need a handler */
1107          sigprocmask(SIG_BLOCK, &nset, &oset);
1108          a_popen_hadsig = 0;
1109          a_popen_jobsigs_up();
1110       }
1111    }
1112
1113    if((rv = n_child_start(cmd, mask_or_null, infd, outfd, a0_or_null,
1114          a1_or_null, a2_or_null, env_addon_or_null)) < 0){
1115       e = n_err_no;
1116       rv = -1;
1117    }else{
1118       int ws;
1119
1120       e = 0;
1121       if(n_child_wait(rv, &ws))
1122          rv = 0;
1123       else if(wait_status_or_null == NULL || !WIFEXITED(ws)){
1124          if(ok_blook(bsdcompat) || ok_blook(bsdmsgs))
1125             n_err(_("Fatal error in process\n"));
1126          e = n_ERR_CHILD;
1127          rv = -1;
1128       }
1129       if(wait_status_or_null != NULL)
1130          *wait_status_or_null = ws;
1131    }
1132
1133    if(f & a_TTY){
1134       a_popen_jobsigs_down();
1135       n_TERMCAP_RESUME(a_popen_hadsig ? TRU1 : FAL0);
1136       tcsetattr(((n_psonce & n_PSO_TTYIN) ? STDIN_FILENO : STDOUT_FILENO),
1137          ((n_psonce & n_PSO_TTYIN) ? TCSAFLUSH : TCSADRAIN), &a_popen_tios);
1138       sigprocmask(SIG_SETMASK, &oset, NULL);
1139    }
1140    if(f & a_INTIGN){
1141       if(soldint != SIG_IGN)
1142          safe_signal(SIGINT, soldint);
1143    }
1144
1145    if(e != 0)
1146       n_err_no = e;
1147    NYD_LEAVE;
1148    return rv;
1149 }
1150
1151 FL int
1152 n_child_start(char const *cmd, sigset_t *mask_or_null, int infd, int outfd,
1153    char const *a0_or_null, char const *a1_or_null, char const *a2_or_null,
1154    char const **env_addon_or_null)
1155 {
1156    int rv, e;
1157    NYD_ENTER;
1158
1159    if ((rv = n_child_fork()) == -1) {
1160       e = n_err_no;
1161       n_perr(_("fork"), 0);
1162       n_err_no = e;
1163       rv = -1;
1164    } else if (rv == 0) {
1165       char *argv[128];
1166       int i;
1167
1168       if (env_addon_or_null != NULL) {
1169          extern char **environ;
1170          size_t ei, ei_orig, ai, ai_orig;
1171          char **env;
1172
1173          /* TODO note we don't check the POSIX limit:
1174           * the total space used to store the environment and the arguments to
1175           * the process is limited to {ARG_MAX} bytes */
1176          for (ei = 0; environ[ei] != NULL; ++ei)
1177             ;
1178          ei_orig = ei;
1179          for (ai = 0; env_addon_or_null[ai] != NULL; ++ai)
1180             ;
1181          ai_orig = ai;
1182          env = ac_alloc(sizeof(*env) * (ei + ai +1));
1183          memcpy(env, environ, sizeof(*env) * ei);
1184
1185          /* Replace all those keys that yet exist */
1186          while (ai-- > 0) {
1187             char const *ee, *kvs;
1188             size_t kl;
1189
1190             ee = env_addon_or_null[ai];
1191             kvs = strchr(ee, '=');
1192             assert(kvs != NULL);
1193             kl = PTR2SIZE(kvs - ee);
1194             assert(kl > 0);
1195             for (ei = ei_orig; ei-- > 0;) {
1196                char const *ekvs = strchr(env[ei], '=');
1197                if (ekvs != NULL && kl == PTR2SIZE(ekvs - env[ei]) &&
1198                      !memcmp(ee, env[ei], kl)) {
1199                   env[ei] = n_UNCONST(ee);
1200                   env_addon_or_null[ai] = NULL;
1201                   break;
1202                }
1203             }
1204          }
1205
1206          /* And append the rest */
1207          for (ei = ei_orig, ai = ai_orig; ai-- > 0;)
1208             if (env_addon_or_null[ai] != NULL)
1209                env[ei++] = n_UNCONST(env_addon_or_null[ai]);
1210
1211          env[ei] = NULL;
1212          environ = env;
1213       }
1214
1215       i = (int)getrawlist(TRU1, argv, n_NELEM(argv), cmd, strlen(cmd));
1216
1217       if ((argv[i++] = n_UNCONST(a0_or_null)) != NULL &&
1218             (argv[i++] = n_UNCONST(a1_or_null)) != NULL &&
1219             (argv[i++] = n_UNCONST(a2_or_null)) != NULL)
1220          argv[i] = NULL;
1221       n_child_prepare(mask_or_null, infd, outfd);
1222       execvp(argv[0], argv);
1223       perror(argv[0]);
1224       _exit(n_EXIT_ERR);
1225    }
1226    NYD_LEAVE;
1227    return rv;
1228 }
1229
1230 FL int
1231 n_child_fork(void){
1232    /* Strictly speaking we should do so in the waitpid(2) case too, but since
1233     * we explicitly waitpid(2) on the pid if just the structure exists, which
1234     * n_child_wait() does in the parent, all is fine */
1235 #if n_SIGSUSPEND_NOT_WAITPID
1236    sigset_t nset, oset;
1237 #endif
1238    struct child *cp;
1239    int pid;
1240    NYD2_ENTER;
1241
1242 #if n_SIGSUSPEND_NOT_WAITPID
1243    sigfillset(&nset);
1244    sigprocmask(SIG_BLOCK, &nset, &oset);
1245 #endif
1246
1247    cp = a_popen_child_find(0, TRU1);
1248
1249    if((cp->pid = pid = fork()) == -1){
1250       a_popen_child_del(cp);
1251       n_perr(_("fork"), 0);
1252    }
1253
1254 #if n_SIGSUSPEND_NOT_WAITPID
1255    sigprocmask(SIG_SETMASK, &oset, NULL);
1256 #endif
1257    NYD2_LEAVE;
1258    return pid;
1259 }
1260
1261 FL void
1262 n_child_prepare(sigset_t *nset_or_null, int infd, int outfd)
1263 {
1264    int i;
1265    sigset_t fset;
1266    NYD_ENTER;
1267
1268    /* All file descriptors other than 0, 1, and 2 are supposed to be cloexec */
1269    /* TODO WHAT IS WITH STDERR_FILENO DAMN? */
1270    if ((i = (infd == n_CHILD_FD_NULL)))
1271       infd = open(n_path_devnull, O_RDONLY);
1272    if (infd >= 0) {
1273       dup2(infd, STDIN_FILENO);
1274       if (i)
1275          close(infd);
1276    }
1277
1278    if ((i = (outfd == n_CHILD_FD_NULL)))
1279       outfd = open(n_path_devnull, O_WRONLY);
1280    if (outfd >= 0) {
1281       dup2(outfd, STDOUT_FILENO);
1282       if (i)
1283          close(outfd);
1284    }
1285
1286    if (nset_or_null != NULL) {
1287       for (i = 1; i < NSIG; ++i)
1288          if (sigismember(nset_or_null, i))
1289             safe_signal(i, SIG_IGN);
1290       if (!sigismember(nset_or_null, SIGINT))
1291          safe_signal(SIGINT, SIG_DFL);
1292    }
1293
1294    sigemptyset(&fset);
1295    sigprocmask(SIG_SETMASK, &fset, NULL);
1296    NYD_LEAVE;
1297 }
1298
1299 FL void
1300 n_child_free(int pid){
1301    sigset_t nset, oset;
1302    struct child *cp;
1303    NYD2_ENTER;
1304
1305    sigemptyset(&nset);
1306    sigaddset(&nset, SIGCHLD);
1307    sigprocmask(SIG_BLOCK, &nset, &oset);
1308
1309    if((cp = a_popen_child_find(pid, FAL0)) != NULL){
1310       if(cp->done)
1311          a_popen_child_del(cp);
1312       else
1313          cp->free = TRU1;
1314    }
1315
1316    sigprocmask(SIG_SETMASK, &oset, NULL);
1317    NYD2_LEAVE;
1318 }
1319
1320 FL bool_t
1321 n_child_wait(int pid, int *wait_status_or_null){
1322 #if !n_SIGSUSPEND_NOT_WAITPID
1323    sigset_t oset;
1324 #endif
1325    sigset_t nset;
1326    struct child *cp;
1327    int ws;
1328    bool_t rv;
1329    NYD_ENTER;
1330
1331 #if !n_SIGSUSPEND_NOT_WAITPID
1332    sigemptyset(&nset);
1333    sigaddset(&nset, SIGCHLD);
1334    sigprocmask(SIG_BLOCK, &nset, &oset);
1335 #endif
1336
1337    if((cp = a_popen_child_find(pid, FAL0)) != NULL){
1338 #if n_SIGSUSPEND_NOT_WAITPID
1339       sigfillset(&nset);
1340       sigdelset(&nset, SIGCHLD);
1341       while(!cp->done)
1342          sigsuspend(&nset); /* TODO we should allow more than SIGCHLD!! */
1343       ws = cp->status;
1344 #else
1345       waitpid(pid, &ws, 0);
1346 #endif
1347       a_popen_child_del(cp);
1348    }else
1349       ws = 0;
1350
1351 #if !n_SIGSUSPEND_NOT_WAITPID
1352    sigprocmask(SIG_SETMASK, &oset, NULL);
1353 #endif
1354
1355    if(wait_status_or_null != NULL)
1356       *wait_status_or_null = ws;
1357    rv = (WIFEXITED(ws) && WEXITSTATUS(ws) == 0);
1358    NYD_LEAVE;
1359    return rv;
1360 }
1361
1362 /* s-it-mode */