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: 505550 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 34EB71401CD for ; Mon, 10 Aug 2015 20:00:59 +1000 (AEST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1755303AbbHJKAc (ORCPT ); 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-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-type:content-transfer-encoding; bh=D5AoCv3V4NH9Y2hwdo455C+07yJL3kGf/fN7+09KJeI=; b=m3BLErEr6YHT0ddNnJJGhRmTIG7NhKgz4eCSHdo76XCw9ZQuXHP4eyzpJdhprMZfKc mZw+TnOgROq01eKA2QnBF02TIsDGktUpAh+LaxgXMBvu3ilG/ul/UiL6qNJ+mA4UST7D bkvV0SRC4TqMSQkFbya3E0mF4C6evCbPljJ3gy4p/vg0wIghtrE3WKhW0Nl2sAI612KQ qQSR1Colrx1GYspSUZuo92zQMfz2gd1dijHJZf3f0nm9r+U4Yd60YX8oAdm0M7AP7ecY nrBQo8wIpp3J+vGjHQ53ss4B6nwlvdYRzRIy2RyRIGC7jgevzRn5sf1jkMLVfP9E3bqn kQaA== X-Gm-Message-State: ALoCoQm4jA+HygByRHwAgn39PiYC5l8PCtk86QsCkZ9Tr6yU/+AJya6H9wdkacMGepFNwcdnSE+R 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: bulk List-ID: X-Mailing-List: linux-gpio@vger.kernel.org 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 Reviewed-by: Alexandre Courbot --- 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