Subversion Repositories HelenOS

Rev

Rev 3343 | Rev 3593 | Go to most recent revision | Only display areas with differences | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 3343 Rev 3492
1
/*
1
/*
2
 * Copyright (c) 2008 Jiri Svoboda
2
 * Copyright (c) 2008 Jiri Svoboda
3
 * All rights reserved.
3
 * All rights reserved.
4
 *
4
 *
5
 * Redistribution and use in source and binary forms, with or without
5
 * Redistribution and use in source and binary forms, with or without
6
 * modification, are permitted provided that the following conditions
6
 * modification, are permitted provided that the following conditions
7
 * are met:
7
 * are met:
8
 *
8
 *
9
 * - Redistributions of source code must retain the above copyright
9
 * - Redistributions of source code must retain the above copyright
10
 *   notice, this list of conditions and the following disclaimer.
10
 *   notice, this list of conditions and the following disclaimer.
11
 * - Redistributions in binary form must reproduce the above copyright
11
 * - Redistributions in binary form must reproduce the above copyright
12
 *   notice, this list of conditions and the following disclaimer in the
12
 *   notice, this list of conditions and the following disclaimer in the
13
 *   documentation and/or other materials provided with the distribution.
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
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.
15
 *   derived from this software without specific prior written permission.
16
 *
16
 *
17
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
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
18
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
19
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20
 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
20
 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
21
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22
 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
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
23
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
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
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.
26
 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27
 */
27
 */
28
 
28
 
29
/** @addtogroup loader
29
/** @addtogroup loader
30
 * @brief   Loads and runs programs from VFS.
30
 * @brief   Loads and runs programs from VFS.
31
 * @{
31
 * @{
32
 */
32
 */
33
/**
33
/**
34
 * @file
34
 * @file
35
 * @brief   Loads and runs programs from VFS.
35
 * @brief   Loads and runs programs from VFS.
36
 *
36
 *
37
 * The program loader is a special init binary. Its image is used
37
 * The program loader is a special init binary. Its image is used
38
 * to create a new task upon a @c task_spawn syscall. The syscall
38
 * to create a new task upon a @c task_spawn syscall. The syscall
39
 * returns the id of a phone connected to the newly created task.
39
 * returns the id of a phone connected to the newly created task.
40
 *
40
 *
41
 * The caller uses this phone to send the pathname and various other
41
 * The caller uses this phone to send the pathname and various other
42
 * information to the loader. This is normally done by the C library
42
 * information to the loader. This is normally done by the C library
43
 * and completely hidden from applications.
43
 * and completely hidden from applications.
44
 */
44
 */
45
 
45
 
46
#include <stdio.h>
46
#include <stdio.h>
47
#include <stdlib.h>
47
#include <stdlib.h>
48
#include <unistd.h>
48
#include <unistd.h>
-
 
49
#include <bool.h>
49
#include <fcntl.h>
50
#include <fcntl.h>
50
#include <sys/types.h>
51
#include <sys/types.h>
51
#include <ipc/ipc.h>
52
#include <ipc/ipc.h>
52
#include <ipc/loader.h>
53
#include <ipc/loader.h>
53
#include <loader/pcb.h>
54
#include <loader/pcb.h>
54
#include <errno.h>
55
#include <errno.h>
55
#include <async.h>
56
#include <async.h>
56
#include <as.h>
57
#include <as.h>
57
 
58
 
58
#include <elf.h>
59
#include <elf.h>
59
#include <elf_load.h>
60
#include <elf_load.h>
60
 
61
 
61
/**
62
/**
62
 * Bias used for loading the dynamic linker. This will be soon replaced
63
 * Bias used for loading the dynamic linker. This will be soon replaced
63
 * by automatic placement.
64
 * by automatic placement.
64
 */
65
 */
65
#define RTLD_BIAS 0x80000
66
#define RTLD_BIAS 0x80000
66
 
67
 
67
/** Pathname of the file that will be loaded */
68
/** Pathname of the file that will be loaded */
68
static char *pathname = NULL;
69
static char *pathname = NULL;
69
 
70
 
70
/** The Program control block */
71
/** The Program control block */
71
static pcb_t pcb;
72
static pcb_t pcb;
72
 
73
 
73
/** Number of arguments */
74
/** Number of arguments */
74
static int argc = 0;
75
static int argc = 0;
75
/** Argument vector */
76
/** Argument vector */
76
static char **argv = NULL;
77
static char **argv = NULL;
77
/** Buffer holding all arguments */
78
/** Buffer holding all arguments */
78
static char *arg_buf = NULL;
79
static char *arg_buf = NULL;
79
 
80
 
-
 
81
static elf_info_t prog_info;
-
 
82
static elf_info_t interp_info;
-
 
83
 
-
 
84
static bool is_dyn_linked;
-
 
85
 
-
 
86
 
-
 
87
static void loader_get_taskid(ipc_callid_t rid, ipc_call_t *request)
-
 
88
{
-
 
89
    ipc_callid_t callid;
-
 
90
    task_id_t task_id;
-
 
91
    size_t len;
-
 
92
 
-
 
93
    task_id = task_get_id();
-
 
94
 
-
 
95
    if (!ipc_data_read_receive(&callid, &len)) {
-
 
96
        ipc_answer_0(callid, EINVAL);
-
 
97
        ipc_answer_0(rid, EINVAL);
-
 
98
        return;
-
 
99
    }
-
 
100
 
-
 
101
    if (len > sizeof(task_id)) len = sizeof(task_id);
-
 
102
 
-
 
103
    ipc_data_read_finalize(callid, &task_id, len);
-
 
104
    ipc_answer_0(rid, EOK);
-
 
105
}
-
 
106
 
-
 
107
 
80
/** Receive a call setting pathname of the program to execute.
108
/** Receive a call setting pathname of the program to execute.
81
 *
109
 *
82
 * @param rid
110
 * @param rid
83
 * @param request
111
 * @param request
84
 */
112
 */
85
static void loader_set_pathname(ipc_callid_t rid, ipc_call_t *request)
113
static void loader_set_pathname(ipc_callid_t rid, ipc_call_t *request)
86
{
114
{
87
    ipc_callid_t callid;
115
    ipc_callid_t callid;
88
    size_t len;
116
    size_t len;
89
    char *name_buf;
117
    char *name_buf;
90
 
118
 
91
    if (!ipc_data_write_receive(&callid, &len)) {
119
    if (!ipc_data_write_receive(&callid, &len)) {
92
        ipc_answer_0(callid, EINVAL);
120
        ipc_answer_0(callid, EINVAL);
93
        ipc_answer_0(rid, EINVAL);
121
        ipc_answer_0(rid, EINVAL);
94
        return;
122
        return;
95
    }
123
    }
96
 
124
 
97
    name_buf = malloc(len + 1);
125
    name_buf = malloc(len + 1);
98
    if (!name_buf) {
126
    if (!name_buf) {
99
        ipc_answer_0(callid, ENOMEM);
127
        ipc_answer_0(callid, ENOMEM);
100
        ipc_answer_0(rid, ENOMEM);
128
        ipc_answer_0(rid, ENOMEM);
101
        return;
129
        return;
102
    }
130
    }
103
 
131
 
104
    ipc_data_write_finalize(callid, name_buf, len);
132
    ipc_data_write_finalize(callid, name_buf, len);
105
    ipc_answer_0(rid, EOK);
133
    ipc_answer_0(rid, EOK);
106
 
134
 
107
    if (pathname != NULL) {
135
    if (pathname != NULL) {
108
        free(pathname);
136
        free(pathname);
109
        pathname = NULL;
137
        pathname = NULL;
110
    }
138
    }
111
 
139
 
112
    name_buf[len] = '\0';
140
    name_buf[len] = '\0';
113
    pathname = name_buf;
141
    pathname = name_buf;
114
}
142
}
115
 
143
 
116
/** Receive a call setting arguments of the program to execute.
144
/** Receive a call setting arguments of the program to execute.
117
 *
145
 *
118
 * @param rid
146
 * @param rid
119
 * @param request
147
 * @param request
120
 */
148
 */
121
static void loader_set_args(ipc_callid_t rid, ipc_call_t *request)
149
static void loader_set_args(ipc_callid_t rid, ipc_call_t *request)
122
{
150
{
123
    ipc_callid_t callid;
151
    ipc_callid_t callid;
124
    size_t buf_len, arg_len;
152
    size_t buf_len, arg_len;
125
    char *p;
153
    char *p;
126
    int n;
154
    int n;
127
 
155
 
128
    if (!ipc_data_write_receive(&callid, &buf_len)) {
156
    if (!ipc_data_write_receive(&callid, &buf_len)) {
129
        ipc_answer_0(callid, EINVAL);
157
        ipc_answer_0(callid, EINVAL);
130
        ipc_answer_0(rid, EINVAL);
158
        ipc_answer_0(rid, EINVAL);
131
        return;
159
        return;
132
    }
160
    }
133
 
161
 
134
    if (arg_buf != NULL) {
162
    if (arg_buf != NULL) {
135
        free(arg_buf);
163
        free(arg_buf);
136
        arg_buf = NULL;
164
        arg_buf = NULL;
137
    }
165
    }
138
 
166
 
139
    if (argv != NULL) {
167
    if (argv != NULL) {
140
        free(argv);
168
        free(argv);
141
        argv = NULL;
169
        argv = NULL;
142
    }
170
    }
143
 
171
 
144
    arg_buf = malloc(buf_len + 1);
172
    arg_buf = malloc(buf_len + 1);
145
    if (!arg_buf) {
173
    if (!arg_buf) {
146
        ipc_answer_0(callid, ENOMEM);
174
        ipc_answer_0(callid, ENOMEM);
147
        ipc_answer_0(rid, ENOMEM);
175
        ipc_answer_0(rid, ENOMEM);
148
        return;
176
        return;
149
    }
177
    }
150
 
178
 
151
    ipc_data_write_finalize(callid, arg_buf, buf_len);
179
    ipc_data_write_finalize(callid, arg_buf, buf_len);
152
    ipc_answer_0(rid, EOK);
180
    ipc_answer_0(rid, EOK);
153
 
181
 
154
    arg_buf[buf_len] = '\0';
182
    arg_buf[buf_len] = '\0';
155
 
183
 
156
    /*
184
    /*
157
     * Count number of arguments
185
     * Count number of arguments
158
     */
186
     */
159
    p = arg_buf;
187
    p = arg_buf;
160
    n = 0;
188
    n = 0;
161
    while (p < arg_buf + buf_len) {
189
    while (p < arg_buf + buf_len) {
162
        arg_len = strlen(p);
190
        arg_len = strlen(p);
163
        p = p + arg_len + 1;
191
        p = p + arg_len + 1;
164
        ++n;
192
        ++n;
165
    }
193
    }
166
 
194
 
167
    /* Allocate argv */
195
    /* Allocate argv */
168
    argv = malloc((n + 1) * sizeof(char *));
196
    argv = malloc((n + 1) * sizeof(char *));
169
 
197
 
170
    if (argv == NULL) {
198
    if (argv == NULL) {
171
        free(arg_buf);
199
        free(arg_buf);
172
        ipc_answer_0(callid, ENOMEM);
200
        ipc_answer_0(callid, ENOMEM);
173
        ipc_answer_0(rid, ENOMEM);
201
        ipc_answer_0(rid, ENOMEM);
174
        return;
202
        return;
175
    }
203
    }
176
 
204
 
177
    /*
205
    /*
178
     * Fill argv with argument pointers
206
     * Fill argv with argument pointers
179
     */
207
     */
180
    p = arg_buf;
208
    p = arg_buf;
181
    n = 0;
209
    n = 0;
182
    while (p < arg_buf + buf_len) {
210
    while (p < arg_buf + buf_len) {
183
        argv[n] = p;
211
        argv[n] = p;
184
 
212
 
185
        arg_len = strlen(p);
213
        arg_len = strlen(p);
186
        p = p + arg_len + 1;
214
        p = p + arg_len + 1;
187
        ++n;
215
        ++n;
188
    }
216
    }
189
 
217
 
190
    argc = n;
218
    argc = n;
191
    argv[n] = NULL;
219
    argv[n] = NULL;
192
}
220
}
193
 
221
 
194
 
-
 
195
/** Load and run the previously selected program.
222
/** Load the previously selected program.
196
 *
223
 *
197
 * @param rid
224
 * @param rid
198
 * @param request
225
 * @param request
199
 * @return 0 on success, !0 on error.
226
 * @return 0 on success, !0 on error.
200
 */
227
 */
201
static int loader_run(ipc_callid_t rid, ipc_call_t *request)
228
static int loader_load(ipc_callid_t rid, ipc_call_t *request)
202
{
229
{
203
    int rc;
230
    int rc;
204
 
231
 
205
    elf_info_t prog_info;
-
 
206
    elf_info_t interp_info;
-
 
207
 
-
 
208
//  printf("Load program '%s'\n", pathname);
232
//  printf("Load program '%s'\n", pathname);
209
 
233
 
210
    rc = elf_load_file(pathname, 0, &prog_info);
234
    rc = elf_load_file(pathname, 0, &prog_info);
211
    if (rc < 0) {
235
    if (rc < 0) {
212
        printf("failed to load program\n");
236
        printf("failed to load program\n");
213
        ipc_answer_0(rid, EINVAL);
237
        ipc_answer_0(rid, EINVAL);
214
        return 1;
238
        return 1;
215
    }
239
    }
216
 
240
 
217
//  printf("Create PCB\n");
241
//  printf("Create PCB\n");
218
    elf_create_pcb(&prog_info, &pcb);
242
    elf_create_pcb(&prog_info, &pcb);
219
 
243
 
220
    pcb.argc = argc;
244
    pcb.argc = argc;
221
    pcb.argv = argv;
245
    pcb.argv = argv;
222
 
246
 
223
    if (prog_info.interp == NULL) {
247
    if (prog_info.interp == NULL) {
224
        /* Statically linked program */
248
        /* Statically linked program */
225
//      printf("Run statically linked program\n");
249
//      printf("Run statically linked program\n");
226
//      printf("entry point: 0x%llx\n", prog_info.entry);
250
//      printf("entry point: 0x%llx\n", prog_info.entry);
-
 
251
        is_dyn_linked = false;
227
        ipc_answer_0(rid, EOK);
252
        ipc_answer_0(rid, EOK);
228
        close_console();
-
 
229
        elf_run(&prog_info, &pcb);
-
 
230
        return 0;
253
        return 0;
231
    }
254
    }
232
 
255
 
233
    printf("Load dynamic linker '%s'\n", prog_info.interp);
256
    printf("Load dynamic linker '%s'\n", prog_info.interp);
234
    rc = elf_load_file("/rtld.so", RTLD_BIAS, &interp_info);
257
    rc = elf_load_file("/rtld.so", RTLD_BIAS, &interp_info);
235
    if (rc < 0) {
258
    if (rc < 0) {
236
        printf("failed to load dynamic linker\n");
259
        printf("failed to load dynamic linker\n");
237
        ipc_answer_0(rid, EINVAL);
260
        ipc_answer_0(rid, EINVAL);
238
        return 1;
261
        return 1;
239
    }
262
    }
240
 
263
 
241
    /*
264
    /*
242
     * Provide dynamic linker with some useful data
265
     * Provide dynamic linker with some useful data
243
     */
266
     */
244
    pcb.rtld_dynamic = interp_info.dynamic;
267
    pcb.rtld_dynamic = interp_info.dynamic;
245
    pcb.rtld_bias = RTLD_BIAS;
268
    pcb.rtld_bias = RTLD_BIAS;
246
 
269
 
247
    printf("run dynamic linker\n");
270
    is_dyn_linked = true;
248
    printf("entry point: 0x%llx\n", interp_info.entry);
-
 
249
    close_console();
-
 
250
 
-
 
251
    ipc_answer_0(rid, EOK);
271
    ipc_answer_0(rid, EOK);
252
    elf_run(&interp_info, &pcb);
-
 
253
 
272
 
254
    /* Not reached */
-
 
255
    return 0;
273
    return 0;
256
}
274
}
257
 
275
 
-
 
276
 
-
 
277
/** Run the previously loaded program.
-
 
278
 *
-
 
279
 * @param rid
-
 
280
 * @param request
-
 
281
 * @return 0 on success, !0 on error.
-
 
282
 */
-
 
283
static void loader_run(ipc_callid_t rid, ipc_call_t *request)
-
 
284
{
-
 
285
    if (is_dyn_linked == true) {
-
 
286
        /* Dynamically linked program */
-
 
287
        printf("run dynamic linker\n");
-
 
288
        printf("entry point: 0x%llx\n", interp_info.entry);
-
 
289
        close_console();
-
 
290
 
-
 
291
        ipc_answer_0(rid, EOK);
-
 
292
        elf_run(&interp_info, &pcb);
-
 
293
 
-
 
294
    } else {
-
 
295
        /* Statically linked program */
-
 
296
        close_console();
-
 
297
        ipc_answer_0(rid, EOK);
-
 
298
        elf_run(&prog_info, &pcb);
-
 
299
    }
-
 
300
 
-
 
301
    /* Not reached */
-
 
302
}
-
 
303
 
258
/** Handle loader connection.
304
/** Handle loader connection.
259
 *
305
 *
260
 * Receive and carry out commands (of which the last one should be
306
 * Receive and carry out commands (of which the last one should be
261
 * to execute the loaded program).
307
 * to execute the loaded program).
262
 */
308
 */
263
static void loader_connection(ipc_callid_t iid, ipc_call_t *icall)
309
static void loader_connection(ipc_callid_t iid, ipc_call_t *icall)
264
{
310
{
265
    ipc_callid_t callid;
311
    ipc_callid_t callid;
266
    ipc_call_t call;
312
    ipc_call_t call;
267
    int retval;
313
    int retval;
268
 
314
 
269
    /* Ignore parameters, the connection is already open */
315
    /* Ignore parameters, the connection is already open */
270
    (void)iid; (void)icall;
316
    (void)iid; (void)icall;
271
 
317
 
272
    while (1) {
318
    while (1) {
273
        callid = async_get_call(&call);
319
        callid = async_get_call(&call);
274
//      printf("received call from phone %d, method=%d\n",
-
 
275
//          call.in_phone_hash, IPC_GET_METHOD(call));
-
 
-
 
320
 
276
        switch (IPC_GET_METHOD(call)) {
321
        switch (IPC_GET_METHOD(call)) {
-
 
322
        case LOADER_GET_TASKID:
-
 
323
            loader_get_taskid(callid, &call);
-
 
324
            continue;
277
        case LOADER_SET_PATHNAME:
325
        case LOADER_SET_PATHNAME:
278
            loader_set_pathname(callid, &call);
326
            loader_set_pathname(callid, &call);
279
            continue;
327
            continue;
280
        case LOADER_SET_ARGS:
328
        case LOADER_SET_ARGS:
281
            loader_set_args(callid, &call);
329
            loader_set_args(callid, &call);
-
 
330
            continue;
-
 
331
        case LOADER_LOAD:
-
 
332
            loader_load(callid, &call);
-
 
333
            continue;
282
        case LOADER_RUN:
334
        case LOADER_RUN:
283
            loader_run(callid, &call);
335
            loader_run(callid, &call);
284
            exit(0);
-
 
285
            continue;
336
            /* Not reached */
286
        default:
337
        default:
287
            retval = ENOENT;
338
            retval = ENOENT;
288
            break;
339
            break;
289
        }
340
        }
290
        if ((callid & IPC_CALLID_NOTIFICATION) == 0 &&
341
        if ((callid & IPC_CALLID_NOTIFICATION) == 0 &&
291
            IPC_GET_METHOD(call) != IPC_M_PHONE_HUNGUP) {
342
            IPC_GET_METHOD(call) != IPC_M_PHONE_HUNGUP) {
292
            printf("responding EINVAL to method %d\n",
343
            printf("responding EINVAL to method %d\n",
293
                IPC_GET_METHOD(call));
344
                IPC_GET_METHOD(call));
294
            ipc_answer_0(callid, EINVAL);
345
            ipc_answer_0(callid, EINVAL);
295
        }
346
        }
296
    }
347
    }
297
}
348
}
298
 
349
 
299
/** Program loader main function.
350
/** Program loader main function.
300
 */
351
 */
301
int main(int argc, char *argv[])
352
int main(int argc, char *argv[])
302
{
353
{
303
    ipc_callid_t callid;
354
    ipc_callid_t callid;
304
    ipc_call_t call;
355
    ipc_call_t call;
305
    ipcarg_t phone_hash;
356
    ipcarg_t phone_hash;
306
 
357
 
307
    /* The first call only communicates the incoming phone hash */
358
    /* The first call only communicates the incoming phone hash */
308
    callid = ipc_wait_for_call(&call);
359
    callid = ipc_wait_for_call(&call);
309
 
360
 
310
    if (IPC_GET_METHOD(call) != LOADER_HELLO) {
361
    if (IPC_GET_METHOD(call) != LOADER_HELLO) {
311
        if (IPC_GET_METHOD(call) != IPC_M_PHONE_HUNGUP)
362
        if (IPC_GET_METHOD(call) != IPC_M_PHONE_HUNGUP)
312
            ipc_answer_0(callid, EINVAL);
363
            ipc_answer_0(callid, EINVAL);
313
        return 1;
364
        return 1;
314
    }
365
    }
315
 
366
 
316
    ipc_answer_0(callid, EOK);
367
    ipc_answer_0(callid, EOK);
317
    phone_hash = call.in_phone_hash;
368
    phone_hash = call.in_phone_hash;
318
 
369
 
319
    /*
370
    /*
320
     * Up until now async must not be used as it couldn't
371
     * Up until now async must not be used as it couldn't
321
     * handle incoming requests. (Which means e.g. printf()
372
     * handle incoming requests. (Which means e.g. printf()
322
     * cannot be used)
373
     * cannot be used)
323
     */
374
     */
324
    async_new_connection(phone_hash, 0, NULL, loader_connection);
375
    async_new_connection(phone_hash, 0, NULL, loader_connection);
325
    async_manager();
376
    async_manager();
326
 
377
 
327
    /* not reached */
378
    /* not reached */
328
    return 0;
379
    return 0;
329
}
380
}
330
 
381
 
331
/** @}
382
/** @}
332
 */
383
 */
333
 
384