diff --git a/docs/user/net/NetworkAddress.dox b/docs/user/net/NetworkAddress.dox
new file mode 100644
index 0000000000..ea65bc1336
--- /dev/null
+++ b/docs/user/net/NetworkAddress.dox
@@ -0,0 +1,1106 @@
+/*
+ * Copyright 2026 Haiku, Inc. All rights reserved.
+ * Distributed under the terms of the MIT License.
+ *
+ * Authors:
+ *		cafeina
+ *
+ * Corresponds to:
+ *		headers/os/net/NetworkAddress.h	hrev59275
+ *		src/kits/network/libnetapi/NetworkAddress.cpp	hrev59275
+ */
+
+
+/*!
+	\file NetworkAddress.h
+	\ingroup network
+	\brief Provides the BNetworkAddress class.
+*/
+
+
+/*!
+	\class BNetworkAddress
+	\ingroup network
+	\brief BNetworkAddress class represents a network address.
+
+	There are several ways to initialize a BNetworkAddress object, from any
+	of the constructors with parameters or the SetTo() methods. Depending on the
+	overloaded version, the parameters could be:
+
+	- The \a address, that is the representation of a host's IP address (such as
+	\c "127.0.0.1" or \c "::1") or hostname (such as \c "www.haiku-os.org").
+
+	- The \a port, a number representing the communication endpoint in the address,
+	that identifies a specific process or application.
+
+	- The \a service, a string with a service name such as \a "http", \a "ftp",
+	etc., that can be mapped to a port number and a protocol.
+
+	- The \a family, the address family identifier. A list of possible values
+	is defined in POSIX header sys/socket.h.
+
+	- \a flags to pass to the address resolver: \c 0 (default value),
+	\c B_NO_ADDRESS_RESOLUTION or \c B_UNCONFIGURED_ADDRESS_FAMILIES.
+
+	A BNetworkAddress object can also be initialized from a socket storage
+	object (sockaddr, sockaddr_storage, sockaddr_in, sockaddr_in6 or
+	sockaddr_dl), or from a raw IP address (in_addr_t for IPv4 or in6_addr
+	for IPv6).
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn BNetworkAddress::BNetworkAddress()
+	\brief Creates an uninitialized BNetworkAddress object.
+
+	It can be later initialized with any of the SetTo() functions.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn BNetworkAddress::BNetworkAddress(const char* address, uint16 port = 0, uint32 flags = 0)
+	\brief Creates and initializes a BNetworkAddress object using a network
+		\a address and a \a port.
+
+	\param[in] address A network address.
+	\param[in] port The port in \a address.
+	\param[in] flags Configuration flags to pass to the address resolver.
+
+	\sa SetTo(const char*, uint16, uint32)
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn BNetworkAddress::BNetworkAddress(const char* address, const char* service, uint32 flags = 0)
+	\brief Creates and initializes a BNetworkAddress object using a network
+		\a address and a \a service.
+
+	\param[in] address A network address.
+	\param[in] service The service to be used.
+	\param[in] flags Configuration flags to pass to the address resolver.
+
+	\sa SetTo(const char*, const char*, uint32)
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn BNetworkAddress::BNetworkAddress(int family, const char* address, uint16 port = 0, uint32 flags = 0)
+	\brief Creates and initializes a BNetworkAddress object using a network
+		\a family, \a address and a \a port.
+
+	\param[in] family The address family identifier.
+	\param[in] address A network address.
+	\param[in] port The port in \a address.
+	\param[in] flags Configuration flags to pass to the address resolver.
+
+	\sa SetTo(int, const char*, uint16, uint32)
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn BNetworkAddress::BNetworkAddress(int family, const char* address, const char* service, uint32 flags = 0)
+	\brief Creates and initializes a BNetworkAddress object using a network
+		\a family, \a address and a \a service.
+
+	\param[in] family The address family identifier.
+	\param[in] address A network address.
+	\param[in] service The service to be used.
+	\param[in] flags Configuration flags to pass to the address resolver.
+
+	\sa SetTo(int, const char*, const char*, uint32)
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn BNetworkAddress::BNetworkAddress(const sockaddr& address)
+	\brief Creates and initializes a BNetworkAddress object from a generic
+		socket address storage object.
+
+	\param[in] address The sockaddr instance containing the socket address
+		information.
+
+	\sa SetTo(const sockaddr&)
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn BNetworkAddress::BNetworkAddress(const sockaddr_storage& address)
+	\brief Creates and initializes a BNetworkAddress object from a generic
+		socket address storage object.
+
+	\param[in] address The sockaddr_storage instance containing the socket
+		address information.
+
+	\sa SetTo(const sockaddr_storage&)
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn BNetworkAddress::BNetworkAddress(const sockaddr_in& address)
+	\brief Creates and initializes a BNetworkAddress object from a IPv4
+		socket address storage object.
+
+	\param[in] address The sockaddr_in instance containing the socket
+		address	information.
+
+	\sa SetTo(const sockaddr_in&)
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn BNetworkAddress::BNetworkAddress(const sockaddr_in6& address)
+	\brief Creates and initializes a BNetworkAddress object from a IPv6
+		socket address storage object.
+
+	\param[in] address The sockaddr_in6 instance containing the socket
+		address	information.
+
+	\sa SetTo(const sockaddr_in6&)
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn BNetworkAddress::BNetworkAddress(const sockaddr_dl& address)
+	\brief Creates and initializes a BNetworkAddress object from a link level
+		socket address storage object.
+
+	\param[in] address The sockaddr_dl instance containing the socket
+		address	information.
+
+	\sa SetTo(const sockaddr_dl&)
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn BNetworkAddress::BNetworkAddress(in_addr_t address, uint16 port = 0)
+	\brief Creates and initializes a BNetworkAddress object to a raw
+		IPv4 \a address and a \a port.
+
+	\param[in] address A IPv4 address in 32-bit binary form.
+	\param[in] port The port number.
+
+	\sa SetTo(in_addr_t, uint16)
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn BNetworkAddress::BNetworkAddress(const in6_addr& address, uint16 port = 0)
+	\brief Creates and initializes a BNetworkAddress object to a raw
+		IPv6 \a address and a \a port.
+
+	\param[in] address A IPv6 address in 128-bit binary form.
+	\param[in] port The port number.
+
+	\sa SetTo(const in6_addr&, uint16)
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn BNetworkAddress::BNetworkAddress(const BNetworkAddress& other)
+	\brief Copy constructor.
+
+	\param[in] other Another BNetworkAddress instance from where to initialize.
+
+	\sa SetTo(const BNetworkAddress&)
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn BNetworkAddress::~BNetworkAddress()
+	\brief Default destructor.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkAddress::InitCheck() const
+	\brief Returns the initialization status of this object.
+
+	If Unset() is used, the initialization status turns into \c B_OK.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\name Initialization and assignment
+*/
+
+//! @{
+
+
+/*!
+	\fn status_t BNetworkAddress::SetTo(const char* address, uint16 port = 0, uint32 flags = 0)
+	\brief (Re)initializes the object using a network \a address and a \a port.
+
+	\param[in] address A network address.
+	\param[in] port The port in \a address.
+	\param[in] flags Configuration flags to pass to the address resolver.
+
+	\retval B_OK Initialization was successful.
+	\retval B_ERROR Unknown error.
+	\retval B_NO_MEMORY Internal memory allocation error.
+	\retval B_BAD_VALUE Address family not supported, unknown host or service,
+		bad port number or socket type not supported.
+	\retval B_TIMED_OUT Temporary failure in name resolution.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkAddress::SetTo(const char* address, const char* service, uint32 flags = 0)
+	\brief (Re)initializes the object using a network \a address and a \a service.
+
+	\param[in] address A network address.
+	\param[in] service The service to be used.
+	\param[in] flags Configuration flags to pass to the address resolver.
+
+	\retval B_OK Initialization was successful.
+	\retval B_ERROR Unknown error.
+	\retval B_NO_MEMORY Internal memory allocation error.
+	\retval B_BAD_VALUE Address family not supported, unknown host or service,
+		bad port number or socket type not supported.
+	\retval B_TIMED_OUT Temporary failure in name resolution.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkAddress::SetTo(int family, const char* address, uint16 port = 0, uint32 flags = 0)
+	\brief (Re)initializes the object using a network \a family, \a address
+		and a \a port.
+
+	\param[in] family The address family identifier.
+	\param[in] address A network address.
+	\param[in] port The port in \a address.
+	\param[in] flags Configuration flags to pass to the address resolver.
+
+	\retval B_OK Initialization was successful.
+	\retval B_ERROR Unknown error.
+	\retval B_NO_MEMORY Internal memory allocation error.
+	\retval B_BAD_VALUE Address family not supported, unknown host or service,
+		bad port number or socket type not supported.
+	\retval B_TIMED_OUT Temporary failure in name resolution.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkAddress::SetTo(int family, const char* address, const char* service, uint32 flags = 0)
+	\brief (Re)initializes the object using a network \a family, \a address
+		and a \a service.
+
+	\param[in] family The address family identifier.
+	\param[in] address A network address.
+	\param[in] service The service to be used.
+	\param[in] flags Configuration flags to pass to the address resolver.
+
+	\retval B_OK Initialization was successful.
+	\retval B_ERROR Unknown error.
+	\retval B_NO_MEMORY Internal memory allocation error.
+	\retval B_BAD_VALUE Address family not supported, unknown host or service,
+		bad port number or socket type not supported.
+	\retval B_TIMED_OUT Temporary failure in name resolution.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn void BNetworkAddress::SetTo(const sockaddr& address)
+	\brief (Re)initializes the object from a generic
+		socket address storage object.
+
+	It automatically casts the kind of socket according to the address family.
+
+	\param[in] address The sockaddr instance containing the socket address
+		information.
+
+	\sa SetTo(const sockaddr&, size_t)
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn void BNetworkAddress::SetTo(const sockaddr& address, size_t length)
+	\brief (Re)initializes the object from a generic
+		socket address storage object.
+
+	\param[in] address The sockaddr instance containing the socket
+		address information.
+	\param[in] length The data length of \a address.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn void BNetworkAddress::SetTo(const sockaddr_storage& address)
+	\brief (Re)initializes the object from a generic
+		socket address storage object.
+
+	\param[in] address The sockaddr_storage instance containing the socket
+		address information.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn void BNetworkAddress::SetTo(const sockaddr_in& address)
+	\brief (Re)initializes the object from a IPv4
+		socket address storage object.
+
+	\param[in] address The sockaddr_in instance containing the socket
+		address information.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn void BNetworkAddress::SetTo(const sockaddr_in6& address)
+	\brief (Re)initializes the object from a IPv6
+		socket address storage object.
+
+	\param[in] address The sockaddr_in6 instance containing the socket
+		address information.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn void BNetworkAddress::SetTo(const sockaddr_dl& address)
+	\brief (Re)initializes the object from a link level
+		socket address storage object.
+
+	\param[in] address The sockaddr_dl instance containing the socket
+		address information.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn void BNetworkAddress::SetTo(in_addr_t address, uint16 port = 0)
+	\brief (Re)initializes the object to a raw IPv4 \a address and a \a port.
+
+	\param[in] address The IPv4 address represented with a 32-bit integer.
+	\param[in] port The port number.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn void BNetworkAddress::SetTo(const in6_addr& address, uint16 port = 0)
+	\brief (Re)initializes the object to a raw IPv6 \a address and a \a port.
+
+	\param[in] address The IPv6 address represented in binary form.
+	\param[in] port The port number.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn void BNetworkAddress::SetTo(const BNetworkAddress& other)
+	\brief (Re)initializes the object from \a other instance.
+
+	\param[in] other Another BNetworkAddress instance from where to initialize.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkAddress::SetToBroadcast(int family, uint16 port = 0)
+	\brief (Re)initializes the object to the broadcast address.
+
+	\param[in] family The address family.
+	\param[in] port The port number.
+
+	\retval B_OK Operation performed successfully.
+	\retval B_NOT_SUPPORTED The address family is not \c AF_INET.
+
+	\sa IsBroadCast()
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkAddress::SetToLocal(int family = AF_UNSPEC, uint16 port = 0)
+	\brief Unimplemented.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkAddress::SetToLoopback(int family = AF_UNSPEC, uint16 port = 0)
+	\brief (Re)initializes the object to the loopback address.
+
+	The loopback address is \c INADDR_LOOPBACK (\c 127.0.0.1) for the family
+	\c AF_INET, or in6addr_loopback (\c ::1) for the family \c AF_INET6.
+
+	\param[in] family The address family.
+	\param[in] port The port number.
+
+	\retval B_OK Operation performed successfully.
+	\retval B_NOT_SUPPORTED The address family does not support loopback address.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkAddress::SetToMask(int family, uint32 prefixLength)
+	\brief (Re)initializes the object to a mask address depending on the
+		address \a family loopback address, and \a prefixLength for the
+		address prefix.
+
+	\param[in] family The address family.
+	\param[in] prefixLength The subnet prefix length.
+
+	\retval B_OK Operation performed successfully.
+	\retval B_BAD_VALUE \a prefixLength is greater than \c 32 if \a family is
+		\c AF_INET, or greater than \c 128 if \a family is \c AF_INET6.
+	\retval B_NOT_SUPPORTED The address \a family does not support subnet masks
+		(is not \c AF_INET nor \c AF_INET6).
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkAddress::SetToWildcard(int family, uint16 port = 0)
+	\brief (Re)initializes the object to the wildcard address.
+
+	\param[in] family The family address.
+	\param[in] port The port number.
+
+	\retval B_OK Operation performed successfully.
+	\retval B_NOT_SUPPORTED The address \a family does not support wildcard
+		addresses.
+
+	\sa IsWildcard()
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkAddress::SetAddress(in_addr_t address)
+	\brief Sets the address to a IPv4 \a address.
+
+	\param[in] address A IPv4 network address in 32-bit form.
+
+	\retval B_OK Operation performed successfully.
+	\retval B_BAD_VALUE The address family is not \c AF_INET.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkAddress::SetAddress(const in6_addr& address)
+	\brief Sets the address to a IPv6 \a address.
+
+	\param[in] address A IPv6 network address in 128-bit form.
+
+	\retval B_OK Operation performed successfully.
+	\retval B_BAD_VALUE The address family is not \c AF_INET6.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn void BNetworkAddress::SetPort(uint16 port)
+	\brief Changes the port number.
+
+	This works only if the address family is \c AF_INET or \c AF_INET6.
+
+	\param[in] port The port number.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkAddress::SetPort(const char* service)
+	\brief Unimplemented.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn void BNetworkAddress::SetToLinkLevel(const uint8* address, size_t length)
+	\brief Sets the address to a link local address.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn void BNetworkAddress::SetToLinkLevel(const char* name)
+	\brief Sets the address to a link local address.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn void BNetworkAddress::SetToLinkLevel(uint32 index)
+	\brief Sets the address to a link local address.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn void BNetworkAddress::SetLinkLevelIndex(uint32 index)
+	\brief Sets the link local address at \a index.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn void BNetworkAddress::SetLinkLevelType(uint8 type)
+	\brief Sets the link local address \a type.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn void BNetworkAddress::SetLinkLevelFrameType(uint16 frameType)
+	\brief Sets the link local address \a frameType.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn BNetworkAddress& BNetworkAddress::operator=(const BNetworkAddress& other)
+	\brief Copies \a other address onto \a this address object.
+
+	\param[in] other The other BNetworkAddress object from where to copy the data.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn void BNetworkAddress::Unset()
+	\brief Uninitializes the BNetworkAddress object.
+
+	\since Haiku R1
+*/
+
+//! @}
+
+
+/*!
+	\name Information and access
+*/
+
+//! @{
+
+/*!
+	\fn int BNetworkAddress::Family() const
+	\brief Returns the address family.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn uint16 BNetworkAddress::Port() const
+	\brief Returns the address port.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn size_t BNetworkAddress::Length() const
+	\brief Returns the address length.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn bool BNetworkAddress::IsEmpty() const
+	\brief Returns whether the address is empty or not.
+
+	If the address family is \c AF_UNSPEC, it is considered empty.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn bool BNetworkAddress::IsWildcard() const
+	\brief Returns whether the address is a wildcard address or not.
+
+	This is valid only for \c AF_INET or \c AF_INET6 address families. For other
+	families it always returns \c false.
+
+	For IPv4 addresses, the wildcard address is \c INADDR_ANY
+	(\c 0.0.0.0), and for IPv6 addresses is \a in6addr_any (\c ::).
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn bool BNetworkAddress::IsBroadcast() const
+	\brief Returns whether the address is a broadcast address or not.
+
+	This is valid only for \c AF_INET or \c AF_INET6 address families. For other
+	families it always returns \c false.
+
+	The broadcast address is \c INADDR_BROADCAST (\c 255.255.255.255).
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn bool BNetworkAddress::IsMulticast() const
+	\brief Returns whether the address is a multicast address or not.
+
+	This is valid only for \c AF_INET or \c AF_INET6 address families. For other
+	families it always returns \c false.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn bool BNetworkAddress::IsMulticastGlobal() const
+	\brief Returns whether the IPv6 multicast address is of global scope or not.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn bool BNetworkAddress::IsMulticastNodeLocal() const
+	\brief Returns whether the IPv6 multicast address is node local or not.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn bool BNetworkAddress::IsMulticastLinkLocal() const
+	\brief Returns whether the IPv6 multicast address is link local or not.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn bool BNetworkAddress::IsMulticastSiteLocal() const
+	\brief Returns whether the IPv6 multicast address is site local or not.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn bool BNetworkAddress::IsMulticastOrgLocal() const
+	\brief Returns whether the IPv6 multicast address is organization local or not.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn bool BNetworkAddress::IsLinkLocal() const
+	\brief Returns whether the address is link local or not.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn bool BNetworkAddress::IsSiteLocal() const
+	\brief Returns whether the address is site local or not.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn bool BNetworkAddress::IsLocal() const
+	\brief Returns whether the address is local or not.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn ssize_t BNetworkAddress::PrefixLength() const
+	\brief Returns the prefix length for the subnet mask.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn uint32 BNetworkAddress::LinkLevelIndex() const
+	\brief Returns the index of the network interface that
+		the link local address belongs to.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn BString BNetworkAddress::LinkLevelInterface() const
+	\brief Returns the link local address' interface name.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn uint8 BNetworkAddress::LinkLevelType() const
+	\brief Returns the link local address' interface type.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn uint16 BNetworkAddress::LinkLevelFrameType() const
+	\brief Returns the link local address' frame type.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn uint8* BNetworkAddress::LinkLevelAddress() const
+	\brief Returns a pointer to the link local address.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn size_t BNetworkAddress::LinkLevelAddressLength() const
+	\brief Returns the link local address length.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn BString BNetworkAddress::ToString(bool includePort = true) const
+	\brief Returns the network address in a stringified form.
+
+	\param[in] includePort If \c true, includes the port number in the output
+		string.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn BString BNetworkAddress::HostName() const
+	\brief Returns the host name for the network address.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn BString BNetworkAddress::ServiceName() const
+	\brief Returns the port number for the current address.
+
+	\since Haiku R1
+*/
+
+//! @}
+
+
+/*!
+	\name Address resolver
+*/
+
+//! @{
+
+/*!
+	\fn status_t BNetworkAddress::ResolveForDestination(const BNetworkAddress& destination)
+	\brief For the given \a destination resolves the source address in the route
+		and sets \a this object address to that source address.
+
+	\param[in] destination The destination address from where to resolve
+		the source address.
+
+	\retval B_OK Source address was resolved successfully.
+	\retval B_BAD_VALUE The destination address family is not the same as this
+		address family.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkAddress::ResolveTo(const BNetworkAddress& address)
+	\brief Sets this object to \a address.
+
+	\param[in] address The addres to be resolved.
+
+	\retval B_OK Operation performed successfully.
+	\retval B_BAD_VALUE The address family of \a address is not the same as
+		this object's address family.
+
+	\since Haiku R1
+*/
+
+//! @}
+
+
+/*!
+	\name Comparison
+*/
+
+//! @{
+
+/*!
+	\fn bool BNetworkAddress::Equals(const BNetworkAddress& other, bool includePort = true) const
+	\brief Compares if \a this address is equal to \a other address.
+
+	\retval true \a this address is equal to \a other address.
+	\retval false \a this address is not equal to \a other address.
+
+	\since Haiku R1
+*/
+
+//! @}
+
+
+/*!
+	\name BFlattenable implementation
+*/
+
+//! @{
+
+/*!
+	\fn virtual bool BNetworkAddress::IsFixedSize() const
+	\brief Returnd whether or not BNetworkAddress flattened objects
+		always have a fixed size.
+
+	\returns It always returns \c false.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn virtual type_code BNetworkAddress::TypeCode() const
+	\brief Returns the type_code this class flattens to.
+
+	\returns The type code of this class \c ::B_NETWORK_ADDRESS_TYPE.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn virtual ssize_t BNetworkAddress::FlattenedSize() const
+	\brief Returns the size of the flattened object in bytes.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn virtual status_t BNetworkAddress::Flatten(void* buffer, ssize_t size) const
+	\brief Flattens the object into the supplied \a buffer.
+
+	\param[in] buffer The buffer to flatten in.
+	\param[in] size The size of the buffer.
+
+	\retval B_OK The object was flattened.
+	\retval B_BAD_VALUE The supplied buffer is \c NULL or the size is lesser than
+		the required size in FlattenedSize().
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn virtual status_t BNetworkAddress::Unflatten(type_code code, const void* buffer, ssize_t size)
+	\brief Unflattens the buffer and puts the contents into the current object.
+
+	\param[in] code The type code of the data.
+	\param[in] buffer The buffer to unflatten the data from.
+	\param[in] size The size of the data.
+
+	\retval B_OK The data was unflattened into this object.
+	\retval B_BAD_TYPE This class does not support the type \a code.
+	\retval B_BAD_VALUE The buffer is \c NULL or too small, or it contains an
+		invalid address.
+
+	\since Haiku R1
+*/
+
+//! @}
+
+
+/*!
+	\name Comparison
+*/
+
+//! @{
+
+
+/*!
+	\fn bool BNetworkAddress::operator==(const BNetworkAddress& other) const
+	\brief Compares if \a this address is equal to \a other address.
+
+	\retval true \a this address is equal to \a other address.
+	\retval false \a this address is not equal to \a other address.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn bool BNetworkAddress::operator!=(const BNetworkAddress& other) const
+	\brief Compares if \a this address is not equal to \a other address.
+
+	\retval true \a this address is not equal to \a other address.
+	\retval false \a this address is equal to \a other address.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn bool BNetworkAddress::operator<(const BNetworkAddress& other) const
+	\brief Compares if \a this address is less than \a other address.
+
+	\retval true \a this address is less than \a other address.
+	\retval false \a this address is equal to or greater than \a other address.
+
+	\since Haiku R1
+*/
+
+//! @}
+
+
+/*!
+	\name Socket address access and operators
+*/
+
+//! @{
+
+/*!
+	\fn const sockaddr& BNetworkAddress::SockAddr() const
+	\brief Returns a read only reference to the underlying socket address.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn sockaddr& BNetworkAddress::SockAddr()
+	\brief Returns a mutable reference to the underlying socket address.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn BNetworkAddress::operator const sockaddr*() const
+	\brief Returns a read only pointer to the underlying socket address.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn BNetworkAddress::operator const sockaddr&() const
+	\brief Returns a read only reference to the underlying socket address.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn BNetworkAddress::operator const sockaddr*()
+	\brief Returns a read only pointer to the underlying socket address.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn BNetworkAddress::operator sockaddr*()
+	\brief Returns a mutable pointer to the underlying socket address.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn BNetworkAddress::operator const sockaddr&()
+	\brief Returns a read only reference to the underlying socket address.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn BNetworkAddress::operator sockaddr&()
+	\brief Returns a mutable reference to the underlying socket address.
+
+	\since Haiku R1
+*/
+
+//! @}
diff --git a/docs/user/net/NetworkDevice.dox b/docs/user/net/NetworkDevice.dox
new file mode 100644
index 0000000000..9fb7c64c37
--- /dev/null
+++ b/docs/user/net/NetworkDevice.dox
@@ -0,0 +1,734 @@
+/*
+ * Copyright 2026 Haiku, Inc. All rights reserved.
+ * Distributed under the terms of the MIT License.
+ *
+ * Authors:
+ *		cafeina
+ *
+ * Corresponds to:
+ *		headers/os/net/NetworkDevice.h	hrev59275
+ *		src/kits/network/libnetapi/NetworkDevice.cpp	hrev59275
+ */
+
+
+/*!
+	\file NetworkDevice.h
+	\ingroup network
+	\brief Provides the BNetworkDevice class and wireless_network struct.
+*/
+
+
+/*!
+	\var ::B_NETWORK_AUTHENTICATION_NONE
+	\brief Authentication is performed without any authentication method.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\var ::B_NETWORK_AUTHENTICATION_WEP
+	\brief Authentication is performed via Wired Equivalent Privacy (WEP)
+		authentication method.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\var ::B_NETWORK_AUTHENTICATION_WPA
+	\brief Authentication is performed via Wi-Fi Protected Access (WPA)
+		authentication method.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\var ::B_NETWORK_AUTHENTICATION_WPA2
+	\brief Authentication is performed via Wi-Fi Protected Access 2 (WPA2)
+		authentication method.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\var ::B_NETWORK_AUTHENTICATION_EAP
+	\brief Authentication is performed via Extensible Authentication Protocol
+		(EAP) authentication method.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\var ::B_NETWORK_CIPHER_NONE
+	\brief The data stream is not ciphered.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\var ::B_NETWORK_CIPHER_WEP_40
+	\brief The data stream is ciphered using WEP-40: a RC4 based stream cipher
+		consisting of a  40-bit key plus a 24-bit initialization vector.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\var ::B_NETWORK_CIPHER_WEP_104
+	\brief The data stream is ciphered using WEP-104: a RC4 based stream cipher
+		consisting of a 104-bit key plus a 24-bit initialization vector.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\var ::B_NETWORK_CIPHER_TKIP
+	\brief The data stream is ciphered using Temporal Key Integrity Protocol
+		(TKIP).
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\var ::B_NETWORK_CIPHER_CCMP
+	\brief The data stream is ciphered using Counter Mode with CBC-MAC
+		Protocol (CCMP).
+
+	\since Haiku R1
+*/
+
+/* RFC 4493 */
+/*!
+	\var ::B_NETWORK_CIPHER_AES_128_CMAC
+	\brief The data stream is ciphered using Advanced Encryption Standard (AES)
+		with a 128-bit block size with Cipher-based Message Authentication Code
+		(CMAC) for data integrity.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\var ::B_KEY_MODE_IEEE802_1X
+	\brief The cryptographic key is distibuted using IEEE 802.1X mode,
+		making use of the Extensible Authentication Protocol (EAP). Also
+		known as WPA-Enterprise.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\var ::B_KEY_MODE_PSK
+	\brief The cryptographic key is distibuted using Pre-shared Key (PSK) mode.
+		Also known as WPA-Personal.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\var ::B_KEY_MODE_NONE
+	\brief There is no particular key mode or the network is open
+		(not encrypted).
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\var ::B_KEY_MODE_FT_IEEE802_1X
+	\brief The cryptographic key is distibuted using IEEE 802.1X Fast Transition
+		mode, making use of the Extensible Authentication Protocol (EAP).
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\var ::B_KEY_MODE_FT_PSK
+	\brief The cryptographic key is distibuted using Pre-shared Key (PSK)
+		Fast Transition mode.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\var ::B_KEY_MODE_IEEE802_1X_SHA256
+	\brief The cryptographic key is distibuted using IEEE 802.1X with SHA-256
+		 mode.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\var ::B_KEY_MODE_PSK_SHA256
+	\brief The cryptographic key is distibuted using Pre-shared Key (PSK)
+		with SHA-256 mode.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\var ::B_KEY_MODE_WPS
+	\brief The cryptographic key is distibuted through Wi-Fi Protected Setup
+		(WPS).
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\var ::B_NETWORK_EAP_ENCAPSULATION_NONE
+	\brief There is no particular encapsulation for the Extensible
+		Authentication Protocol (EAP) mode or the network device is not using
+		this protocol.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\var ::B_NETWORK_EAP_ENCAPSULATION_PEAP
+	\brief The Extensible Authentication Protocol (EAP) authentication is encapsulated
+		within a Protected Extensible Authentication Protocol (PEAP)
+		encrypted tunnel.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\var ::B_NETWORK_EAP_ENCAPSULATION_TLS
+	\brief The Extensible Authentication Protocol (EAP) authentication is performed
+		using Transport Layer Security (TLS) for cryptographic negotiation
+		between the endpoints.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\def B_NETWORK_IS_ENCRYPTED
+	\brief The wireless_network is encrypted.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\def B_NETWORK_IS_PERSISTENT
+	\brief The wireless_network is set as persistent.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\struct wireless_network
+	\ingroup network
+	\brief Describes a wireless network.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\var wireless_network::name
+
+	\brief The service set identifier (SSID) of the wireless network.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\var wireless_network::address
+
+	\brief The basic service set identifier (BSSID) of the wireless network.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\var wireless_network::noise_level
+
+	\brief The noise level of the wireless network.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\var wireless_network::signal_strength
+
+	\brief The signal strength of the wireless network.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\var wireless_network::flags
+	\brief Configuration flags of the wireless_network object.
+
+	Valid values are:
+	- ::B_NETWORK_IS_ENCRYPTED
+	- ::B_NETWORK_IS_PERSISTENT
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\var wireless_network::authentication_mode
+
+	\brief The authentication mode of the wireless network.
+
+	The authentication modes are described in this enumeration:
+	\code{.cpp}
+	// authentication modes
+	enum {
+		B_NETWORK_AUTHENTICATION_NONE		= 0,
+		B_NETWORK_AUTHENTICATION_WEP		= 1,
+		B_NETWORK_AUTHENTICATION_WPA		= 2,
+		B_NETWORK_AUTHENTICATION_WPA2		= 3,
+		B_NETWORK_AUTHENTICATION_EAP		= 4
+	};
+	\endcode
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\var wireless_network::cipher
+
+	\brief The cipher algorithm of the wireless network.
+
+	The cipher algorithms are described in this enumeration:
+	\code{.cpp}
+	// cipher algorithms
+	enum {
+		B_NETWORK_CIPHER_NONE				= 0x01,
+		B_NETWORK_CIPHER_WEP_40				= 0x02,
+		B_NETWORK_CIPHER_WEP_104			= 0x04,
+		B_NETWORK_CIPHER_TKIP				= 0x08,
+		B_NETWORK_CIPHER_CCMP				= 0x10,
+		B_NETWORK_CIPHER_AES_128_CMAC		= 0x20
+	};
+	\endcode
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\var wireless_network::group_cipher
+
+	\brief This field could be defined with one of the values described
+	in wireless_network::cipher.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\var wireless_network::key_mode
+
+	\brief The key negotiation mode.
+
+	The key modes are described in this enumeration:
+	\code{.cpp}
+	// key modes
+	enum {
+		B_KEY_MODE_IEEE802_1X				= 0x0001,
+		B_KEY_MODE_PSK						= 0x0002,
+		B_KEY_MODE_NONE						= 0x0004,
+		B_KEY_MODE_FT_IEEE802_1X			= 0x0020,
+		B_KEY_MODE_FT_PSK					= 0x0040,
+		B_KEY_MODE_IEEE802_1X_SHA256		= 0x0080,
+		B_KEY_MODE_PSK_SHA256				= 0x0100,
+		B_KEY_MODE_WPS						= 0x0200
+	};
+	\endcode
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn bool wireless_network::operator==(const wireless_network& other)
+	\brief Checks if \a other is the same wireless network as this.
+
+	The check ignores the address difference between \a address and
+	\a other.address.
+
+	\returns \c true if both wireless_network objects represent the same
+		wireless network, or \c false otherwise.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\class BNetworkDevice
+	\ingroup network
+	\brief BNetworkDevice class represents a network device.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn BNetworkDevice::BNetworkDevice()
+	\brief Creates a BNetworkDevice object in an uninitialized state.
+
+	\sa SetTo()
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn BNetworkDevice::BNetworkDevice(const char* name)
+	\brief Creates and initializes a BNetworkDevice object identified by \a name.
+
+	\param[in] name The device name.
+
+	\sa SetTo()
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn void BNetworkDevice::Unset()
+	\brief Returns the object to an uninitialized state.
+
+	\sa SetTo()
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn void BNetworkDevice::SetTo(const char* name)
+	\brief (Re)initializes the BNetworkDevice object to work with the
+		device in \a name.
+
+	\param[in] name The device name.
+
+	\sa Unset()
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn const char* BNetworkDevice::Name() const
+	\brief Returns the device name.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn bool BNetworkDevice::Exists() const
+	\brief Checks if the network device identified as Name() exists in the system.
+
+	\retval true The device exists.
+	\retval false The device does not exist or the BNetworkDevice object
+		is not initialized.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn uint32 BNetworkDevice::Index() const
+	\brief Returns the index of the device in the list of network devices.
+
+	If the device was not found or this object is not initialized,
+	it returns \c 0.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn uint32 BNetworkDevice::Flags() const
+	\brief Returns a bit mask of the flags associated with the device.
+
+	Possible flags are those defined in the POSIX header \c net/if.h.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn bool BNetworkDevice::HasLink() const
+	\brief Checks if the device has an active connection with another interface.
+
+	\retval true The device has a link.
+	\retval false The device does not have a link.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn int32 BNetworkDevice::Media() const
+	\brief Returns a bit mask of the device's media options.
+
+	Possible flags are those defined in the header \c net/if_media.h.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkDevice::SetMedia(int32 media)
+	\brief Configures the media options of the device.
+
+	\returns B_OK on success, or an error code.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkDevice::GetHardwareAddress(BNetworkAddress& address)
+	\brief Gets the MAC address of the device.
+
+	\param[out] address A BNetworkAddress object where to write the address.
+
+	\returns \c B_OK on success, or an error code.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn bool BNetworkDevice::IsEthernet()
+	\brief Checks if the device media type is ethernet.
+
+	\retval true The device is an ethernet device.
+	\retval false The device is not an ethernet device.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn bool BNetworkDevice::IsWireless()
+	\brief Checks if the device media type is IEEE 802.11 (WLAN) or wireless.
+
+	\retval true The device is a wireless device.
+	\retval false The device is not a wireless device.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkDevice::Control(int option, void* request)
+	\brief Sends an ioctl request to the device.
+
+	\param[in] option The kind of operation.
+	\param[in] request The request data.
+
+	\returns \c B_OK on success, or an error code.
+
+	\retval B_OK Command sent and processed successfully.
+	\retval B_ERROR Something went wrong, or performing ioctl calls is not
+		supported for the device's media type.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkDevice::Scan(bool wait = true, bool forceRescan = true)
+	\brief Scans for a wireless network.
+
+	\param[in] wait Tells the object to wait for any WLAN change before starting
+		to scan.
+	\param[in] forceRescan Flush any previous scan result.
+
+	\return B_OK if the operation was performed successfully or an error code
+		otherwise.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkDevice::GetNetworks(wireless_network*& networks,
+		uint32& count)
+	\brief Gets all the detected wireless networks from a previous scan.
+
+	\param[out] networks A \c NULL pointer where an array of wireless_network
+		will be written to.
+	\param[out] count How many items there are in \a networks.
+
+	\retval B_OK Operation performed successfully.
+	\retval B_BAD_VALUE \a networks is not \c NULL.
+	\retval B_NO_MEMORY Internal memory allocation error.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkDevice::GetNetwork(const char* name,
+		wireless_network& network)
+	\brief Returns a wireless_network object of the network identified as \a name.
+
+	\param[in] name The wireless network name.
+	\param[out] network A wireless_network object where the network information
+		will be written to.
+
+	\retval B_OK Operation performed successfully.
+	\retval B_BAD_VALUE \a name is \c NULL.
+	\retval B_NO_MEMORY Internal memory allocation error.
+	\retval B_ENTRY_NOT_FOUND There is no network called \a name.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkDevice::GetNetwork(const BNetworkAddress& address,
+		wireless_network& network)
+	\brief Returns a wireless_network object of the network
+		described in \a address.
+
+	\param[in] address A BNetworkAddress object of the wireless network.
+	\param[out] network A wireless_network object where the network information
+		will be written to.
+
+	\retval B_OK Operation performed successfully.
+	\retval B_BAD_VALUE \a address'	family is not \c AF_LINK.
+	\retval B_NO_MEMORY Internal memory allocation error.
+	\retval B_ENTRY_NOT_FOUND There is no network called \a name.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkDevice::JoinNetwork(const char* name,
+		const char* password = NULL)
+	\brief Connects to the network identified as \a name.
+
+	\param[in] name The network name.
+	\param[in] password The network password.
+
+	\retval B_OK Operation performed successfully.
+	\retval B_BAD_VALUE \a name is \c NULL.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkDevice::JoinNetwork(const wireless_network& network,
+		const char* password = NULL)
+	\brief Connects to the network described in \a network.
+
+	\param[in] network A wireless_network object with the network information.
+	\param[in] password The network password.
+
+	\retval B_OK Operation performed successfully.
+	\retval B_BAD_VALUE The name in \a network is \c NULL.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkDevice::JoinNetwork(const BNetworkAddress& address,
+		const char* password = NULL)
+	\brief Connects to the network in \a address.
+
+	\param[in] address The network address.
+	\param[in] password The network password.
+
+	\retval B_OK Operation performed successfully.
+	\retval B_BAD_VALUE \a address is not properly initialized.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkDevice::LeaveNetwork(const char* name)
+	\brief Disconnects from the wireless network \a name.
+
+	\param[in] name The network name.
+
+	\return \c B_OK if it could leave the network or an error code.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkDevice::LeaveNetwork(const wireless_network& network)
+	\brief Disconnects from the wireless \a network.
+
+	\param[in] network A wireless_network object with the network name.
+
+	\return \c B_OK if it could leave the network or an error code.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkDevice::LeaveNetwork(const BNetworkAddress& address)
+	\brief Disconnects from the wireless network in \a address.
+
+	\return \c B_OK if it could leave the network or an error code.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkDevice::GetNextAssociatedNetwork(uint32& cookie,
+		wireless_network& network)
+	\brief Iterates through the associated networks and saves the next one
+		in \a network.
+
+	\retval B_OK Operation performed successfully.
+	\retval B_ENTRY_NOT_FOUND There are no more associated networks.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkDevice::GetNextAssociatedNetwork(uint32& cookie,
+		BNetworkAddress& address)
+	\brief Iterates through the associated networks and saves the address of
+		next one in \a address.
+
+	\retval B_OK Operation performed successfully.
+	\retval B_ENTRY_NOT_FOUND There are no more associated networks.
+
+	\since Haiku R1
+*/
diff --git a/docs/user/net/NetworkNotifications.dox b/docs/user/net/NetworkNotifications.dox
new file mode 100644
index 0000000000..487720d002
--- /dev/null
+++ b/docs/user/net/NetworkNotifications.dox
@@ -0,0 +1,197 @@
+/*
+ * Copyright 2026 Haiku, Inc. All rights reserved.
+ * Distributed under the terms of the MIT License.
+ *
+ * Authors:
+ *		cafeina
+ *
+ * Corresponds to:
+ *		headers/os/net/NetworkNotifications.h	hrev59275
+ *		src/kits/network/libnetapi/notifications.cpp	hrev59275
+ */
+
+
+/*!
+	\file NetworkNotifications.h
+	\ingroup network
+	\brief Provides C functions to get network related notifications.
+
+	There is a C++ view of the API: BNetworkRoster::StartWatching() to
+	subscribe to get these events and BNetworkRoster::StopWatching() to
+	unsubscribe from them.
+*/
+
+
+/*!
+	\def B_NETWORK_INTERFACE_ADDED
+	\brief Notification sent to subscribers when a network interface was added.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\def B_NETWORK_INTERFACE_REMOVED
+	\brief Notification sent to subscribers when a network interface was removed.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\def B_NETWORK_INTERFACE_CHANGED
+	\brief Notification sent to subscribers when a network interface was modified.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\def B_NETWORK_DEVICE_LINK_CHANGED
+	\brief Notification sent to subscribers when a network link was changed.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\def B_NETWORK_WLAN_JOINED
+	\brief Notification sent to subscribers when joining a wireless network.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\def B_NETWORK_WLAN_LEFT
+	\brief Notification sent to subscribers when leaving a wireless network.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\def B_NETWORK_WLAN_SCANNED
+	\brief Notification sent to subscribers after scanning for available
+		wireless networks.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\def B_NETWORK_WLAN_MESSAGE_INTEGRITY_FAILED
+	\brief Notification sent to subscribers when in a wireless network using WPA
+		based protocols, the message integrity check sent to prevent tampering
+		of messages by "man in the middle" attacks has failed.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\var B_WATCH_NETWORK_INTERFACE_CHANGES
+	\brief Flag to subscribe to receive network interface changes notifications.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\var B_WATCH_NETWORK_LINK_CHANGES
+	\brief Flag to subscribe to receive network link changes notifications.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\var B_WATCH_NETWORK_WLAN_CHANGES
+	\brief Flag to subscribe to receive wireless networks changes notifications.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t start_watching_network(uint32 flags, const BMessenger& target)
+	\brief Subscribes \a target to receive network events' notifications
+		described in \a flags.
+
+	Valid values for \a flags are any combination of the following:
+	- \c ::B_WATCH_NETWORK_INTERFACE_CHANGES
+	- \c ::B_WATCH_NETWORK_LINK_CHANGES
+	- \c ::B_WATCH_NETWORK_WLAN_CHANGES
+
+	For \c B_WATCH_NETWORK_INTERFACE_CHANGES, the following notifications
+		will be sent to \a target if such events happen:
+	- \c ::B_NETWORK_INTERFACE_ADDED
+	- \c ::B_NETWORK_INTERFACE_REMOVED
+	- \c ::B_NETWORK_INTERFACE_CHANGED
+
+	For \c B_WATCH_NETWORK_LINK_CHANGES, the following notification
+		will be sent to \a target if such event happens:
+	- \c ::B_NETWORK_DEVICE_LINK_CHANGED
+
+	For \c B_WATCH_NETWORK_WLAN_CHANGES, the following notifications
+		will be sent to \a target if such events happen:
+	- \c ::B_NETWORK_WLAN_JOINED
+	- \c ::B_NETWORK_WLAN_LEFT
+	- \c ::B_NETWORK_WLAN_SCANNED
+	- \c ::B_NETWORK_WLAN_MESSAGE_INTEGRITY_FAILED
+
+	If \a flags is \c 0, it will stop sending notifications to \a target.
+
+	\param[in] flags A flags mask for the events to watch. Setting it to
+		\c 0 will stop watching for network events.
+	\param[in] target A BMessenger object to where the notification messages
+		will be delivered.
+
+	\retval B_OK \a target was subscribed to receive network notifications.
+	\retval B_NOT_SUPPORTED The network notifications API is not supported.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t start_watching_network(uint32 flags, const BHandler* target,
+		const BLooper* looper = NULL)
+	\brief Subscribes \a target or \a looper to receive network notifications.
+
+	For the valid values for \a flags and the notifications that will be
+	received by the subscriber, see
+	start_watching_network(uint32, const BMessenger&).
+
+	\retval B_OK \a target or \a looper was subscribed to receive
+		network notifications.
+	\retval B_NOT_SUPPORTED The network notifications API is not supported.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t stop_watching_network(const BMessenger& target)
+	\brief Unsubscribes \a target from receiving network messages.
+
+	\retval B_OK \a target was unsubscribed from receiving network notifications.
+	\retval B_NOT_SUPPORTED The network notifications API is not supported.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t stop_watching_network(const BHandler* target,
+		const BLooper* looper = NULL)
+	\brief Unsubscribes \a target or \a looper from receiving network messages.
+
+	\retval B_OK \a target or \a looper was subscribed from receiving
+		network notifications.
+	\retval B_NOT_SUPPORTED The network notifications API is not supported.
+
+	\since Haiku R1
+*/
+
+
diff --git a/docs/user/net/NetworkRoster.dox b/docs/user/net/NetworkRoster.dox
new file mode 100644
index 0000000000..39799c9e88
--- /dev/null
+++ b/docs/user/net/NetworkRoster.dox
@@ -0,0 +1,296 @@
+/*
+ * Copyright 2025 Haiku, Inc. All rights reserved.
+ * Distributed under the terms of the MIT License.
+ *
+ * Authors:
+ *		cafeina
+ *
+ * Corresponds to:
+ *		headers/os/net/NetworkRoster.h	hrev59275
+ *		src/kits/network/libnetapi/NetworkRoster.cpp	hrev59275
+ */
+
+
+/*!
+	\file NetworkRoster.h
+	\ingroup network
+	\brief Provides the BNetworkRoster class.
+*/
+
+
+/*!
+	\class BNetworkRoster
+	\ingroup network
+	\brief BNetworkRoster class allows to manage network interfaces as well as
+		persistent (wireless) networks.
+
+	To use this class you have to call the default instance:
+
+	\code{.cpp}
+	BNetworkRoster& roster = BNetworkRoster::Default();
+	\endcode
+
+	Once done, you can manage network interfaces using AddInterface() and
+	RemoveInterface(), or enumerate them using CountInterfaces() and
+	GetNextInterface().
+
+	You can also manage persistent networks using AddPersistentNetwork() and
+	RemovePersistentNetwork(), as well as enumerate them using
+	CountPersistentNetworks() and GetNextPersistentNetwork().
+
+	In addition, you can have access to the network notifications API using
+	StartWatching() and StopWatching(), attaching to it a BMessenger instance
+	as a parameter to start or stop monitoring for network related events.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn static BNetworkRoster& BNetworkRoster::Default()
+	\brief Returns the default network roster.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\name Network interfaces
+*/
+
+
+//! @{
+
+
+/*!
+	\fn size_t BNetworkRoster::CountInterfaces() const
+	\brief Returns the number of network interfaces in the system.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkRoster::GetNextInterface(uint32* cookie, BNetworkInterface& interface) const
+	\brief Iterate through the network interfaces.
+
+	\param[out] cookie A cookie used to keep track of where you are in the list
+		of network interfaces. Before doing the first query, it has to be
+		initialized to \c 0. After that, pass the cookie to each subsequent call
+		to progress the iterator.
+	\param[out] interface A pre-allocated BNetworkInterface where to write the
+		network interface information. For each successful iteration,
+		the existing contents is overwritten.
+
+	\returns \c B_OK if the iteration was successful, or an error code.
+
+	\retval B_OK The iteration was successful and the current
+		interface information was written to \a interface.
+	\retval B_BAD_VALUE \a cookie is \c NULL, or no more interfaces were found.
+	\retval B_NO_MEMORY Internal memory allocation error.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkRoster::AddInterface(const char* name)
+	\brief Add a network interface identified by \a name.
+
+	\param[in] name The name of the interface.
+
+	\returns B_OK if the interface was added, or an error code.
+
+	\retval B_OK Operation performed successfully.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkRoster::AddInterface(const BNetworkInterface& interface)
+	\brief Add a network interface from a BNetworkInterface object.
+
+	\param[in] interface A BNetworkInterface object from where
+		to create the interface.
+
+	\returns B_OK if the interface was added, or an error code.
+
+	\retval B_OK Operation performed successfully.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkRoster::RemoveInterface(const char* name)
+	\brief Remove the network interface identified by \a name.
+
+	\param[in] name The name of the interface.
+
+	\returns B_OK if the interface was removed, or an error code.
+
+	\retval B_OK Operation performed successfully.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkRoster::RemoveInterface(const BNetworkInterface& interface)
+	\brief Remove the network interface matching a BNetworkInterface object.
+
+	\param[in] interface A BNetworkInterface object from where to get the
+		interface name to remove.
+
+	\returns B_OK if the interface was removed, or an error code.
+
+	\retval B_OK Operation performed successfully.
+
+	\since Haiku R1
+*/
+
+
+//! @}
+
+
+/*!
+	\name Persistent networks
+*/
+
+
+//! @{
+
+
+/*!
+	\fn int32 BNetworkRoster::CountPersistentNetworks() const
+	\brief Returns the number of saved persistent networks.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkRoster::GetNextPersistentNetwork(uint32* cookie,
+									wireless_network& network) const
+	\brief Iterate through the saved persistent networks.
+
+	\param[out] cookie A cookie used to keep track of where you are in the list
+		of persistent networks. Before doing the first query, it has to be
+		initialized to \c 0. After that, pass the cookie to each subsequent call
+		to progress the iterator.
+	\param[out] network A pre-allocated wireless_network object where to write
+		the network information. For each successful iteration, the existing
+		contents is overwritten.
+
+	\returns \c B_OK if the iteration was successful, or an error code.
+
+	\retval B_OK The iteration was successful and the current persistent
+		network was written to \a network.
+	\retval B_ERROR There was an error receiving the reply from the net server,
+		the end of the persistent networks was reached,
+		or the network name could not be retrieved.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkRoster::AddPersistentNetwork(
+									const wireless_network& network) const
+	\brief Add \a network to the list of persistent networks.
+
+	\param[in] network The wireless_network instance containing the network
+		information.
+
+	\returns \c B_OK on success, or an error code otherwise.
+
+	\retval B_OK The network was added to the persistent network list.
+	\retval B_BAD_VALUE wireless_network::name is NULL or its length
+		is equal to \c 0.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkRoster::RemovePersistentNetwork(const char* name) const
+	\brief Remove the persistent network identified as \a name.
+
+	\param[in] name The network name.
+
+	\returns \c B_OK on success, or an error code otherwise.
+
+	\retval B_OK The network was removed successfully.
+	\retval B_BAD_VALUE \a name is NULL or its length is equal to \c 0.
+	\retval B_ENTRY_NOT_FOUND A network \a name could not be found in the
+		persistent networks list.
+
+	\since Haiku R1
+*/
+
+
+//! @}
+
+
+/*!
+	\name Notifications API
+*/
+
+
+//! @{
+
+
+/*!
+	\fn status_t BNetworkRoster::StartWatching(const BMessenger& target,
+									uint32 eventMask)
+	\brief Subscribes \a target to receive network events' notifications
+		described in \a eventMask.
+
+	Valid values for \a eventMask are any combination of the following:
+	- \c ::B_WATCH_NETWORK_INTERFACE_CHANGES
+	- \c ::B_WATCH_NETWORK_LINK_CHANGES
+	- \c ::B_WATCH_NETWORK_WLAN_CHANGES
+
+	For \c B_WATCH_NETWORK_INTERFACE_CHANGES, the following notifications
+		will be sent to \a target if such events happen:
+	- \c ::B_NETWORK_INTERFACE_ADDED
+	- \c ::B_NETWORK_INTERFACE_REMOVED
+	- \c ::B_NETWORK_INTERFACE_CHANGED
+
+	For \c B_WATCH_NETWORK_LINK_CHANGES, the following notification
+		will be sent to \a target if such event happens:
+	- \c ::B_NETWORK_DEVICE_LINK_CHANGED
+
+	For \c B_WATCH_NETWORK_WLAN_CHANGES, the following notifications
+		will be sent to \a target if such events happen:
+	- \c ::B_NETWORK_WLAN_JOINED
+	- \c ::B_NETWORK_WLAN_LEFT
+	- \c ::B_NETWORK_WLAN_SCANNED
+	- \c ::B_NETWORK_WLAN_MESSAGE_INTEGRITY_FAILED
+
+	If \a eventMask is \c 0, it will stop sending notifications to \a target.
+
+	\param[in] target A BMessenger object to where the notification messages
+		will be delivered.
+	\param[in] eventMask A flags mask for the events to watch. Setting it to
+		\c 0 will stop watching for network events (the same as calling
+		StopWatching()).
+
+	\returns \c B_OK on success or an error code.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn void BNetworkRoster::StopWatching(const BMessenger& target)
+	\brief Unsubscribes \a target from receiving network messages.
+
+	\param[in] target A BMessenger object that will not be sent any more messages.
+
+	\since Haiku R1
+*/
+
+
+//! @}
diff --git a/docs/user/net/NetworkRoute.dox b/docs/user/net/NetworkRoute.dox
new file mode 100644
index 0000000000..e1cdc90d60
--- /dev/null
+++ b/docs/user/net/NetworkRoute.dox
@@ -0,0 +1,337 @@
+/*
+ * Copyright 2026 Haiku, Inc. All rights reserved.
+ * Distributed under the terms of the MIT License.
+ *
+ * Authors:
+ *		cafeina
+ *
+ * Corresponds to:
+ *		headers/os/net/NetworkRoute.h	hrev59275
+ *		src/kits/network/libnetapi/NetworkRoute.cpp	hrev59275
+ */
+
+
+/*!
+	\file NetworkRoute.h
+	\ingroup network
+	\brief Provides the BNetworkRoute class.
+*/
+
+
+/*!
+	\class BNetworkRoute
+	\ingroup network
+	\brief BNetworkRoute class represents a network route, a path for
+		traffic across one or multiple networks.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn BNetworkRoute::BNetworkRoute()
+	\brief Creates an uninitialized BNetworkRoute object.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn BNetworkRoute::~BNetworkRoute()
+	\brief Releases all the allocated resources.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkRoute::SetTo(const BNetworkRoute& other)
+	\brief Initializes this object from \a other BNetworkRoute object.
+
+	\param[in] other The BNetworkRoute instance from where to
+		initialize this object.
+
+	\return \c B_OK if the object was initialized or an error code.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkRoute::SetTo(const route_entry& routeEntry)
+	\brief Initializes this object from a route_entry instance.
+
+	\param[in] routeEntry A route_entry object with the routing information.
+
+	\return \c B_OK if the object was initialized or an error code.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn void BNetworkRoute::Adopt(BNetworkRoute& other)
+	\brief Moves \a other to this instance.
+
+	\a other is left uninitialized.
+
+	\param other The other BNetworkRoute object.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn const route_entry& BNetworkRoute::RouteEntry() const
+	\brief Returns a copy of the route_entry with routing information of this
+		object.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn const sockaddr* BNetworkRoute::Destination() const
+	\brief Returns the destination address.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkRoute::SetDestination(const sockaddr& destination)
+	\brief Sets the destination address.
+
+	\param[in] destination A sockaddr struct instance with the destination
+		information.
+
+	\retval B_OK The destination has been modified successfully.
+	\retval B_BAD_VALUE The length in \a destination.sa_len is higher than
+		the size of sockaddr_storage struct.
+	\retval B_NO_MEMORY Internal memory allocation error.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn void BNetworkRoute::UnsetDestination()
+	\brief Uninitializes the destination address.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn const sockaddr* BNetworkRoute::Mask() const
+	\brief Returns the subnet mask address.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkRoute::SetMask(const sockaddr& mask)
+	\brief Sets the subnet mask address.
+
+	\param[in] mask A sockaddr struct instance with the mask information.
+
+	\retval B_OK The mask has been modified successfully.
+	\retval B_BAD_VALUE The length in \a mask.sa_len is higher than
+		the size of sockaddr_storage struct.
+	\retval B_NO_MEMORY Internal memory allocation error.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn void BNetworkRoute::UnsetMask()
+	\brief Uninitializes the subnet mask address.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn const sockaddr* BNetworkRoute::Gateway() const
+	\brief Returns the gateway address.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkRoute::SetGateway(const sockaddr& gateway)
+	\brief Sets the gateway address.
+
+	\param[in] gateway A sockaddr struct instance with the gateway information.
+
+	\retval B_OK The gateway has been modified successfully.
+	\retval B_BAD_VALUE The length in \a gateway.sa_len is higher than
+		the size of sockaddr_storage struct.
+	\retval B_NO_MEMORY Internal memory allocation error.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn void BNetworkRoute::UnsetGateway()
+	\brief Uninitializes the gateway address.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn const sockaddr* BNetworkRoute::Source() const
+	\brief Returns the source address.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn status_t BNetworkRoute::SetSource(const sockaddr& source)
+	\brief Sets the source address.
+
+	\param[in] source A sockaddr struct instance with the source address
+		information.
+
+	\retval B_OK The source address has been modified successfully.
+	\retval B_BAD_VALUE The length in \a source.sa_len is higher than
+		the size of sockaddr_storage struct.
+	\retval B_NO_MEMORY Internal memory allocation error.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn void BNetworkRoute::UnsetSource()
+	\brief Uninitializes the source address.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn uint32 BNetworkRoute::Flags() const
+	\brief Returns the route's flags mask.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn void BNetworkRoute::SetFlags(uint32 flags)
+	\brief Sets the route's flags mask.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn uint32 BNetworkRoute::MTU() const
+	\brief Returns the maximum transmission unit size of the route.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn void BNetworkRoute::SetMTU(uint32 mtu)
+	\brief Sets the maximum transmission unit size of the route.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn int BNetworkRoute::AddressFamily() const
+	\brief Returns the route's address family.
+
+	If this object is uninitialized, it returns \c AF_UNSPEC.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn static status_t BNetworkRoute::GetDefaultRoute(int family,
+		const char* interfaceName, BNetworkRoute& route)
+	\brief Gets the default route.
+
+	\param[in] family The address family. See the POSIX header file
+		sys/socket.h for the address families.
+	\param[in] interfaceName The network interface name.
+	\param[out] route A BNetworkRoute where to write the default route.
+
+	\retval B_OK The default route was successfully retrieved.
+	\retval B_ENTRY_NOT_FOUND There is not a default route configured.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn static status_t BNetworkRoute::GetDefaultGateway(int family,
+		const char* interfaceName, sockaddr& gateway)
+	\brief Gets the default gateway.
+
+	\param[in] family The address family. See the POSIX header file
+		sys/socket.h for the address families.
+	\param[in] interfaceName The network interface name.
+	\param[out] gateway A sockaddr instance where to write the default gateway.
+
+	\return \c B_OK on success, or an error code otherwise.
+
+	\retval B_OK The default gateway was successfully retrieved.
+	\retval B_ENTRY_NOT_FOUND There is not a default route or
+		a default gateway configured.
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn static status_t BNetworkRoute::GetRoutes(int family,
+		BObjectList<BNetworkRoute, true>& routes)
+	\brief Returns the routes of \a family type into \a routes.
+
+	\sa BNetworkRoute::GetRoutes(int, const char*,
+		uint32, BObjectList<BNetworkRoute, true>&)
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn static status_t BNetworkRoute::GetRoutes(int family, const char* interfaceName,
+		BObjectList<BNetworkRoute, true>& routes)
+	\brief Returns the routes of \a family type in \a interfaceName
+		into \a routes.
+
+	\sa BNetworkRoute::GetRoutes(int, const char*,
+		uint32, BObjectList<BNetworkRoute, true>&)
+
+	\since Haiku R1
+*/
+
+
+/*!
+	\fn static status_t BNetworkRoute::GetRoutes(int family, const char* interfaceName,
+		uint32 filterFlags, BObjectList<BNetworkRoute, true>& routes)
+	\brief Returns the routes of \a family type in \a interfaceName that are not
+		filtered by \a filterFlags into \a routes.
+
+	\param[in] family The address family. See the POSIX header file
+		sys/socket.h for the address families.
+	\param[in] interfaceName The network interface name.
+	\param[in] filterFlags Flag mask to filter out routes. See the
+		POSIX header file net/route.h for the valid route flags.
+	\param[out] routes A BObjectList of BNetworkRoute to store the found routes.
+
+	\since Haiku R1
+*/