spawn.c File Reference

GIS Library - Handles process spawning. More...

#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <signal.h>
#include <stdarg.h>
#include <unistd.h>
#include <fcntl.h>
#include <errno.h>
#include <sys/types.h>
#include <sys/wait.h>
#include <grass/config.h>
#include <grass/gis.h>
#include <grass/glocale.h>
#include <grass/spawn.h>
Include dependency graph for spawn.c:

Go to the source code of this file.

Data Structures

struct  redirect
struct  signal
struct  binding

Defines

#define MAX_ARGS   256
#define MAX_BINDINGS   256
#define MAX_SIGNALS   32
#define MAX_REDIRECTS   32
#define NEXT_ARG(var, type)   ((type) *(var)++)

Functions

int G_spawn (const char *command,...)
 Spawns a new process.
int G_vspawn_ex (const char *command, const char **args)
 Spawn new process based on command.
int G_spawn_ex (const char *command,...)
 Spawn new process based on command.

Detailed Description

GIS Library - Handles process spawning.

(C) 2001-2008 by the GRASS Development Team

This program is free software under the GNU General Public License (>=v2). Read the file COPYING that comes with GRASS for details.

Author:
Glynn Clements
Date:
2004-2006

Definition in file spawn.c.


Define Documentation

#define MAX_ARGS   256

Definition at line 42 of file spawn.c.

Referenced by G_spawn().

#define MAX_BINDINGS   256

Definition at line 43 of file spawn.c.

#define MAX_REDIRECTS   32

Definition at line 45 of file spawn.c.

#define MAX_SIGNALS   32

Definition at line 44 of file spawn.c.

#define NEXT_ARG ( var,
type   )     ((type) *(var)++)

Definition at line 465 of file spawn.c.


Function Documentation

int G_spawn ( const char *  command,
  ... 
)

Spawns a new process.

A more useful alternative to G_system(), which takes the arguments of command as parameters.

Parameters:
[in] command command to execute
Returns:
-1 on error
process status on success

Definition at line 91 of file spawn.c.

References G_debug(), G_warning(), MAX_ARGS, and NULL.

Referenced by G_gishelp().

int G_spawn_ex ( const char *  command,
  ... 
)

Spawn new process based on command.

This is a more advanced version of G_spawn().

Parameters:
[in] command 
Returns:
-1 on error
process status on success

Definition at line 644 of file spawn.c.

int G_vspawn_ex ( const char *  command,
const char **  args 
)

Spawn new process based on command.

This is a more advanced version of G_spawn().

Parameters:
[in] command 
[in] args arguments
Returns:
-1 on error
process status on success

Definition at line 625 of file spawn.c.


Generated on Sat Oct 24 03:24:59 2009 for GRASS Programmer's Manual by  doxygen 1.6.1