/**************************************************************************** * binfmt/builtin.c * * 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 * * http://www.apache.org/licenses/LICENSE-2.0 * * 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. * ****************************************************************************/ /**************************************************************************** * Included Files ****************************************************************************/ #include #include #include #include #include #include #include #include #include #include #include #include #ifdef CONFIG_FS_BINFS /**************************************************************************** * Private Function Prototypes ****************************************************************************/ static int builtin_loadbinary(FAR struct binary_s *binp, FAR const char *filename, FAR const struct symtab_s *exports, int nexports); /**************************************************************************** * Private Data ****************************************************************************/ static struct binfmt_s g_builtin_binfmt = { NULL, /* next */ builtin_loadbinary, /* load */ NULL, /* unload */ }; /**************************************************************************** * Private Functions ****************************************************************************/ /**************************************************************************** * Name: builtin_loadbinary * * Description: * Verify that the file is an builtin binary. * ****************************************************************************/ static int builtin_loadbinary(FAR struct binary_s *binp, FAR const char *filename, FAR const struct symtab_s *exports, int nexports) { FAR const struct builtin_s *builtin; int fd; int index; int ret; binfo("Loading file: %s\n", filename); /* Open the binary file for reading (only) */ fd = nx_open(filename, O_RDONLY); if (fd < 0) { berr("ERROR: Failed to open binary %s: %d\n", filename, fd); return fd; } /* If this file is a BINFS file system, then we can recover the name of * the file using the FIOC_FILENAME ioctl() call. */ ret = nx_ioctl(fd, FIOC_FILENAME, (unsigned long)((uintptr_t)&filename)); if (ret < 0) { berr("ERROR: FIOC_FILENAME ioctl failed: %d\n", ret); nx_close(fd); return ret; } /* Other file systems may also support FIOC_FILENAME, so the real proof * is that we can look up the index to this name in g_builtins[]. */ index = builtin_isavail(filename); if (index < 0) { berr("ERROR: %s is not a builtin application\n", filename); nx_close(fd); return index; } /* Return the load information. NOTE: that there is no way to configure * the priority. That is a bug and needs to be fixed. */ builtin = builtin_for_index(index); binp->entrypt = builtin->main; binp->stacksize = builtin->stacksize; binp->priority = builtin->priority; nx_close(fd); return OK; } /**************************************************************************** * Public Functions ****************************************************************************/ /**************************************************************************** * Name: builtin_initialize * * Description: * In order to use the builtin binary format, this function must be called * during system initialize to register the builtin binary format. * * Returned Value: * This is a NuttX internal function so it follows the convention that * 0 (OK) is returned on success and a negated errno is returned on * failure. * ****************************************************************************/ int builtin_initialize(void) { int ret; /* Register ourselves as a binfmt loader */ binfo("Registering Builtin Loader\n"); ret = register_binfmt(&g_builtin_binfmt); if (ret != 0) { berr("Failed to register binfmt: %d\n", ret); } return ret; } /**************************************************************************** * Name: builtin_uninitialize * * Description: * Unregister the builtin binary loader * * Returned Value: * None * ****************************************************************************/ void builtin_uninitialize(void) { unregister_binfmt(&g_builtin_binfmt); } #endif /* CONFIG_FS_BINFS */