linux-kernel - Re: [RFC 1/5] platform-drivers-x86: add support for Technologic Systems TS-5xxx detection

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <20110502215535.GA30373@kroah.com>
Date:	Mon, 2 May 2011 14:55:35 -0700
From:	Greg KH <greg@...ah.com>
To:	Vivien Didelot <vivien.didelot@...oirfairelinux.com>
Cc:	linux-kernel <linux-kernel@...r.kernel.org>,
	Jonas Fonseca <jonas.fonseca@...oirfairelinux.com>,
	platform-driver-x86 <platform-driver-x86@...r.kernel.org>,
	linux-serial <linux-serial@...r.kernel.org>,
	lm-sensors <lm-sensors@...sensors.org>
Subject: Re: [RFC 1/5] platform-drivers-x86: add support for Technologic
 Systems TS-5xxx detection

On Mon, May 02, 2011 at 05:07:29PM -0400, Vivien Didelot wrote:
> Hi,
> 
> Thanks you all for your comments, I'll consider them carefully.
> 
> Excerpts from Greg KH's message of 2011-04-29 19:32:30 -0400:
> > On Fri, Apr 29, 2011 at 06:21:48PM -0400, Vivien Didelot wrote:
> > > +/proc filesystem
> > > +----------------
> > > +
> > > +Information about the TS board is available through the /proc/ts-sbcinfo.
> > 
> > Really?  Why?
> > 
> > As you now have added a new kernel/user ABI, it must be documented in
> > Documentation/ABI/
> > 
> > Please include that in your next patch.
> > 
> > But first off, why a new proc file?  What is it used for?
> 
> I think it could be useful for the user to know what option is available
> or not on the board.

But that's not how we export data to userspace anymore, sorry.  We try
to learn from our past mistakes.

Almost all of this data can be gotten from other methods anyway, you
need to justify why you wish to repeat this here.

> > > +static int ts_sbcinfo_init_buffer(char *buf, struct ts5xxx_sbcinfo *sbcinfo)
> > > +{
> > > +    char *pos = buf;
> > > +
> > > +    pos += ts_addbuf(pos, "Board ID", "TS-%d", sbcinfo->board_id);
> > > +    pos += ts_addbuf(pos, "RS485", "%s", sbcinfo->rs485 ? "yes" : "no");
> > > +    pos += ts_addbuf(pos, "AnalogToDigital", "%s",
> > > +             sbcinfo->adc ? "yes" : "no");
> > > +    pos += ts_addbuf(pos, "Auto485", "%s", sbcinfo->auto485 ? "yes" : "no");
> > > +    pos += ts_addbuf(pos, "SRAM", "%s", sbcinfo->sram ? "yes" : "no");
> > > +    pos += ts_addbuf(pos, "External Reset", "%s",
> > > +             sbcinfo->external_reset ? "yes" : "no");
> > 
> > Most of these look like they should be simple "one value per file" sysfs
> > files for your system.  That would make things much easier on your
> > userspace tools to handle parsing them properly, right?
> > 
> > Why not do that instead?
> 
> I had a look at other drivers, and /sys/devices/platform/ts/ seems to be
> a good place to hold those entries (one per options as you suggested).
> Do you agree with that?

No, this is not a platform device, is it?  Only platform devices go
there, and I really doubt you have many of them for this board.

> By the way, as they would be sysfs attributes, is Documentation/ABI the
> best place to add the documentation file?

Yes.

thanks,

greg k-h
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@...r.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/