diff options
| author | Alejandro Colomar <alx.manpages@gmail.com> | 2022-09-05 23:03:38 +0200 |
|---|---|---|
| committer | Alejandro Colomar <alx.manpages@gmail.com> | 2022-09-05 23:03:47 +0200 |
| commit | 70ac1c4785fc1e158ab2349a962dba2526bf4fbc (patch) | |
| tree | bff270e2496dd284bccfc1271b43946f5d225224 /man3/inet_pton.3 | |
| parent | 5423a6f86b2b920a5f3e8cf8d759b513050f2d33 (diff) | |
| download | man-pages-70ac1c4785fc1e158ab2349a962dba2526bf4fbc.tar.gz | |
src.mk, All pages: Move man* to man/
The root of the repository is becoming a bit overpopulated and
unorganized, due to the recent addition of more mandirs, and more
informative and configuration files too. Let's create a specific
mandir <man/> that contains the mandirs <man[1-8]*>.
Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com>
Diffstat (limited to 'man3/inet_pton.3')
| -rw-r--r-- | man3/inet_pton.3 | 221 |
1 files changed, 0 insertions, 221 deletions
diff --git a/man3/inet_pton.3 b/man3/inet_pton.3 deleted file mode 100644 index 807c4ea030..0000000000 --- a/man3/inet_pton.3 +++ /dev/null @@ -1,221 +0,0 @@ -.\" Copyright 2000 Sam Varshavchik <mrsam@courier-mta.com> -.\" and Copyright (c) 2008 Michael Kerrisk <mtk.manpages@gmail.com> -.\" -.\" SPDX-License-Identifier: Linux-man-pages-copyleft -.\" -.\" References: RFC 2553 -.TH INET_PTON 3 2021-03-22 "Linux man-pages (unreleased)" -.SH NAME -inet_pton \- convert IPv4 and IPv6 addresses from text to binary form -.SH LIBRARY -Standard C library -.RI ( libc ", " \-lc ) -.SH SYNOPSIS -.nf -.B #include <arpa/inet.h> -.PP -.BI "int inet_pton(int " af ", const char *restrict " src \ -", void *restrict " dst ); -.fi -.SH DESCRIPTION -This function converts the character string -.I src -into a network address structure in the -.I af -address family, then -copies -the network address structure to -.IR dst . -The -.I af -argument must be either -.B AF_INET -or -.BR AF_INET6 . -.I dst -is written in network byte order. -.PP -The following address families are currently supported: -.TP -.B AF_INET -.I src -points to a character string containing an IPv4 network address in -dotted-decimal format, "\fIddd.ddd.ddd.ddd\fP", where -.I ddd -is a decimal number of up to three digits in the range 0 to 255. -The address is converted to a -.I struct in_addr -and copied to -.IR dst , -which must be -.I sizeof(struct in_addr) -(4) bytes (32 bits) long. -.TP -.B AF_INET6 -.I src -points to a character string containing an IPv6 network address. -The address is converted to a -.I struct in6_addr -and copied to -.IR dst , -which must be -.I sizeof(struct in6_addr) -(16) bytes (128 bits) long. -The allowed formats for IPv6 addresses follow these rules: -.RS -.IP 1. 3 -The preferred format is -.IR x:x:x:x:x:x:x:x . -This form consists of eight hexadecimal numbers, -each of which expresses a 16-bit value (i.e., each -.I x -can be up to 4 hex digits). -.IP 2. -A series of contiguous zero values in the preferred format -can be abbreviated to -.IR :: . -Only one instance of -.I :: -can occur in an address. -For example, the loopback address -.I 0:0:0:0:0:0:0:1 -can be abbreviated as -.IR ::1 . -The wildcard address, consisting of all zeros, can be written as -.IR :: . -.IP 3. -An alternate format is useful for expressing IPv4-mapped IPv6 addresses. -This form is written as -.IR x:x:x:x:x:x:d.d.d.d , -where the six leading -.IR x s -are hexadecimal values that define the six most-significant -16-bit pieces of the address (i.e., 96 bits), and the -.IR d s -express a value in dotted-decimal notation that -defines the least significant 32 bits of the address. -An example of such an address is -.IR ::FFFF:204.152.189.116 . -.RE -.IP -See RFC 2373 for further details on the representation of IPv6 addresses. -.SH RETURN VALUE -.BR inet_pton () -returns 1 on success (network address was successfully converted). -0 is returned if -.I src -does not contain a character string representing a valid network -address in the specified address family. -If -.I af -does not contain a valid address family, \-1 is returned and -.I errno -is set to -.BR EAFNOSUPPORT . -.SH ATTRIBUTES -For an explanation of the terms used in this section, see -.BR attributes (7). -.ad l -.nh -.TS -allbox; -lbx lb lb -l l l. -Interface Attribute Value -T{ -.BR inet_pton () -T} Thread safety MT-Safe locale -.TE -.hy -.ad -.sp 1 -.SH STANDARDS -POSIX.1-2001, POSIX.1-2008. -.SH NOTES -Unlike -.BR inet_aton (3) -and -.BR inet_addr (3), -.BR inet_pton () -supports IPv6 addresses. -On the other hand, -.BR inet_pton () -accepts only IPv4 addresses in dotted-decimal notation, whereas -.BR inet_aton (3) -and -.BR inet_addr (3) -allow the more general numbers-and-dots notation (hexadecimal -and octal number formats, and formats that don't require all -four bytes to be explicitly written). -For an interface that handles both IPv6 addresses, and IPv4 -addresses in numbers-and-dots notation, see -.BR getaddrinfo (3). -.SH BUGS -.B AF_INET6 -does not recognize IPv4 addresses. -An explicit IPv4-mapped IPv6 address must be supplied in -.I src -instead. -.SH EXAMPLES -The program below demonstrates the use of -.BR inet_pton () -and -.BR inet_ntop (3). -Here are some example runs: -.PP -.in +4n -.EX -.RB "$" " ./a.out i6 0:0:0:0:0:0:0:0" -:: -.RB "$" " ./a.out i6 1:0:0:0:0:0:0:8" -1::8 -.RB "$" " ./a.out i6 0:0:0:0:0:FFFF:204.152.189.116" -::ffff:204.152.189.116 -.EE -.in -.SS Program source -\& -.EX -#include <arpa/inet.h> -#include <stdio.h> -#include <stdlib.h> -#include <string.h> - -int -main(int argc, char *argv[]) -{ - unsigned char buf[sizeof(struct in6_addr)]; - int domain, s; - char str[INET6_ADDRSTRLEN]; - - if (argc != 3) { - fprintf(stderr, "Usage: %s {i4|i6|<num>} string\en", argv[0]); - exit(EXIT_FAILURE); - } - - domain = (strcmp(argv[1], "i4") == 0) ? AF_INET : - (strcmp(argv[1], "i6") == 0) ? AF_INET6 : atoi(argv[1]); - - s = inet_pton(domain, argv[2], buf); - if (s <= 0) { - if (s == 0) - fprintf(stderr, "Not in presentation format"); - else - perror("inet_pton"); - exit(EXIT_FAILURE); - } - - if (inet_ntop(domain, buf, str, INET6_ADDRSTRLEN) == NULL) { - perror("inet_ntop"); - exit(EXIT_FAILURE); - } - - printf("%s\en", str); - - exit(EXIT_SUCCESS); -} -.EE -.SH SEE ALSO -.BR getaddrinfo (3), -.BR inet (3), -.BR inet_ntop (3) |