Add interfaces to support getting/setting of thread/task names

git-svn-id: https://nuttx.svn.sourceforge.net/svnroot/nuttx/trunk@4658 7fd9a85b-ad96-42d3-883c-3090e2eb8679
2026-10-26 18:53:33 +08:00 · 2012-04-26 15:00:35 +00:00
parent 414af0aef2
commit 305cf084d4
10 changed files with 296 additions and 9 deletions
@@ -43,7 +43,7 @@ MISC_SRCS	= os_start.c os_bringup.c errno_getptr.c errno_get.c errno_set.c \
 		  sched_getstreams.c sched_setupidlefiles.c sched_setuptaskfiles.c \
 		  sched_setuppthreadfiles.c sched_releasefiles.c

-TSK_SRCS	= task_create.c task_init.c task_setup.c task_activate.c \
+TSK_SRCS	= prctl.c task_create.c task_init.c task_setup.c task_activate.c \
 		  task_start.c task_delete.c task_deletecurrent.c task_exithook.c \
 		  task_restart.c exit.c getpid.c sched_addreadytorun.c \
 		  sched_removereadytorun.c sched_addprioritized.c sched_mergepending.c \
@@ -0,0 +1,138 @@
+/************************************************************************
+ * sched/prctl.c
+ *
+ *   Copyright (C) 2012 Gregory Nutt. All rights reserved.
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in
+ *    the documentation and/or other materials provided with the
+ *    distribution.
+ * 3. Neither the name NuttX nor the names of its contributors may be
+ *    used to endorse or promote products derived from this software
+ *    without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+ * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+ * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+ * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+ * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
+ * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
+ * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+ * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ *
+ ************************************************************************/
+
+/************************************************************************
+ * Included Files
+ ************************************************************************/
+
+#include <nuttx/config.h>
+
+#include <sys/prctl.h>
+#include <stdarg.h>
+#include <string.h>
+#include <errno.h>
+#include <debug.h>
+
+#include <nuttx/sched.h>
+#include "os_internal.h"
+
+/************************************************************************
+ * Private Functions
+ ************************************************************************/
+
+/************************************************************************
+ * Public Functions
+ ************************************************************************/
+
+/****************************************************************************
+ * Name: prctl
+ *
+ * Description:
+ *   prctl() is called with a first argument describing what to do (with
+ *   values PR_* defined above) and with additional arguments depending on
+ *   the specific command.
+ *
+ * Returned Value:
+ *   The returned value may depend on the specific commnand.  For PR_SET_NAME
+ *   and PR_GET_NAME, the returned value of 0 indicates successful operation.
+ *   On any failure, -1 is retruend and the errno value is set appropriately.
+ *
+ *     EINVAL The value of 'option' is not recognized.
+ *     EFAULT optional arg1 is not a valid address.
+ *     ESRCH  No task/thread can be found corresponding to that specified
+ *       by optional arg1. 
+ *   
+ ****************************************************************************/
+
+int prctl(int option, ...)
+{
+  va_list ap;
+  int err;
+
+  va_start(ap, option);
+  switch (option)
+    {
+    case PR_SET_NAME:
+    case PR_GET_NAME:
+#if CONFIG_TASK_NAME_SIZE > 0
+      {
+        int       pid  = va_arg(ap, int);
+        char     *name = va_arg(ap, char *);
+        FAR _TCB *tcb  = sched_gettcb(pid);
+        if (!tcb)
+          {
+            sdbg("Pid does not correspond to a task: %d\n", pid);
+            err = ESRCH;
+            goto errout;
+          }
+
+        if (!name)
+          {
+            sdbg("No name provide\n");
+            err = EFAULT;
+            goto errout;
+          }
+
+        if (option == PR_SET_NAME)
+          {
+            strncpy(tcb->name, name, CONFIG_TASK_NAME_SIZE);
+          }
+        else
+          {
+            strncpy(name, tcb->name, CONFIG_TASK_NAME_SIZE-1);
+            name[CONFIG_TASK_NAME_SIZE-1];
+          }
+      }
+      break;
+#else
+      sdbg("Option not enabled: %d\n", option);
+      err = ENOSYS;
+      goto errout;
+#endif
+
+    default:
+      sdbg("Unrecognized option: %d\n", option);
+      err = EINVAL;
+      goto errout;
+    }
+
+  va_end(ap);
+  return OK;
+
+errout:
+  va_end(ap);
+  set_errno(err);
+  return ERROR;
+}