Subversion Repositories HelenOS

Rev

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

Rev 4014 Rev 4154
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 <bool.h>
50
#include <fcntl.h>
50
#include <fcntl.h>
51
#include <sys/types.h>
51
#include <sys/types.h>
52
#include <ipc/ipc.h>
52
#include <ipc/ipc.h>
53
#include <ipc/services.h>
53
#include <ipc/services.h>
54
#include <ipc/loader.h>
54
#include <ipc/loader.h>
55
#include <loader/pcb.h>
55
#include <loader/pcb.h>
-
 
56
#include <console.h>
56
#include <errno.h>
57
#include <errno.h>
57
#include <async.h>
58
#include <async.h>
58
#include <as.h>
59
#include <as.h>
59
 
60
 
60
#include <elf.h>
61
#include <elf.h>
61
#include <elf_load.h>
62
#include <elf_load.h>
62
 
63
 
63
#define DPRINTF(...)
64
#define DPRINTF(...)
64
 
65
 
65
/** Pathname of the file that will be loaded */
66
/** Pathname of the file that will be loaded */
66
static char *pathname = NULL;
67
static char *pathname = NULL;
67
 
68
 
68
/** The Program control block */
69
/** The Program control block */
69
static pcb_t pcb;
70
static pcb_t pcb;
70
 
71
 
71
/** Number of arguments */
72
/** Number of arguments */
72
static int argc = 0;
73
static int argc = 0;
73
/** Argument vector */
74
/** Argument vector */
74
static char **argv = NULL;
75
static char **argv = NULL;
75
/** Buffer holding all arguments */
76
/** Buffer holding all arguments */
76
static char *arg_buf = NULL;
77
static char *arg_buf = NULL;
77
 
78
 
78
static elf_info_t prog_info;
79
static elf_info_t prog_info;
79
static elf_info_t interp_info;
80
static elf_info_t interp_info;
80
 
81
 
81
static bool is_dyn_linked;
82
static bool is_dyn_linked;
82
 
83
 
83
/** Used to limit number of connections to one. */
84
/** Used to limit number of connections to one. */
84
static bool connected;
85
static bool connected;
85
 
86
 
86
static void loader_get_taskid(ipc_callid_t rid, ipc_call_t *request)
87
static void loader_get_taskid(ipc_callid_t rid, ipc_call_t *request)
87
{
88
{
88
    ipc_callid_t callid;
89
    ipc_callid_t callid;
89
    task_id_t task_id;
90
    task_id_t task_id;
90
    size_t len;
91
    size_t len;
91
   
92
   
92
    task_id = task_get_id();
93
    task_id = task_get_id();
93
   
94
   
94
    if (!ipc_data_read_receive(&callid, &len)) {
95
    if (!ipc_data_read_receive(&callid, &len)) {
95
        ipc_answer_0(callid, EINVAL);
96
        ipc_answer_0(callid, EINVAL);
96
        ipc_answer_0(rid, EINVAL);
97
        ipc_answer_0(rid, EINVAL);
97
        return;
98
        return;
98
    }
99
    }
99
   
100
   
100
    if (len > sizeof(task_id))
101
    if (len > sizeof(task_id))
101
        len = sizeof(task_id);
102
        len = sizeof(task_id);
102
   
103
   
103
    ipc_data_read_finalize(callid, &task_id, len);
104
    ipc_data_read_finalize(callid, &task_id, len);
104
    ipc_answer_0(rid, EOK);
105
    ipc_answer_0(rid, EOK);
105
}
106
}
106
 
107
 
107
 
108
 
108
/** Receive a call setting pathname of the program to execute.
109
/** Receive a call setting pathname of the program to execute.
109
 *
110
 *
110
 * @param rid
111
 * @param rid
111
 * @param request
112
 * @param request
112
 */
113
 */
113
static void loader_set_pathname(ipc_callid_t rid, ipc_call_t *request)
114
static void loader_set_pathname(ipc_callid_t rid, ipc_call_t *request)
114
{
115
{
115
    ipc_callid_t callid;
116
    ipc_callid_t callid;
116
    size_t len;
117
    size_t len;
117
    char *name_buf;
118
    char *name_buf;
118
   
119
   
119
    if (!ipc_data_write_receive(&callid, &len)) {
120
    if (!ipc_data_write_receive(&callid, &len)) {
120
        ipc_answer_0(callid, EINVAL);
121
        ipc_answer_0(callid, EINVAL);
121
        ipc_answer_0(rid, EINVAL);
122
        ipc_answer_0(rid, EINVAL);
122
        return;
123
        return;
123
    }
124
    }
124
   
125
   
125
    name_buf = malloc(len + 1);
126
    name_buf = malloc(len + 1);
126
    if (!name_buf) {
127
    if (!name_buf) {
127
        ipc_answer_0(callid, ENOMEM);
128
        ipc_answer_0(callid, ENOMEM);
128
        ipc_answer_0(rid, ENOMEM);
129
        ipc_answer_0(rid, ENOMEM);
129
        return;
130
        return;
130
    }
131
    }
131
   
132
   
132
    ipc_data_write_finalize(callid, name_buf, len);
133
    ipc_data_write_finalize(callid, name_buf, len);
133
    ipc_answer_0(rid, EOK);
134
    ipc_answer_0(rid, EOK);
134
   
135
   
135
    if (pathname != NULL) {
136
    if (pathname != NULL) {
136
        free(pathname);
137
        free(pathname);
137
        pathname = NULL;
138
        pathname = NULL;
138
    }
139
    }
139
   
140
   
140
    name_buf[len] = '\0';
141
    name_buf[len] = '\0';
141
    pathname = name_buf;
142
    pathname = name_buf;
142
}
143
}
143
 
144
 
144
/** Receive a call setting arguments of the program to execute.
145
/** Receive a call setting arguments of the program to execute.
145
 *
146
 *
146
 * @param rid
147
 * @param rid
147
 * @param request
148
 * @param request
148
 */
149
 */
149
static void loader_set_args(ipc_callid_t rid, ipc_call_t *request)
150
static void loader_set_args(ipc_callid_t rid, ipc_call_t *request)
150
{
151
{
151
    ipc_callid_t callid;
152
    ipc_callid_t callid;
152
    size_t buf_len, arg_len;
153
    size_t buf_len, arg_len;
153
    char *p;
154
    char *p;
154
    int n;
155
    int n;
155
   
156
   
156
    if (!ipc_data_write_receive(&callid, &buf_len)) {
157
    if (!ipc_data_write_receive(&callid, &buf_len)) {
157
        ipc_answer_0(callid, EINVAL);
158
        ipc_answer_0(callid, EINVAL);
158
        ipc_answer_0(rid, EINVAL);
159
        ipc_answer_0(rid, EINVAL);
159
        return;
160
        return;
160
    }
161
    }
161
   
162
   
162
    if (arg_buf != NULL) {
163
    if (arg_buf != NULL) {
163
        free(arg_buf);
164
        free(arg_buf);
164
        arg_buf = NULL;
165
        arg_buf = NULL;
165
    }
166
    }
166
   
167
   
167
    if (argv != NULL) {
168
    if (argv != NULL) {
168
        free(argv);
169
        free(argv);
169
        argv = NULL;
170
        argv = NULL;
170
    }
171
    }
171
   
172
   
172
    arg_buf = malloc(buf_len + 1);
173
    arg_buf = malloc(buf_len + 1);
173
    if (!arg_buf) {
174
    if (!arg_buf) {
174
        ipc_answer_0(callid, ENOMEM);
175
        ipc_answer_0(callid, ENOMEM);
175
        ipc_answer_0(rid, ENOMEM);
176
        ipc_answer_0(rid, ENOMEM);
176
        return;
177
        return;
177
    }
178
    }
178
   
179
   
179
    ipc_data_write_finalize(callid, arg_buf, buf_len);
180
    ipc_data_write_finalize(callid, arg_buf, buf_len);
180
    ipc_answer_0(rid, EOK);
181
    ipc_answer_0(rid, EOK);
181
   
182
   
182
    arg_buf[buf_len] = '\0';
183
    arg_buf[buf_len] = '\0';
183
   
184
   
184
    /*
185
    /*
185
     * Count number of arguments
186
     * Count number of arguments
186
     */
187
     */
187
    p = arg_buf;
188
    p = arg_buf;
188
    n = 0;
189
    n = 0;
189
    while (p < arg_buf + buf_len) {
190
    while (p < arg_buf + buf_len) {
190
        arg_len = strlen(p);
191
        arg_len = strlen(p);
191
        p = p + arg_len + 1;
192
        p = p + arg_len + 1;
192
        ++n;
193
        ++n;
193
    }
194
    }
194
   
195
   
195
    /* Allocate argv */
196
    /* Allocate argv */
196
    argv = malloc((n + 1) * sizeof(char *));
197
    argv = malloc((n + 1) * sizeof(char *));
197
   
198
   
198
    if (argv == NULL) {
199
    if (argv == NULL) {
199
        free(arg_buf);
200
        free(arg_buf);
200
        ipc_answer_0(callid, ENOMEM);
201
        ipc_answer_0(callid, ENOMEM);
201
        ipc_answer_0(rid, ENOMEM);
202
        ipc_answer_0(rid, ENOMEM);
202
        return;
203
        return;
203
    }
204
    }
204
   
205
   
205
    /*
206
    /*
206
     * Fill argv with argument pointers
207
     * Fill argv with argument pointers
207
     */
208
     */
208
    p = arg_buf;
209
    p = arg_buf;
209
    n = 0;
210
    n = 0;
210
    while (p < arg_buf + buf_len) {
211
    while (p < arg_buf + buf_len) {
211
        argv[n] = p;
212
        argv[n] = p;
212
       
213
       
213
        arg_len = strlen(p);
214
        arg_len = strlen(p);
214
        p = p + arg_len + 1;
215
        p = p + arg_len + 1;
215
        ++n;
216
        ++n;
216
    }
217
    }
217
   
218
   
218
    argc = n;
219
    argc = n;
219
    argv[n] = NULL;
220
    argv[n] = NULL;
220
}
221
}
221
 
222
 
222
/** Load the previously selected program.
223
/** Load the previously selected program.
223
 *
224
 *
224
 * @param rid
225
 * @param rid
225
 * @param request
226
 * @param request
226
 * @return 0 on success, !0 on error.
227
 * @return 0 on success, !0 on error.
227
 */
228
 */
228
static int loader_load(ipc_callid_t rid, ipc_call_t *request)
229
static int loader_load(ipc_callid_t rid, ipc_call_t *request)
229
{
230
{
230
    int rc;
231
    int rc;
231
   
232
   
232
    rc = elf_load_file(pathname, 0, &prog_info);
233
    rc = elf_load_file(pathname, 0, &prog_info);
233
    if (rc < 0) {
234
    if (rc < 0) {
234
        DPRINTF("Failed to load executable '%s'.\n", pathname);
235
        DPRINTF("Failed to load executable '%s'.\n", pathname);
235
        ipc_answer_0(rid, EINVAL);
236
        ipc_answer_0(rid, EINVAL);
236
        return 1;
237
        return 1;
237
    }
238
    }
238
   
239
   
239
    elf_create_pcb(&prog_info, &pcb);
240
    elf_create_pcb(&prog_info, &pcb);
240
   
241
   
241
    pcb.argc = argc;
242
    pcb.argc = argc;
242
    pcb.argv = argv;
243
    pcb.argv = argv;
243
   
244
   
244
    if (prog_info.interp == NULL) {
245
    if (prog_info.interp == NULL) {
245
        /* Statically linked program */
246
        /* Statically linked program */
246
        is_dyn_linked = false;
247
        is_dyn_linked = false;
247
        ipc_answer_0(rid, EOK);
248
        ipc_answer_0(rid, EOK);
248
        return 0;
249
        return 0;
249
    }
250
    }
250
   
251
   
251
    rc = elf_load_file(prog_info.interp, 0, &interp_info);
252
    rc = elf_load_file(prog_info.interp, 0, &interp_info);
252
    if (rc < 0) {
253
    if (rc < 0) {
253
        DPRINTF("Failed to load interpreter '%s.'\n",
254
        DPRINTF("Failed to load interpreter '%s.'\n",
254
            prog_info.interp);
255
            prog_info.interp);
255
        ipc_answer_0(rid, EINVAL);
256
        ipc_answer_0(rid, EINVAL);
256
        return 1;
257
        return 1;
257
    }
258
    }
258
   
259
   
259
    is_dyn_linked = true;
260
    is_dyn_linked = true;
260
    ipc_answer_0(rid, EOK);
261
    ipc_answer_0(rid, EOK);
261
   
262
   
262
    return 0;
263
    return 0;
263
}
264
}
264
 
265
 
265
 
266
 
266
/** Run the previously loaded program.
267
/** Run the previously loaded program.
267
 *
268
 *
268
 * @param rid
269
 * @param rid
269
 * @param request
270
 * @param request
270
 * @return 0 on success, !0 on error.
271
 * @return 0 on success, !0 on error.
271
 */
272
 */
272
static void loader_run(ipc_callid_t rid, ipc_call_t *request)
273
static void loader_run(ipc_callid_t rid, ipc_call_t *request)
273
{
274
{
274
    const char *cp;
275
    const char *cp;
275
   
276
   
276
    /* Set the task name. */
277
    /* Set the task name. */
277
    cp = strrchr(pathname, '/');
278
    cp = strrchr(pathname, '/');
278
    cp = (cp == NULL) ? pathname : (cp + 1);
279
    cp = (cp == NULL) ? pathname : (cp + 1);
279
    task_set_name(cp);
280
    task_set_name(cp);
280
   
281
   
281
    if (is_dyn_linked == true) {
282
    if (is_dyn_linked == true) {
282
        /* Dynamically linked program */
283
        /* Dynamically linked program */
283
        DPRINTF("Run ELF interpreter.\n");
284
        DPRINTF("Run ELF interpreter.\n");
284
        DPRINTF("Entry point: 0x%lx\n", interp_info.entry);
285
        DPRINTF("Entry point: 0x%lx\n", interp_info.entry);
285
        close_console();
286
        console_close();
286
       
287
       
287
        ipc_answer_0(rid, EOK);
288
        ipc_answer_0(rid, EOK);
288
        elf_run(&interp_info, &pcb);
289
        elf_run(&interp_info, &pcb);
289
    } else {
290
    } else {
290
        /* Statically linked program */
291
        /* Statically linked program */
291
        close_console();
292
        console_close();
292
        ipc_answer_0(rid, EOK);
293
        ipc_answer_0(rid, EOK);
293
        elf_run(&prog_info, &pcb);
294
        elf_run(&prog_info, &pcb);
294
    }
295
    }
295
 
296
 
296
    /* Not reached */
297
    /* Not reached */
297
}
298
}
298
 
299
 
299
/** Handle loader connection.
300
/** Handle loader connection.
300
 *
301
 *
301
 * Receive and carry out commands (of which the last one should be
302
 * Receive and carry out commands (of which the last one should be
302
 * to execute the loaded program).
303
 * to execute the loaded program).
303
 */
304
 */
304
static void loader_connection(ipc_callid_t iid, ipc_call_t *icall)
305
static void loader_connection(ipc_callid_t iid, ipc_call_t *icall)
305
{
306
{
306
    ipc_callid_t callid;
307
    ipc_callid_t callid;
307
    ipc_call_t call;
308
    ipc_call_t call;
308
    int retval;
309
    int retval;
309
   
310
   
310
    /* Already have a connection? */
311
    /* Already have a connection? */
311
    if (connected) {
312
    if (connected) {
312
        ipc_answer_0(iid, ELIMIT);
313
        ipc_answer_0(iid, ELIMIT);
313
        return;
314
        return;
314
    }
315
    }
315
   
316
   
316
    connected = true;
317
    connected = true;
317
   
318
   
318
    /* Accept the connection */
319
    /* Accept the connection */
319
    ipc_answer_0(iid, EOK);
320
    ipc_answer_0(iid, EOK);
320
   
321
   
321
    /* Ignore parameters, the connection is already open */
322
    /* Ignore parameters, the connection is already open */
322
    (void) iid;
323
    (void) iid;
323
    (void) icall;
324
    (void) icall;
324
   
325
   
325
    while (1) {
326
    while (1) {
326
        callid = async_get_call(&call);
327
        callid = async_get_call(&call);
327
       
328
       
328
        switch (IPC_GET_METHOD(call)) {
329
        switch (IPC_GET_METHOD(call)) {
329
        case IPC_M_PHONE_HUNGUP:
330
        case IPC_M_PHONE_HUNGUP:
330
            exit(0);
331
            exit(0);
331
        case LOADER_GET_TASKID:
332
        case LOADER_GET_TASKID:
332
            loader_get_taskid(callid, &call);
333
            loader_get_taskid(callid, &call);
333
            continue;
334
            continue;
334
        case LOADER_SET_PATHNAME:
335
        case LOADER_SET_PATHNAME:
335
            loader_set_pathname(callid, &call);
336
            loader_set_pathname(callid, &call);
336
            continue;
337
            continue;
337
        case LOADER_SET_ARGS:
338
        case LOADER_SET_ARGS:
338
            loader_set_args(callid, &call);
339
            loader_set_args(callid, &call);
339
            continue;
340
            continue;
340
        case LOADER_LOAD:
341
        case LOADER_LOAD:
341
            loader_load(callid, &call);
342
            loader_load(callid, &call);
342
            continue;
343
            continue;
343
        case LOADER_RUN:
344
        case LOADER_RUN:
344
            loader_run(callid, &call);
345
            loader_run(callid, &call);
345
            /* Not reached */
346
            /* Not reached */
346
        default:
347
        default:
347
            retval = ENOENT;
348
            retval = ENOENT;
348
            break;
349
            break;
349
        }
350
        }
350
        if ((callid & IPC_CALLID_NOTIFICATION) == 0 &&
351
        if ((callid & IPC_CALLID_NOTIFICATION) == 0 &&
351
            IPC_GET_METHOD(call) != IPC_M_PHONE_HUNGUP) {
352
            IPC_GET_METHOD(call) != IPC_M_PHONE_HUNGUP) {
352
            DPRINTF("Responding EINVAL to method %d.\n",
353
            DPRINTF("Responding EINVAL to method %d.\n",
353
                IPC_GET_METHOD(call));
354
                IPC_GET_METHOD(call));
354
            ipc_answer_0(callid, EINVAL);
355
            ipc_answer_0(callid, EINVAL);
355
        }
356
        }
356
    }
357
    }
357
}
358
}
358
 
359
 
359
/** Program loader main function.
360
/** Program loader main function.
360
 */
361
 */
361
int main(int argc, char *argv[])
362
int main(int argc, char *argv[])
362
{
363
{
363
    ipcarg_t phonead;
364
    ipcarg_t phonead;
364
   
365
   
365
    connected = false;
366
    connected = false;
366
   
367
   
367
    /* Set a handler of incomming connections. */
368
    /* Set a handler of incomming connections. */
368
    async_set_client_connection(loader_connection);
369
    async_set_client_connection(loader_connection);
369
   
370
   
370
    /* Register at naming service. */
371
    /* Register at naming service. */
371
    if (ipc_connect_to_me(PHONE_NS, SERVICE_LOAD, 0, 0, &phonead) != 0)
372
    if (ipc_connect_to_me(PHONE_NS, SERVICE_LOAD, 0, 0, &phonead) != 0)
372
        return -1;
373
        return -1;
373
   
374
   
374
    async_manager();
375
    async_manager();
375
   
376
   
376
    /* Never reached */
377
    /* Never reached */
377
    return 0;
378
    return 0;
378
}
379
}
379
 
380
 
380
/** @}
381
/** @}
381
 */
382
 */
382
 
383