From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 0E5EB45AF0; Wed, 9 Oct 2024 10:58:20 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 8DA2640B9E; Wed, 9 Oct 2024 10:58:19 +0200 (CEST) Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) by mails.dpdk.org (Postfix) with ESMTP id A6B3A402E8 for ; Wed, 9 Oct 2024 10:58:17 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1728464297; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=kGacQJQwIu7OrTWZ+2AzSr1BfGbTxO/penUJL0kQ1x4=; b=CUuoysarLa4wBOzFAh0kHif2dNr6q/r23j18yXKGC9wO3kNmmzJaQ7QAZ0++u4/FVRxxvQ lUME5usOYGpI3vYUXLm9e2uE9OLzmzlrBrL5AdwK0Fz8Ror6uZjtr0pdkIeu6VBhrh7Tgn O7PL4xTF4tlXKvGiUSCzyO4l7bkSpaw= Received: from mx-prod-mc-01.mail-002.prod.us-west-2.aws.redhat.com (ec2-54-186-198-63.us-west-2.compute.amazonaws.com [54.186.198.63]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-624-yb6w3rDnMh-ipri2hVSPJQ-1; Wed, 09 Oct 2024 04:58:13 -0400 X-MC-Unique: yb6w3rDnMh-ipri2hVSPJQ-1 Received: from mx-prod-int-01.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-01.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.4]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mx-prod-mc-01.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id 343B91955D53; Wed, 9 Oct 2024 08:58:11 +0000 (UTC) Received: from max-p1.redhat.com (unknown [10.39.208.2]) by mx-prod-int-01.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 01398300018D; Wed, 9 Oct 2024 08:58:07 +0000 (UTC) From: Maxime Coquelin To: dev@dpdk.org, techboard@dpdk.org, david.marchand@redhat.com, thomas@monjalon.net, mb@smartsharesystems.com, stephen@networkplumber.org, ferruh.yigit@amd.com Cc: Maxime Coquelin Subject: [PATCH v1 0/3] Import Kernel uAPI header files Date: Wed, 9 Oct 2024 10:58:02 +0200 Message-ID: <20241009085805.2638314-1-maxime.coquelin@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 3.4.1 on 10.30.177.4 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: 8bit Content-Type: text/plain; charset="US-ASCII"; x-default=true X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org This series enables importing Linux Kernel uAPI headers into the DPDK repository. It aims at solving alignment issues between the build system and the system applications linked ot DPDK libraries are run on. It can also help simplify spaghetti code done to support different versions of the Linux Kernel headers used by the build system. Guidelines and import script are also part of first patch. The uAPI checker script has been merged with the import script in this V1, goals is to use it in CI for any patch touching linux-headers/uapi. Follow-up patches are an example of imported uAPI inclusion of VDUSE header into the Vhost library. Changes in v1: ============== - Merged import-linux-uapi.sh and check_linux-uapi.sh in a single linux-uapi.sh script (David) - Moved imported headers to kernel/linux/ (Thomas) - Lots of fixes and improvements in the script (David) - Fixed headers fixup to mimic linux kernel headers install (David) - Updated documentation Changes in RFC v3: ================== - Support nested headers include - Interactive mode to select which headers to include - Store version in a file instead of git commit messages - All imported headers aligned on same version - Improve loops in scripts (David) - Update documentation Changes in RFC v2: ================== - Fix typos in documentation and commit messags (David, Morten) - Add uAPI checker script - Add uAPI to global_inc - Fix build issues on FreeBSD and documentation (CI, David) - Simplify import script (David) Maxime Coquelin (3): uapi: introduce kernel uAPI headers import uapi: import VDUSE header vduse: use imported VDUSE uAPI header devtools/linux-uapi.sh | 177 +++++++++++++ doc/guides/contributing/index.rst | 1 + doc/guides/contributing/linux_uapi.rst | 70 +++++ kernel/linux/uapi/.gitignore | 4 + kernel/linux/uapi/linux/vduse.h | 353 +++++++++++++++++++++++++ kernel/linux/uapi/version | 1 + lib/vhost/meson.build | 5 +- lib/vhost/vduse.c | 2 +- lib/vhost/vduse.h | 22 -- meson.build | 8 +- 10 files changed, 614 insertions(+), 29 deletions(-) create mode 100755 devtools/linux-uapi.sh create mode 100644 doc/guides/contributing/linux_uapi.rst create mode 100644 kernel/linux/uapi/.gitignore create mode 100644 kernel/linux/uapi/linux/vduse.h create mode 100644 kernel/linux/uapi/version -- 2.46.2