b82f58bfe3
Sometimes it's useful to provide a default value during an environment
expansion, if the environment variable isn't already set.
For instance $XDG_DATA_DIRS is suppose to default to:
/usr/local/share/:/usr/share/
if it's not yet set. That means callers wishing to augment
XDG_DATA_DIRS need to manually add those two values.
This commit changes replace_env to support the following shell
compatible default value syntax:
XDG_DATA_DIRS=/foo:${XDG_DATA_DIRS:-/usr/local/share/:/usr/share}
Likewise, it's useful to provide an alternate value during an
environment expansion, if the environment variable isn't already set.
For instance, $LD_LIBRARY_PATH will inadvertently search the current
working directory if it starts or ends with a colon, so the following
is usually wrong:
LD_LIBRARY_PATH=/foo/lib:${LD_LIBRARY_PATH}
To address that, this changes replace_env to support the following
shell compatible alternate value syntax:
LD_LIBRARY_PATH=/foo/lib${LD_LIBRARY_PATH:+:${LD_LIBRARY_PATH}}
[zj: gate the new syntax under REPLACE_ENV_ALLOW_EXTENDED switch, so
existing callers are not modified.]
67 lines
2.3 KiB
C
67 lines
2.3 KiB
C
#pragma once
|
|
|
|
/***
|
|
This file is part of systemd.
|
|
|
|
Copyright 2013 Lennart Poettering
|
|
|
|
systemd is free software; you can redistribute it and/or modify it
|
|
under the terms of the GNU Lesser General Public License as published by
|
|
the Free Software Foundation; either version 2.1 of the License, or
|
|
(at your option) any later version.
|
|
|
|
systemd is distributed in the hope that it will be useful, but
|
|
WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
Lesser General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Lesser General Public License
|
|
along with systemd; If not, see <http://www.gnu.org/licenses/>.
|
|
***/
|
|
|
|
#include <stdbool.h>
|
|
#include <stddef.h>
|
|
#include <stdio.h>
|
|
|
|
#include "macro.h"
|
|
|
|
bool env_name_is_valid(const char *e);
|
|
bool env_value_is_valid(const char *e);
|
|
bool env_assignment_is_valid(const char *e);
|
|
|
|
enum {
|
|
REPLACE_ENV_USE_ENVIRONMENT = 1u,
|
|
REPLACE_ENV_ALLOW_BRACELESS = 2u,
|
|
REPLACE_ENV_ALLOW_EXTENDED = 4u,
|
|
};
|
|
|
|
char *replace_env_n(const char *format, size_t n, char **env, unsigned flags);
|
|
char **replace_env_argv(char **argv, char **env);
|
|
|
|
static inline char *replace_env(const char *format, char **env, unsigned flags) {
|
|
return replace_env_n(format, strlen(format), env, flags);
|
|
}
|
|
|
|
bool strv_env_is_valid(char **e);
|
|
#define strv_env_clean(l) strv_env_clean_with_callback(l, NULL, NULL)
|
|
char **strv_env_clean_with_callback(char **l, void (*invalid_callback)(const char *p, void *userdata), void *userdata);
|
|
|
|
bool strv_env_name_is_valid(char **l);
|
|
bool strv_env_name_or_assignment_is_valid(char **l);
|
|
|
|
char **strv_env_merge(unsigned n_lists, ...);
|
|
char **strv_env_delete(char **x, unsigned n_lists, ...); /* New copy */
|
|
|
|
char **strv_env_set(char **x, const char *p); /* New copy ... */
|
|
char **strv_env_unset(char **l, const char *p); /* In place ... */
|
|
char **strv_env_unset_many(char **l, ...) _sentinel_;
|
|
int strv_env_replace(char ***l, char *p); /* In place ... */
|
|
|
|
char *strv_env_get_n(char **l, const char *name, size_t k, unsigned flags) _pure_;
|
|
char *strv_env_get(char **x, const char *n) _pure_;
|
|
|
|
int getenv_bool(const char *p);
|
|
|
|
int serialize_environment(FILE *f, char **environment);
|
|
int deserialize_environment(char ***environment, const char *line);
|