X-Git-Url: http://git.onelab.eu/?a=blobdiff_plain;f=lib%2Fprocess.h;h=3feac7e9783a0604d8bb5dda0ab0f9c1af199a9e;hb=0ef165ecb57943e17a8ee8270df68ffb8d032e29;hp=d4aba3ae76deaa8251f0974997066de51e4f77b7;hpb=064af42167bf4fc9aaea2702d80ce08074b889c0;p=sliver-openvswitch.git diff --git a/lib/process.h b/lib/process.h index d4aba3ae7..3feac7e97 100644 --- a/lib/process.h +++ b/lib/process.h @@ -1,17 +1,17 @@ /* - * Copyright (c) 2008, 2009 Nicira Networks. + * Copyright (c) 2008, 2009, 2011, 2013 Nicira, Inc. * - * Permission to use, copy, modify, and/or distribute this software for any - * purpose with or without fee is hereby granted, provided that the above - * copyright notice and this permission notice appear in all copies. + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at: * - * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES - * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF - * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR - * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES - * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN - * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF - * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. */ #ifndef PROCESS_H @@ -21,28 +21,27 @@ #include struct process; + +/* Starting and monitoring subprocesses. + * + * process_init() and process_start() may safely be called only from a + * single-threaded parent process. The parent process may safely create + * additional threads afterward, as long as the remaining functions in this + * group are called only from a single thread at any given time. */ void process_init(void); -char *process_escape_args(char **argv); -int process_start(char **argv, - const int *keep_fds, size_t n_keep_fds, - const int *null_fds, size_t n_null_fds, - struct process **); +int process_start(char **argv, struct process **); void process_destroy(struct process *); int process_kill(const struct process *, int signr); - -int process_run(char **argv, - const int *keep_fds, size_t n_keep_fds, - const int *null_fds, size_t n_null_fds, - int *status); - pid_t process_pid(const struct process *); const char *process_name(const struct process *); bool process_exited(struct process *); int process_status(const struct process *); -char *process_status_msg(int); - +void process_run(void); void process_wait(struct process *); +/* These functions are thread-safe. */ +char *process_status_msg(int); +char *process_escape_args(char **argv); char *process_search_path(const char *); #endif /* process.h */