Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752737Ab3ISOVK (ORCPT ); Thu, 19 Sep 2013 10:21:10 -0400 Received: from mho-02-ewr.mailhop.org ([204.13.248.72]:61706 "EHLO mho-02-ewr.mailhop.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751655Ab3ISOVI (ORCPT ); Thu, 19 Sep 2013 10:21:08 -0400 X-Mail-Handler: Dyn Standard SMTP by Dyn X-Originating-IP: 108.39.110.144 X-Report-Abuse-To: abuse@dyndns.com (see http://www.dyndns.com/services/sendlabs/outbound_abuse.html for abuse reporting information) X-MHO-User: U2FsdGVkX19zOzeERCL4RmNpFIkjR1oDq3gYvRgsSyU= Date: Thu, 19 Sep 2013 10:20:48 -0400 From: Jason Cooper To: Michal Simek Cc: Greg KH , 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: <20130919142048.GS19937@titan.lakedaemon.net> 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> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <523B05E6.90605@monstr.eu> User-Agent: Mutt/1.5.20 (2009-06-14) Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 2098 Lines: 59 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. thx, Jason. -- 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/