2020-11-09 05:23:58 +01:00
|
|
|
/* SPDX-License-Identifier: LGPL-2.1-or-later */
|
2013-02-11 03:46:08 +01:00
|
|
|
#pragma once
|
|
|
|
|
|
|
|
#include <stdbool.h>
|
2015-11-30 21:43:37 +01:00
|
|
|
#include <stddef.h>
|
2017-02-11 03:44:21 +01:00
|
|
|
#include <stdio.h>
|
2019-05-11 09:51:33 +02:00
|
|
|
#include <unistd.h>
|
2013-02-11 03:46:08 +01:00
|
|
|
|
2015-02-10 12:56:53 +01:00
|
|
|
#include "macro.h"
|
2018-06-13 17:37:32 +02:00
|
|
|
#include "string.h"
|
2015-02-10 12:56:53 +01:00
|
|
|
|
2019-05-11 09:51:33 +02:00
|
|
|
static inline size_t sc_arg_max(void) {
|
|
|
|
long l = sysconf(_SC_ARG_MAX);
|
|
|
|
assert(l > 0);
|
|
|
|
return (size_t) l;
|
|
|
|
}
|
|
|
|
|
2013-02-11 03:46:08 +01:00
|
|
|
bool env_name_is_valid(const char *e);
|
|
|
|
bool env_value_is_valid(const char *e);
|
|
|
|
bool env_assignment_is_valid(const char *e);
|
|
|
|
|
2016-08-04 18:00:00 +02:00
|
|
|
enum {
|
2019-01-03 12:18:47 +01:00
|
|
|
REPLACE_ENV_USE_ENVIRONMENT = 1 << 0,
|
|
|
|
REPLACE_ENV_ALLOW_BRACELESS = 1 << 1,
|
|
|
|
REPLACE_ENV_ALLOW_EXTENDED = 1 << 2,
|
2016-08-04 18:00:00 +02:00
|
|
|
};
|
|
|
|
|
2016-08-09 16:20:22 +02:00
|
|
|
char *replace_env_n(const char *format, size_t n, char **env, unsigned flags);
|
2015-04-11 00:25:43 +02:00
|
|
|
char **replace_env_argv(char **argv, char **env);
|
|
|
|
|
2016-08-09 16:20:22 +02:00
|
|
|
static inline char *replace_env(const char *format, char **env, unsigned flags) {
|
|
|
|
return replace_env_n(format, strlen(format), env, flags);
|
|
|
|
}
|
|
|
|
|
2013-02-11 03:46:08 +01:00
|
|
|
bool strv_env_is_valid(char **e);
|
2014-12-23 19:04:56 +01:00
|
|
|
#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);
|
2013-02-11 03:46:08 +01:00
|
|
|
|
2015-09-07 08:06:53 +02:00
|
|
|
bool strv_env_name_is_valid(char **l);
|
2013-02-11 23:41:15 +01:00
|
|
|
bool strv_env_name_or_assignment_is_valid(char **l);
|
|
|
|
|
tree-wide: be more careful with the type of array sizes
Previously we were a bit sloppy with the index and size types of arrays,
we'd regularly use unsigned. While I don't think this ever resulted in
real issues I think we should be more careful there and follow a
stricter regime: unless there's a strong reason not to use size_t for
array sizes and indexes, size_t it should be. Any allocations we do
ultimately will use size_t anyway, and converting forth and back between
unsigned and size_t will always be a source of problems.
Note that on 32bit machines "unsigned" and "size_t" are equivalent, and
on 64bit machines our arrays shouldn't grow that large anyway, and if
they do we have a problem, however that kind of overly large allocation
we have protections for usually, but for overflows we do not have that
so much, hence let's add it.
So yeah, it's a story of the current code being already "good enough",
but I think some extra type hygiene is better.
This patch tries to be comprehensive, but it probably isn't and I missed
a few cases. But I guess we can cover that later as we notice it. Among
smaller fixes, this changes:
1. strv_length()' return type becomes size_t
2. the unit file changes array size becomes size_t
3. DNS answer and query array sizes become size_t
Fixes: https://bugs.freedesktop.org/show_bug.cgi?id=76745
2018-04-27 14:09:31 +02:00
|
|
|
char **strv_env_merge(size_t n_lists, ...);
|
|
|
|
char **strv_env_delete(char **x, size_t n_lists, ...); /* New copy */
|
2013-02-11 03:46:08 +01:00
|
|
|
|
|
|
|
char **strv_env_set(char **x, const char *p); /* New copy ... */
|
|
|
|
char **strv_env_unset(char **l, const char *p); /* In place ... */
|
2014-01-12 12:39:56 +01:00
|
|
|
char **strv_env_unset_many(char **l, ...) _sentinel_;
|
2016-10-28 03:15:59 +02:00
|
|
|
int strv_env_replace(char ***l, char *p); /* In place ... */
|
2013-02-11 03:46:08 +01:00
|
|
|
|
2016-08-04 18:00:00 +02:00
|
|
|
char *strv_env_get_n(char **l, const char *name, size_t k, unsigned flags) _pure_;
|
2013-05-03 04:51:50 +02:00
|
|
|
char *strv_env_get(char **x, const char *n) _pure_;
|
2015-10-08 16:15:38 +02:00
|
|
|
|
|
|
|
int getenv_bool(const char *p);
|
2017-09-14 09:20:27 +02:00
|
|
|
int getenv_bool_secure(const char *p);
|
2020-11-10 12:25:55 +01:00
|
|
|
|
|
|
|
/* Like setenv, but calls unsetenv if value == NULL. */
|
|
|
|
int set_unset_env(const char *name, const char *value, bool overwrite);
|