/* * Copyright (c) 2006 Jakub Jermar * Copyright (c) 2008 Jiri Svoboda * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * * - Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * - Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * - The name of the author may not be used to endorse or promote products * derived from this software without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ /** @addtogroup libc * @{ */ /** @file */ #include #include #include #include #include #include #include #include #include task_id_t task_get_id(void) { task_id_t task_id; (void) __SYSCALL1(SYS_TASK_GET_ID, (sysarg_t) &task_id); return task_id; } /** Set the task name. * * @param name The new name, typically the command used to execute the * program. * * @return Zero on success or negative error code. * */ int task_set_name(const char *name) { return __SYSCALL2(SYS_TASK_SET_NAME, (sysarg_t) name, str_size(name)); } /** Create a new task by running an executable from the filesystem. * * This is really just a convenience wrapper over the more complicated * loader API. * * @param path pathname of the binary to execute * @param argv command-line arguments * * @return ID of the newly created task or zero on error. * */ task_id_t task_spawn(const char *path, const char *const args[]) { /* Connect to a program loader. */ loader_t *ldr = loader_connect(); if (ldr == NULL) return 0; /* Get task ID. */ task_id_t task_id; int rc = loader_get_task_id(ldr, &task_id); if (rc != EOK) goto error; /* Send spawner's current working directory. */ rc = loader_set_cwd(ldr); if (rc != EOK) goto error; /* Send program pathname. */ rc = loader_set_pathname(ldr, path); if (rc != EOK) goto error; /* Send arguments. */ rc = loader_set_args(ldr, args); if (rc != EOK) goto error; /* Send default files */ fdi_node_t *files[4]; fdi_node_t stdin_node; fdi_node_t stdout_node; fdi_node_t stderr_node; if ((stdin != NULL) && (fnode(stdin, &stdin_node) == EOK)) files[0] = &stdin_node; else files[0] = NULL; if ((stdout != NULL) && (fnode(stdout, &stdout_node) == EOK)) files[1] = &stdout_node; else files[1] = NULL; if ((stderr != NULL) && (fnode(stderr, &stderr_node) == EOK)) files[2] = &stderr_node; else files[2] = NULL; files[3] = NULL; rc = loader_set_files(ldr, files); if (rc != EOK) goto error; /* Load the program. */ rc = loader_load_program(ldr); if (rc != EOK) goto error; /* Run it. */ rc = loader_run(ldr); if (rc != EOK) goto error; /* Success */ free(ldr); return task_id; error: /* Error exit */ loader_abort(ldr); free(ldr); return 0; } int task_wait(task_id_t id, task_exit_t *texit, int *retval) { ipcarg_t te, rv; int rc; rc = (int) async_req_2_2(PHONE_NS, NS_TASK_WAIT, LOWER32(id), UPPER32(id), &te, &rv); *texit = te; *retval = rv; return rc; } int task_retval(int val) { return (int) async_req_1_0(PHONE_NS, NS_RETVAL, val); } /** @} */