plugins/runcmd.h

   1 /****************************************************************************
   2 *
   3 * License: GPL
   4 * Copyright (c) 2005 Nagios Plugins Development Team
   5 * Author: Andreas Ericsson <ae@op5.se>
   6 *
   7 *
   8 * This program is free software: you can redistribute it and/or modify
   9 * it under the terms of the GNU General Public License as published by
  10 * the Free Software Foundation, either version 3 of the License, or
  11 * (at your option) any later version.
  12 *
  13 * This program is distributed in the hope that it will be useful,
  14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16 * GNU General Public License for more details.
  17 *
  18 * You should have received a copy of the GNU General Public License
  19 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  20 *
  21 *
  22 *****************************************************************************/
  23
  24 #ifndef NAGIOSPLUG_RUNCMD_H
  25 #define NAGIOSPLUG_RUNCMD_H
  26
  27 #include "common.h"
  28
  29 /** types **/
  30 struct output {
  31         char *buf;     /* output buffer */
  32         size_t buflen; /* output buffer content length */
  33         char **line;   /* array of lines (points to buf) */
  34         size_t *lens;  /* string lengths */
  35         size_t lines;  /* lines of output */
  36 };
  37
  38 typedef struct output output;
  39
  40 /** prototypes **/
  41 int np_runcmd(const char *, output *, output *, int);
  42 void popen_timeout_alarm_handler(int)
  43         __attribute__((__noreturn__));
  44
  45 /* only multi-threaded plugins need to bother with this */
  46 void np_runcmd_init(void);
  47 #define NP_RUNCMD_INIT np_runcmd_init()
  48
  49 /* possible flags for np_runcmd()'s fourth argument */
  50 #define RUNCMD_NO_ARRAYS 0x01 /* don't populate arrays at all */
  51 #define RUNCMD_NO_ASSOC 0x02  /* output.line won't point to buf */
  52
  53 #endif /* NAGIOSPLUG_RUNCMD_H */