Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/2196023/?format=api
{ "id": 2196023, "url": "http://patchwork.ozlabs.org/api/patches/2196023/?format=api", "web_url": "http://patchwork.ozlabs.org/project/glibc/patch/20260212182031.107003-2-eggert@cs.ucla.edu/", "project": { "id": 41, "url": "http://patchwork.ozlabs.org/api/projects/41/?format=api", "name": "GNU C Library", "link_name": "glibc", "list_id": "libc-alpha.sourceware.org", "list_email": "libc-alpha@sourceware.org", "web_url": "", "scm_url": "", "webscm_url": "", "list_archive_url": "", "list_archive_url_format": "", "commit_url_format": "" }, "msgid": "<20260212182031.107003-2-eggert@cs.ucla.edu>", "list_archive_url": null, "date": "2026-02-12T18:18:11", "name": "[v3,1/4] Document max_align_t", "commit_ref": null, "pull_url": null, "state": "new", "archived": false, "hash": "95bc61742d753b09250ad0ccca68316ffbee9cf3", "submitter": { "id": 4434, "url": "http://patchwork.ozlabs.org/api/people/4434/?format=api", "name": "Paul Eggert", "email": "eggert@CS.UCLA.EDU" }, "delegate": null, "mbox": "http://patchwork.ozlabs.org/project/glibc/patch/20260212182031.107003-2-eggert@cs.ucla.edu/mbox/", "series": [ { "id": 492003, "url": "http://patchwork.ozlabs.org/api/series/492003/?format=api", "web_url": "http://patchwork.ozlabs.org/project/glibc/list/?series=492003", "date": "2026-02-12T18:18:14", "name": "malloc doc fixes for alignment", "version": 3, "mbox": "http://patchwork.ozlabs.org/series/492003/mbox/" } ], "comments": "http://patchwork.ozlabs.org/api/patches/2196023/comments/", "check": "pending", "checks": "http://patchwork.ozlabs.org/api/patches/2196023/checks/", "tags": {}, "related": [], "headers": { "Return-Path": "<libc-alpha-bounces~incoming=patchwork.ozlabs.org@sourceware.org>", "X-Original-To": [ "incoming@patchwork.ozlabs.org", "libc-alpha@sourceware.org" ], "Delivered-To": [ "patchwork-incoming@legolas.ozlabs.org", "libc-alpha@sourceware.org" ], "Authentication-Results": [ "legolas.ozlabs.org;\n\tdkim=pass (2048-bit key;\n unprotected) header.d=cs.ucla.edu header.i=@cs.ucla.edu header.a=rsa-sha256\n header.s=9D0B346E-2AEB-11ED-9476-E14B719DCE6C header.b=QBNHFlH3;\n\tdkim-atps=neutral", "legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=sourceware.org\n (client-ip=2620:52:6:3111::32; helo=vm01.sourceware.org;\n envelope-from=libc-alpha-bounces~incoming=patchwork.ozlabs.org@sourceware.org;\n receiver=patchwork.ozlabs.org)", "sourceware.org;\n\tdkim=pass (2048-bit key,\n unprotected) header.d=cs.ucla.edu header.i=@cs.ucla.edu header.a=rsa-sha256\n header.s=9D0B346E-2AEB-11ED-9476-E14B719DCE6C header.b=QBNHFlH3", "sourceware.org;\n dmarc=pass (p=none dis=none) header.from=cs.ucla.edu", "sourceware.org; spf=pass smtp.mailfrom=cs.ucla.edu", "server2.sourceware.org;\n arc=none smtp.remote-ip=131.179.128.66", "mail.cs.ucla.edu (amavis); dkim=pass (2048-bit key)\n header.d=cs.ucla.edu" ], "Received": [ "from vm01.sourceware.org (vm01.sourceware.org\n [IPv6:2620:52:6:3111::32])\n\t(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n\t key-exchange x25519 server-signature ECDSA (secp384r1) server-digest SHA384)\n\t(No client certificate requested)\n\tby legolas.ozlabs.org (Postfix) with ESMTPS id 4fBkFh40JVz1xpY\n\tfor <incoming@patchwork.ozlabs.org>; Fri, 13 Feb 2026 05:23:36 +1100 (AEDT)", "from vm01.sourceware.org (localhost [127.0.0.1])\n\tby sourceware.org (Postfix) with ESMTP id 9EA194BA23FF\n\tfor <incoming@patchwork.ozlabs.org>; Thu, 12 Feb 2026 18:23:34 +0000 (GMT)", "from mail.cs.ucla.edu (mail.cs.ucla.edu [131.179.128.66])\n by sourceware.org (Postfix) with ESMTPS id DBE7D4BA23FE\n for <libc-alpha@sourceware.org>; Thu, 12 Feb 2026 18:20:57 +0000 (GMT)", "from localhost (localhost [127.0.0.1])\n by mail.cs.ucla.edu (Postfix) with ESMTP id 42F0C3C03E9ED;\n Thu, 12 Feb 2026 10:20:57 -0800 (PST)", "from mail.cs.ucla.edu ([127.0.0.1])\n by localhost (mail.cs.ucla.edu [127.0.0.1]) (amavis, port 10032) with ESMTP\n id rICZYSJ-n33G; Thu, 12 Feb 2026 10:20:57 -0800 (PST)", "from localhost (localhost [127.0.0.1])\n by mail.cs.ucla.edu (Postfix) with ESMTP id 1AC213C03E9EF;\n Thu, 12 Feb 2026 10:20:57 -0800 (PST)", "from mail.cs.ucla.edu ([127.0.0.1])\n by localhost (mail.cs.ucla.edu [127.0.0.1]) (amavis, port 10026) with ESMTP\n id 4HNAWHTwoPcC; Thu, 12 Feb 2026 10:20:57 -0800 (PST)", "from wing.home (47-154-25-30.fdr01.snmn.ca.ip.frontiernet.net\n [47.154.25.30])\n by mail.cs.ucla.edu (Postfix) with ESMTPSA id 01CBD3C03E9ED;\n Thu, 12 Feb 2026 10:20:57 -0800 (PST)" ], "DKIM-Filter": [ "OpenDKIM Filter v2.11.0 sourceware.org 9EA194BA23FF", "OpenDKIM Filter v2.11.0 sourceware.org DBE7D4BA23FE", "OpenDKIM Filter v2.10.3 mail.cs.ucla.edu 1AC213C03E9EF" ], "DMARC-Filter": "OpenDMARC Filter v1.4.2 sourceware.org DBE7D4BA23FE", "ARC-Filter": "OpenARC Filter v1.0.0 sourceware.org DBE7D4BA23FE", "ARC-Seal": "i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1770920458; cv=none;\n b=qvR9qDhKHVMbb0nPkpo9EB5Lw0kKbsyPafFCWOgQq9qXewnwBvt7GryiHzOoSILl65YAoySUX2AZFu4gws4ES2YujQlndcOvXipPm/owI/LNO1IFTPARY5D5dVbJ5vEv0hF7Zxa+tPqRR28JsWu+rywQxY9l5xkrX79EhuL6u4Y=", "ARC-Message-Signature": "i=1; a=rsa-sha256; d=sourceware.org; s=key;\n t=1770920458; c=relaxed/simple;\n bh=bFxhtbltxFITRPhUpAW+825ppcu4r/jGPI/F0/Q9cfs=;\n h=DKIM-Signature:From:To:Subject:Date:Message-ID:MIME-Version;\n b=pyDBCuimW98tO01K3ZVxyG3gd5Bx6hi3sOMdElvi2ain1VcBQjHwZkw5d9EHasncSJonv06LihKrM5RK3L/dIokrDdD49Rb8EP2q+B/Krv1L/xt+Bq2OopegkwSAF30G0R3/rTAU4op3VvSjFv5k9lt8JJycevw/WMEwe+l+UOM=", "ARC-Authentication-Results": "i=1; server2.sourceware.org", "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=cs.ucla.edu;\n s=9D0B346E-2AEB-11ED-9476-E14B719DCE6C; t=1770920457;\n bh=12ztZ+YWDlvZM8xUctQoSrZ9BqDc9/kbHsukjG+y0Gg=;\n h=From:To:Date:Message-ID:MIME-Version;\n b=QBNHFlH3naRCLpTQkWO1QZyfruE6paf1kxI8UqubscKsZ9uYGZioKUZvdK18vTuGn\n disuxGewJ4N2ZqDcKKwIUULC2vaGN91rj5+xBjETYZKCkZlBOfznnXm4d5zHy4c+Kk\n BPgdU9U7VuHpA+Q9a3rU244kgaLsr+LoeTT1HLlueRG9KrGne2XwcrOyXQcD8baPdh\n Q9iE7VIlkoIAc54Ua5KFwKPE03rTgCZh6+oUKiPSOoh/xa+LSPYVltDG/AfEweBa+b\n o8EI6QyOuZerwep+50U1uebxBEFV5tfhlaPBkfe1oXdkTEWjr23T0yOyDupisnfbcQ\n AG9AmpXzDqE2Q==", "X-Virus-Scanned": "amavis at mail.cs.ucla.edu", "From": "Paul Eggert <eggert@cs.ucla.edu>", "To": "libc-alpha@sourceware.org", "Cc": "Paul Eggert <eggert@cs.ucla.edu>", "Subject": "[PATCH v3 1/4] Document max_align_t", "Date": "Thu, 12 Feb 2026 10:18:11 -0800", "Message-ID": "<20260212182031.107003-2-eggert@cs.ucla.edu>", "X-Mailer": "git-send-email 2.51.0", "In-Reply-To": "<20260212182031.107003-1-eggert@cs.ucla.edu>", "References": "<20260212182031.107003-1-eggert@cs.ucla.edu>", "MIME-Version": "1.0", "Content-Transfer-Encoding": "quoted-printable", "X-BeenThere": "libc-alpha@sourceware.org", "X-Mailman-Version": "2.1.30", "Precedence": "list", "List-Id": "Libc-alpha mailing list <libc-alpha.sourceware.org>", "List-Unsubscribe": "<https://sourceware.org/mailman/options/libc-alpha>,\n <mailto:libc-alpha-request@sourceware.org?subject=unsubscribe>", "List-Archive": "<https://sourceware.org/pipermail/libc-alpha/>", "List-Post": "<mailto:libc-alpha@sourceware.org>", "List-Help": "<mailto:libc-alpha-request@sourceware.org?subject=help>", "List-Subscribe": "<https://sourceware.org/mailman/listinfo/libc-alpha>,\n <mailto:libc-alpha-request@sourceware.org?subject=subscribe>", "Errors-To": "libc-alpha-bounces~incoming=patchwork.ozlabs.org@sourceware.org" }, "content": "* manual/lang.texi (Important Data Types): Mention max_align_t.\n---\n manual/lang.texi | 28 ++++++++++++++++++++--------\n 1 file changed, 20 insertions(+), 8 deletions(-)", "diff": "diff --git a/manual/lang.texi b/manual/lang.texi\nindex cd90ff60d2..28e7de2b2c 100644\n--- a/manual/lang.texi\n+++ b/manual/lang.texi\n@@ -16,7 +16,7 @@ features has been written, we are publishing it here.\n * Variadic Functions:: Defining functions with varying numbers\n of args.\n * Null Pointer Constant:: The macro @code{NULL}.\n-* Important Data Types:: Data types for object sizes.\n+* Important Data Types:: Types for sizes and alignments of objects.\n * Data Type Measurements:: Parameters of data type representations.\n @end menu\n \n@@ -555,7 +555,8 @@ recommend instead adding a prototype for the function you are calling.\n The result of subtracting two pointers in C is always an integer, but the\n precise data type varies from C compiler to C compiler. Likewise, the\n data type of the result of @code{sizeof} also varies between compilers.\n-ISO C defines standard aliases for these two types, so you can refer to\n+Also, it helps to have a data type with the greatest fundamental alignment.\n+ISO C defines standard aliases for these types, so you can refer to\n them in a portable fashion. They are defined in the header file\n @file{stddef.h}.\n @pindex stddef.h\n@@ -583,12 +584,23 @@ will be @w{@code{unsigned int}} or @w{@code{unsigned long int}}.\n arguments or variables that hold the size of an object.\n @end deftp\n \n-@strong{Compatibility Note:} Implementations of C before the advent of\n-@w{ISO C} generally used @code{unsigned int} for representing object sizes\n-and @code{int} for pointer subtraction results. They did not\n-necessarily define either @code{size_t} or @code{ptrdiff_t}. Unix\n-systems did define @code{size_t}, in @file{sys/types.h}, but the\n-definition was usually a signed type.\n+@deftp {Data Type} max_align_t\n+@standards{ISO, stddef.h}\n+@cindex fundamental alignment\n+This is an object type with the greatest @dfn{fundamental alignment},\n+i.e., the greatest alignment needed by standard types.\n+Code can use @code{alignof (max_align_t)} when calculating space\n+needed for arbitrary collections of objects, so long as the objects'\n+types have a fundamental alignment and lack stricter alignment specifiers.\n+@end deftp\n+\n+In @theglibc{}, the value of @code{alignof (max_align_t)} is 16 on\n+most architectures. However, it is 8 on 32-bit architectures that do\n+not require 16-byte alignment from @code{malloc} to support predefined\n+types.\n+\n+@strong{Compatibility Note:} The C11 standard introduced @code{max_align_t};\n+older compilers may lack the type.\n \n @node Data Type Measurements\n @section Data Type Measurements\n", "prefixes": [ "v3", "1/4" ] }