src/basic/env-util.h

   1 /* SPDX-License-Identifier: LGPL-2.1+ */
   2 #pragma once
   3
   4 /***
   5   This file is part of systemd.
   6
   7   Copyright 2013 Lennart Poettering
   8 ***/
   9
  10 #include <stdbool.h>
  11 #include <stddef.h>
  12 #include <stdio.h>
  13
  14 #include "macro.h"
  15
  16 bool env_name_is_valid(const char *e);
  17 bool env_value_is_valid(const char *e);
  18 bool env_assignment_is_valid(const char *e);
  19
  20 enum {
  21         REPLACE_ENV_USE_ENVIRONMENT = 1u,
  22         REPLACE_ENV_ALLOW_BRACELESS = 2u,
  23         REPLACE_ENV_ALLOW_EXTENDED  = 4u,
  24 };
  25
  26 #if 0 /// UNNEEDED by elogind
  27 char *replace_env_n(const char *format, size_t n, char **env, unsigned flags);
  28 char **replace_env_argv(char **argv, char **env);
  29
  30 static inline char *replace_env(const char *format, char **env, unsigned flags) {
  31         return replace_env_n(format, strlen(format), env, flags);
  32 }
  33
  34 bool strv_env_is_valid(char **e);
  35 #define strv_env_clean(l) strv_env_clean_with_callback(l, NULL, NULL)
  36 char **strv_env_clean_with_callback(char **l, void (*invalid_callback)(const char *p, void *userdata), void *userdata);
  37
  38 bool strv_env_name_is_valid(char **l);
  39 bool strv_env_name_or_assignment_is_valid(char **l);
  40
  41 char **strv_env_merge(size_t n_lists, ...);
  42 char **strv_env_delete(char **x, size_t n_lists, ...); /* New copy */
  43
  44 char **strv_env_set(char **x, const char *p); /* New copy ... */
  45 char **strv_env_unset(char **l, const char *p); /* In place ... */
  46 char **strv_env_unset_many(char **l, ...) _sentinel_;
  47 int strv_env_replace(char ***l, char *p); /* In place ... */
  48
  49 char *strv_env_get_n(char **l, const char *name, size_t k, unsigned flags) _pure_;
  50 char *strv_env_get(char **x, const char *n) _pure_;
  51 #endif // 0
  52
  53 int getenv_bool(const char *p);
  54 #if 0 /// UNNEEDED by elogind
  55 int getenv_bool_secure(const char *p);
  56
  57 int serialize_environment(FILE *f, char **environment);
  58 int deserialize_environment(char ***environment, const char *line);
  59 #endif // 0