Return-Path: <linux-kernel-owner@vger.kernel.org>
Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand
	id S1751956Ab1BFAhJ (ORCPT <rfc822;w@1wt.eu>);
	Sat, 5 Feb 2011 19:37:09 -0500
Received: from mail.perches.com ([173.55.12.10]:3611 "EHLO mail.perches.com"
	rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP
	id S1751200Ab1BFAhI (ORCPT <rfc822;linux-kernel@vger.kernel.org>);
	Sat, 5 Feb 2011 19:37:08 -0500
Subject: Re: [PATCH] printk-formats.txt documentation update
From: Joe Perches <joe@perches.com>
To: Andrew Murray <amurray@mpcdata.com>
Cc: linux-embedded@vger.kernel.org,
        linux kernel <linux-kernel@vger.kernel.org>,
        Jiri Kosina <trivial@kernel.org>
In-Reply-To: <AANLkTikj+FU8OF_-KFr2hmTSWqTHMK5JnrnTVyn-XtxQ@mail.gmail.com>
References: <AANLkTikj+FU8OF_-KFr2hmTSWqTHMK5JnrnTVyn-XtxQ@mail.gmail.com>
Content-Type: text/plain; charset="UTF-8"
Date: Sat, 05 Feb 2011 16:37:06 -0800
Message-ID: <1296952626.4133.77.camel@Joe-Laptop>
Mime-Version: 1.0
X-Mailer: Evolution 2.30.3 
Content-Transfer-Encoding: 7bit
Sender: linux-kernel-owner@vger.kernel.org
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org
Content-Length: 2556
Lines: 72

On Sun, 2011-02-06 at 00:15 +0000, Andrew Murray wrote:
> From: Andrew Murray <amurray@mpc-data.co.uk>
> This patch updates the incomplete documentation concerning the printk
> extended format specifiers.
> Signed-off-by: Andrew Murray <amurray@mpc-data.co.uk>
> ---
> diff --git 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:

I think it'd be better if each extension were individually described
with an example output.

> +
> +	General:
> +
> +	%pF	function pointer with offset, e.g. module_start
> +	%pf	function pointer without offset, e.g. module_start+0x0/0x62 [hello]

with/without inversion?

> +	%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

spelling: separated

> +	%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

Maybe a simple 2 line table without the e.g.:

	%p<extension1>	sample output1
			description1
	%p<extension2>	sample output2
			description2
	

--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/