get:
Show a patch.

patch:
Update a patch.

put:
Update a patch.

GET /api/patches/105534/?format=api
HTTP 200 OK
Allow: GET, PUT, PATCH, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "id": 105534,
    "url": "http://patchwork.dpdk.org/api/patches/105534/?format=api",
    "web_url": "http://patchwork.dpdk.org/project/dpdk/patch/20211230144828.3550807-1-dkozlyuk@nvidia.com/",
    "project": {
        "id": 1,
        "url": "http://patchwork.dpdk.org/api/projects/1/?format=api",
        "name": "DPDK",
        "link_name": "dpdk",
        "list_id": "dev.dpdk.org",
        "list_email": "dev@dpdk.org",
        "web_url": "http://core.dpdk.org",
        "scm_url": "git://dpdk.org/dpdk",
        "webscm_url": "http://git.dpdk.org/dpdk",
        "list_archive_url": "https://inbox.dpdk.org/dev",
        "list_archive_url_format": "https://inbox.dpdk.org/dev/{}",
        "commit_url_format": ""
    },
    "msgid": "<20211230144828.3550807-1-dkozlyuk@nvidia.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/20211230144828.3550807-1-dkozlyuk@nvidia.com",
    "date": "2021-12-30T14:48:28",
    "name": "[RFC,5/6] eal: allow hugepage file reuse with --huge-unlink",
    "commit_ref": null,
    "pull_url": null,
    "state": "superseded",
    "archived": true,
    "hash": "9c7d0d4e064cb06165652836a4aa2724cceb71c3",
    "submitter": {
        "id": 2248,
        "url": "http://patchwork.dpdk.org/api/people/2248/?format=api",
        "name": "Dmitry Kozlyuk",
        "email": "dkozlyuk@nvidia.com"
    },
    "delegate": {
        "id": 24651,
        "url": "http://patchwork.dpdk.org/api/users/24651/?format=api",
        "username": "dmarchand",
        "first_name": "David",
        "last_name": "Marchand",
        "email": "david.marchand@redhat.com"
    },
    "mbox": "http://patchwork.dpdk.org/project/dpdk/patch/20211230144828.3550807-1-dkozlyuk@nvidia.com/mbox/",
    "series": [
        {
            "id": 21042,
            "url": "http://patchwork.dpdk.org/api/series/21042/?format=api",
            "web_url": "http://patchwork.dpdk.org/project/dpdk/list/?series=21042",
            "date": "2021-12-30T14:37:38",
            "name": "Fast restart with many hugepages",
            "version": 1,
            "mbox": "http://patchwork.dpdk.org/series/21042/mbox/"
        }
    ],
    "comments": "http://patchwork.dpdk.org/api/patches/105534/comments/",
    "check": "warning",
    "checks": "http://patchwork.dpdk.org/api/patches/105534/checks/",
    "tags": {},
    "related": [],
    "headers": {
        "Return-Path": "<dev-bounces@dpdk.org>",
        "X-Original-To": "patchwork@inbox.dpdk.org",
        "Delivered-To": "patchwork@inbox.dpdk.org",
        "Received": [
            "from mails.dpdk.org (mails.dpdk.org [217.70.189.124])\n\tby inbox.dpdk.org (Postfix) with ESMTP id 5951EA04A5;\n\tThu, 30 Dec 2021 15:48:56 +0100 (CET)",
            "from [217.70.189.124] (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id E04FE410F1;\n\tThu, 30 Dec 2021 15:48:55 +0100 (CET)",
            "from NAM12-MW2-obe.outbound.protection.outlook.com\n (mail-mw2nam12on2086.outbound.protection.outlook.com [40.107.244.86])\n by mails.dpdk.org (Postfix) with ESMTP id 295D440F35\n for <dev@dpdk.org>; Thu, 30 Dec 2021 15:48:55 +0100 (CET)",
            "from DM5PR21CA0068.namprd21.prod.outlook.com (2603:10b6:3:129::30)\n by BL1PR12MB5287.namprd12.prod.outlook.com (2603:10b6:208:317::12) with\n Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4823.19; Thu, 30 Dec\n 2021 14:48:53 +0000",
            "from DM6NAM11FT060.eop-nam11.prod.protection.outlook.com\n (2603:10b6:3:129:cafe::b1) by DM5PR21CA0068.outlook.office365.com\n (2603:10b6:3:129::30) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4867.3 via Frontend\n Transport; Thu, 30 Dec 2021 14:48:53 +0000",
            "from mail.nvidia.com (12.22.5.234) by\n DM6NAM11FT060.mail.protection.outlook.com (10.13.173.63) with Microsoft SMTP\n Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id\n 15.20.4844.14 via Frontend Transport; Thu, 30 Dec 2021 14:48:52 +0000",
            "from rnnvmail201.nvidia.com (10.129.68.8) by DRHQMAIL101.nvidia.com\n (10.27.9.10) with Microsoft SMTP Server (TLS) id 15.0.1497.18;\n Thu, 30 Dec 2021 14:48:52 +0000",
            "from nvidia.com (172.20.187.6) by rnnvmail201.nvidia.com\n (10.129.68.8) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id 15.2.986.9; Thu, 30 Dec 2021\n 06:48:51 -0800"
        ],
        "ARC-Seal": "i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none;\n b=LukjQOCAPrDi6xcUaYKhKGJsrYauOTxSBHacvURdFTTe28jrD/0YG4ueqr1bRvtysQ7DvXI6AoNakKXVsy1excy3JlMtubY3oXVdm/bYR6aDVadnWFAqBNW9FYSNtkfT5icd3DWGrBQdy4vJ8hq1nyn6ih4vJzi+40YlH/kZN3sBuMN+xvEBsrv99wK2tW+4UmJvCfAJXEn2gC0nxW6upiHq+PH7TQUrw2SPhtmZ6XpbOBsfn+oP2bxGKDEfrGlKLI6lDXcoMWxpUrJnifrBx9dlnNYDrdz/nTO9KEz1y7H61yZUMUhNXTEsBwV+C42ZyHXMCJPERGIbSQSPUKDDFw==",
        "ARC-Message-Signature": "i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com;\n s=arcselector9901;\n h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1;\n bh=YNex9xojSORQQ5vrHy0+qa4ydSeStw/7eFu+Ayts7yE=;\n b=Vh5VS653pmTu0QiqHzrdJH1mbRqjvOemZj0rOBnH8HP7LRad0Rucp7m4MUuykiIPOxjoH6lod5Z/uBsmOhzd8tFQVCcdFXoolabG3Xpiz3KzTgu2CH8mqseW6Z/o/GnfG4yUrISuaRZznAUCANIzBgbLtqvTntFo/LfzhkSj9JwB0YaacKRTN5/pRk2nP9bQXnQtloGp0gdkW/N7rXylgyn42tGOk+1kYZk7qVlj1jU6HnHtsn3Y1mIoqVo96LW2ZpFnEgEW2e1dc0B7mpjvh5pFDSOZ7R7MCK/yL4ROQBQa8/d5DjWqNpIs+ZF7B3ygrCJPRazLtu97W16tki59Ow==",
        "ARC-Authentication-Results": "i=1; mx.microsoft.com 1; spf=pass (sender ip is\n 12.22.5.234) smtp.rcpttodomain=intel.com smtp.mailfrom=nvidia.com; dmarc=pass\n (p=reject sp=reject pct=100) action=none header.from=nvidia.com; dkim=none\n (message not signed); arc=none",
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=Nvidia.com;\n s=selector2;\n h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck;\n bh=YNex9xojSORQQ5vrHy0+qa4ydSeStw/7eFu+Ayts7yE=;\n b=kJ1QCh6diHI3CFGYq+c7oNoz5gKT919XrN6bsWmkwAzVsRuF+ZJorsY0S0LZ8RMTxAiddlLPWjUj6AO8zgxg5qFtkwShFCAp1y1AttD4vkON0YBIkQ0kKfRedbWhDXGjJegrhHQkNWbITfJygySgwD//NLvLKfnYhn5yHVKWtCtqczSQQDXUSCsSP0tD03iHLyTGQl7PEyS74XnZ9yiWNgq46j0QO5gI/sl1DfwD1mGjZUSQmP4Yv8iwFDTgTGsKkoek0E+PNOXBWk4WctfUjviVHhXKiXof3GyvsjRklYJ4jE5kwuf6hLriN+wJrO4k1QGEtVbB4DzyK+45OPU+6g==",
        "X-MS-Exchange-Authentication-Results": "spf=pass (sender IP is 12.22.5.234)\n smtp.mailfrom=nvidia.com; dkim=none (message not signed)\n header.d=none;dmarc=pass action=none header.from=nvidia.com;",
        "Received-SPF": "Pass (protection.outlook.com: domain of nvidia.com designates\n 12.22.5.234 as permitted sender) receiver=protection.outlook.com;\n client-ip=12.22.5.234; helo=mail.nvidia.com;",
        "From": "Dmitry Kozlyuk <dkozlyuk@nvidia.com>",
        "To": "<dev@dpdk.org>",
        "CC": "Anatoly Burakov <anatoly.burakov@intel.com>",
        "Subject": "[RFC PATCH 5/6] eal: allow hugepage file reuse with --huge-unlink",
        "Date": "Thu, 30 Dec 2021 16:48:28 +0200",
        "Message-ID": "<20211230144828.3550807-1-dkozlyuk@nvidia.com>",
        "X-Mailer": "git-send-email 2.25.1",
        "In-Reply-To": "<20211230143744.3550098-1-dkozlyuk@nvidia.com>",
        "References": "<20211230143744.3550098-1-dkozlyuk@nvidia.com>",
        "MIME-Version": "1.0",
        "Content-Transfer-Encoding": "8bit",
        "Content-Type": "text/plain",
        "X-Originating-IP": "[172.20.187.6]",
        "X-ClientProxiedBy": "HQMAIL111.nvidia.com (172.20.187.18) To\n rnnvmail201.nvidia.com (10.129.68.8)",
        "X-EOPAttributedMessage": "0",
        "X-MS-PublicTrafficType": "Email",
        "X-MS-Office365-Filtering-Correlation-Id": "a1a00c35-f250-4d50-2f6b-08d9cba37f98",
        "X-MS-TrafficTypeDiagnostic": "BL1PR12MB5287:EE_",
        "X-Microsoft-Antispam-PRVS": "\n <BL1PR12MB5287C5390ACF89ADC4E6CE59B9459@BL1PR12MB5287.namprd12.prod.outlook.com>",
        "X-MS-Oob-TLC-OOBClassifiers": "OLM:8882;",
        "X-MS-Exchange-SenderADCheck": "1",
        "X-MS-Exchange-AntiSpam-Relay": "0",
        "X-Microsoft-Antispam": "BCL:0;",
        "X-Microsoft-Antispam-Message-Info": "\n ZfcYdjo6y+0/VBIFU4hG7we8WUOUMs3+jaqXWsz8kIAaU3CAl/gL+Kp48VElH7AI7kfujTvRaIiCdL65J3qZlAC1DkrobLkdt9llUPOn/wNbRM4L8pIWIklaRyjKc8Xa8CDENnKGrwqDZBd6iW8Xqd0Yfn+uhXCFYvmlahjyM4AXsNKbMlsa/8wPljuSnSGhzLJg8ZALqcmRlIIurjNWml7YCj9c8QzSNwOeuw7i2nYFjN70CISe4jftw/WGr/NVjP+nRwzXSVJzaLOfjYR3DNaaeGS20/RckOvlxry/e4o2rJ/nTgNRNTwpo4t5nx5lYXVZv5uVgYioKeQvhuvBLEPRkK9DC6Rzpp/OfzwRm0bpATe09IqDTgwLKk6rRQdiHu/uOEXj2z0ceIYw5SrEsPfqSOAp3P6oWoLAaIehcQ+aA3ZmT0u5SvaOiZ7XAiQU0ol4ttFML+L344MtkUypVW/iUfLPfHynryCfMB774C0UFq9p+YmjPZwpJftKF4V61jFSyE5opjU+ay0NWaSlkJICTKaRuKhaR93twE29AiPQqMu6t/HoN7aYlWH+Nkp91kVfG6a7yB5EvYwYUqO9e8zMd1eyjRUquKW4KHKZKhanxFXq2CgoLf+8kLNg0Pl4KyAdJuQhiDjbHVxwfjnYIZ2IehZ4mg0IfhaH7+MnlfGZzC2yKiq5wKjgrdCRPHAHgIPhb9h/jJIW9jERlGSyqU+cenKZwh5yeYyFdcuLQWEhogIJ1wSLn4OY3YZLU/puXRpJeWKGw0KMEA7YO2fuVSJyt4fz0ZDc04aBfGG3PeFUNDeTkONInuuCRIthEK+d6nfqeQK6+GCHzSFCg5nn0A==",
        "X-Forefront-Antispam-Report": "CIP:12.22.5.234; CTRY:US; LANG:en; SCL:1; SRV:;\n IPV:CAL; SFV:NSPM; H:mail.nvidia.com; PTR:InfoNoRecords; CAT:NONE;\n SFS:(4636009)(46966006)(36840700001)(40470700002)(316002)(2906002)(36756003)(5660300002)(1076003)(6916009)(47076005)(70586007)(508600001)(6666004)(86362001)(2616005)(186003)(4326008)(83380400001)(426003)(55016003)(336012)(40460700001)(82310400004)(81166007)(6286002)(8936002)(356005)(8676002)(16526019)(7696005)(36860700001)(26005)(70206006)(14583001)(36900700001);\n DIR:OUT; SFP:1101;",
        "X-OriginatorOrg": "Nvidia.com",
        "X-MS-Exchange-CrossTenant-OriginalArrivalTime": "30 Dec 2021 14:48:52.9017 (UTC)",
        "X-MS-Exchange-CrossTenant-Network-Message-Id": "\n a1a00c35-f250-4d50-2f6b-08d9cba37f98",
        "X-MS-Exchange-CrossTenant-Id": "43083d15-7273-40c1-b7db-39efd9ccc17a",
        "X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp": "\n TenantId=43083d15-7273-40c1-b7db-39efd9ccc17a; Ip=[12.22.5.234];\n Helo=[mail.nvidia.com]",
        "X-MS-Exchange-CrossTenant-AuthSource": "\n DM6NAM11FT060.eop-nam11.prod.protection.outlook.com",
        "X-MS-Exchange-CrossTenant-AuthAs": "Anonymous",
        "X-MS-Exchange-CrossTenant-FromEntityHeader": "HybridOnPrem",
        "X-MS-Exchange-Transport-CrossTenantHeadersStamped": "BL1PR12MB5287",
        "X-BeenThere": "dev@dpdk.org",
        "X-Mailman-Version": "2.1.29",
        "Precedence": "list",
        "List-Id": "DPDK patches and discussions <dev.dpdk.org>",
        "List-Unsubscribe": "<https://mails.dpdk.org/options/dev>,\n <mailto:dev-request@dpdk.org?subject=unsubscribe>",
        "List-Archive": "<http://mails.dpdk.org/archives/dev/>",
        "List-Post": "<mailto:dev@dpdk.org>",
        "List-Help": "<mailto:dev-request@dpdk.org?subject=help>",
        "List-Subscribe": "<https://mails.dpdk.org/listinfo/dev>,\n <mailto:dev-request@dpdk.org?subject=subscribe>",
        "Errors-To": "dev-bounces@dpdk.org"
    },
    "content": "Expose Linux EAL ability to reuse existing hugepage files\nvia --huge-unlink=never switch.\nDefault behavior is unchanged, it can also be specified\nusing --huge-unlink=existing for consistency.\nOld --huge-unlink switch is kept,\nit is an alias for --huge-unlink=always.\n\nSigned-off-by: Dmitry Kozlyuk <dkozlyuk@nvidia.com>\n---\n doc/guides/linux_gsg/linux_eal_parameters.rst | 21 ++++++++--\n .../prog_guide/env_abstraction_layer.rst      |  9 +++++\n doc/guides/rel_notes/release_22_03.rst        |  7 ++++\n lib/eal/common/eal_common_options.c           | 39 +++++++++++++++++--\n 4 files changed, 69 insertions(+), 7 deletions(-)",
    "diff": "diff --git a/doc/guides/linux_gsg/linux_eal_parameters.rst b/doc/guides/linux_gsg/linux_eal_parameters.rst\nindex 74df2611b5..64cd73b497 100644\n--- a/doc/guides/linux_gsg/linux_eal_parameters.rst\n+++ b/doc/guides/linux_gsg/linux_eal_parameters.rst\n@@ -84,10 +84,23 @@ Memory-related options\n     Use specified hugetlbfs directory instead of autodetected ones. This can be\n     a sub-directory within a hugetlbfs mountpoint.\n \n-*   ``--huge-unlink``\n-\n-    Unlink hugepage files after creating them (implies no secondary process\n-    support).\n+*   ``--huge-unlink[=existing|always|never]``\n+\n+    No ``--huge-unlink`` option or ``--huge-unlink=existing`` is the default:\n+    existing hugepage files are removed and re-created\n+    to ensure the kernel clears the memory and prevents any data leaks.\n+\n+    With ``--huge-unlink`` (no value) or ``--huge-unlink=always``,\n+    hugepage files are also removed after creating them,\n+    so that the application leaves no files in hugetlbfs.\n+    This mode implies no multi-process support.\n+\n+    When ``--huge-unlink=never`` is specified, existing hugepage files\n+    are not removed neither before nor after mapping them.\n+    This makes restart faster by saving time to clear memory at initialization,\n+    but it may slow down zeroed allocations later.\n+    Reused hugepages can contain data from previous processes that used them,\n+    which may be a security concern.\n \n *   ``--match-allocations``\n \ndiff --git a/doc/guides/prog_guide/env_abstraction_layer.rst b/doc/guides/prog_guide/env_abstraction_layer.rst\nindex 6cddb86467..d8940f5e2e 100644\n--- a/doc/guides/prog_guide/env_abstraction_layer.rst\n+++ b/doc/guides/prog_guide/env_abstraction_layer.rst\n@@ -277,6 +277,15 @@ to prevent data leaks from previous users of the same hugepage.\n EAL ensures this behavior by removing existing backing files at startup\n and by recreating them before opening for mapping (as a precaution).\n \n+One expection is ``--huge-unlink=never`` mode.\n+It is used to speed up EAL initialization, usually on application restart.\n+Clearing memory constitutes more than 95% of hugepage mapping time.\n+EAL can save it by remapping existing backing files\n+with all the data left in the mapped hugepages (\"dirty\" memory).\n+Such segments are marked with ``RTE_MEMSEG_FLAG_DIRTY``.\n+Memory allocator detects dirty segments handles them accordingly,\n+in particular, it clears memory requested with ``rte_zmalloc*()``.\n+\n Anonymous mapping does not allow multi-process architecture,\n but it is free of filename conflicts and leftover files on hugetlbfs.\n If memfd_create(2) is supported both at build and run time,\ndiff --git a/doc/guides/rel_notes/release_22_03.rst b/doc/guides/rel_notes/release_22_03.rst\nindex 6d99d1eaa9..0b882362cf 100644\n--- a/doc/guides/rel_notes/release_22_03.rst\n+++ b/doc/guides/rel_notes/release_22_03.rst\n@@ -55,6 +55,13 @@ New Features\n      Also, make sure to start the actual text at the margin.\n      =======================================================\n \n+* **Added ability to reuse hugepages in Linux.**\n+\n+  It is possible to reuse files in hugetlbfs to speed up hugepage mapping,\n+  which may be useful for fast restart and large allocations.\n+  The new mode is activated with ``--huge-unlink=never``\n+  and has security implications, refer to the user and programmer guides.\n+\n \n Removed Items\n -------------\ndiff --git a/lib/eal/common/eal_common_options.c b/lib/eal/common/eal_common_options.c\nindex 7520ebda8e..905a7769bd 100644\n--- a/lib/eal/common/eal_common_options.c\n+++ b/lib/eal/common/eal_common_options.c\n@@ -74,7 +74,7 @@ eal_long_options[] = {\n \t{OPT_FILE_PREFIX,       1, NULL, OPT_FILE_PREFIX_NUM      },\n \t{OPT_HELP,              0, NULL, OPT_HELP_NUM             },\n \t{OPT_HUGE_DIR,          1, NULL, OPT_HUGE_DIR_NUM         },\n-\t{OPT_HUGE_UNLINK,       0, NULL, OPT_HUGE_UNLINK_NUM      },\n+\t{OPT_HUGE_UNLINK,       2, NULL, OPT_HUGE_UNLINK_NUM      },\n \t{OPT_IOVA_MODE,\t        1, NULL, OPT_IOVA_MODE_NUM        },\n \t{OPT_LCORES,            1, NULL, OPT_LCORES_NUM           },\n \t{OPT_LOG_LEVEL,         1, NULL, OPT_LOG_LEVEL_NUM        },\n@@ -1596,6 +1596,28 @@ available_cores(void)\n \treturn str;\n }\n \n+#define HUGE_UNLINK_NEVER \"never\"\n+\n+static int\n+eal_parse_huge_unlink(const char *arg, struct hugepage_file_discipline *out)\n+{\n+\tif (arg == NULL || strcmp(arg, \"always\") == 0) {\n+\t\tout->unlink_before_mapping = true;\n+\t\treturn 0;\n+\t}\n+\tif (strcmp(arg, \"existing\") == 0) {\n+\t\t/* same as not specifying the option */\n+\t\treturn 0;\n+\t}\n+\tif (strcmp(arg, HUGE_UNLINK_NEVER) == 0) {\n+\t\tRTE_LOG(WARNING, EAL, \"Using --\"OPT_HUGE_UNLINK\"=\"\n+\t\t\tHUGE_UNLINK_NEVER\" may create data leaks.\\n\");\n+\t\tout->keep_existing = true;\n+\t\treturn 0;\n+\t}\n+\treturn -1;\n+}\n+\n int\n eal_parse_common_option(int opt, const char *optarg,\n \t\t\tstruct internal_config *conf)\n@@ -1737,7 +1759,10 @@ eal_parse_common_option(int opt, const char *optarg,\n \n \t/* long options */\n \tcase OPT_HUGE_UNLINK_NUM:\n-\t\tconf->hugepage_file.unlink_before_mapping = true;\n+\t\tif (eal_parse_huge_unlink(optarg, &conf->hugepage_file) < 0) {\n+\t\t\tRTE_LOG(ERR, EAL, \"invalid --\"OPT_HUGE_UNLINK\" option\\n\");\n+\t\t\treturn -1;\n+\t\t}\n \t\tbreak;\n \n \tcase OPT_NO_HUGE_NUM:\n@@ -2068,6 +2093,12 @@ eal_check_common_options(struct internal_config *internal_cfg)\n \t\t\t\"not compatible with --\"OPT_HUGE_UNLINK\"\\n\");\n \t\treturn -1;\n \t}\n+\tif (internal_cfg->hugepage_file.keep_existing &&\n+\t\t\tinternal_cfg->in_memory) {\n+\t\tRTE_LOG(ERR, EAL, \"Option --\"OPT_IN_MEMORY\" is not compatible \"\n+\t\t\t\"with --\"OPT_HUGE_UNLINK\"=\"HUGE_UNLINK_NEVER\"\\n\");\n+\t\treturn -1;\n+\t}\n \tif (internal_cfg->legacy_mem &&\n \t\t\tinternal_cfg->in_memory) {\n \t\tRTE_LOG(ERR, EAL, \"Option --\"OPT_LEGACY_MEM\" is not compatible \"\n@@ -2200,7 +2231,9 @@ eal_common_usage(void)\n \t       \"  --\"OPT_NO_TELEMETRY\"   Disable telemetry support\\n\"\n \t       \"  --\"OPT_FORCE_MAX_SIMD_BITWIDTH\" Force the max SIMD bitwidth\\n\"\n \t       \"\\nEAL options for DEBUG use only:\\n\"\n-\t       \"  --\"OPT_HUGE_UNLINK\"       Unlink hugepage files after init\\n\"\n+\t       \"  --\"OPT_HUGE_UNLINK\"[=existing|always|never]\\n\"\n+\t       \"                      When to unlink files in hugetlbfs\\n\"\n+\t       \"                      ('existing' by default, no value means 'always')\\n\"\n \t       \"  --\"OPT_NO_HUGE\"           Use malloc instead of hugetlbfs\\n\"\n \t       \"  --\"OPT_NO_PCI\"            Disable PCI\\n\"\n \t       \"  --\"OPT_NO_HPET\"           Disable HPET\\n\"\n",
    "prefixes": [
        "RFC",
        "5/6"
    ]
}