1 /* SPDX-License-Identifier: LGPL-2.1-or-later */
9 typedef enum ImageClass
{
13 _IMAGE_CLASS_EXTENSION_FIRST
= IMAGE_SYSEXT
, /* First "extension" image type, so that we can easily generically iterate through them */
15 _IMAGE_CLASS_EXTENSION_LAST
= IMAGE_CONFEXT
, /* Last "extension image type */
17 _IMAGE_CLASS_INVALID
= -EINVAL
,
20 const char* image_class_to_string(ImageClass cl
) _const_
;
21 ImageClass
image_class_from_string(const char *s
) _pure_
;
23 /* The *_extension_release flavours will look for /usr/lib/extension-release/extension-release.NAME
24 * for sysext images and for /etc/extension-release.d/extension-release.NAME for confext images
25 * in accordance with the OS extension specification, rather than for /usr/lib/ or /etc/os-release. */
27 bool image_name_is_valid(const char *s
) _pure_
;
28 int path_extract_image_name(const char *path
, char **ret
);
30 int path_is_extension_tree(ImageClass image_class
, const char *path
, const char *extension
, bool relax_extension_release_check
);
31 static inline int path_is_os_tree(const char *path
) {
32 return path_is_extension_tree(_IMAGE_CLASS_INVALID
, path
, NULL
, false);
35 int open_extension_release(const char *root
, ImageClass image_class
, const char *extension
, bool relax_extension_release_check
, char **ret_path
, int *ret_fd
);
36 int open_extension_release_at(int rfd
, ImageClass image_class
, const char *extension
, bool relax_extension_release_check
, char **ret_path
, int *ret_fd
);
37 int open_os_release(const char *root
, char **ret_path
, int *ret_fd
);
38 int open_os_release_at(int rfd
, char **ret_path
, int *ret_fd
);
40 int parse_extension_release_sentinel(const char *root
, ImageClass image_class
, bool relax_extension_release_check
, const char *extension
, ...) _sentinel_
;
41 #define parse_extension_release(root, image_class, extension, relax_extension_release_check, ...) \
42 parse_extension_release_sentinel(root, image_class, relax_extension_release_check, extension, __VA_ARGS__, NULL)
43 #define parse_os_release(root, ...) \
44 parse_extension_release_sentinel(root, _IMAGE_CLASS_INVALID, false, NULL, __VA_ARGS__, NULL)
46 int parse_extension_release_at_sentinel(int rfd
, ImageClass image_class
, bool relax_extension_release_check
, const char *extension
, ...) _sentinel_
;
47 #define parse_extension_release_at(rfd, image_class, extension, relax_extension_release_check, ...) \
48 parse_extension_release_at_sentinel(rfd, image_class, relax_extension_release_check, extension, __VA_ARGS__, NULL)
49 #define parse_os_release_at(rfd, ...) \
50 parse_extension_release_at_sentinel(rfd, _IMAGE_CLASS_INVALID, false, NULL, __VA_ARGS__, NULL)
52 int load_extension_release_pairs(const char *root
, ImageClass image_class
, const char *extension
, bool relax_extension_release_check
, char ***ret
);
53 static inline int load_os_release_pairs(const char *root
, char ***ret
) {
54 return load_extension_release_pairs(root
, _IMAGE_CLASS_INVALID
, NULL
, false, ret
);
56 int load_os_release_pairs_with_prefix(const char *root
, const char *prefix
, char ***ret
);
58 int os_release_support_ended(const char *support_end
, bool quiet
, usec_t
*ret_eol
);
60 const char *os_release_pretty_name(const char *pretty_name
, const char *name
);