src/basic/unit-name.h

   1 /* SPDX-License-Identifier: LGPL-2.1+ */
   2 #pragma once
   3
   4 /***
   5   This file is part of systemd.
   6
   7   Copyright 2010 Lennart Poettering
   8 ***/
   9
  10 #include <stdbool.h>
  11
  12 #include "macro.h"
  13 #include "unit-def.h"
  14
  15 #define UNIT_NAME_MAX 256
  16
  17 #if 0 /// UNNEEDED by elogind
  18 #endif // 0
  19 typedef enum UnitNameFlags {
  20         UNIT_NAME_PLAIN = 1,      /* Allow foo.service */
  21         UNIT_NAME_INSTANCE = 2,   /* Allow foo@bar.service */
  22         UNIT_NAME_TEMPLATE = 4,   /* Allow foo@.service */
  23         UNIT_NAME_ANY = UNIT_NAME_PLAIN|UNIT_NAME_INSTANCE|UNIT_NAME_TEMPLATE,
  24 } UnitNameFlags;
  25
  26 bool unit_name_is_valid(const char *n, UnitNameFlags flags) _pure_;
  27 bool unit_prefix_is_valid(const char *p) _pure_;
  28 bool unit_instance_is_valid(const char *i) _pure_;
  29 bool unit_suffix_is_valid(const char *s) _pure_;
  30
  31 #if 0 /// UNNEEDED by elogind
  32 static inline int unit_prefix_and_instance_is_valid(const char *p) {
  33         /* For prefix+instance and instance the same rules apply */
  34         return unit_instance_is_valid(p);
  35 }
  36
  37 int unit_name_to_prefix(const char *n, char **prefix);
  38 int unit_name_to_instance(const char *n, char **instance);
  39 int unit_name_to_prefix_and_instance(const char *n, char **ret);
  40 #endif // 0
  41
  42 UnitType unit_name_to_type(const char *n) _pure_;
  43
  44 #if 0 /// UNNEEDED by elogind
  45 int unit_name_change_suffix(const char *n, const char *suffix, char **ret);
  46 #endif // 0
  47
  48 int unit_name_build(const char *prefix, const char *instance, const char *suffix, char **ret);
  49
  50 #if 0 /// UNNEEDED by elogind
  51 char *unit_name_escape(const char *f);
  52 int unit_name_unescape(const char *f, char **ret);
  53 int unit_name_path_escape(const char *f, char **ret);
  54 int unit_name_path_unescape(const char *f, char **ret);
  55
  56 int unit_name_replace_instance(const char *f, const char *i, char **ret);
  57
  58 int unit_name_template(const char *f, char **ret);
  59
  60 int unit_name_from_path(const char *path, const char *suffix, char **ret);
  61 int unit_name_from_path_instance(const char *prefix, const char *path, const char *suffix, char **ret);
  62 int unit_name_to_path(const char *name, char **ret);
  63
  64 typedef enum UnitNameMangle {
  65         UNIT_NAME_MANGLE_GLOB = 1,
  66         UNIT_NAME_MANGLE_WARN = 2,
  67 } UnitNameMangle;
  68
  69 int unit_name_mangle_with_suffix(const char *name, UnitNameMangle flags, const char *suffix, char **ret);
  70
  71 static inline int unit_name_mangle(const char *name, UnitNameMangle flags, char **ret) {
  72         return unit_name_mangle_with_suffix(name, flags, ".service", ret);
  73 }
  74
  75 int slice_build_parent_slice(const char *slice, char **ret);
  76 #endif // 0
  77 int slice_build_subslice(const char *slice, const char*name, char **subslice);
  78 bool slice_name_is_valid(const char *name);
  79 #if 0 /// UNNEEDED by elogind
  80 #endif // 0