linux-kernel - Re: [PATCH trivial] UAPI: Kbuild: add/modify comments for "uapi/Kbuild" and "uapi/linux/Kbuild"

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: <5226EAAE.6090500@asianux.com>
Date:	Wed, 04 Sep 2013 16:09:18 +0800
From:	Chen Gang <gang.chen@...anux.com>
To:	Geert Uytterhoeven <geert@...ux-m68k.org>
CC:	Jiri Kosina <trivial@...nel.org>,
	Paul McKenney <paulmck@...ux.vnet.ibm.com>,
	"dhowells@...hat.com" <dhowells@...hat.com>,
	Thomas Gleixner <tglx@...utronix.de>,
	Dave Jones <davej@...hat.com>, Arnd Bergmann <arnd@...db.de>,
	David Miller <davem@...emloft.net>,
	"linux-kernel@...r.kernel.org" <linux-kernel@...r.kernel.org>
Subject: Re: [PATCH trivial] UAPI: Kbuild: add/modify comments for "uapi/Kbuild"
 and "uapi/linux/Kbuild"

On 09/04/2013 03:02 PM, Geert Uytterhoeven wrote:
> On Wed, Sep 4, 2013 at 3:08 AM, Chen Gang <gang.chen@...anux.com> wrote:
>> On 09/04/2013 12:41 AM, Geert Uytterhoeven wrote:
>>> On Tue, Aug 6, 2013 at 3:46 AM, Chen Gang <gang.chen@...anux.com> wrote:
>>>> --- a/include/uapi/Kbuild
>>>> +++ b/include/uapi/Kbuild
>>>> @@ -1,7 +1,6 @@
>>>>  # UAPI Header export list
>>>> -# Top-level Makefile calls into asm-$(ARCH)
>>>> -# List only non-arch directories below
>>>> -
>>>> +# Except "linux/", UAPI means Universal API.
>>>
>>> Sorry for my silly question, but what's the purpose of this "Universal
>>> API" comment?
>>>
>>
>> Firstly, at least for me, I don't think it is a silly question (maybe
>> it means I should give additional explanations).  :-)
>>
>> I 'guess' the "Universal API" means:
>>
>>   "the API which can be used under multiple OS (independent from Linux), it may be used under kernel mode or user mode".
>>
>> It is just my 'guess', welcome additional suggestions or completions by
>> any members.
>>
>> When we get this correct additional explanation after discussing, if
>> suitable, I should add the final explanation to current patch.
> 
> Thanks. As this is not related at all to Linux, I don't see a reason
> to add this comment.
> 
> Here, "UAPI" means "userspace API" only.
> 

Hmm... why we need "uapi/linux/" ?  (I can not find some related
documents, so I have to 'guess').

And in my opinion, most of APIs can be independent from Linux, for in
semantics, most of them are really independent from Linux.

  e.g. net protocol, scsi protocol, usb protocol, pci protocol...

So in my opinion (ideal world), the API which is not only used under
Linux (e.g. Windows, MacOS, AIX, HPUX, SPARC ...), recommend to let
them be "Universal API".


BTW: if this patch was really applied, it seems most of files under
"include/uapi/" would need be improvement.


Thanks.

> Gr{oetje,eeting}s,
> 
>                         Geert
> 
> --
> Geert Uytterhoeven -- There's lots of Linux beyond ia32 -- geert@...ux-m68k.org
> 
> In personal conversations with technical people, I call myself a hacker. But
> when I'm talking to journalists I just say "programmer" or something like that.
>                                 -- Linus Torvalds
> 
> 


-- 
Chen Gang
--
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/