Daan De Meyer
aec52c1e6e
Let's introduce these for the following two reasons: - Using them makes sure the parameter names match between declaration and definition (if both use the corresponding macros). - They make sure developers can't forget the _const_ and _pure_ attributes for the declarations. This commit also includes some include sorting fixes
60 lines
1.9 KiB
C
60 lines
1.9 KiB
C
/* SPDX-License-Identifier: LGPL-2.1-or-later */
|
|
#pragma once
|
|
|
|
#include "shared-forward.h"
|
|
|
|
typedef enum HostnameSource {
|
|
HOSTNAME_STATIC, /* from /etc/hostname */
|
|
HOSTNAME_TRANSIENT, /* a transient hostname set through systemd, hostnamed, the container manager, or otherwise */
|
|
HOSTNAME_DEFAULT, /* the os-release default or the compiled-in fallback were used */
|
|
_HOSTNAME_INVALID = -EINVAL,
|
|
} HostnameSource;
|
|
|
|
DECLARE_STRING_TABLE_LOOKUP(hostname_source, HostnameSource);
|
|
|
|
int sethostname_idempotent(const char *s);
|
|
|
|
int shorten_overlong(const char *s, char **ret);
|
|
|
|
int read_etc_hostname_stream(FILE *f, bool substitute_wildcards, char **ret);
|
|
int read_etc_hostname(const char *path, bool substitute_wildcards, char **ret);
|
|
|
|
void hostname_update_source_hint(const char *hostname, HostnameSource source);
|
|
int hostname_setup(bool really);
|
|
|
|
int hostname_substitute_wildcards(char *name);
|
|
|
|
char* get_default_hostname(void);
|
|
|
|
typedef enum GetHostnameFlags {
|
|
GET_HOSTNAME_ALLOW_LOCALHOST = 1 << 0, /* accepts "localhost" or friends. */
|
|
GET_HOSTNAME_FALLBACK_DEFAULT = 1 << 1, /* use default hostname if no hostname is set. */
|
|
GET_HOSTNAME_SHORT = 1 << 2, /* kills the FQDN part if present. */
|
|
} GetHostnameFlags;
|
|
|
|
int gethostname_full(GetHostnameFlags flags, char **ret);
|
|
|
|
static inline int gethostname_strict(char **ret) {
|
|
return gethostname_full(0, ret);
|
|
}
|
|
|
|
static inline char* gethostname_malloc(void) {
|
|
char *s;
|
|
|
|
if (gethostname_full(GET_HOSTNAME_ALLOW_LOCALHOST | GET_HOSTNAME_FALLBACK_DEFAULT, &s) < 0)
|
|
return NULL;
|
|
|
|
return s;
|
|
}
|
|
|
|
static inline char* gethostname_short_malloc(void) {
|
|
char *s;
|
|
|
|
if (gethostname_full(GET_HOSTNAME_ALLOW_LOCALHOST | GET_HOSTNAME_FALLBACK_DEFAULT | GET_HOSTNAME_SHORT, &s) < 0)
|
|
return NULL;
|
|
|
|
return s;
|
|
}
|
|
|
|
int pidref_gethostname_full(PidRef *pidref, GetHostnameFlags flags, char **ret);
|