Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752429Ab3ISOgm (ORCPT ); Thu, 19 Sep 2013 10:36:42 -0400 Received: from out3-smtp.messagingengine.com ([66.111.4.27]:59385 "EHLO out3-smtp.messagingengine.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751562Ab3ISOgl (ORCPT ); Thu, 19 Sep 2013 10:36:41 -0400 X-Sasl-enc: jHQyMbhSFjEYnV33pMkWt6TPDm2HDJBWJQu62BirG8mK 1379601400 Date: Thu, 19 Sep 2013 07:37:15 -0700 From: Greg KH To: Jason Cooper Cc: Michal Simek , Pavel Machek , Alan Tull , Jason Gunthorpe , Michal Simek , linux-kernel@vger.kernel.org, Dinh Nguyen , Philip Balister , Alessandro Rubini , Mauro Carvalho Chehab , Andrew Morton , Cesar Eduardo Barros , Joe Perches , "David S. Miller" , Stephen Warren , Arnd Bergmann , David Brown , Dom Cobley Subject: Re: /sys rules Re: [RFC PATCH] fpga: Introduce new fpga subsystem Message-ID: <20130919143715.GA22928@kroah.com> References: <20130918191517.GQ19937@titan.lakedaemon.net> <20130918203247.GA11181@obsidianresearch.com> <1379539063.31417.23.camel@atx-linux-37> <523AD814.1060406@monstr.eu> <20130919111719.GA26246@amd.pavel.ucw.cz> <523ADE58.2070103@monstr.eu> <20130919125237.GA7125@amd.pavel.ucw.cz> <20130919140633.GC19943@kroah.com> <523B05E6.90605@monstr.eu> <20130919142048.GS19937@titan.lakedaemon.net> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20130919142048.GS19937@titan.lakedaemon.net> User-Agent: Mutt/1.5.21 (2010-09-15) Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 2318 Lines: 60 On Thu, Sep 19, 2013 at 10:20:48AM -0400, Jason Cooper wrote: > On Thu, Sep 19, 2013 at 04:10:46PM +0200, Michal Simek wrote: > > On 09/19/2013 04:06 PM, Greg KH wrote: > > > On Thu, Sep 19, 2013 at 02:52:37PM +0200, Pavel Machek wrote: > > >> On Thu 2013-09-19 13:22:00, Michal Simek wrote: > > >>> On 09/19/2013 01:17 PM, Pavel Machek wrote: > > >> > > >>>>> Status is just there and for my zynq devcfg driver I do export some status > > >>>>> bits. > > >>>>> > > >>>>> root@petalinux:~# cat /sys/class/fpga/fpga0/status > > >>>>> partial_bitstream_status: 0 > > >>>>> prog_done_status: 1 > > >>>>> dbg_lock_status: 0 > > >>>>> seu_lock_status: 0 > > >>>>> aes_en_lock_status: 0 > > >>>>> aes_status: 0 > > >>>>> seu_status: 0 > > >>>>> spniden_status: 1 > > >>>>> spiden_status: 1 > > >>>>> niden_status: 1 > > >>>>> dbgen_status: 1 > > >>>>> dap_en_status: 7 > > >>>> > > >>>> This is single file? If so, it needs to be changed. Greg is rather > > >>>> clear about that. > > >>> > > >>> Don't you have a link to these rules? I have seen any paragraph from Greg > > >>> about it but I forget where was it. > > >> > > >> "one value per file" and "there must be documentation in > > >> Documentation/ for each file" are the rules, iirc. > > >> > > >> There's Documentation/sysfs-rules.txt, but it does not seem too > > >> relevant. > > > > > > Documentation/filesystems/sysfs.txt says it. It probably should be > > > added to sysfs-rules.txt as well, but the odds that anyone ever reads > > > the documentation is so low I doubt it's even worth it. > > > > > > Also, all sysfs files have to be documented in Documentation/ABI/ which > > > this patch does not do :( > > > > > > And yes, multiple values in a single sysfs file is not allowed at all. > > > > > > > ok. I will read that. This is output from my fpga end driver - nothing > > what I have sent for review. > > If this is useful to you (and others), you could use debugfs for this. > The rules there are intentionally a lot more lax. Yes, there is only one rule in debugfs, "There is no rules". greg k-h -- To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/