1 /*********************************************************************** 2 * * 3 * This software is part of the ast package * 4 * Copyright (c) 1985-2009 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 105