lists.openwall.net   lists  /  announce  owl-users  owl-dev  john-users  john-dev  passwdqc-users  yescrypt  popa3d-users  /  oss-security  kernel-hardening  musl  sabotage  tlsify  passwords  /  crypt-dev  xvendor  /  Bugtraq  Full-Disclosure  linux-kernel  linux-netdev  linux-ext4  linux-hardening  linux-cve-announce  PHC 
Open Source and information security mailing list archives
 
Hash Suite: Windows password security audit tool. GUI, reports in PDF.
[<prev] [next>] [thread-next>] [day] [month] [year] [list]
Message-ID: <AANLkTikj+FU8OF_-KFr2hmTSWqTHMK5JnrnTVyn-XtxQ@mail.gmail.com>
Date:	Sun, 6 Feb 2011 00:15:58 +0000
From:	Andrew Murray <amurray@...data.com>
To:	linux-embedded@...r.kernel.org
Cc:	linux kernel <linux-kernel@...r.kernel.org>, trivial@...nel.org
Subject: [PATCH] printk-formats.txt documentation update

From: Andrew Murray <amurray@...-data.co.uk>

This patch updates the incomplete documentation concerning the printk
extended format specifiers.

Signed-off-by: Andrew Murray <amurray@...-data.co.uk>
---
diff --git a/Documentation/printk-formats.txt b/Documentation/printk-formats.txt
index 1b5a5dd..df14336 100644
--- a/Documentation/printk-formats.txt
+++ b/Documentation/printk-formats.txt
@@ -9,7 +9,42 @@ If variable is of Type,		use printk format specifier:
 		size_t			%zu or %zx
 		ssize_t			%zd or %zx

-Raw pointer value SHOULD be printed with %p.
+Raw pointer value SHOULD be printed with %p. The kernel supports
+the following extended format specifiers for pointer types:
+
+	General:
+
+	%pF	function pointer with offset, e.g. module_start
+	%pf	function pointer without offset, e.g. module_start+0x0/0x62 [hello]
+	%pS	text symbol with offset	
+	%ps	text symbol without offset
+	%pR	struct resource with decoded flags, e.g. [mem 0x0-0x1f 64 bit pref]
+	%pr	struct resource with raw flags, e.g. [mem 0x0-0x1f flags 0x201]
+
+	MAC/FDDI addresses:
+	
+	%pM	colon-seperated 6-byte MAC address in hex notation, e.g. 00:01:02:03:04:05
+	%pm	non-colon-seperated 6-byte MAC address is hex notation, e.g. 000102030405
+	%pMF	6-byte dash-separated FDDI hex notation
+
+	IPv4 addresses:
+
+	%pI4	IPv4 dot-seperated decimal without leading 0's, e.g. 1.2.3.4
+	%pi4	IPv4 dot-seperated decimal with leading 0's, 001.002.003.004
+	%p[Ii]4[hl] IPv4 dot-seperated decimal with/without leading 0's for
+		host (h), little (l) or network/big (default) endian order
+
+	IPv6 addresses:
+	%pI6	IPv6 colon-seperated network-order 16 bit hex with leading 0's,
+		e.g. 0001:0203:...:0708
+	%pi6	IPv6 non-colon-seperated network-order 16 bit hex with leading 0's,
+		e.g. 000102...0f
+	%pI6c	IPv6 address as described by
+		http://tools.ietf.org/html/draft-ietf-6man-text-addr-representation-00,
+		e.g. 1::708
+
+	%pU[bBlL] 16 byte UUID/GUID in big or little endian using lower or upper case
+

 u64 SHOULD be printed with %llu/%llx, (unsigned long long):
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@...r.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/

Powered by blists - more mailing lists

Powered by Openwall GNU/*/Linux Powered by OpenVZ