man/man3/getopt_long*.3: Split getopt_long_only() from getopt_long(3)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3/getopt_long.3: SYNOPSIS: Simplify feature test macro

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3/getopt*.3: Split getopt_long*() from getopt(3)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3/*s*printf.3: Split [v]sprintf() from snprintf(3)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3/*printf.3: Split *s*printf() from printf(3)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man5/proc.5: Remove redundant paragraph

We already reference the manual pages by name.

Fixes: ba0d674b67d6 (2025-12-02; "man/man5/proc*.5: Add references to other proc*.5 pages")
Signed-off-by: Alejandro Colomar <alx@kernel.org>

share/mk/: help-list-variables: Don't list undefined variables

Signed-off-by: Alejandro Colomar <alx@kernel.org>

share/mk/: $UNIQ: Add dependency

Signed-off-by: Alejandro Colomar <alx@kernel.org>

share/mk/: help-list-targets: Use 'make -n'

This makes the command more portable to arbitrary makefiles,
as one can run any target without fear of running any commands.

Signed-off-by: Alejandro Colomar <alx@kernel.org>

share/mk/: help, help-*: Add targets to list targets, variables, and build dependencies

Suggested-by: Paolo Bonzini <bonzini@gnu.org>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

GNUmakefile: wsfix

Signed-off-by: Alejandro Colomar <alx@kernel.org>

share/mk/: $TR: Add dependency

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/PR_SET_NAME.2const: SYNOPSIS: Fix prototype

The array may be narrower than that.

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/PR_SET_NAME.2const: SYNOPSIS: tfix

Fixes: a4fc95108363 (2024-05-31; "prctl.2, PR_[SG]ET_NAME.2const: Split PR_[SG]ET_NAME from prctl(2)")
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man5/proc*.5: Add references to other proc*.5 pages

Fixes: 0569afbbccd6 (2023-08-17; "proc*.5: Make sashimi")
Reported-by: "Michael T. Kerrisk" <mtk.manpages@gmail.com>
Reported-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/: Make sashimi of ipv6(7)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/IPV6_V6ONLY.2const: Tweak after split

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/{IPPROTO_IPV6,IPV6_V6ONLY}.2const: Split IPV6_V6ONLY from IPPROTO_IPV6(2const)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/IPV6_UNICAST_HOPS.2const: Tweak after split

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/{IPPROTO_IPV6,IPV6_UNICAST_HOPS}.2const: Split IPV6_UNICAST_HOPS from IPPROTO_IPV6(2const)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/IPV6_ROUTER_ALERT.2const: Tweak after split

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/{IPPROTO_IPV6,IPV6_ROUTER_ALERT}.2const: Split IPV6_ROUTER_ALERT from IPPROTO_IPV6(2const)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/IPV6_RECVERR.2const: Tweak after split

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/{IPPROTO_IPV6,IPV6_RECVERR}.2const: Split IPV6_RECVERR from IPPROTO_IPV6(2const)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/IPV6_RTHDR.2const: Tweak after split

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/IPV6_{AUTHHDR,DSTOPTS,HOPOPTS,FLOWINFO,HOPLIMIT}.2const: Add link pages

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/{IPPROTO_IPV6,IPV6_RTHDR}.2const: Split IPV6_{RTHDR,AUTHHDR,DSTOPTS,HOPOPTS,FLOWINFO,HOPLIMIT} from IPPROTO_IPV6(2const)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/IPV6_RECVPKTINFO.2const: Tweak after split

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/{IPPROTO_IPV6,IPV6_RECVPKTINFO}.2const: Split IPV6_RECVPKTINFO from IPPROTO_IPV6(2const)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/IPV6_MULTICAST_LOOP.2const: Tweak after split

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/{IPPROTO_IPV6,IPV6_MULTICAST_LOOP}.2const: Split IPV6_MULTICAST_LOOP from IPPROTO_IPV6(2const)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/IPV6_MULTICAST_IF.2const: Tweak after split

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/{IPPROTO_IPV6,IPV6_MULTICAST_IF}.2const: Split IPV6_MULTICAST_IF from IPPROTO_IPV6(2const)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/IPV6_MULTICAST_HOPS.2const: Tweak after split

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/{IPPROTO_IPV6,IPV6_MULTICAST_HOPS}.2const: Split IPV6_MULTICAST_HOPS from IPPROTO_IPV6(2const)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/IPV6_MTU_DISCOVER.2const: Tweak after split

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/{IPPROTO_IPV6,IPV6_MTU_DISCOVER}.2const: Split IPV6_MTU_DISCOVER from IPPROTO_IPV6(2const)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/IPV6_MTU.2const: Tweak after split

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/{IPPROTO_IPV6,IPV6_MTU}.2const: Split IPV6_MTU from IPPROTO_IPV6(2const)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/IPV6_ADD_MEMBERSHIP.2const: Tweak after split

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/IPV6_DROP_MEMBERSHIP.2const: Add link page

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/{IPPROTO_IPV6,IPV6_ADD_MEMBERSHIP}.2const: Split IPV6_ADD_MEMBERSHIP, IPV6_DROP_MEMBERSHIP from IPPROTO_IPV6(2const)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/IPV6_ADDRFORM.2const: Tweak after split

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/{IPPROTO_IPV6,IPV6_ADDRFORM}.2const: Split IPV6_ADDRFORM from IPPROTO_IPV6(2const)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man7/ipv6.7, man/man2const/IPPROTO_IPV6.2const: Split IPPROTO_IPV6 from ipv6(7)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3/strtol.3: Use _Maxof(3) and _Minof(3) instead of macros from <limits.h>

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/IP_PKTINFO.2const: tfix

Fixes: fea681dafb13 (2004-11-03, 2004-11-03; "Import of man-pages 1.70")
Fixes: 9d1fd1157306 (1999-06-15, 2022-12-19; "man-pages 1.24")
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/: Fix and de-duplicate SO_PEERSEC(2const)

-  SO_PEERSEC is a SOL_SOCKET option, not an IPPROTO_IP one.

-  Its description was duplicated in both ip(7) --moved to
   SO_PEERSEC(2const)-- and unix(7).  De-duplicate the texts.

-  It was listed in unix(7) as AF_UNIX-only, but it also works with
   AF_INET.

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man7/operator.7: Document _Maxof(3) and _Minof(3)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3/_Minof.3: Add link page

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3/_Maxof.3: Add page

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man7/ip.7: Don't say that bind(INADDR_BROADCAST) is the same as bind(INADDR_ANY)

Because it's patently not true: a program like
#define _GNU_SOURCE
#include <netinet/in.h>
#include <netinet/udp.h>
#include <stdbool.h>
#include <stdcountof.h>
#include <stdlib.h>
#include <sys/socket.h>
#define sizeof_a(a)                                           \
(                                                             \
countof(a) * sizeof((a)[0])                           \
)
#define recv_a(sfd, buf, flags)                               \
(                                                             \
recv(sfd, buf, sizeof_a(buf), flags)                  \
)
#define bind_T(sfd, addr, T)                                  \
((                                                            \
_Generic(addr, T *: 0, const T *: 0),                 \
bind(sfd, addr, sizeof(T))                            \
))
#define setsockopt_T(sfd, l, opt, val, T)                     \
((                                                            \
_Generic(val, T *: 0, const T *: 0),                  \
setsockopt(sfd, l, opt, val, sizeof(T))               \
))
static inline int
setsockopt_int(int sfd, int l, int opt, int val)
{
return setsockopt_T(sfd, l, opt, &val, int);
}
int
main(void)
{
int                 sock;
unsigned char       buf[512];
struct sockaddr_in  addr;

sock = socket(AF_INET, SOCK_DGRAM | SOCK_CLOEXEC, IPPROTO_UDP);
setsockopt_int(sock, SOL_SOCKET, SO_REUSEADDR, true);
setsockopt_int(sock, SOL_SOCKET, SO_REUSEPORT, true);
addr = (struct sockaddr_in){
.sin_family = AF_INET,
.sin_port = htons(123),
.sin_addr = {INADDR_ANY}
};
bind_T(sock, &addr, struct sockaddr_in);

recv_a(sock, buf, 0);
exit(EXIT_SUCCESS);
}
will receive an NTP broadcast,
but if you s/INADDR_ANY/INADDR_BROADCAST/ it won't.

Quoth POSIX.1-2024:
11252  The <netinet/in.h> header shall define the following symbolic constant for use as a destination
11253  address in the structures passed to connect( ), sendmsg( ), and sendto( ):
11254  INADDR_BROADCAST   IPv4 broadcast address.
(this is one of two mentions of the symbol,
 the other is a RATIONALE for why no byte ordering is specified).

Linux calls it
/* Address to send to all hosts. */
#define INADDR_BROADCAST ((unsigned long int) 0xffffffff)
and AFAICT never uses it in the receive path
(except in RDS to reject bind(2)).

Fixes: fea681dafb13 (2004-11-03, 2004-11-03; "Import of man-pages 1.70")
Fixes: 3c5f99be9759 (1999-11-28, 2022-12-19; "man-pages 1.28")
Signed-off-by: Ahelenia Ziemiańska <nabijaczleweli@nabijaczleweli.xyz>
Message-ID: <qzlsd5wpn42hdxj43tavdyzhrpocjaddwxgyikiuk2bdzvobya@tarta.nabijaczleweli.xyz>
[alx: some safety improvements to the program in commit message]
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3/sscanf.3: Document exact matching for %c

The glibc manual has always documented this behavior, but the
implementation differed, treating the field width as an upper limit.

Signed-off-by: Florian Weimer <fweimer@redhat.com>
Message-ID: <lhu1pli6tsj.fsf@oldenburg.str.redhat.com>
Reviewed-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2type/in_pktinfo.2type: Tweak after split

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/IP_PKTINFO.2const, man/man2type/in_pktinfo.2type: Split struct in_pktinfo from IP_PKTINFO(2const)

Suggested-by: Jakub Głogowski <not@dzwdz.net>
Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/: Make sashimi of ip(7)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man7/ip.7: Refer to sockaddr_in(3type)

And improve formatting.

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3type/sockaddr*.3type: Make sashimi of sockaddr(3type)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3type/sockaddr_un.3type: Tweak after split

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3type/sockaddr{,_un}.3type: Split struct sockaddr_un from sockaddr(3type)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3type/sockaddr{,_in,_in6}.3type: Split struct sockaddr_in6 from sockaddr_in(3type)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/{IPPROTO_IP,IP_*,SO_*}.2const: Make sashimi of IPPROTO_IP(2const)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3type/sockaddr_in.3type: Tweak after split

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man3type/sockaddr{,_in,_in6}.3type: Split IP types from sockaddr(3type)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/IPPROTO_IP.2const: Tweak after making sashimi of this page

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/SO_PEERSEC.2const: Tweak after split

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/{IPPROTO_IP,SO_PEERSEC}.2const: Split SO_PEERSEC from IPPROTO_IP(2const)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/IP_UNBLOCK_SOURCE.2const: Tweak after split

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/{IPPROTO_IP,IP_UNBLOCK_SOURCE}.2const: Split IP_UNBLOCK_SOURCE from IPPROTO_IP(2const)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/IP_TTL.2const: Tweak after split

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/{IPPROTO_IP,IP_TTL}.2const: Split IP_TTL from IPPROTO_IP(2const)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/IP_TRANSPARENT.2const: Tweak after split

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/{IPPROTO_IP,IP_TRANSPARENT}.2const: Split IP_TRANSPARENT from IPPROTO_IP(2const)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/IP_TOS.2const: Tweak after split

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/{IPPROTO_IP,IP_TOS}.2const: Split IP_TOS from IPPROTO_IP(2const)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/IP_ROUTER_ALERT.2const: Tweak after split

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/{IPPROTO_IP,IP_ROUTER_ALERT}.2const: Split IP_ROUTER_ALERT from IPPROTO_IP(2const)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/IP_RETOPTS.2const: Tweak after split

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/{IPPROTO_IP,IP_RETOPTS}.2const: Split IP_RETOPTS from IPPROTO_IP(2const)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/IP_RECVTTL.2const: Tweak after split

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/{IPPROTO_IP,IP_RECVTTL}.2const: Split IP_RECVTTL from IPPROTO_IP(2const)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/IP_RECVTOS.2const: Tweak after split

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/{IPPROTO_IP,IP_RECVTOS}.2const: Split IP_RECVTOS from IPPROTO_IP(2const)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/IP_RECVORIGDSTADDR.2const: Tweak after split

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/{IPPROTO_IP,IP_RECVORIGDSTADDR}.2const: Split IP_RECVORIGDSTADDR from IPPROTO_IP(2const)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/IP_RECVOPTS.2const: Tweak after split

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/{IPPROTO_IP,IP_RECVOPTS}.2const: Split IP_RECVOPTS from IPPROTO_IP(2const)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/IP_RECVERR.2const: Tweak after split

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/{IPPROTO_IP,IP_RECVERR}.2const: Split IP_RECVERR from IPPROTO_IP(2const)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/IP_PKTINFO.2const: Tweak after split

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/{IPPROTO_IP,IP_PKTINFO}.2const: Split IP_PKTINFO from IPPROTO_IP(2const)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/IP_PASSSEC.2const: Tweak after split

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/{IPPROTO_IP,IP_PASSSEC}.2const: Split IP_PASSSEC from IPPROTO_IP(2const)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/IP_OPTIONS.2const: Tweak after split

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/{IPPROTO_IP,IP_OPTIONS}.2const: Split IP_OPTIONS from IPPROTO_IP(2const)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/IP_NODEFRAG.2const: Tweak after split

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/{IPPROTO_IP,IP_NODEFRAG}.2const: Split IP_NODEFRAG from IPPROTO_IP(2const)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/IP_MULTICAST_TTL.2const: Tweak after split

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/{IPPROTO_IP,IP_MULTICAST_TTL}.2const: Split IP_MULTICAST_TTL from IPPROTO_IP(2const)

Signed-off-by: Alejandro Colomar <alx@kernel.org>

man/man2const/IP_MULTICAST_LOOP.2const: Tweak after split

Signed-off-by: Alejandro Colomar <alx@kernel.org>