ccdf03b9c7
Clean up the naming of the sd-path enums. Previously, the more recently added fields where named in the form SD_PATH_xyz_DIR and SD_PATH_xyz_PATH, while the older fields where called just SD_PATH_xyz and SD_PATH_SEARCH_xyz. Let's clean this up, to come to a more unified way how we name this stuff. I opted to stick to the old naming, i.e. dropthe suffixes. It's a bit of a bike-shedding question of course, but I think there's a good reason to avoid the additional DIR and PATH suffixes: the enum prefix contains "PATH" anyway (i.e. "SD_PATH_"), so including PATH twice in each name is redundant. Moreover, the key difference between the enums with the "dir" and the "path" in the name is that the latter are *seach* paths, and I think this is better emphasized by sticking to the "SEARCH" in the name. Moreover dropping the suffixes makes the identifiers a lot shorter, in particular in the "systemd-path" list output. And that's always good. This means the naming pkgconfig file and in sd-path slightly deviate (though the mapping is very simple), but I think that's OK, given that this is developer facing and not user facing.
122 lines
3.7 KiB
C
122 lines
3.7 KiB
C
/* SPDX-License-Identifier: LGPL-2.1+ */
|
|
#ifndef foosdpathhfoo
|
|
#define foosdpathhfoo
|
|
|
|
/***
|
|
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 <inttypes.h>
|
|
|
|
#include "_sd-common.h"
|
|
|
|
_SD_BEGIN_DECLARATIONS;
|
|
|
|
enum {
|
|
/* Temporary files */
|
|
SD_PATH_TEMPORARY,
|
|
SD_PATH_TEMPORARY_LARGE,
|
|
|
|
/* Vendor supplied data */
|
|
SD_PATH_SYSTEM_BINARIES,
|
|
SD_PATH_SYSTEM_INCLUDE,
|
|
SD_PATH_SYSTEM_LIBRARY_PRIVATE,
|
|
SD_PATH_SYSTEM_LIBRARY_ARCH,
|
|
SD_PATH_SYSTEM_SHARED,
|
|
SD_PATH_SYSTEM_CONFIGURATION_FACTORY,
|
|
SD_PATH_SYSTEM_STATE_FACTORY,
|
|
|
|
/* System configuration, runtime, state, ... */
|
|
SD_PATH_SYSTEM_CONFIGURATION,
|
|
SD_PATH_SYSTEM_RUNTIME,
|
|
SD_PATH_SYSTEM_RUNTIME_LOGS,
|
|
SD_PATH_SYSTEM_STATE_PRIVATE,
|
|
SD_PATH_SYSTEM_STATE_LOGS,
|
|
SD_PATH_SYSTEM_STATE_CACHE,
|
|
SD_PATH_SYSTEM_STATE_SPOOL,
|
|
|
|
/* Vendor supplied data */
|
|
SD_PATH_USER_BINARIES,
|
|
SD_PATH_USER_LIBRARY_PRIVATE,
|
|
SD_PATH_USER_LIBRARY_ARCH,
|
|
SD_PATH_USER_SHARED,
|
|
|
|
/* User configuration, state, runtime ... */
|
|
SD_PATH_USER_CONFIGURATION, /* takes both actual configuration (like /etc) and state (like /var/lib) */
|
|
SD_PATH_USER_RUNTIME,
|
|
SD_PATH_USER_STATE_CACHE,
|
|
|
|
/* User resources */
|
|
SD_PATH_USER, /* $HOME itself */
|
|
SD_PATH_USER_DOCUMENTS,
|
|
SD_PATH_USER_MUSIC,
|
|
SD_PATH_USER_PICTURES,
|
|
SD_PATH_USER_VIDEOS,
|
|
SD_PATH_USER_DOWNLOAD,
|
|
SD_PATH_USER_PUBLIC,
|
|
SD_PATH_USER_TEMPLATES,
|
|
SD_PATH_USER_DESKTOP,
|
|
|
|
/* Search paths */
|
|
SD_PATH_SEARCH_BINARIES,
|
|
SD_PATH_SEARCH_BINARIES_DEFAULT,
|
|
SD_PATH_SEARCH_LIBRARY_PRIVATE,
|
|
SD_PATH_SEARCH_LIBRARY_ARCH,
|
|
SD_PATH_SEARCH_SHARED,
|
|
SD_PATH_SEARCH_CONFIGURATION_FACTORY,
|
|
SD_PATH_SEARCH_STATE_FACTORY,
|
|
SD_PATH_SEARCH_CONFIGURATION,
|
|
|
|
/* Various systemd paths, generally mirroring systemd.pc — Except we drop the "dir" suffix (and
|
|
* replaces "path" by "search"), since this API is about dirs/paths anyway, and contains "path"
|
|
* already in the prefix */
|
|
SD_PATH_SYSTEMD_UTIL,
|
|
SD_PATH_SYSTEMD_SYSTEM_UNIT,
|
|
SD_PATH_SYSTEMD_SYSTEM_PRESET,
|
|
SD_PATH_SYSTEMD_SYSTEM_CONF,
|
|
SD_PATH_SYSTEMD_USER_UNIT,
|
|
SD_PATH_SYSTEMD_USER_PRESET,
|
|
SD_PATH_SYSTEMD_USER_CONF,
|
|
|
|
SD_PATH_SYSTEMD_SEARCH_SYSTEM_UNIT,
|
|
SD_PATH_SYSTEMD_SEARCH_USER_UNIT,
|
|
|
|
SD_PATH_SYSTEMD_SYSTEM_GENERATOR,
|
|
SD_PATH_SYSTEMD_USER_GENERATOR,
|
|
SD_PATH_SYSTEMD_SEARCH_SYSTEM_GENERATOR,
|
|
SD_PATH_SYSTEMD_SEARCH_USER_GENERATOR,
|
|
|
|
SD_PATH_SYSTEMD_SLEEP,
|
|
SD_PATH_SYSTEMD_SHUTDOWN,
|
|
|
|
SD_PATH_TMPFILES,
|
|
SD_PATH_SYSUSERS,
|
|
SD_PATH_SYSCTL,
|
|
SD_PATH_BINFMT,
|
|
SD_PATH_MODULES_LOAD,
|
|
SD_PATH_CATALOG,
|
|
|
|
/* systemd-networkd search paths */
|
|
SD_PATH_SYSTEMD_SEARCH_NETWORK,
|
|
|
|
_SD_PATH_MAX,
|
|
};
|
|
|
|
int sd_path_lookup(uint64_t type, const char *suffix, char **path);
|
|
int sd_path_lookup_strv(uint64_t type, const char *suffix, char ***paths);
|
|
|
|
_SD_END_DECLARATIONS;
|
|
|
|
#endif
|