From patchwork Fri Oct 4 16:39:55 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jonathan Corbet X-Patchwork-Id: 175241 Delivered-To: patch@linaro.org Received: by 2002:a92:7e96:0:0:0:0:0 with SMTP id q22csp944620ill; Fri, 4 Oct 2019 09:40:13 -0700 (PDT) X-Google-Smtp-Source: APXvYqzJihCtyWKxvGzY1Mr6VMhjmY/Dug1uK3SA1QqiKSXL/63a/H9vsUeMa7KgYOEpr9i1XMBK X-Received: by 2002:a17:906:1e44:: with SMTP id i4mr13145665ejj.141.1570207213421; Fri, 04 Oct 2019 09:40:13 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1570207213; cv=none; d=google.com; s=arc-20160816; b=Rb/G7JqW1R/wbQtu/oFOy9jHTjmrNUByZAOh2+6qZ8w6m3hxBW+zUYm+j1JrQXPnMt riPnBvsz1jOPcTxaFfeudJvMqRuE2HKY9LWnOuZelDsnlrqcVDWIv0tcIAgoCe6482+0 UiYi0nFBQ5NZirmlD7+1lPf+ipcPIgV3U8fjnBLVdnEF5f9M0bIgb//YPtMKvyg0TznX VsT2EFHF+0XM5YuB54gsqzjjjyBNSU7jEKEAj28LwsEA3OAwVn/SdI0ezaQuF4icIoPA 0p/A+4glIUb6YSl533HoLAlGsFYGCsHRhXsf+0mXDw6UgXDdI1w3CSkA7DN0Sofyoowl HDrA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from; bh=RgM3EdF45r7tC2gd+rqnrgdvO5DDZm6iKAUQrODCn7g=; b=Lhl/NSorTGFb6MX77D/gCf+h7/tVoMyJyGq2rf+0wPnwrfMHvgJrsCLXuHMX5yGuoS JaGMrffz3rzUONv//DOVzK2rApMSKtGKPrd8f457AGGYo3hWZWl1pWxNPa2647qiujW7 S69QRLXAnOPdboVolBNwAEM5gQIsw3F7iNAH7ftmNGFCni5RkIA99SywSdavbxXaOTTy lHMfwrHQnYpcOchlAU/yArsXeOMM4UA2sqIdjjraB9EfhdxUVbFQt7lcOkxIm+F8Su3X TmYHxQLD+CDs5pY6j5klx5/iZkAhfcF1fbUlj3UIir3dXeD16TxgW6u2A6uc6Dk0vTTb C1Cg== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id q30si4335030eda.5.2019.10.04.09.40.13; Fri, 04 Oct 2019 09:40:13 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1730080AbfJDQkM (ORCPT + 27 others); Fri, 4 Oct 2019 12:40:12 -0400 Received: from ms.lwn.net ([45.79.88.28]:40210 "EHLO ms.lwn.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726111AbfJDQkH (ORCPT ); Fri, 4 Oct 2019 12:40:07 -0400 Received: from meer.lwn.net (localhost [127.0.0.1]) by ms.lwn.net (Postfix) with ESMTPA id 0660C7C0; Fri, 4 Oct 2019 16:40:06 +0000 (UTC) From: Jonathan Corbet To: Thomas Gleixner Cc: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Jonathan Corbet Subject: [PATCH 2/2] docs: Add request_irq() documentation Date: Fri, 4 Oct 2019 10:39:55 -0600 Message-Id: <20191004163955.14419-3-corbet@lwn.net> X-Mailer: git-send-email 2.21.0 In-Reply-To: <20191004163955.14419-1-corbet@lwn.net> References: <20191004163955.14419-1-corbet@lwn.net> MIME-Version: 1.0 Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org While checking the results of the :c:func: removal, I noticed that there was no documentation for request_irq(), and request_threaded_irq() was not mentioned at all. Add a kerneldoc comment for request_irq() and add request_threaded_irq() to the list of functions. Signed-off-by: Jonathan Corbet --- Documentation/core-api/genericirq.rst | 2 ++ include/linux/interrupt.h | 13 +++++++++++++ 2 files changed, 15 insertions(+) -- 2.21.0 Reviewed-by: Thomas Gleixner diff --git a/Documentation/core-api/genericirq.rst b/Documentation/core-api/genericirq.rst index 2e6c99e3ce3b..8f06d885c310 100644 --- a/Documentation/core-api/genericirq.rst +++ b/Documentation/core-api/genericirq.rst @@ -127,6 +127,8 @@ The high-level Driver API consists of following functions: - request_irq() +- request_threaded_irq() + - free_irq() - disable_irq() diff --git a/include/linux/interrupt.h b/include/linux/interrupt.h index 89fc59dab57d..ba873ec7e09d 100644 --- a/include/linux/interrupt.h +++ b/include/linux/interrupt.h @@ -140,6 +140,19 @@ request_threaded_irq(unsigned int irq, irq_handler_t handler, irq_handler_t thread_fn, unsigned long flags, const char *name, void *dev); +/** + * request_irq - Add a handler for an interrupt line + * @irq: The interrupt line to allocate + * @handler: Function to be called when the IRQ occurs. + * Primary handler for threaded interrupts + * If NULL, the default primary handler is installed + * @flags: Handling flags + * @name: Name of the device generating this interrupt + * @dev: A cookie passed to the handler function + * + * This call allocates an interrupt and establishes a handler; see + * the documentation for request_threaded_irq() for details. + */ static inline int __must_check request_irq(unsigned int irq, irq_handler_t handler, unsigned long flags, const char *name, void *dev)