Add missing fiels for W32.
[gnupg.git] / common / exechelp.h
1 /* exechelp.h - Definitions for the fork and exec helpers
2  *      Copyright (C) 2004 Free Software Foundation, Inc.
3  *
4  * This file is part of GnuPG.
5  *
6  * GnuPG is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License as published by
8  * the Free Software Foundation; either version 2 of the License, or
9  * (at your option) any later version.
10  *
11  * GnuPG is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  * GNU General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License
17  * along with this program; if not, write to the Free Software
18  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
19  * USA.
20  */
21
22 #ifndef GNUPG_COMMON_EXECHELP_H
23 #define GNUPG_COMMON_EXECHELP_H
24
25
26
27 /* Fork and exec the PGMNAME, connect the file descriptor of INFILE to
28    stdin, write the output to OUTFILE, return a new stream in
29    STATUSFILE for stderr and the pid of the process in PID. The
30    arguments for the process are expected in the NULL terminated array
31    ARGV.  The program name itself should not be included there.  if
32    PREEXEC is not NULL, that function will be called right before the
33    exec.  Returns 0 on success or an error code. */
34 gpg_error_t gnupg_spawn_process (const char *pgmname, const char *argv[],
35                                  FILE *infile, FILE *outfile,
36                                  void (*preexec)(void),
37                                  FILE **statusfile, pid_t *pid);
38
39 /* Wait for the process identified by PID to terminate. PGMNAME should
40    be the same as suplieed to the spawn fucntion and is only used for
41    diagnostics. Returns 0 if the process succeded, GPG_ERR_GENERAL for
42    any failures of the spawned program or other error codes.*/
43 gpg_error_t gnupg_wait_process (const char *pgmname, pid_t pid);
44
45
46 /* Spawn a new process and immediatley detach from it.  The name of
47    the program to exec is PGMNAME and its arguments are in ARGV (the
48    programname is automatically passed as first argument).
49    Environment strings in ENVP are set.  An error is returned if
50    pgmname is not executable; to make this work it is necessary to
51    provide an absolute file name.  */
52 gpg_error_t gnupg_spawn_process_detached (const char *pgmname,
53                                           const char *argv[],
54                                           const char *envp[] );
55
56
57
58 #endif /*GNUPG_COMMON_EXECHELP_H*/