Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752997AbcLMDIg (ORCPT ); Mon, 12 Dec 2016 22:08:36 -0500 Received: from mail.kernel.org ([198.145.29.136]:32912 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751569AbcLMDIf (ORCPT ); Mon, 12 Dec 2016 22:08:35 -0500 From: "Luis R. Rodriguez" To: gregkh@linuxfoundation.org, ming.lei@canonical.com Cc: daniel.wagner@bmw-carit.de, teg@jklm.no, mchehab@osg.samsung.com, zajec5@gmail.com, linux-kernel@vger.kernel.org, markivx@codeaurora.org, stephen.boyd@linaro.org, broonie@kernel.org, zohar@linux.vnet.ibm.com, tiwai@suse.de, johannes@sipsolutions.net, chunkeey@googlemail.com, hauke@hauke-m.de, jwboyer@fedoraproject.org, dmitry.torokhov@gmail.com, dwmw2@infradead.org, jslaby@suse.com, torvalds@linux-foundation.org, luto@amacapital.net, fengguang.wu@intel.com, rpurdie@rpsys.net, j.anaszewski@samsung.com, Abhay_Salunke@dell.com, Julia.Lawall@lip6.fr, Gilles.Muller@lip6.fr, nicolas.palix@imag.fr, dhowells@redhat.com, bjorn.andersson@linaro.org, arend.vanspriel@broadcom.com, kvalo@codeaurora.org, "Luis R. Rodriguez" Subject: [PATCH 0/5] firmware: doc revamp Date: Mon, 12 Dec 2016 19:08:23 -0800 Message-Id: <20161213030828.17820-1-mcgrof@kernel.org> X-Mailer: git-send-email 2.10.2 Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 3286 Lines: 60 Greg, here's a few simple changes for documentation revamp and a few simple fixes for the firmware test script. I'm pretty sure this is too late for the next release so I am happy with this getting queued in until the merge window closes, posting now to iron out kinks once the merge window closes. I'll soon also post the extensible firmware API as per feedback, much of which was just name change preferences and also a huge clarification on roadmap on fallback mechanisms. The documentation should help iron out tons of kinks I think folks have on this front, but more on all this later once those patches get posted. You may notice I've dropped the SmPL patches which complain on use of the API on init and probe -- although valid the context was off given the only valid use case was if you don't use initramfs, and that's a corner case. Fortunatley Daniel Wagner and Tom Gundersen have come up with some ideas that should help correct these issues, so I've dropped that grammar patch. Luis R. Rodriguez (5): selftests: firmware: only modprobe if driver is missing selftests: firmware: send expected errors to /dev/null firmware: revamp firmware documentation firmware: add SmPL report for custom fallback mechanism firmware: add DECLARE_FW_CUSTOM_FALLBACK() annotation Documentation/driver-api/firmware/built-in-fw.rst | 36 ++++ Documentation/driver-api/firmware/core.rst | 16 ++ .../driver-api/firmware/direct-fs-lookup.rst | 30 +++ .../driver-api/firmware/fallback-mechanisms.rst | 215 +++++++++++++++++++++ .../driver-api/firmware/firmware_cache.rst | 51 +++++ .../driver-api/firmware/fw_search_path.rst | 26 +++ Documentation/driver-api/firmware/index.rst | 16 ++ Documentation/driver-api/firmware/introduction.rst | 27 +++ Documentation/driver-api/firmware/lookup-order.rst | 18 ++ .../driver-api/firmware/request_firmware.rst | 56 ++++++ Documentation/driver-api/index.rst | 1 + Documentation/firmware_class/README | 128 ------------ drivers/firmware/dell_rbu.c | 1 + drivers/leds/leds-lp55xx-common.c | 1 + include/linux/firmware.h | 7 + .../api/request_firmware-custom-fallback.cocci | 44 +++++ tools/testing/selftests/firmware/fw_filesystem.sh | 25 ++- 17 files changed, 565 insertions(+), 133 deletions(-) create mode 100644 Documentation/driver-api/firmware/built-in-fw.rst create mode 100644 Documentation/driver-api/firmware/core.rst create mode 100644 Documentation/driver-api/firmware/direct-fs-lookup.rst create mode 100644 Documentation/driver-api/firmware/fallback-mechanisms.rst create mode 100644 Documentation/driver-api/firmware/firmware_cache.rst create mode 100644 Documentation/driver-api/firmware/fw_search_path.rst create mode 100644 Documentation/driver-api/firmware/index.rst create mode 100644 Documentation/driver-api/firmware/introduction.rst create mode 100644 Documentation/driver-api/firmware/lookup-order.rst create mode 100644 Documentation/driver-api/firmware/request_firmware.rst delete mode 100644 Documentation/firmware_class/README create mode 100644 scripts/coccinelle/api/request_firmware-custom-fallback.cocci -- 2.10.1