1 /*
   2  * CDDL HEADER START
   3  *
   4  * The contents of this file are subject to the terms of the
   5  * Common Development and Distribution License, Version 1.0 only
   6  * (the "License").  You may not use this file except in compliance
   7  * with the License.
   8  *
   9  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
  10  * or http://www.opensolaris.org/os/licensing.
  11  * See the License for the specific language governing permissions
  12  * and limitations under the License.
  13  *
  14  * When distributing Covered Code, include this CDDL HEADER in each
  15  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  16  * If applicable, add the following below this CDDL HEADER, with the
  17  * fields enclosed by brackets "[]" replaced with your own identifying
  18  * information: Portions Copyright [yyyy] [name of copyright owner]
  19  *
  20  * CDDL HEADER END
  21  */
  22 /*
  23  * Copyright 2003 Sun Microsystems, Inc.  All rights reserved.
  24  * Use is subject to license terms.
  25  */
  26 
  27 #pragma ident   "%Z%%M% %I%     %E% SMI"
  28 
  29 #include <stdio.h>
  30 #include <stdlib.h>
  31 #include <unistd.h>
  32 #include <fcntl.h>
  33 #include <ctype.h>
  34 #include <string.h>
  35 #include <signal.h>
  36 #include <errno.h>
  37 #include <sys/types.h>
  38 #include <sys/wait.h>
  39 #include <libproc.h>
  40 
  41 #define NOREAP_TIME 60          /* wait 60 seconds before allow a reap */
  42 
  43 static volatile int interrupt;
  44 static int Fflag;
  45 static char *command;
  46 
  47 static void
  48 intr(int sig)
  49 {
  50         interrupt = sig;
  51 }
  52 
  53 static int
  54 open_usage(pid_t pid, int *perr)
  55 {
  56         char path[64];
  57         struct stat64 st;
  58         int fd;
  59 
  60         (void) snprintf(path, sizeof (path), "/proc/%d/usage", (int)pid);
  61 
  62         /*
  63          * Attempt to open the usage file, and return the fd if we can
  64          * confirm this is a regular file provided by /proc.
  65          */
  66         if ((fd = open64(path, O_RDONLY)) >= 0) {
  67                 if (fstat64(fd, &st) != 0 || !S_ISREG(st.st_mode) ||
  68                     strcmp(st.st_fstype, "proc") != 0) {
  69                         (void) close(fd);
  70                         fd = -1;
  71                 }
  72         } else if (errno == EACCES || errno == EPERM)
  73                 *perr = G_PERM;
  74 
  75         return (fd);
  76 }
  77 
  78 static int
  79 proc_usage(pid_t pid, prusage_t *pup, int *perr)
  80 {
  81         int fd;
  82 
  83         *perr = G_NOPROC;
  84 
  85         if ((fd = open_usage(pid, perr)) != -1) {
  86                 if (read(fd, pup, sizeof (prusage_t)) == sizeof (prusage_t)) {
  87                         *perr = 0;
  88                         (void) close(fd);
  89                         return (0);
  90                 }
  91 
  92                 /*
  93                  * If the read failed, the process may have gone away.
  94                  */
  95                 (void) close(fd);
  96         }
  97         return (-1);
  98 }
  99 
 100 /*
 101  * Force the parent process (ppid) to wait for its child process (pid).
 102  */
 103 static int
 104 reap(char *arg, pid_t *reap_pid, int *exit_status)
 105 {
 106         struct ps_prochandle *Pr;
 107         siginfo_t siginfo;
 108         psinfo_t psinfo;
 109         prusage_t usage;
 110         pid_t pid, ppid;
 111         time_t elapsed;
 112         int gret;
 113 
 114         /*
 115          * get the specified pid and the psinfo struct
 116          */
 117         if ((pid = proc_arg_psinfo(arg, PR_ARG_PIDS, &psinfo, &gret)) == -1) {
 118                 (void) fprintf(stderr, "%s: cannot examine %s: %s\n",
 119                     command, arg, Pgrab_error(gret));
 120                 return (1);
 121         }
 122 
 123         if (psinfo.pr_nlwp != 0) {
 124                 (void) fprintf(stderr, "%s: process not defunct: %d\n",
 125                     command, (int)pid);
 126                 return (1);
 127         }
 128 
 129         *exit_status = psinfo.pr_wstat;
 130         *reap_pid = psinfo.pr_pid;
 131         ppid = psinfo.pr_ppid;
 132 
 133         if (ppid == 1) {
 134                 (void) fprintf(stderr, "%s: Failed to reap %d: the only "
 135                     "non-defunct ancestor is 'init'\n", command,
 136                     (int)pid);
 137                 return (1);
 138         }
 139 
 140         if (proc_usage(pid, &usage, &gret) == 0) {
 141                 elapsed = usage.pr_tstamp.tv_sec - usage.pr_term.tv_sec;
 142         } else {
 143                 (void) fprintf(stderr, "%s: cannot examine %d: %s\n",
 144                     command, (int)pid, Pgrab_error(gret));
 145                 return (1);
 146         }
 147 
 148         if ((Fflag == 0) && (elapsed < NOREAP_TIME)) {
 149                 (void) fprintf(stderr, "%s: unsafe to reap %d; it has been "
 150                     "defunct less than %d seconds\n", command, (int)pid,
 151                     NOREAP_TIME);
 152                 return (1);
 153         }
 154 
 155         if ((Pr = Pgrab(ppid, Fflag | PGRAB_NOSTOP, &gret)) == NULL) {
 156                 (void) fprintf(stderr, "%s: cannot examine %d: %s\n", command,
 157                     (int)ppid, Pgrab_error(gret));
 158                 return (1);
 159         }
 160 
 161         if ((Fflag == 0) && (Pstate(Pr) == PS_STOP)) {
 162                 Prelease(Pr, 0);
 163                 (void) fprintf(stderr, "%s: unsafe to reap %d; parent is "
 164                     "stopped and may reap status upon restart\n", command,
 165                     (int)pid);
 166                 return (1);
 167         }
 168 
 169         /*
 170          * Pstop() will fail if the process to be stopped has become a zombie.
 171          * This means that we can say with certainty that the child of this
 172          * process has not changed parents (i.e. been reparented to init) once
 173          * the Pstop() succeeds.
 174          */
 175         if (Pstop(Pr, 1000) != 0) {
 176                 Prelease(Pr, 0);
 177                 (void) fprintf(stderr, "%s: failed to stop %d: %s", command,
 178                     (int)ppid, strerror(errno));
 179                 return (1);
 180         }
 181 
 182         if (pr_waitid(Pr, P_PID, pid, &siginfo, WEXITED|WNOHANG) != 0) {
 183                 Prelease(Pr, 0);
 184                 (void) fprintf(stderr, "%s: waitid() in process %d failed: %s",
 185                     command, (int)ppid, strerror(errno));
 186                 return (1);
 187         }
 188 
 189         Prelease(Pr, 0);
 190         return (0);
 191 }
 192 
 193 static void
 194 print_exit_status(pid_t pid, int wstat)
 195 {
 196         (void) printf("%d: ", (int)pid);
 197         if (WIFSIGNALED(wstat)) {
 198                 char buf[SIG2STR_MAX];
 199                 int sig = WTERMSIG(wstat);
 200 
 201                 if (sig2str(sig, buf) == 0)
 202                         (void) printf("killed by signal %s", buf);
 203                 else
 204                         (void) printf("killed by signal %d", sig);
 205 
 206                 if (WCOREDUMP(wstat))
 207                         (void) printf(" (core dumped)");
 208         } else {
 209                 (void) printf("exited with status %d", WEXITSTATUS(wstat));
 210         }
 211         (void) printf("\n");
 212 }
 213 
 214 int
 215 main(int argc, char *argv[])
 216 {
 217         int retc = 0;
 218         int opt;
 219         int errflg = 0;
 220 
 221         if ((command = strrchr(argv[0], '/')) != NULL)
 222                 command++;
 223         else
 224                 command = argv[0];
 225 
 226         while ((opt = getopt(argc, argv, "F")) != EOF) {
 227                 switch (opt) {
 228                 case 'F':               /* force grabbing (no O_EXCL) */
 229                         Fflag = PGRAB_FORCE;
 230                         break;
 231                 default:
 232                         errflg = 1;
 233                         break;
 234                 }
 235         }
 236 
 237         argc -= optind;
 238         argv += optind;
 239 
 240         if (errflg || argc <= 0) {
 241                 (void) fprintf(stderr, "usage:  %s pid ...\n", command);
 242                 (void) fprintf(stderr, "  (Reap a defunct process by forcing "
 243                     "its parent to wait(2) for it)\n");
 244                 exit(2);
 245         }
 246 
 247         /* catch signals from terminal */
 248         if (sigset(SIGHUP, SIG_IGN) == SIG_DFL)
 249                 (void) sigset(SIGHUP, intr);
 250         if (sigset(SIGINT, SIG_IGN) == SIG_DFL)
 251                 (void) sigset(SIGINT, intr);
 252         if (sigset(SIGPIPE, SIG_IGN) == SIG_DFL)
 253                 (void) sigset(SIGPIPE, intr);
 254         if (sigset(SIGQUIT, SIG_IGN) == SIG_DFL)
 255                 (void) sigset(SIGQUIT, intr);
 256         (void) sigset(SIGTERM, intr);
 257 
 258         while (--argc >= 0 && !interrupt) {
 259                 pid_t pid;
 260                 int wstat, r;
 261 
 262                 retc += r = reap(*argv++, &pid, &wstat);
 263 
 264                 if (r == 0)
 265                         print_exit_status(pid, wstat);
 266         }
 267 
 268         if (interrupt && retc == 0)
 269                 retc++;
 270         return (retc == 0 ? 0 : 1);
 271 }