From patchwork Thu Oct 22 08:32:29 2015 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Linus Walleij X-Patchwork-Id: 55416 Return-Path: X-Original-To: linaro@patches.linaro.org Delivered-To: linaro@patches.linaro.org Received: from mail-wi0-f198.google.com (mail-wi0-f198.google.com [209.85.212.198]) by patches.linaro.org (Postfix) with ESMTPS id 4059223024 for ; Thu, 22 Oct 2015 08:33:11 +0000 (UTC) Received: by wikv3 with SMTP id v3sf30333469wik.1 for ; Thu, 22 Oct 2015 01:33:10 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:mime-version:delivered-to:from:to:cc:subject :date:message-id:in-reply-to:references:sender:precedence:list-id :x-original-sender:x-original-authentication-results:mailing-list :list-post:list-help:list-archive:list-unsubscribe; bh=wTNRm25O/TWN0znibUuCT1jF+qNODXkMWoaxz49730U=; b=bkJlb1EC5jgSn16HuaizQ+LFfrU6Eji4AnH3tEkmHukFRtqgNMMDuJWcxHx4kPAtWX /nSacq+R4XysMXaaqCUpervpbJ/nnHhdomwc3s3ZjJaBmlMySRBQC9KSTJccwMv1ZvhF yIPweZP6nD4B3OtuhYMQ5SvFtIqt2RYI5q6zI8AzkSoYvXHwjEPq8x93R0t8zJks49qG mlUl/z5UkuziClEPk7Dkx5h1bYXNlrHhGm2Ng3/0zd1T4eIRGEaoFQSZctHEhxQb/Yqm CHbmy0paj/60oWTDMS+Bq5Mgog9axIPVQeVUg52jtUD12USMmPk/hGvA6r2WDQppZfvW T5BA== X-Gm-Message-State: ALoCoQm1myHEobgYdMQ59iEGb5iGmSGda8iOPajBFa3EZDrMMCyrpZf56+Ib3uJvpXSiXfF+m9qo X-Received: by 10.194.109.233 with SMTP id hv9mr3326574wjb.1.1445502790609; Thu, 22 Oct 2015 01:33:10 -0700 (PDT) MIME-Version: 1.0 X-BeenThere: patchwork-forward@linaro.org Received: by 10.25.150.207 with SMTP id y198ls312265lfd.107.gmail; Thu, 22 Oct 2015 01:33:10 -0700 (PDT) X-Received: by 10.112.147.10 with SMTP id tg10mr7885323lbb.58.1445502790329; Thu, 22 Oct 2015 01:33:10 -0700 (PDT) Received: from mail-lf0-f53.google.com (mail-lf0-f53.google.com. [209.85.215.53]) by mx.google.com with ESMTPS id h73si285772lfh.88.2015.10.22.01.33.10 for (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Thu, 22 Oct 2015 01:33:10 -0700 (PDT) Received-SPF: pass (google.com: domain of patch+caf_=patchwork-forward=linaro.org@linaro.org designates 209.85.215.53 as permitted sender) client-ip=209.85.215.53; Received: by lfaz124 with SMTP id z124so39299454lfa.1 for ; Thu, 22 Oct 2015 01:33:10 -0700 (PDT) X-Received: by 10.25.205.193 with SMTP id d184mr2826069lfg.72.1445502790211; Thu, 22 Oct 2015 01:33:10 -0700 (PDT) X-Forwarded-To: patchwork-forward@linaro.org X-Forwarded-For: patch@linaro.org patchwork-forward@linaro.org Delivered-To: patch@linaro.org Received: by 10.112.59.35 with SMTP id w3csp448249lbq; Thu, 22 Oct 2015 01:33:09 -0700 (PDT) X-Received: by 10.68.134.73 with SMTP id pi9mr16161685pbb.55.1445502789200; Thu, 22 Oct 2015 01:33:09 -0700 (PDT) Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id ep1si19422198pbd.256.2015.10.22.01.33.08; Thu, 22 Oct 2015 01:33:09 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-gpio-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1756737AbbJVIdI (ORCPT + 3 others); Thu, 22 Oct 2015 04:33:08 -0400 Received: from mail-lf0-f42.google.com ([209.85.215.42]:34087 "EHLO mail-lf0-f42.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1756712AbbJVIdG (ORCPT ); Thu, 22 Oct 2015 04:33:06 -0400 Received: by lfaz124 with SMTP id z124so39297449lfa.1 for ; Thu, 22 Oct 2015 01:33:05 -0700 (PDT) X-Received: by 10.112.205.231 with SMTP id lj7mr7684628lbc.57.1445502785575; Thu, 22 Oct 2015 01:33:05 -0700 (PDT) Received: from localhost.localdomain ([85.235.10.227]) by smtp.gmail.com with ESMTPSA id um10sm2148562lbc.15.2015.10.22.01.33.03 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Thu, 22 Oct 2015 01:33:04 -0700 (PDT) From: Linus Walleij To: linux-gpio@vger.kernel.org, Johan Hovold , Alexandre Courbot , Arnd Bergmann , Michael Welling , Markus Pargmann Cc: Mark Brown , Amit Kucheria , Linus Walleij Subject: [PATCH 5/6] gpio: add a userspace character device ABI Date: Thu, 22 Oct 2015 10:32:29 +0200 Message-Id: <1445502750-22672-6-git-send-email-linus.walleij@linaro.org> X-Mailer: git-send-email 2.4.3 In-Reply-To: <1445502750-22672-1-git-send-email-linus.walleij@linaro.org> References: <1445502750-22672-1-git-send-email-linus.walleij@linaro.org> Sender: linux-gpio-owner@vger.kernel.org Precedence: list List-ID: X-Mailing-List: linux-gpio@vger.kernel.org X-Removed-Original-Auth: Dkim didn't pass. X-Original-Sender: linus.walleij@linaro.org X-Original-Authentication-Results: mx.google.com; spf=pass (google.com: domain of patch+caf_=patchwork-forward=linaro.org@linaro.org designates 209.85.215.53 as permitted sender) smtp.mailfrom=patch+caf_=patchwork-forward=linaro.org@linaro.org Mailing-list: list patchwork-forward@linaro.org; contact patchwork-forward+owners@linaro.org X-Google-Group-Id: 836684582541 List-Post: , List-Help: , List-Archive: List-Unsubscribe: , Put in some documentation for the new character device ABI so we can properly etch it in stone. Signed-off-by: Linus Walleij --- Documentation/ABI/testing/gpio-cdev | 26 ++++++++++++++++++++++++++ MAINTAINERS | 1 + 2 files changed, 27 insertions(+) create mode 100644 Documentation/ABI/testing/gpio-cdev diff --git a/Documentation/ABI/testing/gpio-cdev b/Documentation/ABI/testing/gpio-cdev new file mode 100644 index 000000000000..7b265fbb47e3 --- /dev/null +++ b/Documentation/ABI/testing/gpio-cdev @@ -0,0 +1,26 @@ +What: /dev/gpiochip[0-9]+ +Date: November 2015 +KernelVersion: 4.4 +Contact: linux-gpio@vger.kernel.org +Description: + The character device files /dev/gpiochip* are the interface + between GPIO chips and userspace. + + The ioctl(2)-based ABI is defined and documented in + [include/uapi]. + + The following file operations are supported: + + open(2) + Currently the only useful flags are O_RDWR. + + ioctl(2) + Initiate various actions. + See the inline documentation in [include/uapi] + for descriptions of all ioctls. + + close(2) + Stops and free up the I/O contexts that was associated + with the file descriptor. + +Users: TBD diff --git a/MAINTAINERS b/MAINTAINERS index 3bb1f52d54e0..23cd966cb974 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -4642,6 +4642,7 @@ L: linux-gpio@vger.kernel.org T: git git://git.kernel.org/pub/scm/linux/kernel/git/linusw/linux-gpio.git S: Maintained F: Documentation/gpio/ +F: Documentation/ABI/testing/gpio-cdev F: drivers/gpio/ F: include/linux/gpio/ F: include/linux/gpio.h