/**************************************************************************** * sched/environ/env_setenv.c * * Copyright (C) 2007, 2009, 2011, 2013 Gregory Nutt. All rights reserved. * Author: Gregory Nutt * * 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 #ifndef CONFIG_DISABLE_ENVIRON #include #include #include #include #include #include #include "sched/sched.h" #include "environ/environ.h" /**************************************************************************** * Public Functions ****************************************************************************/ /**************************************************************************** * Name: setenv * * Description: * The setenv() function adds the variable name to the environment with the * specified 'value' if the varialbe 'name" does not exist. If the 'name' * does exist in the environment, then its value is changed to 'value' if * 'overwrite' is non-zero; if 'overwrite' is zero, then the value of name * unaltered. * * Parameters: * name - The name of the variable to change * value - The new value of the variable * overwrite - Replace any existing value if non-zero. * * Returned Value: * Zero on success * * Assumptions: * Not called from an interrupt handler * ****************************************************************************/ int setenv(FAR const char *name, FAR const char *value, int overwrite) { FAR struct tcb_s *rtcb; FAR struct task_group_s *group; FAR char *pvar; FAR char *newenvp; int newsize; int varlen; int ret = OK; /* Verify input parameter */ if (!name) { ret = EINVAL; goto errout; } /* if no value is provided, then this is the same as unsetenv (unless * overwrite is false) */ if (!value || *value == '\0') { /* If overwite is set then this is the same as unsetenv */ if (overwrite) { return unsetenv(name); } else { /* Otherwise, it is a request to remove a variable without altering it? */ return OK; } } /* Get a reference to the thread-private environ in the TCB. */ sched_lock(); rtcb = this_task(); group = rtcb->group; DEBUGASSERT(group); /* Check if the variable already exists */ if (group->tg_envp && (pvar = env_findvar(group, name)) != NULL) { /* It does! Do we have permission to overwrite the existing value? */ if (!overwrite) { /* No.. then just return success */ sched_unlock(); return OK; } /* Yes.. just remove the name=value pair from the environment. It will * be added again below. Note that we are responsible for reallocating * the environment buffer; this will happen below. */ (void)env_removevar(group, pvar); } /* Get the size of the new name=value string. The +2 is for the '=' and for * null terminator */ varlen = strlen(name) + strlen(value) + 2; /* Then allocate or reallocate the environment buffer */ if (group->tg_envp) { newsize = group->tg_envsize + varlen; newenvp = (FAR char *)kumm_realloc(group->tg_envp, newsize); if (!newenvp) { ret = ENOMEM; goto errout_with_lock; } pvar = &newenvp[group->tg_envsize]; } else { newsize = varlen; newenvp = (FAR char *)kumm_malloc(varlen); if (!newenvp) { ret = ENOMEM; goto errout_with_lock; } pvar = newenvp; } /* Save the new buffer and size */ group->tg_envp = newenvp; group->tg_envsize = newsize; /* Now, put the new name=value string into the environment buffer */ sprintf(pvar, "%s=%s", name, value); sched_unlock(); return OK; errout_with_lock: sched_unlock(); errout: set_errno(ret); return ERROR; } #endif /* CONFIG_DISABLE_ENVIRON */