From patchwork Mon Aug 10 10:00:17 2015 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Linus Walleij X-Patchwork-Id: 52184 Return-Path: X-Original-To: linaro@patches.linaro.org Delivered-To: linaro@patches.linaro.org Received: from mail-la0-f72.google.com (mail-la0-f72.google.com [209.85.215.72]) by patches.linaro.org (Postfix) with ESMTPS id D266F2152A for ; Mon, 10 Aug 2015 10:01:01 +0000 (UTC) Received: by labia3 with SMTP id ia3sf37708462lab.1 for ; Mon, 10 Aug 2015 03:01:00 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:delivered-to:from:to:cc:subject:date:message-id :mime-version:content-type:content-transfer-encoding:sender :precedence:list-id:x-original-sender :x-original-authentication-results:mailing-list:list-post:list-help :list-archive:list-unsubscribe; bh=LW5dpl4SA2blOMq09Qd6wDhqKYkbqYV4i0VOW91Ui6I=; b=MbNhKK25L2TGs4YLbt3ILTkix9r7fzOEIVv/u7xKdISC1U4/tVYEUYE11ojONXxqRH IJroAZrordjkLXWDs7canYWhe6uCfgBJqOYupZEDZY8AyK/rOV+OwOtOfGWHuLNp0ebB 0YFVKngE9lQ3dh06tS412j6hAqel4400y3nTqaaHJTDZ6re8tOQTOghpL26f9De145w5 DlIXGdvokczTXgXOqOop5S0JiiuP3U4CVT1y0VWVtP54iozjM4wB8czGR04+pAOoMlT/ yd7q2VtutOUXpAgWpKR8x6vxTIm7XJQlrz7sA/vJkgNkFjD3+cIHm3J4xxbLqXQgs+F3 C/zw== X-Gm-Message-State: ALoCoQmUD6sh0E+9YVBoHsnytrSgHqOYJDFzlJeh7ki/L9ZGv4sO3xGOuPDf881Z4MqxZh66C+vM X-Received: by 10.152.28.100 with SMTP id a4mr6076179lah.4.1439200860864; Mon, 10 Aug 2015 03:01:00 -0700 (PDT) X-BeenThere: patchwork-forward@linaro.org Received: by 10.152.204.106 with SMTP id kx10ls49795lac.51.gmail; Mon, 10 Aug 2015 03:01:00 -0700 (PDT) X-Received: by 10.152.45.9 with SMTP id i9mr19271271lam.105.1439200860716; Mon, 10 Aug 2015 03:01:00 -0700 (PDT) Received: from mail-la0-f44.google.com (mail-la0-f44.google.com. [209.85.215.44]) by mx.google.com with ESMTPS id d3si7952148laf.74.2015.08.10.03.01.00 for (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Mon, 10 Aug 2015 03:01:00 -0700 (PDT) Received-SPF: pass (google.com: domain of patch+caf_=patchwork-forward=linaro.org@linaro.org designates 209.85.215.44 as permitted sender) client-ip=209.85.215.44; Received: by lagz9 with SMTP id z9so50713252lag.3 for ; Mon, 10 Aug 2015 03:01:00 -0700 (PDT) X-Received: by 10.112.140.68 with SMTP id re4mr19369805lbb.72.1439200860603; Mon, 10 Aug 2015 03:01:00 -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.7.198 with SMTP id l6csp1830447lba; Mon, 10 Aug 2015 03:00:59 -0700 (PDT) X-Received: by 10.66.63.99 with SMTP id f3mr43607562pas.6.1439200859610; Mon, 10 Aug 2015 03:00:59 -0700 (PDT) Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id fb1si32271141pbb.110.2015.08.10.03.00.58; Mon, 10 Aug 2015 03:00:59 -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 S1755303AbbHJKAc (ORCPT + 2 others); Mon, 10 Aug 2015 06:00:32 -0400 Received: from mail-lb0-f182.google.com ([209.85.217.182]:34502 "EHLO mail-lb0-f182.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1754836AbbHJKA0 (ORCPT ); Mon, 10 Aug 2015 06:00:26 -0400 Received: by lbbtg9 with SMTP id tg9so54230053lbb.1 for ; Mon, 10 Aug 2015 03:00:24 -0700 (PDT) X-Received: by 10.112.189.161 with SMTP id gj1mr19336739lbc.20.1439200824881; Mon, 10 Aug 2015 03:00:24 -0700 (PDT) Received: from localhost.localdomain ([85.235.11.236]) by smtp.gmail.com with ESMTPSA id rl1sm4127251lac.14.2015.08.10.03.00.23 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Mon, 10 Aug 2015 03:00:24 -0700 (PDT) From: Linus Walleij To: linux-gpio@vger.kernel.org Cc: Alexandre Courbot , Linus Walleij , Daniel Silverstone , Markus Pargmann , Johan Hovold , =?UTF-8?q?Uwe=20Kleine-K=C3=B6nig?= Subject: [PATCH] gpio/ABI: document what is already the case Date: Mon, 10 Aug 2015 12:00:17 +0200 Message-Id: <1439200817-7268-1-git-send-email-linus.walleij@linaro.org> X-Mailer: git-send-email 2.4.3 MIME-Version: 1.0 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.44 as permitted sender) smtp.mail=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: , commit 926b663ce8215ba448960e1ff6e58b67a2c3b99b "gpiolib: allow GPIOs to be named" added the ability to name GPIO lines by an array of names stored in the GPIO chip. This was in 2009 and has been an ABI since. Let's document it properly. Cc: Daniel Silverstone Cc: Markus Pargmann Cc: Johan Hovold Cc: Uwe Kleine-König Signed-off-by: Linus Walleij --- This flat namespace does not allow two GPIO lines to have the same name, sadly. Now I can not do anything about it, it is just so. --- Documentation/ABI/testing/sysfs-gpio | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/Documentation/ABI/testing/sysfs-gpio b/Documentation/ABI/testing/sysfs-gpio index 80f4c94c7bef..55ffa2df1c10 100644 --- a/Documentation/ABI/testing/sysfs-gpio +++ b/Documentation/ABI/testing/sysfs-gpio @@ -16,7 +16,8 @@ Description: /sys/class/gpio /export ... asks the kernel to export a GPIO to userspace /unexport ... to return a GPIO to the kernel - /gpioN ... for each exported GPIO #N + /gpioN ... for each exported GPIO #N OR + / ... for a properly named GPIO line /value ... always readable, writes fail for input GPIOs /direction ... r/w as: in, out (default low); write: high, low /edge ... r/w as: none, falling, rising, both