Format adresu¶

UDP stosuje format adresu IPv4 sockaddr_in opisany w ip(7).

Obsługa błędów¶

Wszystkie błędy krytyczne są przekazywane do programu użytkownika jako wartość zwracana, nawet gdy gniazdo nie jest połączone. Dotyczy to także błędów asynchronicznych otrzymywanych z sieci. Można też otrzymać błąd dotyczący pakietu wcześniej wysłanego z danego gniazda. To zachowanie różni się od wielu innych implementacji gniazd BSD, które nie przekazują żadnych błędów, gdy gniazdo nie jest połączone. Zachowanie Linuksa ma oparcie w RFC 1122.

Dla zgodności z kodem odziedziczonym w wersjach 2.0 i 2.2 jądra Linuksa było możliwe ustawienie opcji SOL_SOCKET SO_BSDCOMPAT, aby otrzymywać błędy zdalne tylko wtedy, gdy gniazdo jest połączone (z wyjątkiem EPROTO i EMSGSIZE). Błędy wygenerowane lokalnie są zawsze przekazywane. Obsługa tej opcji została usunięta w kolejnych wersjach jądra; szczegóły można znaleźć w socket(7).

Gdy włączona jest opcja IP_RECVERR, wszystkie błędy są przechowywane w kolejce błędów gniazda i mogą być odczytywane za pomocą recvmsg(2) z ustawionym znacznikiem MSG_ERRQUEUE.

Interfejsy /proc¶

Systemowe ustawienia parametrów można zmieniać, używając plików z katalogu /proc/sys/net/ipv4/.

udp_mem (od Linuksa 2.6.25)

Jest wektorem trzech liczb całkowitych zawierających numery stron, które mogą być kolejkowane przez wszystkie gniazda UDP.

Domyślne wartości powyższych trzech pozycji są wyliczane podczas startu systemu na podstawie ilości dostępnej pamięci.

udp_rmem_min (liczba całkowita; wartość domyślna: PAGE_SIZE; od Linuksa 2.6.25)

Minimalny rozmiar, bajtach, bufora otrzymywania używanego z umiarem przez gniazda UDP. Każde gniazdo UDP jest w stanie użyć tego rozmiaru do otrzymywania danych, nawet jeśli całkowita liczba stron gniazd UDP przekroczy udp_mem.

udp_wmem_min (liczba całkowita; wartość domyślna: PAGE_SIZE; od Linuksa 2.6.25)

Minimalny rozmiar, bajtach, bufora wysyłania używanego z umiarem przez gniazda UDP. Każde gniazdo UDP jest w stanie użyć tego rozmiaru do wysyłania danych, nawet jeśli całkowita liczba stron gniazd UDP przekroczy udp_mem.

Opcje gniazda¶

Aby ustawić lub pobrać opcję gniazda UDP, należy wywołać getsockopt(2) w celu odczytania lub setsockopt(2) w celu zapisania opcji, ustawiając argument poziomu opcji na IPPROTO_UDP. Jeśli nie zaznaczono inaczej, optval jest wskaźnikiem do int.

Poniższa lista dotyczy opcji gniazd charakterystycznych dla UDP. W podręczniku socket(7) opisano pewne inne opcje gniazd, które dotyczą również gniazd UDP.

UDP_CORK (od Linuksa 2.5.44)

Jeśli ta opcja zostanie włączona, to wszystkie dane na wyjściu tego gniazda są łączone do pojedynczego datagramu, który zostanie wysłany, kiedy ta opcja zostanie wyłączona. Opcja ta nie powinna być używana w kodzie, który w zamierzeniu ma być przenośny.

UDP_SEGMENT (od Linuksa 4.18)

Enables UDP segmentation offload. Segmentation offload reduces send(2) cost by transferring multiple datagrams worth of data as a single large packet through the kernel transmit path, even when that exceeds MTU. As late as possible, the large packet is split by segment size into a series of datagrams. This segmentation offload step is deferred to hardware if supported, else performed in software. This option takes a value in the range [0, USHRT_MAX] that sets the segment size: the size of datagram payload, excluding the UDP header. The segment size must be chosen such that at most 64 datagrams are sent in a single call and that the datagrams after segmentation meet the same MTU rules that apply to datagrams sent without this option. Segmentation offload depends on checksum offload, as datagram checksums are computed after segmentation. The option may also be set for individual sendmsg(2) calls by passing it as a cmsg(3). A value of zero disables the feature. This option should not be used in code intended to be portable.

UDP_GRO (od Linuksa 5.0)

Włącza odciążanie odbiorcze UDP. Po włączeniu, gniazdo może otrzymywać dane wielu datagramów jako pojedynczy, duży bufor, razem z cmsg(3), który zawiera rozmiar segmentu. Opcja ta jest odwrotnością odciążania segmentacji. Redukuje koszt obsługi odbioru, obsługując dane wielu datagramów jako pojedynczy, duży pakiet w ścieżce odbiorczej jądra nawet, gdy przekracza to MTU. Opcji tej nie należy używać w kodzie, który ma być przenośny.

Kontrolki systemowe (ioctl)¶

Do poniższych kontrolek wejścia/wyjścia można uzyskać dostęp za pomocą funkcji ioctl(2). Prawidłowa składnia to:

int value;
error = ioctl(udp_socket, ioctl_type, &value);

FIONREAD (SIOCINQ)

Pobiera jako argument wskaźnik do liczby całkowitej. Zwraca w tej zmiennej rozmiar następnego oczekującego datagramu lub 0, w razie braku oczekujących datagramów. Ostrzeżenie: FIONREAD nie daje możliwości rozróżnienia przypadku braku datagramów od przypadku, w którym następny oczekujący datagram zawiera zero bajtów danych. Żeby rozróżnić takie sytuacje bezpieczniej jest używać select(2), poll(2) lub epoll(7).

TIOCOUTQ (SIOCOUTQ)

Zwraca liczbę bajtów danych w lokalnej kolejce pakietów wychodzących. Obsługiwane jedynie przez Linuksa 2.4 i późniejsze wersje.

Ponadto wspierane są wszystkie kontrolki wejścia/wyjścia opisane w ip(7) i socket(7).