Re: [PATCH] memmem.3: Added list of known systems where this is available

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Hi,

On Wed, Nov 23, 2022 at 1:39 AM Guillem Jover <guillem@xxxxxxxxxxx> wrote:
>
> Hi!
>
> On Thu, 2022-11-10 at 12:36:47 +0100, Alejandro Colomar wrote:
> > On 11/10/22 01:13, Andrew Clayton wrote:
> > > While looking at which systems provide memmem(3) I have been able to
> > > discern the following:
> > >
> > >    musl libc since v0.9.7
> > >    bionic since Android 9
> > >
> > >    FreeBSD since 6.0
> > >    OpenBSD since 5.4
> > >    NetBSD
> > >    macOS
> > >    Illumos
>
> > > For macOS and Illumos I checked the memmem(3) man page on those systems.
> > > For the rest there are links below to on-line man pages or commit logs.
>
> > > +FreeBSD 6.0, OpenBSD 5.4, NetBSD, macOS & Illumos.
>
> > For the commit message, it's interesting to note macOS and Bionic, for
> > speleology purposes.  However, I'm opposed to adding them to the page itself
> > because of the following:
> >
> > -  macOS is not free software.  I refuse to reference nonfree software on
> > this project.
>
> I understand where you are coming from, and from a full system PoV,
> it's very true that macOS is non-free. But the lower layers of its
> stack are free software (at least according to the FSF and OSI), such
> as its kernel (Darwin), or its libc (where memmem() is implemented):
>
>   https://opensource.apple.com/source/Libc/Libc-1439.40.11/
>
> among others.
>
> Similar with Solaris and Illumos (but with the CDDL, MIT, BSD), AFAIUI.
>
> > -  Android is not a real Unix system, in that you can't even program in C in
> > there, unless you're Google or have hacked your system.  It's not friendly
> > to us programmers, so we don't need to be friendly to it.  I don't want to
> > be cluttering the pages with information that is irrelevant to normal users.
>
> I'm assuming bionic is being used in some of the Android free
> alternatives too, but then I'm not sure how usable for programming those
> are either. And, well musl libc is not a real Unix system you can program
> against either. :)
>
> In any case I also find it useful to have this kind of portability
> information when deciding what to use in code. But can understand the
> reluctance to include such references, at least if thought out as the
> entire system. Perhaps thinking about these merely at their kernel or
> libc level would make including information about some of them more
> palatable, given that standalone they are free software? So perhaps
> an option is to instead refer to their specific components, say
> "bionic libc X.Y", "Apple Libc M.N.O" or similar.

Not sure if it's the job of Linux man-pages to document when other
OSes started supporting certain APIs. That info has to be maintained,
updated etc. People can always read the man pages of other systems,
right? Maybe it's worth only pointing out when an interface is
Linux-only, or the Linux implementation diverges significantly.

For musl and other libcs, I think the man pages already document some
instances where their behavior diverges from glibc.

Just my 2c,
Stefan.

>
> Thanks,
> Guillem



[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux