Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/2195771/?format=api
{ "id": 2195771, "url": "http://patchwork.ozlabs.org/api/patches/2195771/?format=api", "web_url": "http://patchwork.ozlabs.org/project/glibc/patch/20260211201815.82913-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": "<20260211201815.82913-2-eggert@cs.ucla.edu>", "list_archive_url": null, "date": "2026-02-11T20:17:34", "name": "[v2,1/4] Document max_align_t", "commit_ref": null, "pull_url": null, "state": "new", "archived": false, "hash": "f6d8743e509b79ab41f27dab37f544b3254baf89", "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/20260211201815.82913-2-eggert@cs.ucla.edu/mbox/", "series": [ { "id": 491904, "url": "http://patchwork.ozlabs.org/api/series/491904/?format=api", "web_url": "http://patchwork.ozlabs.org/project/glibc/list/?series=491904", "date": "2026-02-11T20:17:33", "name": "malloc doc fixes for alignment", "version": 2, "mbox": "http://patchwork.ozlabs.org/series/491904/mbox/" } ], "comments": "http://patchwork.ozlabs.org/api/patches/2195771/comments/", "check": "pending", "checks": "http://patchwork.ozlabs.org/api/patches/2195771/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=Nt1fyYU+;\n\tdkim-atps=neutral", "legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=sourceware.org\n (client-ip=38.145.34.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=Nt1fyYU+", "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 [38.145.34.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 4fB8tY3Xspz1xqf\n\tfor <incoming@patchwork.ozlabs.org>; Thu, 12 Feb 2026 07:20:05 +1100 (AEDT)", "from vm01.sourceware.org (localhost [127.0.0.1])\n\tby sourceware.org (Postfix) with ESMTP id 4E2334B9DB41\n\tfor <incoming@patchwork.ozlabs.org>; Wed, 11 Feb 2026 20:20:03 +0000 (GMT)", "from mail.cs.ucla.edu (mail.cs.ucla.edu [131.179.128.66])\n by sourceware.org (Postfix) with ESMTPS id 69E7E4BA543C\n for <libc-alpha@sourceware.org>; Wed, 11 Feb 2026 20:18:30 +0000 (GMT)", "from localhost (localhost [127.0.0.1])\n by mail.cs.ucla.edu (Postfix) with ESMTP id BC2A13C0149E2;\n Wed, 11 Feb 2026 12:18:29 -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 CLSvoSRslZwE; Wed, 11 Feb 2026 12:18:29 -0800 (PST)", "from localhost (localhost [127.0.0.1])\n by mail.cs.ucla.edu (Postfix) with ESMTP id 9478C3C0149E3;\n Wed, 11 Feb 2026 12:18:29 -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 3GBNcBmiKaeJ; Wed, 11 Feb 2026 12:18:29 -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 7ADD13C0149E2;\n Wed, 11 Feb 2026 12:18:29 -0800 (PST)" ], "DKIM-Filter": [ "OpenDKIM Filter v2.11.0 sourceware.org 4E2334B9DB41", "OpenDKIM Filter v2.11.0 sourceware.org 69E7E4BA543C", "OpenDKIM Filter v2.10.3 mail.cs.ucla.edu 9478C3C0149E3" ], "DMARC-Filter": "OpenDMARC Filter v1.4.2 sourceware.org 69E7E4BA543C", "ARC-Filter": "OpenARC Filter v1.0.0 sourceware.org 69E7E4BA543C", "ARC-Seal": "i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1770841110; cv=none;\n b=PfTEBhyrHxXUDXy4YYLlAWHj1iwTx+YaJC435QcRT6cv0nZqycDmSABMDk4HtJtZdnNAZ9RYcT3284e17poT+z+QrNDenbHN3zErMTHLej6Np7D8JcZIFfQBQGuRXOMo4FWWPy9HVgNxUrLUBKjSj+/LAXtpjc1uxj4mGXuptdY=", "ARC-Message-Signature": "i=1; a=rsa-sha256; d=sourceware.org; s=key;\n t=1770841110; c=relaxed/simple;\n bh=r6QBlQBgYCTkLYYEtvcJ9WC5wcMIn9okzURkusgs4QY=;\n h=DKIM-Signature:From:To:Subject:Date:Message-ID:MIME-Version;\n b=VNB7wV1TLMX/JwTeSbgFQOFFF1y50UYf5+peNq7PTy8OYvCOeCErZgdUgr5EFNPi9aED12ylBjD9XAvQS1pgv3jgtXu2EXQ0GcO15+RQtgBGC+v48Fvw5PIiAQSRnYDhhRol4ODPDtyrkK4iRaD95/wE7KEv6HmWtqQQIHsREgY=", "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=1770841109;\n bh=v7ide9wBBniGrPd9Kwfvz14+IFnX7bQSx+W8iZlwzts=;\n h=From:To:Date:Message-ID:MIME-Version;\n b=Nt1fyYU+fDf+mDoYMdmHpB3nVGC6BUMrnUXv79agn06B2kDyI6SBfDOAht6QJanbT\n s5jYB70fGhtENkRZ6nbTW3M+jidnwNmqAb3B0QX3PUBNB+Y8uqeLwWLONDTEMqd8Mb\n ZVT95zUDEh03RvoYFxyQv/tT1uN/5QnmtKOxxI+0PVhvK4bdk4viW5PkPceef7iGaw\n /m7FCM/j7nDEWWva4O5HVVIJOaGyCgUgWBaXoi/T+lfReY42TlxXGJA6BKl43V780D\n CSh5dSwDA+ntDOiNU6cHNNUTl/jNxeIGwecNs83xOKUtaZ9t2QsduQMDMetswgbzM7\n nHTo5CdvATnqA==", "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 v2 1/4] Document max_align_t", "Date": "Wed, 11 Feb 2026 12:17:34 -0800", "Message-ID": "<20260211201815.82913-2-eggert@cs.ucla.edu>", "X-Mailer": "git-send-email 2.51.0", "In-Reply-To": "<20260211201815.82913-1-eggert@cs.ucla.edu>", "References": "<20260211201815.82913-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..bffe1390e4 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 object sizes and alignments.\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": [ "v2", "1/4" ] }