X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=src%2Fsystemd%2Fsd-network.h;h=027730d11d6b255ea70b2048588d6b508a8fcebc;hp=c0b093d067e79d1be005e720cff70a36d6004d08;hb=2404701e679904979751816930101511d8ec5d49;hpb=fe8db0c5ee3365a2fc80ee7ebffa238f9a0a2ae2 diff --git a/src/systemd/sd-network.h b/src/systemd/sd-network.h index c0b093d06..027730d11 100644 --- a/src/systemd/sd-network.h +++ b/src/systemd/sd-network.h @@ -1,7 +1,7 @@ /*-*- Mode: C; c-basic-offset: 8; indent-tabs-mode: nil -*-*/ -#ifndef foosdloginhfoo -#define foosdloginhfoo +#ifndef foosdnetworkhfoo +#define foosdnetworkhfoo /*** This file is part of systemd. @@ -26,8 +26,6 @@ #include #include -#include "sd-dhcp-lease.h" - #include "_sd-common.h" /* @@ -37,35 +35,96 @@ * may return NULL. * * Free the data the library returns with libc free(). String arrays - * are NULL terminated and you need to free the array itself in + * are NULL terminated, and you need to free the array itself in * addition to the strings contained. * - * We return error codes as negative errno, kernel-style. 0 or - * positive on success. + * We return error codes as negative errno, kernel-style. On success, we + * return 0 or positive. * - * These functions access data in /run. This is a virtual file systems, - * hence the accesses is relatively cheap. + * These functions access data in /run. This is a virtual file system; + * therefore, accesses are relatively cheap. * * See sd-network(3) for more information. */ _SD_BEGIN_DECLARATIONS; -/* Get state from ifindex. Possible states: unknown, unmanaged, failed, configuring, configured */ -int sd_network_get_link_state(unsigned index, char**state); +/* Get overall operational state + * Possible states: down, up, dormant, carrier, degraded, routable + * Possible return codes: + * -ENODATA: networkd is not aware of any links + */ +int sd_network_get_operational_state(char **state); + +/* Get DNS entries for all links. These are string representations of + * IP addresses */ +int sd_network_get_dns(char ***dns); + +/* Get NTP entries for all links. These are domain names or string + * representations of IP addresses */ +int sd_network_get_ntp(char ***ntp); + +/* Get the search/routing domains for all links. */ +int sd_network_get_domains(char ***domains); + +/* Get setup state from ifindex. + * Possible states: + * pending: udev is still processing the link, we don't yet know if we will manage it + * failed: networkd failed to manage the link + * configuring: in the process of retrieving configuration or configuring the link + * configured: link configured successfully + * unmanaged: networkd is not handling the link + * linger: the link is gone, but has not yet been dropped by networkd + * Possible return codes: + * -ENODATA: networkd is not aware of the link + */ +int sd_network_link_get_setup_state(int ifindex, char **state); + +/* Get operational state from ifindex. + * Possible states: + * off: the device is powered down + * no-carrier: the device is powered up, but it does not yet have a carrier + * dormant: the device has a carrier, but is not yet ready for normal traffic + * carrier: the link has a carrier + * degraded: the link has carrier and addresses valid on the local link configured + * routable: the link has carrier and routable address configured + * Possible return codes: + * -ENODATA: networkd is not aware of the link + */ +int sd_network_link_get_operational_state(int ifindex, char **state); + +/* Get path to .network file applied to link */ +int sd_network_link_get_network_file(int ifindex, char **filename); + +/* Get DNS entries for a given link. These are string representations of + * IP addresses */ +int sd_network_link_get_dns(int ifindex, char ***addr); + +/* Get NTP entries for a given link. These are domain names or string + * representations of IP addresses */ +int sd_network_link_get_ntp(int ifindex, char ***addr); + +/* Indicates whether or not LLMNR should be enabled for the link + * Possible levels of support: yes, no, resolve + * Possible return codes: + * -ENODATA: networkd is not aware of the link + */ +int sd_network_link_get_llmnr(int ifindex, char **llmnr); + +int sd_network_link_get_lldp(int ifindex, char **lldp); -/* Get DHCPv4 lease from ifindex. */ -int sd_network_get_dhcp_lease(unsigned index, sd_dhcp_lease **ret); +/* Get the DNS domain names for a given link. */ +int sd_network_link_get_domains(int ifindex, char ***domains); -/* Get all network interfaces indices, store in *indices. Returns the - * number of indices. If indices is NULL only returns the number of indices. */ -int sd_network_get_ifindices(unsigned **indices); +/* Returns whether or not domains that don't match any link should be resolved + * on this link. 1 for yes, 0 for no and negative value for error */ +int sd_network_link_get_wildcard_domain(int ifindex); /* Monitor object */ typedef struct sd_network_monitor sd_network_monitor; -/* Create a new monitor. Category must be NULL. */ -int sd_network_monitor_new(const char *category, sd_network_monitor** ret); +/* Create a new monitor. Category must be NULL, "links" or "leases". */ +int sd_network_monitor_new(sd_network_monitor **ret, const char *category); /* Destroys the passed monitor. Returns NULL. */ sd_network_monitor* sd_network_monitor_unref(sd_network_monitor *m);