proc.h revision 7c2fbfb345896881c631598ee3852ce9ce33fb07
/***********************************************************************
* *
* This software is part of the ast package *
* Copyright (c) 1985-2008 AT&T Intellectual Property *
* and is licensed under the *
* Common Public License, Version 1.0 *
* by AT&T Intellectual Property *
* *
* A copy of the License is available at *
* http://www.opensource.org/licenses/cpl1.0.txt *
* (with md5 checksum 059e8cd6165cb4c31e351f2b69388fd9) *
* *
* Information and Software Systems Research *
* AT&T Research *
* Florham Park NJ *
* *
* Glenn Fowler <gsf@research.att.com> *
* David Korn <dgk@research.att.com> *
* Phong Vo <kpv@research.att.com> *
* *
***********************************************************************/
#pragma prototyped
/*
* process library interface
*/
#ifndef _PROC_H
#define _PROC_H
#include <ast.h>
#define PROC_ARGMOD (1<<0) /* argv[-1],argv[0] can be modified */
#define PROC_BACKGROUND (1<<1) /* shell background (&) setup */
#define PROC_CHECK (1<<17) /* check that command exists */
#define PROC_CLEANUP (1<<2) /* close parent redirect fds on error */
#define PROC_DAEMON (1<<3) /* daemon setup */
#define PROC_ENVCLEAR (1<<4) /* clear environment */
#define PROC_FOREGROUND (1<<14) /* system(3) setup */
#define PROC_GID (1<<5) /* setgid(getgid()) */
#define PROC_IGNORE (1<<6) /* ignore parent pipe errors */
#define PROC_IGNOREPATH (1<<16) /* procrun() intercept to ignore path */
#define PROC_OVERLAY (1<<7) /* overlay current process if possible */
#define PROC_PARANOID (1<<8) /* restrict everything */
#define PROC_PRIVELEGED (1<<9) /* setuid(0), setgid(getegid()) */
#define PROC_READ (1<<10) /* proc pipe fd 1 returned */
#define PROC_SESSION (1<<11) /* session leader */
#define PROC_UID (1<<12) /* setuid(getuid()) */
#define PROC_WRITE (1<<13) /* proc pipe fd 0 returned */
#define PROC_ZOMBIE (1<<15) /* proc may leave a zombie behind */
#define PROC_ARG_BIT 14 /* bits per op arg */
#define PROC_OP_BIT 4 /* bits per op */
#define PROC_ARG_NULL ((1<<PROC_ARG_BIT)-1)
#define PROC_fd_dup 0x4
#define PROC_FD_CHILD 0x1
#define PROC_FD_PARENT 0x2
#define PROC_sig_dfl 0x8
#define PROC_sig_ign 0x9
#define PROC_sys_pgrp 0xa
#define PROC_sys_umask 0xb
#define PROC_op1(o,a) (((o)<<(2*PROC_ARG_BIT))|((a)&((PROC_ARG_NULL<<PROC_ARG_BIT)|PROC_ARG_NULL)))
#define PROC_op2(o,a,b) (((o)<<(2*PROC_ARG_BIT))|(((b)&PROC_ARG_NULL)<<PROC_ARG_BIT)|((a)&PROC_ARG_NULL))
#define PROC_FD_CLOSE(p,f) PROC_op2(PROC_fd_dup|(f),p,PROC_ARG_NULL)
#define PROC_FD_DUP(p,c,f) PROC_op2(PROC_fd_dup|(f),p,c)
#define PROC_SIG_DFL(s) PROC_op1(PROC_sig_dfl,s,0)
#define PROC_SIG_IGN(s) PROC_op1(PROC_sig_ign,s,0)
#define PROC_SYS_PGRP(g) PROC_op1(PROC_sys_pgrp,g)
#define PROC_SYS_UMASK(m) PROC_op1(PROC_sys_umask,m,0)
#define PROC_OP(x) (((x)>>(2*PROC_ARG_BIT))&((1<<PROC_OP_BIT)-1))
#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)))
typedef struct
{
pid_t pid; /* process id */
pid_t pgrp; /* process group id */
int rfd; /* read fd if applicable */
int wfd; /* write fd if applicable */
#ifdef _PROC_PRIVATE_
_PROC_PRIVATE_
#endif
} Proc_t;
#if _BLD_ast && defined(__EXPORT__)
#define extern __EXPORT__
#endif
extern int procclose(Proc_t*);
extern int procfree(Proc_t*);
extern Proc_t* procopen(const char*, char**, char**, long*, int);
extern int procrun(const char*, char**, int);
#undef extern
#endif