usr/src/lib/libast/common/include/proc.h

   1 /***********************************************************************
   2 *                                                                      *
   3 *               This software is part of the ast package               *
   4 *          Copyright (c) 1985-2010 AT&T Intellectual Property          *
   5 *                      and is licensed under the                       *
   6 *                  Common Public License, Version 1.0                  *
   7 *                    by AT&T Intellectual Property                     *
   8 *                                                                      *
   9 *                A copy of the License is available at                 *
  10 *            http://www.opensource.org/licenses/cpl1.0.txt             *
  11 *         (with md5 checksum 059e8cd6165cb4c31e351f2b69388fd9)         *
  12 *                                                                      *
  13 *              Information and Software Systems Research               *
  14 *                            AT&T Research                             *
  15 *                           Florham Park NJ                            *
  16 *                                                                      *
  17 *                 Glenn Fowler <gsf@research.att.com>                  *
  18 *                  David Korn <dgk@research.att.com>                   *
  19 *                   Phong Vo <kpv@research.att.com>                    *
  20 *                                                                      *
  21 ***********************************************************************/
  22 #pragma prototyped
  23
  24 /*
  25  * process library interface
  26  */
  27
  28 #ifndef _PROC_H
  29 #define _PROC_H
  30
  31 #include <ast.h>
  32
  33 #define PROC_ARGMOD     (1<<0)  /* argv[-1],argv[0] can be modified     */
  34 #define PROC_BACKGROUND (1<<1)  /* shell background (&) setup           */
  35 #define PROC_CHECK      (1<<17) /* check that command exists            */
  36 #define PROC_CLEANUP    (1<<2)  /* close parent redirect fds on error   */
  37 #define PROC_DAEMON     (1<<3)  /* daemon setup                         */
  38 #define PROC_ENVCLEAR   (1<<4)  /* clear environment                    */
  39 #define PROC_FOREGROUND (1<<14) /* system(3) setup                      */
  40 #define PROC_GID        (1<<5)  /* setgid(getgid())                     */
  41 #define PROC_IGNORE     (1<<6)  /* ignore parent pipe errors            */
  42 #define PROC_IGNOREPATH (1<<16) /* procrun() intercept to ignore path   */
  43 #define PROC_OVERLAY    (1<<7)  /* overlay current process if possible  */
  44 #define PROC_PARANOID   (1<<8)  /* restrict everything                  */
  45 #define PROC_PRIVELEGED (1<<9)  /* setuid(0), setgid(getegid())         */
  46 #define PROC_READ       (1<<10) /* proc pipe fd 1 returned              */
  47 #define PROC_SESSION    (1<<11) /* session leader                       */
  48 #define PROC_UID        (1<<12) /* setuid(getuid())                     */
  49 #define PROC_WRITE      (1<<13) /* proc pipe fd 0 returned              */
  50 #define PROC_ZOMBIE     (1<<15) /* proc may leave a zombie behind       */
  51
  52 #define PROC_ARG_BIT    14      /* bits per op arg                      */
  53 #define PROC_OP_BIT     4       /* bits per op                          */
  54
  55 #define PROC_ARG_NULL   ((1<<PROC_ARG_BIT)-1)
  56
  57 #define PROC_fd_dup     0x4
  58 #define PROC_FD_CHILD   0x1
  59 #define PROC_FD_PARENT  0x2
  60
  61 #define PROC_sig_dfl    0x8
  62 #define PROC_sig_ign    0x9
  63
  64 #define PROC_sys_pgrp   0xa
  65 #define PROC_sys_umask  0xb
  66
  67 #define PROC_op1(o,a)   (((o)<<(2*PROC_ARG_BIT))|((a)&((PROC_ARG_NULL<<PROC_ARG_BIT)|PROC_ARG_NULL)))
  68 #define PROC_op2(o,a,b) (((o)<<(2*PROC_ARG_BIT))|(((b)&PROC_ARG_NULL)<<PROC_ARG_BIT)|((a)&PROC_ARG_NULL))
  69
  70 #define PROC_FD_CLOSE(p,f)      PROC_op2(PROC_fd_dup|(f),p,PROC_ARG_NULL)
  71 #define PROC_FD_DUP(p,c,f)      PROC_op2(PROC_fd_dup|(f),p,c)
  72 #define PROC_SIG_DFL(s)         PROC_op1(PROC_sig_dfl,s,0)
  73 #define PROC_SIG_IGN(s)         PROC_op1(PROC_sig_ign,s,0)
  74 #define PROC_SYS_PGRP(g)        PROC_op1(PROC_sys_pgrp,g)
  75 #define PROC_SYS_UMASK(m)       PROC_op1(PROC_sys_umask,m,0)
  76
  77 #define PROC_OP(x)      (((x)>>(2*PROC_ARG_BIT))&((1<<PROC_OP_BIT)-1))
  78 #define PROC_ARG(x,n)   ((n)?(((x)>>(((n)-1)*PROC_ARG_BIT))&PROC_ARG_NULL):(((x)&~((1<<(2*PROC_ARG_BIT))-1))==~((1<<(2*PROC_ARG_BIT))-1))?(-1):((x)&~((1<<(2*PROC_ARG_BIT))-1)))
  79
  80 typedef struct
  81 {
  82         pid_t   pid;                    /* process id                   */
  83         pid_t   pgrp;                   /* process group id             */
  84         int     rfd;                    /* read fd if applicable        */
  85         int     wfd;                    /* write fd if applicable       */
  86
  87 #ifdef _PROC_PRIVATE_
  88 _PROC_PRIVATE_
  89 #endif
  90
  91 } Proc_t;
  92
  93 #if _BLD_ast && defined(__EXPORT__)
  94 #define extern          __EXPORT__
  95 #endif
  96
  97 extern int      procclose(Proc_t*);
  98 extern int      procfree(Proc_t*);
  99 extern Proc_t*  procopen(const char*, char**, char**, long*, int);
 100 extern int      procrun(const char*, char**, int);
 101
 102 #undef  extern
 103
 104 #endif