Rasmus Villemoes 57f5677e53 printf: add support for printing symbolic error names ... It has been suggested several times to extend vsnprintf() to be able to convert the numeric value of ENOSPC to print "ENOSPC". This implements that as a %p extension: With %pe, one can do if (IS_ERR(foo)) { pr_err("Sorry, can't do that: %pe\n", foo); return PTR_ERR(foo); } instead of what is seen in quite a few places in the kernel: if (IS_ERR(foo)) { pr_err("Sorry, can't do that: %ld\n", PTR_ERR(foo)); return PTR_ERR(foo); } If the value passed to %pe is an ERR_PTR, but the library function errname() added here doesn't know about the value, the value is simply printed in decimal. If the value passed to %pe is not an ERR_PTR, we treat it as an ordinary %p and thus print the hashed value (passing non-ERR_PTR values to %pe indicates a bug in the caller, but we can't do much about that). With my embedded hat on, and because it's not very invasive to do, I've made it possible to remove this. The errname() function and associated lookup tables take up about 3K. For most, that's probably quite acceptable and a price worth paying for more readable dmesg (once this starts getting used), while for those that disable printk() it's of very little use - I don't see a procfs/sysfs/seq_printf() file reasonably making use of this - and they clearly want to squeeze vmlinux as much as possible. Hence the default y if PRINTK. The symbols to include have been found by massaging the output of find arch include -iname 'errno*.h' | xargs grep -E 'define\s*E' In the cases where some common aliasing exists (e.g. EAGAIN=EWOULDBLOCK on all platforms, EDEADLOCK=EDEADLK on most), I've moved the more popular one (in terms of 'git grep -w Efoo | wc) to the bottom so that one takes precedence. Link: http://lkml.kernel.org/r/20191015190706.15989-1-linux@rasmusvillemoes.dk To: "Jonathan Corbet" <corbet@lwn.net> To: linux-kernel@vger.kernel.org Cc: "Andy Shevchenko" <andy.shevchenko@gmail.com> Cc: "Andrew Morton" <akpm@linux-foundation.org> Cc: "Joe Perches" <joe@perches.com> Cc: linux-doc@vger.kernel.org Signed-off-by: Rasmus Villemoes <linux@rasmusvillemoes.dk> Acked-by: Uwe Kleine-König <uwe@kleine-koenig.org> Reviewed-by: Petr Mladek <pmladek@suse.com> [andy.shevchenko@gmail.com: use abs()] Acked-by: Andy Shevchenko <andy.shevchenko@gmail.com> Signed-off-by: Petr Mladek <pmladek@suse.com>		2019-10-17 16:23:25 +02:00
..
ABI	ABI: Update dev-kmsg documentation to match current kernel behaviour	2019-09-06 16:26:36 +02:00
accelerators
accounting	psi: introduce psi monitor	2019-05-14 19:52:48 -07:00
acpi/dsd	LED updates for 5.2-rc1.	2019-05-07 18:02:51 -07:00
admin-guide	Merge branch 'for-5.3' of git://git.kernel.org/pub/scm/linux/kernel/git/tj/cgroup	2019-07-08 21:35:12 -07:00
aoe
arm	ARM: 8833/1: Ensure that NEON code always compiles with Clang	2019-02-12 15:20:09 +00:00
arm64	arm64 updates for 5.3:	2019-07-08 09:54:55 -07:00
auxdisplay
backlight
block	for-5.3/block-20190708	2019-07-09 10:45:06 -07:00
blockdev	zram: idle writeback fixes and cleanup	2019-01-08 17:15:10 -08:00
bpf	bpf: btf: fix the brackets of BTF_INT_OFFSET()	2019-05-14 10:05:18 +02:00
bus-devices
cdrom
cgroup-v1	for-5.3/block-20190708	2019-07-09 10:45:06 -07:00
cma
connector
console
core-api	printf: add support for printing symbolic error names	2019-10-17 16:23:25 +02:00
cpu-freq
crypto	crypto: doc - Fix formatting of new crypto engine content	2019-07-03 22:13:12 +08:00
dev-tools	gcov: docs: add a note on GCC vs Clang differences	2019-05-14 19:52:51 -07:00
device-mapper	dm integrity: add a bitmap mode	2019-05-08 13:41:58 -04:00
devicetree	Power management updates for 5.3-rc1	2019-07-09 10:05:22 -07:00
doc-guide	docs: doc-guide: remove the extension from .rst files	2019-04-19 12:46:27 -06:00
driver-api	Bulk GPIO changes for the v5.3 kernel cycle:	2019-07-09 09:07:00 -07:00
driver-model	i2c: core: add device-managed version of i2c_new_dummy	2019-05-17 19:29:40 +02:00
early-userspace
EDID
fault-injection	Documentation: nvme: add an example for nvme fault injection	2019-06-21 11:15:50 +02:00
fb	docs: fb: Add TER16x32 to the available font names	2019-06-19 19:21:48 +02:00
features	Merge branch 'parisc-5.2-1' of git://git.kernel.org/pub/scm/linux/kernel/git/deller/parisc-linux	2019-05-07 19:34:17 -07:00
filesystems	Merge branch 'for-5.3' of git://git.kernel.org/pub/scm/linux/kernel/git/tj/cgroup	2019-07-08 21:35:12 -07:00
firmware_class
firmware-guide	docs: extcon: convert it to ReST and move to ACPI dir	2019-07-03 13:00:26 +02:00
fpga
gpio	docs: gpio: convert docs to ReST and rename to *.rst	2019-04-23 23:30:07 +02:00
gpu	drm: add drm_format_helper.c to kerneldoc	2019-04-17 09:39:22 +02:00
hid	HID: doc: fix wrong data structure reference for UHID_OUTPUT	2018-12-18 14:55:22 +01:00
hwmon	hwmon: (lm75) Add support for TMP75B	2019-05-03 13:16:18 -07:00
i2c	i2c-piix4: Add Hygon Dhyana SMBus support	2019-05-03 16:47:54 +02:00
ia64
ide
iio
infiniband	Documentation/infiniband: update from locked to pinned_vm	2019-02-07 12:56:23 -07:00
input	doc: Change LXR references to elixir.bootlin.com	2019-02-01 16:05:03 -07:00
interconnect	interconnect: Add generic on-chip interconnect API	2019-01-22 13:37:25 +01:00
ioctl	seccomp: add a return code to trap to userspace	2018-12-11 16:28:41 -08:00
isdn
kbuild	kbuild: drop support for cc-ldoption	2019-05-21 00:02:59 +09:00
kdump	Documentation: kdump: fix minor typo	2019-05-21 09:31:28 -06:00
kernel-hacking
laptops	docs: leds: convert to ReST	2019-06-28 20:57:31 +02:00
leds	docs: leds: convert to ReST	2019-06-28 20:57:31 +02:00
lightnvm
livepatch	docs/livepatch: Unify style of livepatch documentation in the ReST format	2019-05-07 16:06:28 -06:00
locking	locking/lockdep: Add explanation to lock usage rules in lockdep design doc	2019-06-03 11:55:48 +02:00
m68k
maintainer
md
media	media: doc-rst: Fix typos	2019-06-27 07:35:47 -04:00
memory-devices
mic
mips
misc-devices	Documentation: add ibmvmc to toctree(index) and fix warnings	2019-01-14 08:37:17 -07:00
mmc
mtd
namespaces
netlabel
networking	tcp: add tcp_min_snd_mss sysctl	2019-06-15 18:47:31 -07:00
nfc
nios2
nvdimm	libnvdimm/security: Add documentation for nvdimm security support	2018-12-21 12:44:41 -08:00
nvmem
openrisc
parisc
PCI
pcmcia
perf
phy
platform
power	PM/EM: Document the Energy Model framework	2019-01-27 12:29:37 +01:00
powerpc	Documentation: powerpc: Expand the DAWR acronym	2019-05-03 02:54:58 +10:00
pps
process	kbuild: Raise the minimum required binutils version to 2.21	2019-06-22 11:38:51 +02:00
pti
ptp
rapidio
RCU	Merge branches 'consolidate.2019.05.28a', 'doc.2019.05.28a', 'fixes.2019.06.13a', 'srcu.2019.05.28a', 'sync.2019.05.28a' and 'torture.2019.05.28a' into HEAD	2019-06-19 09:21:46 -07:00
riscv
s390	docs: s390: s390dbf: typos and formatting, update crash command	2019-07-05 13:42:24 +02:00
scheduler	Merge branch 'for-5.3' of git://git.kernel.org/pub/scm/linux/kernel/git/tj/cgroup	2019-07-08 21:35:12 -07:00
scsi	scsi: ufs-bsg: Allow reading descriptors	2019-02-27 09:00:02 -05:00
security	Merge branch 'next-integrity' of git://git.kernel.org/pub/scm/linux/kernel/git/zohar/linux-integrity	2019-07-08 20:28:59 -07:00
serial	docs: serial: convert docs to ReST and rename to *.rst	2019-04-25 11:37:42 +02:00
sh	sh: remove board_time_init() callback	2018-12-18 16:13:04 +01:00
sound	ALSA: doc: my_chip has no element ioport	2019-04-03 11:55:47 +02:00
sparc	docs: sparc: convert to ReST	2019-05-08 17:13:35 -07:00
sphinx	doc: Cope with the deprecation of AutoReporter	2019-05-23 09:23:11 -06:00
sphinx-static
spi	spi-summary: document set_cs_timing	2019-04-08 14:13:43 +07:00
sysctl	s390/sclp: remove call home support	2019-06-19 17:54:27 +02:00
target	scsi: target/core: Remove the write_pending_status() callback function	2019-02-04 21:23:59 -05:00
thermal	docs: hwmon: Add an index file and rename docs to *.rst	2019-04-17 10:37:23 -07:00
timers	Docs: Correct /proc/stat path	2019-02-22 08:50:17 -07:00
trace	The major changes in this tracing update includes:	2019-05-15 16:05:47 -07:00
translations	doc: Remove ".vnet" from paulmck email addresses	2019-05-28 09:02:57 -07:00
usb	USB: rio500: update Documentation	2019-05-21 10:11:19 +02:00
userspace-api	Documentation: seccomp: unify list indentation	2019-03-18 12:00:28 -06:00
virtual	KVM: x86: Modify struct kvm_nested_state to have explicit fields for data	2019-06-19 16:11:52 +02:00
vm	Merge branch 'for-5.3' of git://git.kernel.org/pub/scm/linux/kernel/git/tj/cgroup	2019-07-08 21:35:12 -07:00
w1
watchdog	Documentation/watchdog: Add documentation mlx-wdt driver	2019-03-02 15:28:20 +01:00
wimax
x86	Merge branch 'for-5.3' of git://git.kernel.org/pub/scm/linux/kernel/git/tj/cgroup	2019-07-08 21:35:12 -07:00
xilinx	drivers: Defer probe if firmware is not ready	2019-03-18 13:45:27 +01:00
xtensa	xtensa: document boot parameter passing	2019-02-03 18:06:19 -08:00
.gitignore
atomic_bitops.txt	docs: atomic_bitops.txt: add a title for this document	2019-04-11 12:37:02 -06:00
atomic_t.txt	Merge branch 'locking-core-for-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/tip/tip	2019-07-08 16:12:03 -07:00
bt8xxgpio.txt
btmrvl.txt
bus-virt-phys-mapping.txt
Changes
clearing-warn-once.txt	A reasonably busy cycle for docs, including:	2019-05-08 12:42:50 -07:00
CodingStyle
conf.py	docs: Fix conf.py for Sphinx 2.0	2019-05-24 09:09:32 -06:00
cpu-load.txt
cputopology.txt	topology: Create core_cpus and die_cpus sysfs attributes	2019-05-23 10:08:34 +02:00
crc32.txt
dcdbas.txt
debugging-modules.txt
debugging-via-ohci1394.txt
dell_rbu.txt
digsig.txt
DMA-API-HOWTO.txt	DMA mapping updates for 5.2	2019-05-09 08:40:55 -07:00
DMA-API.txt	virtio: fixes, cleanups	2019-03-10 12:47:57 -07:00
DMA-attributes.txt
DMA-ISA-LPC.txt	Documentation/DMA-ISA-LPC: fix an incorrect reference	2019-02-11 08:23:07 -07:00
docutils.conf
dontdiff	A reasonably busy cycle for docs, including:	2019-05-08 12:42:50 -07:00
efi-stub.txt
eisa.txt
futex-requeue-pi.txt
gcc-plugins.txt
highuid.txt
hw_random.txt
hwspinlock.txt
index.rst	Merge branch 'x86-mds-for-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/tip/tip	2019-05-14 07:57:29 -07:00
intel_txt.txt
Intel-IOMMU.txt
io_ordering.txt
io-mapping.txt
iostats.txt
IPMI.txt
IRQ-affinity.txt
IRQ-domain.txt
IRQ.txt
irqflags-tracing.txt
isa.txt
isapnp.txt
kernel-per-CPU-kthreads.txt
kobject.txt
kprobes.txt	Merge branch 'parisc-5.2-1' of git://git.kernel.org/pub/scm/linux/kernel/git/deller/parisc-linux	2019-05-07 19:34:17 -07:00
kref.txt
ldm.txt
lockup-watchdogs.txt
logo.gif
logo.txt
lsm.txt
lzo.txt	lib/lzo: fix bugs for very short or empty input	2019-04-05 16:02:30 -10:00
mailbox.txt
Makefile	docs: Makefile: use latexmk if available	2019-04-01 14:33:42 -06:00
memory-barriers.txt	doc: Remove ".vnet" from paulmck email addresses	2019-05-28 09:02:57 -07:00
men-chameleon-bus.txt
nommu-mmap.txt
ntb.txt	docs: ntb.txt: add blank lines to clean up some Sphinx warnings	2019-04-11 12:37:03 -06:00
numastat.txt
packing.txt	lib: Add support for generic packing operations	2019-05-03 10:49:17 -04:00
padata.txt
parport-lowlevel.txt
percpu-rw-semaphore.txt
phy.txt
pi-futex.txt
pnp.txt
preempt-locking.txt	x86/fpu: Remove fpu__restore()	2019-04-09 19:27:42 +02:00
pwm.txt	pwm: Add power management descriptions	2019-06-26 11:39:11 +02:00
rbtree.txt
remoteproc.txt
rfkill.txt
robust-futex-ABI.txt
robust-futexes.txt	futex: Update comments and docs about return values of arch futex code	2019-04-26 13:57:55 +01:00
rpmsg.txt
rtc.txt	Documentation: rtc: Correct location of rtctest.c	2019-03-25 10:34:55 -06:00
SAK.txt
sgi-ioc4.txt
siphash.txt
SM501.txt
smsc_ece1099.txt
speculation.txt	docs: speculation.txt: mark example blocks as such	2019-04-11 12:37:03 -06:00
static-keys.txt	static_keys.txt: Fix trivial spelling mistake	2019-02-06 16:44:16 -07:00
SubmittingPatches
svga.txt
switchtec.txt
sync_file.txt
tee.txt
this_cpu_ops.txt
unaligned-memory-access.txt	docs: unaligned-memory-access.txt: use a lowercase title	2019-04-11 12:37:03 -06:00
vfio-mediated-device.txt
vfio.txt
video-output.txt	docs: video-output.txt: convert it to ReST format	2019-04-11 12:37:03 -06:00
xillybus.txt
xz.txt
zorro.txt