Show a cover letter.

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

{
    "id": 54771,
    "url": "http://patches.dpdk.org/api/covers/54771/?format=api",
    "web_url": "http://patches.dpdk.org/cover/54771/",
    "project": {
        "id": 1,
        "url": "http://patches.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"
    },
    "msgid": "<20190613142344.9188-1-nhorman@tuxdriver.com>",
    "date": "2019-06-13T14:23:34",
    "name": "[v2,0/10] dpdk: introduce __rte_internal tag",
    "submitter": {
        "id": 32,
        "url": "http://patches.dpdk.org/api/people/32/?format=api",
        "name": "Neil Horman",
        "email": "nhorman@tuxdriver.com"
    },
    "mbox": "http://patches.dpdk.org/cover/54771/mbox/",
    "series": [
        {
            "id": 5004,
            "url": "http://patches.dpdk.org/api/series/5004/?format=api",
            "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=5004",
            "date": "2019-06-13T14:23:34",
            "name": "dpdk: introduce __rte_internal tag",
            "version": 2,
            "mbox": "http://patches.dpdk.org/series/5004/mbox/"
        }
    ],
    "comments": "http://patches.dpdk.org/api/covers/54771/comments/",
    "headers": {
        "X-Mailer": "git-send-email 2.20.1",
        "List-Id": "DPDK patches and discussions <dev.dpdk.org>",
        "From": "Neil Horman <nhorman@tuxdriver.com>",
        "List-Help": "<mailto:dev-request@dpdk.org?subject=help>",
        "Date": "Thu, 13 Jun 2019 10:23:34 -0400",
        "X-Mailman-Version": "2.1.15",
        "Delivered-To": "patchwork@dpdk.org",
        "List-Subscribe": "<https://mails.dpdk.org/listinfo/dev>,\n\t<mailto:dev-request@dpdk.org?subject=subscribe>",
        "Cc": "Neil Horman <nhorman@tuxdriver.com>,\n\tJerin Jacob Kollanukkaran <jerinj@marvell.com>,\n\tBruce Richardson <bruce.richardson@intel.com>,\n\tThomas Monjalon <thomas@monjalon.net>",
        "To": "dev@dpdk.org",
        "Errors-To": "dev-bounces@dpdk.org",
        "References": "<20190525184346.27932-1-nhorman@tuxdriver.com>",
        "Content-Transfer-Encoding": "8bit",
        "Return-Path": "<dev-bounces@dpdk.org>",
        "List-Unsubscribe": "<https://mails.dpdk.org/options/dev>,\n\t<mailto:dev-request@dpdk.org?subject=unsubscribe>",
        "List-Post": "<mailto:dev@dpdk.org>",
        "Received": [
            "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id 7192B1D5E6;\n\tThu, 13 Jun 2019 16:24:01 +0200 (CEST)",
            "from smtp.tuxdriver.com (charlotte.tuxdriver.com [70.61.120.58])\n\tby dpdk.org (Postfix) with ESMTP id B1D5E1D5E0\n\tfor <dev@dpdk.org>; Thu, 13 Jun 2019 16:23:59 +0200 (CEST)",
            "from [107.15.85.130] (helo=hmswarspite.think-freely.org)\n\tby smtp.tuxdriver.com with esmtpsa (TLSv1:AES256-SHA:256) (Exim 4.63)\n\t(envelope-from <nhorman@tuxdriver.com>)\n\tid 1hbQdt-0000fv-JK; Thu, 13 Jun 2019 10:23:56 -0400",
            "from hmswarspite.think-freely.org (localhost [127.0.0.1])\n\tby hmswarspite.think-freely.org (8.15.2/8.15.2) with ESMTP id\n\tx5DENlK9009315; Thu, 13 Jun 2019 10:23:47 -0400",
            "(from nhorman@localhost)\n\tby hmswarspite.think-freely.org (8.15.2/8.15.2/Submit) id\n\tx5DENkKj009314; Thu, 13 Jun 2019 10:23:46 -0400"
        ],
        "List-Archive": "<http://mails.dpdk.org/archives/dev/>",
        "Sender": "\"dev\" <dev-bounces@dpdk.org>",
        "Subject": "[dpdk-dev] [PATCH v2 0/10] dpdk: introduce __rte_internal tag",
        "In-Reply-To": "<20190525184346.27932-1-nhorman@tuxdriver.com>",
        "MIME-Version": "1.0",
        "Message-Id": "<20190613142344.9188-1-nhorman@tuxdriver.com>",
        "X-Spam-Score": "-2.9 (--)",
        "Precedence": "list",
        "X-Spam-Status": "No",
        "X-BeenThere": "dev@dpdk.org",
        "X-Original-To": "patchwork@dpdk.org"
    },
    "content": "Hey-\n        Based on our recent conversations regarding the use of symbols only\nmeant for internal dpdk consumption (between dpdk libraries), this is an idea\nthat I've come up with that I'd like to get some feedback on\n\nSummary:\n1) We have symbols in the DPDK that are meant to be used between DPDK libraries,\nbut not by applications linking to them\n2) We would like to document those symbols in the code, so as to note them\nclearly as for being meant for internal use only\n3) Linker symbol visibility is a very coarse grained tool, and so there is no\ngood way in a single library to mark items as being meant for use only by other\nDPDK libraries, at least not without some extensive runtime checking\n\n\nProposal:\nI'm proposing that we introduce the __rte_internal tag.  From a coding\nstandpoint it works a great deal like the __rte_experimental tag in that it\nexpempts the tagged symbol from ABI constraints (as the only users should be\nrepresented in the DPDK build environment).  Additionally, the __rte_internal\nmacro resolves differently based on the definition of the BUILDING_RTE_SDK flag\n(working under the assumption that said flag should only ever be set if we are\nactually building DPDK libraries which will make use of internal calls).  If the\nBUILDING_RTE_SDK flag is set __rte_internal resolves to __attribute__((section\n\"text.internal)), placing it in a special text section which is then used to\nvalidate that the the symbol appears in the INTERNAL section of the\ncorresponding library version map).  If BUILDING_RTE_SDK is not set, then\n__rte_internal resolves to __attribute__((error(\"...\"))), which causes any\ncaller of the tagged function to throw an error at compile time, indicating that\nthe symbol is not available for external use.\n\nThis isn't a perfect solution, as applications can still hack around it of\ncourse, but I think it hits some of the high points, restricting symbol access\nfor any library that prototypes its public and private symbols in the same\nheader file, excluding the internal symbols from ABI constraints, and clearly\ndocumenting those symbols which we wish to limit to internal usage.\n\nSigned-off-by: Neil Horman <nhorman@tuxdriver.com>\nCC: Jerin Jacob Kollanukkaran <jerinj@marvell.com>\nCC: Bruce Richardson <bruce.richardson@intel.com>\nCC: Thomas Monjalon <thomas@monjalon.net>\n\n---\nChange notes\n\nv1->v2\nMoved check-experimental-syms.sh rename to earlier in the series\nUpdated meson build environment to support BUILDING_RTE_SDK"
}