1/***********************************************************************
2*                                                                      *
3*               This software is part of the ast package               *
4*          Copyright (c) 1985-2011 AT&T Intellectual Property          *
5*                      and is licensed under the                       *
6*                 Eclipse Public License, Version 1.0                  *
7*                    by AT&T Intellectual Property                     *
8*                                                                      *
9*                A copy of the License is available at                 *
10*          http://www.eclipse.org/org/documents/epl-v10.html           *
11*         (with md5 checksum b35adb5213ca9657e911e9befb180842)         *
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_ORPHAN	(1<<18)	/* create orphaned process		*/
44#define PROC_OVERLAY	(1<<7)	/* overlay current process if possible	*/
45#define PROC_PARANOID	(1<<8)	/* restrict everything			*/
46#define PROC_PRIVELEGED	(1<<9)	/* setuid(0), setgid(getegid())		*/
47#define PROC_READ	(1<<10)	/* proc pipe fd 1 returned		*/
48#define PROC_SESSION	(1<<11)	/* session leader			*/
49#define PROC_UID	(1<<12)	/* setuid(getuid())			*/
50#define PROC_WRITE	(1<<13)	/* proc pipe fd 0 returned		*/
51#define PROC_ZOMBIE	(1<<15)	/* proc may leave a zombie behind	*/
52
53#define PROC_ARG_BIT	14	/* bits per op arg			*/
54#define PROC_OP_BIT	4	/* bits per op				*/
55
56#define PROC_ARG_NULL	((1<<PROC_ARG_BIT)-1)
57
58#define PROC_fd_dup	0x4
59#define PROC_FD_CHILD	0x1
60#define PROC_FD_PARENT	0x2
61
62#define PROC_sig_dfl	0x8
63#define PROC_sig_ign	0x9
64
65#define PROC_sys_pgrp	0xa
66#define PROC_sys_umask	0xb
67
68#define PROC_fd_ctty	0xc
69
70#define PROC_op1(o,a)	(((o)<<(2*PROC_ARG_BIT))|((a)&((PROC_ARG_NULL<<PROC_ARG_BIT)|PROC_ARG_NULL)))
71#define PROC_op2(o,a,b)	(((o)<<(2*PROC_ARG_BIT))|(((b)&PROC_ARG_NULL)<<PROC_ARG_BIT)|((a)&PROC_ARG_NULL))
72
73#define PROC_FD_CLOSE(p,f)	PROC_op2(PROC_fd_dup|(f),p,PROC_ARG_NULL)
74#define PROC_FD_CTTY(f)		PROC_op1(PROC_fd_ctty,f)
75#define PROC_FD_DUP(p,c,f)	PROC_op2(PROC_fd_dup|(f),p,c)
76#define PROC_SIG_DFL(s)		PROC_op1(PROC_sig_dfl,s,0)
77#define PROC_SIG_IGN(s)		PROC_op1(PROC_sig_ign,s,0)
78#define PROC_SYS_PGRP(g)	PROC_op1(PROC_sys_pgrp,g)
79#define PROC_SYS_UMASK(m)	PROC_op1(PROC_sys_umask,m,0)
80
81#define PROC_OP(x)	(((x)>>(2*PROC_ARG_BIT))&((1<<PROC_OP_BIT)-1))
82#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)))
83
84typedef struct
85{
86	pid_t	pid;			/* process id			*/
87	pid_t	pgrp;			/* process group id		*/
88	int	rfd;			/* read fd if applicable	*/
89	int	wfd;			/* write fd if applicable	*/
90
91#ifdef _PROC_PRIVATE_
92_PROC_PRIVATE_
93#endif
94
95} Proc_t;
96
97#if _BLD_ast && defined(__EXPORT__)
98#define extern		__EXPORT__
99#endif
100
101extern int	procclose(Proc_t*);
102extern int	procfree(Proc_t*);
103extern Proc_t*	procopen(const char*, char**, char**, long*, int);
104extern int	procrun(const char*, char**, int);
105
106#undef	extern
107
108#endif
109