lib/process.h

   1 /*
   2  * Copyright (c) 2008, 2009, 2011, 2013 Nicira, Inc.
   3  *
   4  * Licensed under the Apache License, Version 2.0 (the "License");
   5  * you may not use this file except in compliance with the License.
   6  * You may obtain a copy of the License at:
   7  *
   8  *     http://www.apache.org/licenses/LICENSE-2.0
   9  *
  10  * Unless required by applicable law or agreed to in writing, software
  11  * distributed under the License is distributed on an "AS IS" BASIS,
  12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13  * See the License for the specific language governing permissions and
  14  * limitations under the License.
  15  */
  16
  17 #ifndef PROCESS_H
  18 #define PROCESS_H 1
  19
  20 #include <stdbool.h>
  21 #include <sys/types.h>
  22
  23 struct process;
  24
  25 /* Starting and monitoring subprocesses.
  26  *
  27  * process_init() and process_start() may safely be called only from a
  28  * single-threaded parent process.  The parent process may safely create
  29  * additional threads afterward, as long as the remaining functions in this
  30  * group are called only from a single thread at any given time. */
  31 void process_init(void);
  32 int process_start(char **argv, struct process **);
  33 void process_destroy(struct process *);
  34 int process_kill(const struct process *, int signr);
  35 pid_t process_pid(const struct process *);
  36 const char *process_name(const struct process *);
  37 bool process_exited(struct process *);
  38 int process_status(const struct process *);
  39 void process_run(void);
  40 void process_wait(struct process *);
  41
  42 /* These functions are thread-safe. */
  43 char *process_status_msg(int);
  44 char *process_escape_args(char **argv);
  45 char *process_search_path(const char *);
  46
  47 #endif /* process.h */