HALF ECHO LEARN / REFERENCE COLLECTION
v262.2src/shared/hostname-setup.h
Git blob: b57b6ac2b9a7d2281930ba9e836f61656327c4ba
Lines 1–67 of 67
/* SPDX-License-Identifier: LGPL-2.1-or-later */
#pragma once
#include "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);
/* Returns > 0 if the hostname is the default we recorded in /run earlier, 0 if not (or if no default was
* recorded), and a negative errno if the recorded value could not be read. */
int hostname_matches_default(const char *hostname);
int hostname_setup(bool really);
int hostname_pick_word(sd_id128_t mid, size_t pos, char **ret);
int hostname_substitute_wildcards(const char *name, char **ret);
/* Returns the default hostname with '?'/'$' wildcards expanded, or a negative errno if the expansion
* fails. get_default_hostname_or_fallback() hides such failures behind FALLBACK_HOSTNAME instead. */
int get_default_hostname(char **ret);
char* get_default_hostname_or_fallback(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);