Merge branch 'master' into for-next

[karo-tx-linux.git] / Documentation / printk-formats.txt

diff --git a/Documentation/printk-formats.txt b/Documentation/printk-formats.txt
index 1525e91f94d8d7c2d34d0fb1acd939f787a20489..22b4bc51fb4f18a08d06e93d0a8bce8d4b9bf0e4 100644 (file)
--- a/Documentation/printk-formats.txt
+++ b/Documentation/printk-formats.txt
@@ -121,6 +121,38 @@ IPv6 addresses:
        print a compressed IPv6 address as described by
        http://tools.ietf.org/html/rfc5952
 
+IPv4/IPv6 addresses (generic, with port, flowinfo, scope):
+
+       %pIS    1.2.3.4         or 0001:0002:0003:0004:0005:0006:0007:0008
+       %piS    001.002.003.004 or 00010002000300040005000600070008
+       %pISc   1.2.3.4         or 1:2:3:4:5:6:7:8
+       %pISpc  1.2.3.4:12345   or [1:2:3:4:5:6:7:8]:12345
+       %p[Ii]S[pfschnbl]
+
+       For printing an IP address without the need to distinguish whether it's
+       of type AF_INET or AF_INET6, a pointer to a valid 'struct sockaddr',
+       specified through 'IS' or 'iS', can be passed to this format specifier.
+
+       The additional 'p', 'f', and 's' specifiers are used to specify port
+       (IPv4, IPv6), flowinfo (IPv6) and scope (IPv6). Ports have a ':' prefix,
+       flowinfo a '/' and scope a '%', each followed by the actual value.
+
+       In case of an IPv6 address the compressed IPv6 address as described by
+       http://tools.ietf.org/html/rfc5952 is being used if the additional
+       specifier 'c' is given. The IPv6 address is surrounded by '[', ']' in
+       case of additional specifiers 'p', 'f' or 's' as suggested by
+       https://tools.ietf.org/html/draft-ietf-6man-text-addr-representation-07
+
+       In case of IPv4 addresses, the additional 'h', 'n', 'b', and 'l'
+       specifiers can be used as well and are ignored in case of an IPv6
+       address.
+
+       Further examples:
+
+       %pISfc          1.2.3.4         or [1:2:3:4:5:6:7:8]/123456789
+       %pISsc          1.2.3.4         or [1:2:3:4:5:6:7:8]%1234567890
+       %pISpfc         1.2.3.4:12345   or [1:2:3:4:5:6:7:8]:12345/123456789
+
 UUID/GUID addresses:
 
        %pUb    00010203-0405-0607-0809-0a0b0c0d0e0f