git: 5934a22bec - main - Status/2024Q3/sourcecompat.adoc: Add report

From: Lorenzo Salvadore <salvadore_at_FreeBSD.org>
Date: Thu, 10 Oct 2024 08:46:20 UTC
The branch main has been updated by salvadore:

URL: https://cgit.FreeBSD.org/doc/commit/?id=5934a22bec84b5b03593ac5e805882cd865f4965

commit 5934a22bec84b5b03593ac5e805882cd865f4965
Author:     Edward Tomasz NapieraƂa <trasz@FreeBSD.org>
AuthorDate: 2024-10-10 08:42:33 +0000
Commit:     Lorenzo Salvadore <salvadore@FreeBSD.org>
CommitDate: 2024-10-10 08:45:55 +0000

    Status/2024Q3/sourcecompat.adoc: Add report
    
    Reviewed by:    status (Pau Amma <pauamma@gundo.com>)
    Differential Revision:  https://reviews.freebsd.org/D46812
---
 .../report-2024-07-2024-09/sourcecompat.adoc       | 27 ++++++++++++++++++++++
 1 file changed, 27 insertions(+)

diff --git a/website/content/en/status/report-2024-07-2024-09/sourcecompat.adoc b/website/content/en/status/report-2024-07-2024-09/sourcecompat.adoc
new file mode 100644
index 0000000000..157cac54e0
--- /dev/null
+++ b/website/content/en/status/report-2024-07-2024-09/sourcecompat.adoc
@@ -0,0 +1,27 @@
+=== Linux Source Compatibility Wiki page
+
+Links: +
+link:https://wiki.freebsd.org/LinuxSourceCompatibility[Linux Source Compatibility] URL: link:https://wiki.freebsd.org/LinuxSourceCompatibility[]
+
+Contact: Edward Tomasz Napierala <trasz@freebsd.org>
+
+There is now a wiki page to track source compatibility differences between FreeBSD and Linux -- and it needs your input!
+
+FreeBSD and Linux are already largely compatible at the source code level due to both being Unix systems and following the same standards.
+There are however certain system calls specific to Linux; there are also differences in header files, constants and so on.
+Implementing them in FreeBSD would make porting software easier.
+
+Not all of the items there are fixable.
+Some differences cannot be eliminated due to naming clashes, disagreements on how the system is supposed to work, or because it would make autoconf pick up a less functional compatibility API instead of the native one.
+In such cases we should document it and advise what API to use instead.
+
+The wiki page aims to provide an overview and help track progress.
+That is where your help is needed.
+I need people who actually port software to FreeBSD to add missing APIs, based on their experiences.
+This also includes non-syscall items, like missing headers and unsupported constants.
+Preferably also mention the name of the software that could use them.
+
+ * Add missing items
+ * Add prospective API consumers
+
+Sponsor: Innovate UK