2014-09-15 18:15:19 +02:00
|
|
|
/****************************************************************************
|
2022-04-20 14:53:05 +02:00
|
|
|
* sched/task/task_execve.c
|
2014-09-15 18:15:19 +02:00
|
|
|
*
|
2021-02-08 16:33:58 +01:00
|
|
|
* Licensed to the Apache Software Foundation (ASF) under one or more
|
|
|
|
* contributor license agreements. See the NOTICE file distributed with
|
|
|
|
* this work for additional information regarding copyright ownership. The
|
|
|
|
* ASF licenses this file to you 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
|
2014-09-15 18:15:19 +02:00
|
|
|
*
|
2021-02-08 16:33:58 +01:00
|
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
2014-09-15 18:15:19 +02:00
|
|
|
*
|
2021-02-08 16:33:58 +01:00
|
|
|
* 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.
|
2014-09-15 18:15:19 +02:00
|
|
|
*
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
|
|
* Included Files
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
#include <nuttx/config.h>
|
|
|
|
|
|
|
|
#include <stdlib.h>
|
|
|
|
#include <unistd.h>
|
|
|
|
#include <errno.h>
|
|
|
|
#include <debug.h>
|
|
|
|
|
|
|
|
#include <nuttx/binfmt/binfmt.h>
|
|
|
|
#include <nuttx/binfmt/symtab.h>
|
|
|
|
|
|
|
|
#ifdef CONFIG_LIBC_EXECFUNCS
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
|
|
* Pre-processor Definitions
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
/****************************************************************************
|
2016-02-22 01:08:58 +01:00
|
|
|
* Private Data
|
2014-09-15 18:15:19 +02:00
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
|
|
* Public Functions
|
|
|
|
****************************************************************************/
|
|
|
|
|
|
|
|
/****************************************************************************
|
|
|
|
* Name: execv
|
|
|
|
*
|
|
|
|
* Description:
|
|
|
|
* The standard 'exec' family of functions will replace the current process
|
|
|
|
* image with a new process image. The new image will be constructed from a
|
|
|
|
* regular, executable file called the new process image file. There will
|
|
|
|
* be no return from a successful exec, because the calling process image
|
|
|
|
* is overlaid by the new process image.
|
|
|
|
*
|
|
|
|
* Simplified 'execl()' and 'execv()' functions are provided by NuttX for
|
|
|
|
* compatibility. NuttX is a tiny embedded RTOS that does not support
|
|
|
|
* processes and hence the concept of overlaying a tasks process image with
|
|
|
|
* a new process image does not make any sense. In NuttX, these functions
|
|
|
|
* are wrapper functions that:
|
|
|
|
*
|
|
|
|
* 1. Call the non-standard binfmt function 'exec', and then
|
|
|
|
* 2. exit(0).
|
|
|
|
*
|
|
|
|
* Note the inefficiency when 'exec[l|v]()' is called in the normal, two-
|
|
|
|
* step process: (1) first call vfork() to create a new thread, then (2)
|
|
|
|
* call 'exec[l|v]()' to replace the new thread with a program from the
|
|
|
|
* file system. Since the new thread will be terminated by the
|
|
|
|
* 'exec[l|v]()' call, it really served no purpose other than to support
|
|
|
|
* Unix compatility.
|
|
|
|
*
|
|
|
|
* The non-standard binfmt function 'exec()' needs to have (1) a symbol
|
|
|
|
* table that provides the list of symbols exported by the base code, and
|
|
|
|
* (2) the number of symbols in that table. This information is currently
|
2020-03-08 13:51:33 +01:00
|
|
|
* provided to 'exec()' from 'exec[l|v]()' via NuttX configuration
|
|
|
|
* settings:
|
2014-09-15 18:15:19 +02:00
|
|
|
*
|
2019-10-24 18:49:28 +02:00
|
|
|
* CONFIG_LIBC_EXECFUNCS : Enable exec[l|v] support
|
|
|
|
* CONFIG_EXECFUNCS_HAVE_SYMTAB : Defined if there is a pre-defined
|
|
|
|
* symbol table
|
|
|
|
* CONFIG_EXECFUNCS_SYMTAB_ARRAY : Symbol table name used by exec[l|v]
|
|
|
|
* CONFIG_EXECFUNCS_NSYMBOLS_VAR : Variable holding number of symbols
|
|
|
|
* in the table
|
2014-09-15 18:15:19 +02:00
|
|
|
*
|
|
|
|
* As a result of the above, the current implementations of 'execl()' and
|
|
|
|
* 'execv()' suffer from some incompatibilities that may or may not be
|
|
|
|
* addressed in a future version of NuttX. Other than just being an
|
|
|
|
* inefficient use of MCU resource, the most serious of these is that
|
|
|
|
* the exec'ed task will not have the same task ID as the vfork'ed
|
|
|
|
* function. So the parent function cannot know the ID of the exec'ed
|
|
|
|
* task.
|
|
|
|
*
|
|
|
|
* Input Parameters:
|
2021-08-01 09:27:08 +02:00
|
|
|
* path - The path to the program to be executed. If CONFIG_LIBC_ENVPATH
|
2014-09-15 18:15:19 +02:00
|
|
|
* is defined in the configuration, then this may be a relative path
|
|
|
|
* from the current working directory. Otherwise, path must be the
|
|
|
|
* absolute path to the program.
|
|
|
|
* argv - A pointer to an array of string arguments. The end of the
|
|
|
|
* array is indicated with a NULL entry.
|
2022-04-20 14:53:05 +02:00
|
|
|
* envp - An array of character pointers to null-terminated strings that
|
|
|
|
* provide the environment for the new process image. The environment
|
|
|
|
* array is terminated by a null pointer.
|
2014-09-15 18:15:19 +02:00
|
|
|
*
|
|
|
|
* Returned Value:
|
|
|
|
* This function does not return on success. On failure, it will return
|
|
|
|
* -1 (ERROR) and will set the 'errno' value appropriately.
|
|
|
|
*
|
|
|
|
****************************************************************************/
|
|
|
|
|
2022-04-20 14:53:05 +02:00
|
|
|
int execve(FAR const char *path, FAR char * const argv[],
|
|
|
|
FAR char *const envp[])
|
2014-09-15 18:15:19 +02:00
|
|
|
{
|
|
|
|
FAR const struct symtab_s *symtab;
|
|
|
|
int nsymbols;
|
|
|
|
int ret;
|
|
|
|
|
|
|
|
/* Get the current symbol table selection */
|
|
|
|
|
|
|
|
exec_getsymtab(&symtab, &nsymbols);
|
|
|
|
|
|
|
|
/* Start the task */
|
|
|
|
|
2022-04-20 14:53:05 +02:00
|
|
|
ret = exec(path, argv, envp, symtab, nsymbols);
|
2014-09-15 18:15:19 +02:00
|
|
|
if (ret < 0)
|
|
|
|
{
|
2021-02-15 09:08:51 +01:00
|
|
|
serr("ERROR: exec failed: %d\n", get_errno());
|
2014-09-15 18:15:19 +02:00
|
|
|
return ERROR;
|
|
|
|
}
|
|
|
|
|
|
|
|
/* Then exit */
|
|
|
|
|
|
|
|
exit(0);
|
|
|
|
|
|
|
|
/* We should not get here, but might be needed by some compilers. Other,
|
2020-03-08 13:51:33 +01:00
|
|
|
* smarter compilers might complain that this code is unreachable. You
|
|
|
|
* just can't win.
|
2014-09-15 18:15:19 +02:00
|
|
|
*/
|
|
|
|
|
|
|
|
return ERROR;
|
|
|
|
}
|
|
|
|
|
|
|
|
#endif /* CONFIG_LIBC_EXECFUNCS */
|