source: mainline/uspace/lib/c/include/task.h@ 053fc2b

lfn serial ticket/834-toolchain-update topic/msim-upgrade topic/simplify-dev-export
Last change on this file since 053fc2b was 1c635d6, checked in by Martin Sucha <sucha14@…>, 11 years ago

Do not hold a task's return value after it has disconnected.

Holding the task's return value meant that if nobody waited
for task's result, it polluted NS's memory. This was apparently
done because of a race between spawning a task and waiting for it.

We solve this problem in another way: ns discards the return value
as soon as the task disconnects from it. This typically happens
when the task finishes its execution. In order to avoid the race,
we send the wait request to ns while spawning the task (i.e. when
we talk to the loader), but before we allow the loaded program
to run.

Fixes #132

  • Property mode set to 100644
File size: 2.5 KB
Line 
1/*
2 * Copyright (c) 2006 Jakub Jermar
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 *
9 * - Redistributions of source code must retain the above copyright
10 * notice, this list of conditions and the following disclaimer.
11 * - Redistributions in binary form must reproduce the above copyright
12 * notice, this list of conditions and the following disclaimer in the
13 * documentation and/or other materials provided with the distribution.
14 * - The name of the author may not be used to endorse or promote products
15 * derived from this software without specific prior written permission.
16 *
17 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27 */
28
29/** @addtogroup libc
30 * @{
31 */
32/** @file
33 */
34
35#ifndef LIBC_TASK_H_
36#define LIBC_TASK_H_
37
38#include <sys/types.h>
39#include <abi/proc/task.h>
40#include <stdarg.h>
41#include <async.h>
42#include <types/task.h>
43
44typedef struct {
45 ipc_call_t result;
46 aid_t aid;
47} task_wait_t;
48
49struct _TASK;
50typedef struct _TASK task_t;
51
52extern task_id_t task_get_id(void);
53extern int task_set_name(const char *);
54extern int task_kill(task_id_t);
55
56extern int task_spawnv(task_id_t *, task_wait_t *, const char *path,
57 const char *const []);
58extern int task_spawnvf(task_id_t *, task_wait_t *, const char *path,
59 const char *const [], int *const []);
60extern int task_spawn(task_id_t *, task_wait_t *, const char *path, int,
61 va_list ap);
62extern int task_spawnl(task_id_t *, task_wait_t *, const char *path, ...);
63
64extern int task_setup_wait(task_id_t, task_wait_t *);
65extern void task_cancel_wait(task_wait_t *);
66extern int task_wait(task_wait_t *, task_exit_t *, int *);
67extern int task_wait_task_id(task_id_t, task_exit_t *, int *);
68extern int task_retval(int);
69
70#endif
71
72/** @}
73 */
Note: See TracBrowser for help on using the repository browser.