Consistently use "superuser" instead of "super user"
[pgsql.git] / src / port / unsetenv.c
blobb65f3521f9ccf296ff79ac4e91740874a656ad4f
1 /*-------------------------------------------------------------------------
3 * unsetenv.c
4 * unsetenv() emulation for machines without it
6 * Portions Copyright (c) 1996-2021, PostgreSQL Global Development Group
7 * Portions Copyright (c) 1994, Regents of the University of California
10 * IDENTIFICATION
11 * src/port/unsetenv.c
13 *-------------------------------------------------------------------------
16 #include "c.h"
19 int
20 unsetenv(const char *name)
22 char *envstr;
24 /* Error conditions, per POSIX */
25 if (name == NULL || name[0] == '\0' || strchr(name, '=') != NULL)
27 errno = EINVAL;
28 return -1;
31 if (getenv(name) == NULL)
32 return 0; /* no work */
35 * The technique embodied here works if libc follows the Single Unix Spec
36 * and actually uses the storage passed to putenv() to hold the environ
37 * entry. When we clobber the entry in the second step we are ensuring
38 * that we zap the actual environ member. However, there are some libc
39 * implementations (notably recent BSDs) that do not obey SUS but copy the
40 * presented string. This method fails on such platforms. Hopefully all
41 * such platforms have unsetenv() and thus won't be using this hack. See:
42 * http://www.greenend.org.uk/rjk/2008/putenv.html
44 * Note that repeatedly setting and unsetting a var using this code will
45 * leak memory.
48 envstr = (char *) malloc(strlen(name) + 2);
49 if (!envstr) /* not much we can do if no memory */
50 return -1;
52 /* Override the existing setting by forcibly defining the var */
53 sprintf(envstr, "%s=", name);
54 if (putenv(envstr))
55 return -1;
57 /* Now we can clobber the variable definition this way: */
58 strcpy(envstr, "=");
61 * This last putenv cleans up if we have multiple zero-length names as a
62 * result of unsetting multiple things.
64 return putenv(envstr);