lib_internal/command.h

   1 // $Id$    --*- c -*--
   2
   3 // Copyright (C) 2004 Enrico Scholz <enrico.scholz@informatik.tu-chemnitz.de>
   4 //
   5 // This program is free software; you can redistribute it and/or modify
   6 // it under the terms of the GNU General Public License as published by
   7 // the Free Software Foundation; version 2 of the License.
   8 //
   9 // This program is distributed in the hope that it will be useful,
  10 // but WITHOUT ANY WARRANTY; without even the implied warranty of
  11 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12 // GNU General Public License for more details.
  13 //
  14 // You should have received a copy of the GNU General Public License
  15 // along with this program; if not, write to the Free Software
  16 // Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  17
  18
  19 #ifndef H_UTIL_VSERVER_LIB_INTERNAL_COMMAND_H
  20 #define H_UTIL_VSERVER_LIB_INTERNAL_COMMAND_H
  21
  22 #include <ensc_vector/vector.h>
  23 #include <sys/resource.h>
  24 #include <sys/wait.h>
  25 #include <stdbool.h>
  26
  27 struct Command
  28 {
  29     char const *        filename;
  30     union {
  31         struct Vector   v;
  32         char const **   d;
  33     }                   params;
  34     pid_t               pid;
  35     int                 rc;
  36     int                 err;
  37     struct rusage       rusage;
  38
  39     enum { parNONE, parVEC, parDATA }   params_style_;
  40 };
  41
  42 void    Command_init(struct Command *);
  43 void    Command_free(struct Command *);
  44 void    Command_reset(struct Command *);
  45 bool    Command_exec(struct Command *, bool do_fork);
  46 void    Command_appendParameter(struct Command *, char const *);
  47 void    Command_setParams(struct Command *, char const **);
  48 /**
  49  *  \args do_hang  when true, do not return before command exited, or
  50  *                 an error (e.g. signal) occured
  51  *  \returns       \c true iff command/processes exited; in this case,
  52  *                 exitcode is available in the \c rc member
  53  */
  54 bool    Command_wait(struct Command *, bool do_block);
  55
  56 #endif  //  H_UTIL_VSERVER_LIB_INTERNAL_COMMAND_H