Show a cover letter.

GET /api/covers/898/?format=api
HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "id": 898,
    "url": "http://patchwork.dpdk.org/api/covers/898/?format=api",
    "web_url": "http://patchwork.dpdk.org/project/dpdk/cover/20240430184533.29247-4-npratte@iol.unh.edu/",
    "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": "<20240430184533.29247-4-npratte@iol.unh.edu>",
    "list_archive_url": "https://inbox.dpdk.org/dev/20240430184533.29247-4-npratte@iol.unh.edu",
    "date": "2024-04-30T18:45:34",
    "name": "[v5,0/2] Methodology change for hugepage configuration",
    "submitter": {
        "id": 3281,
        "url": "http://patchwork.dpdk.org/api/people/3281/?format=api",
        "name": "Nicholas Pratte",
        "email": "npratte@iol.unh.edu"
    },
    "mbox": "http://patchwork.dpdk.org/project/dpdk/cover/20240430184533.29247-4-npratte@iol.unh.edu/mbox/",
    "series": [
        {
            "id": 31848,
            "url": "http://patchwork.dpdk.org/api/series/31848/?format=api",
            "web_url": "http://patchwork.dpdk.org/project/dpdk/list/?series=31848",
            "date": "2024-04-30T18:45:34",
            "name": "Methodology change for hugepage configuration",
            "version": 5,
            "mbox": "http://patchwork.dpdk.org/series/31848/mbox/"
        }
    ],
    "comments": "http://patchwork.dpdk.org/api/covers/898/comments/",
    "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 2D1CD43F32;\n\tTue, 30 Apr 2024 20:48:11 +0200 (CEST)",
            "from mails.dpdk.org (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 84034402C7;\n\tTue, 30 Apr 2024 20:48:00 +0200 (CEST)",
            "from mail-qv1-f49.google.com (mail-qv1-f49.google.com\n [209.85.219.49]) by mails.dpdk.org (Postfix) with ESMTP id 0857F402C0\n for <dev@dpdk.org>; Tue, 30 Apr 2024 20:47:59 +0200 (CEST)",
            "by mail-qv1-f49.google.com with SMTP id\n 6a1803df08f44-6a0d274e631so3389826d6.1\n for <dev@dpdk.org>; Tue, 30 Apr 2024 11:47:58 -0700 (PDT)",
            "from d121012.iol.unh.edu ([2606:4100:3880:1271:e2f8:4ec3:8bf3:864c])\n by smtp.gmail.com with ESMTPSA id\n dj14-20020a05622a4e8e00b0043ae234c0f2sm2182479qtb.36.2024.04.30.11.47.57\n (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);\n Tue, 30 Apr 2024 11:47:58 -0700 (PDT)"
        ],
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=iol.unh.edu; s=unh-iol; t=1714502878; x=1715107678; darn=dpdk.org;\n h=content-transfer-encoding:mime-version:references:in-reply-to\n :message-id:date:subject:cc:to:from:from:to:cc:subject:date\n :message-id:reply-to;\n bh=PEosgovwpCzEWBzbGzfaahlDTKIYXedTUTkpimZty1g=;\n b=UOniwwCVJq42BI6wPtGU4I+3K3iHCv4rjpQqeDL3xXSgfSs6wrqw9f7yQspNJqfDj3\n i2LyDVQYFrUMGuT2APMtLnbDE7NUPOIuAliP8ftoaful02i0mFDxlvRgSndmZL/GDqNl\n EEAhVT0Tr/EwiOliAbwRmZz3KTDqBLJXpDZ/Q=",
        "X-Google-DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=1e100.net; s=20230601; t=1714502878; x=1715107678;\n h=content-transfer-encoding:mime-version:references:in-reply-to\n :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc\n :subject:date:message-id:reply-to;\n bh=PEosgovwpCzEWBzbGzfaahlDTKIYXedTUTkpimZty1g=;\n b=hJsV8kt6wW2uPpxuXMfdNbLD1N3EUQHpDxol02dCcdlhHdhFYBk4hEHlMDq4+wofUw\n nvWZzXvpRjFbsqNFMM+H79fnwCHmWk4BHxtvLoi4qEassoyjVkol8F7JVCvGoG9m/y/n\n PN+YQ7gmt6rg0KUndiqVhR6Kf2fBNNTBcgZHlJUc6eHbeETvL3EWIjh+TUBIzmeJ5faf\n dKLJ+b7ksjdxe2rPn/FsGoRGpjVW0uRKTECMwL244OYd1MHJdIWA0y2uWGFdSBB5iICx\n oHqkrS2nRpllLYeL44UndcaGhywis3YEq8ETouiFnTBMJ7IwsNDB3aAjNKSJRs7jKMpA\n cwOA==",
        "X-Gm-Message-State": "AOJu0YzmhwjtDpCTKWBuKkr7mNvwEZCtHX9K81CUc+cDNKJx6bMsYjKC\n 4g48PXhMxzR3F/zyFq+ZjH/t5Aefpdg/8zRITkIba/gP8IXskDwb2iPSevOAyVs=",
        "X-Google-Smtp-Source": "\n AGHT+IHEeE3In8OHNMYdhS+owNHGanYQVXnmq1M0qI0WMKhWvaB+luWLzzMFhMAoJYDgsgPH/lj0bQ==",
        "X-Received": "by 2002:a05:622a:1910:b0:439:ecc6:cdff with SMTP id\n w16-20020a05622a191000b00439ecc6cdffmr173405qtc.1.1714502878432;\n Tue, 30 Apr 2024 11:47:58 -0700 (PDT)",
        "From": "Nicholas Pratte <npratte@iol.unh.edu>",
        "To": "\"jspewock@iol.unh.edumb@smartsharesystems.combruce.richardson\"@intel.com,\n\tyoan.picchi@foss.arm.com, juraj.linkes@pantheon.tech,\n\tpaul.szczepanek@arm.com, wathsala.vithanage@arm.com,\n\tthomas@monjalon.net, Honnappa.Nagarahalli@arm.com, probb@iol.unh.edu",
        "Cc": "dev@dpdk.org,\n\tNicholas Pratte <npratte@iol.unh.edu>",
        "Subject": "[PATCH v5 0/2] Methodology change for hugepage configuration",
        "Date": "Tue, 30 Apr 2024 14:45:34 -0400",
        "Message-ID": "<20240430184533.29247-4-npratte@iol.unh.edu>",
        "X-Mailer": "git-send-email 2.44.0",
        "In-Reply-To": "<20240430184533.29247-2-npratte@iol.unh.edu>",
        "References": "<20240430184533.29247-2-npratte@iol.unh.edu>",
        "MIME-Version": "1.0",
        "Content-Transfer-Encoding": "8bit",
        "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": "In order to prevent accidental misconfiguration of hugepages at runtime,\nthe following changes are made to only allow for configuration of 2MB\nhugepages within the DTS config.yaml. In the previous implementation, a\ndefault hugepage size was selected via the size listed in /proc/meminfo.\nThe problem with this implementation is that, assuming the end-user has\nmade prior modifications to the system, /proc/meminfo may default to\nhugepage sizes that are not recommended to be configured at runtime\n(i.e. 1GB hugepages). This can lead to two problems: overallocation of\nhugepages (which may crash the remote host) configuration of hugepages\nsizes that are not recommended during runtime. In this new implementation,\nwe stipulate that any runtime hugepage configuration size that is not 2MB\nis considered an outlier. If the end-user would like to configure either \n1GB hugepages or any unique hugepage size outside of 2MB, then they should \nmake these configurations either at startup (in the case of 1GB hugepages) \nor runtime outside of DTS configuration (if a user would like hugepages\nthat are not 2MB). In either case, the expectation is that, if wish to\nuse hugepage sizes that are not 2MB, you will make these changes outside\nand prior to the initialization of DTS.\n    \nThe end-user has two options: remove the option for hugepage\nconfiguration in the conf.yaml, or keep the option and specify the\namount of 2MB hugepages desired. In the case of the former, then we assume\nthat hugepages are already configured prior to DTS initialization. In\nthe latter case, the user must define the amount of 2MB hugepages to be\nconfigured at runtime. If the amount of 2MB hugepages requested exceeds\nthe amount of 2MB hugepages already configured on the system, then the\nsystem will remount hugepages to cover the difference. If the amount of\nhugepages requested is either greater than or equal to the amount\nalready configured on the system, then nothing is done.\n\nNicholas Pratte (2):\n  dts: Change hugepage runtime config to 2MB Exclusively\n  dts: Change hugepage 'amount' to a different term\n\n doc/guides/tools/dts.rst                     |  6 ++++-\n dts/conf.yaml                                |  8 +++---\n dts/framework/config/__init__.py             |  8 +++---\n dts/framework/config/conf_yaml_schema.json   | 12 ++++-----\n dts/framework/config/types.py                |  4 +--\n dts/framework/testbed_model/linux_session.py | 28 +++++++++++---------\n dts/framework/testbed_model/node.py          |  4 ++-\n dts/framework/testbed_model/os_session.py    |  7 ++++-\n 8 files changed, 45 insertions(+), 32 deletions(-)"
}