ip.h

Go to the documentation of this file.

#pragma once
 
#include <stdint.h>
#include <stddef.h>
#include "../common.h"
 
/* ============================================================================
 * IP Address Validation Functions
 * @{
 */
 
int is_valid_ipv4(const char *ip);
 
int is_valid_ipv6(const char *ip);
 
/* ============================================================================
 * IP Address Parsing Functions
 * @{
 */
 
int parse_ipv6_address(const char *input, char *output, size_t output_size);
 
int parse_ip_with_port(const char *input, char *ip_output, size_t ip_output_size, uint16_t *port_output);
 
int parse_address_with_optional_port(const char *input, char *address_output, size_t address_output_size,
                                     uint16_t *port_output, uint16_t default_port);
 
/* ============================================================================
 * IP Address Formatting Functions
 * @{
 */
 
asciichat_error_t format_ip_address(int family, const struct sockaddr *addr, char *output, size_t output_size);
 
asciichat_error_t format_ip_with_port(const char *ip, uint16_t port, char *output, size_t output_size);
 
/* ============================================================================
 * IP Version Detection & Unified Validation
 * @{
 */
 
int get_ip_version(const char *ip);
 
int is_valid_ip(const char *ip);
 
/* ============================================================================
 * IP Address Comparison & Equality
 * @{
 */
 
int ip_equals(const char *ip1, const char *ip2);
 
int ip_compare(const char *ip1, const char *ip2);
 
int compare_ip_port_strings(const char *ip_port1, const char *ip_port2);
 
/* ============================================================================
 * CIDR/Subnet Utilities
 * @{
 */
 
int parse_cidr(const char *cidr, char *ip_out, size_t ip_out_size, int *prefix_out);
 
int ip_in_cidr(const char *ip, const char *cidr);
 
int ip_in_cidr_parsed(const char *ip, const char *network, int prefix_len);
 
/* ============================================================================
 * IPv4-Mapped IPv6 Utilities
 * @{
 */
 
asciichat_error_t ipv4_to_ipv6_mapped(const char *ipv4, char *ipv6_out, size_t out_size);
 
asciichat_error_t extract_ipv4_from_mapped_ipv6(const char *ipv6, char *ipv4_out, size_t out_size);
 
int is_ipv4_mapped_ipv6(const char *ipv6);
 
/* ============================================================================
 * IPv6 Canonicalization & Formatting
 * @{
 */
 
asciichat_error_t canonicalize_ipv6(const char *ipv6, char *canonical_out, size_t out_size);
 
asciichat_error_t expand_ipv6(const char *ipv6, char *expanded_out, size_t out_size);
 
asciichat_error_t compact_ipv6(const char *ipv6, char *compact_out, size_t out_size);
 
/* ============================================================================
 * IP Address Classification Functions
 * @{
 */
 
int is_anycast_ipv6(const char *ipv6);
 
/* ============================================================================
 * IP Address Classification Functions
 * @{
 */
 
int is_lan_ipv4(const char *ip);
 
int is_lan_ipv6(const char *ip);
 
int is_broadcast_ipv4(const char *ip);
 
int is_broadcast_ipv6(const char *ip);
 
int is_localhost_ipv4(const char *ip);
 
int is_localhost_ipv6(const char *ip);
 
int is_link_local_ipv4(const char *ip);
 
int is_link_local_ipv6(const char *ip);
 
int is_internet_ipv4(const char *ip);
 
int is_internet_ipv6(const char *ip);
 
int extract_ip_from_address(const char *addr_with_port, char *ip_out, size_t ip_out_size);
 
const char *get_ip_type_string(const char *ip);