{"id":2227582,"url":"http://patchwork.ozlabs.org/api/patches/2227582/?format=json","web_url":"http://patchwork.ozlabs.org/project/glibc/patch/CAEHDMjzdGJ1+46B+gpYDw8VDvfe_0CyMzxOt+Xv3gxDy1k0tiA@mail.gmail.com/","project":{"id":41,"url":"http://patchwork.ozlabs.org/api/projects/41/?format=json","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":"","list_archive_url":null,"date":"2026-04-24T00:55:54","name":"[v2] manual: clarify _FILE_OFFSET_BITS Y2038 implications [BZ #34095]","commit_ref":null,"pull_url":null,"state":"new","archived":false,"hash":"806fbc9e520a2b558f90f63ead038a0bacddbb27","submitter":{"id":93241,"url":"http://patchwork.ozlabs.org/api/people/93241/?format=json","name":"Shamil Abdulaev","email":"ashamil435@gmail.com"},"delegate":null,"mbox":"http://patchwork.ozlabs.org/project/glibc/patch/CAEHDMjzdGJ1+46B+gpYDw8VDvfe_0CyMzxOt+Xv3gxDy1k0tiA@mail.gmail.com/mbox/","series":[{"id":501268,"url":"http://patchwork.ozlabs.org/api/series/501268/?format=json","web_url":"http://patchwork.ozlabs.org/project/glibc/list/?series=501268","date":"2026-04-24T00:55:54","name":"[v2] manual: clarify _FILE_OFFSET_BITS Y2038 implications [BZ #34095]","version":2,"mbox":"http://patchwork.ozlabs.org/series/501268/mbox/"}],"comments":"http://patchwork.ozlabs.org/api/patches/2227582/comments/","check":"pending","checks":"http://patchwork.ozlabs.org/api/patches/2227582/checks/","tags":{},"related":[],"headers":{"Return-Path":"","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=gmail.com header.i=@gmail.com header.a=rsa-sha256\n header.s=20251104 header.b=ntzja1UC;\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=gmail.com header.i=@gmail.com header.a=rsa-sha256\n header.s=20251104 header.b=ntzja1UC","sourceware.org;\n dmarc=pass (p=none dis=none) header.from=gmail.com","sourceware.org; spf=pass smtp.mailfrom=gmail.com","server2.sourceware.org;\n arc=pass smtp.remote-ip=2607:f8b0:4864:20::f2d"],"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 4g1vgB669Hz1xvV\n\tfor ; Fri, 24 Apr 2026 10:56:54 +1000 (AEST)","from vm01.sourceware.org (localhost [127.0.0.1])\n\tby sourceware.org (Postfix) with ESMTP id 9078C4B99F59\n\tfor ; Fri, 24 Apr 2026 00:56:51 +0000 (GMT)","from mail-qv1-xf2d.google.com (mail-qv1-xf2d.google.com\n [IPv6:2607:f8b0:4864:20::f2d])\n by sourceware.org (Postfix) with ESMTPS id ED0FB4BAE7D0\n for ; Fri, 24 Apr 2026 00:56:31 +0000 (GMT)","by mail-qv1-xf2d.google.com with SMTP id\n 6a1803df08f44-8a3970f1a0eso81448206d6.2\n for ; Thu, 23 Apr 2026 17:56:31 -0700 (PDT)"],"DKIM-Filter":["OpenDKIM Filter v2.11.0 sourceware.org 9078C4B99F59","OpenDKIM Filter v2.11.0 sourceware.org ED0FB4BAE7D0"],"DMARC-Filter":"OpenDMARC Filter v1.4.2 sourceware.org ED0FB4BAE7D0","ARC-Filter":"OpenARC Filter v1.0.0 sourceware.org ED0FB4BAE7D0","ARC-Seal":["i=2; a=rsa-sha256; d=sourceware.org; s=key; t=1776992192; cv=pass;\n b=XRgEA2AKod6FJHNerHFdsyTjvCJ2grsE3HQkJE3E6lDLR/JnzdEQjvqb13QJR/fuAj739x4PzbkXrR0MeNgA4MLFHItghtYGgunAsxS7HzVHD4KVE5VOABYvxscIJy3Ft+7l7r8qQMMEjIlULabBPVsEkk6dtvwPJW0ESQkShz0=","i=1; a=rsa-sha256; t=1776992191; cv=none;\n d=google.com; s=arc-20240605;\n b=OKkegh9zKtulWjZ82jdTtrYmuXKv3TzjxC9BbPRSAHnOdz4gczEmsBb6fu2OpQfk9d\n Tt4PNeNNxw6vnn+b3hXBqCpvtrgWdjOQwJWTXb1Y84uamU++NpJVxbCAm6dZLs8VxtGb\n btkEZ6PiA0zr2FSD+vOkKar4NMihMYBLL+6y4Z03ty/1JVhIzW/yJTCWMqhB5Ab+9425\n 8dLgVPWYXr0RKBe7qPsiFR7mEESbQwlLUdHSNxiDvEGmB6vNZG7nvKxsQXhX1zkTAxr4\n 71jB3JHTlOqFZ+XJK41DV5HNlMZMUyOWif+vVn6bg0aiuFVisOqiYn0A34srOjTr94J5\n pChA=="],"ARC-Message-Signature":["i=2; a=rsa-sha256; d=sourceware.org; s=key;\n t=1776992192; c=relaxed/simple;\n bh=fBqpsZizT3qbQ2j2jA+I0NfkLYUQvDYbluQLNS1cNJk=;\n h=DKIM-Signature:MIME-Version:From:Date:Message-ID:Subject:To;\n b=rn3rVCsAb/PR2d3XKdLs6WyLkHzXAX5A2GBV0HIiQkgcJ9tQqJC0/oQDNaJXBPoNRwagWU2wKblA1R4szdCh9RMm7SrqQCLf5g4niPYFEPLZKfRpza9sf5rum4awZp51tZ0YhJTHog2Sr08sxzS3yFA9hF1Ve3T0ZjCbPxD/KKs=","i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com;\n s=arc-20240605;\n h=cc:to:subject:message-id:date:from:mime-version:dkim-signature;\n bh=RnjWzvxVm0hzUjh7ULrQMy/gRtiTgHp1SfdChjgr6Os=;\n fh=BWc75BP1zS1IYThWGuiZtaeA4ny4tC69fgG9Q9jpYDQ=;\n b=FyldHgWsYFWd4GtapuZWTi9GjH7tefrXV6r5DMwi7EJszm7sw+NXzyxfAXLLDU6Qol\n uxVXlNsa6WAlrhtoAEH1ZDkyHrrQYd5LK52N7uisfdb1Cf94zVhnjfPduHQyzu1rP5XS\n Y3nyNIDjLxLSMQ6BfieIdz9FA26Hz2HE0FT6BypIRqdSRcrdGi7M/KqXE5rQMxxypJvF\n MA8S21so5gFYk9lIWvTd6GqiEWiVdz8OMu9EwzJCBqAU7d+h3NepJ7T2qqZVCFCVsOR1\n Jwxc9FhpgnA/HMiGpX/Kbyf8iCU9Peeos4vwfkmBXqgcis0hwgmL8lEKsBV0kxMFPCV3\n Z4hg==; darn=sourceware.org"],"ARC-Authentication-Results":["i=2; server2.sourceware.org","i=1; mx.google.com; arc=none"],"DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=gmail.com; s=20251104; t=1776992191; x=1777596991; darn=sourceware.org;\n h=cc:to:subject:message-id:date:from:mime-version:from:to:cc:subject\n :date:message-id:reply-to;\n bh=RnjWzvxVm0hzUjh7ULrQMy/gRtiTgHp1SfdChjgr6Os=;\n b=ntzja1UCw/YzFXJoOotj+7xQsSJPPYV/8OAIlAgVVLTawzgixPvTwPjXdNZmoP55YS\n +1O66d8YEDZ1HjlG3mG4DB6A1B18mQzLl125AAa6Rjl/cDszxQqXd7SDDYPdYpB17RgE\n QDCP22SNCVzbFOXGP9eqT7JDiv31NA4dalPDgcwSoFfCA6WQBelBF6+ZUaoeHHEGTWhX\n NH/14fPwRHLqNqaS+5odliIJNa5ScDMAN5witGgxa7BTIB27l1zaz+ADt/FbAZfqeUcC\n B/3fCDtxyc/qwxN58zmiIUt+Be6ShdacFXx0DGQD//du8pKDrBI6vtdnV7+12QLgV9B+\n DZLA==","X-Google-DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=1e100.net; s=20251104; t=1776992191; x=1777596991;\n h=cc:to:subject:message-id:date:from:mime-version:x-gm-gg\n :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to;\n bh=RnjWzvxVm0hzUjh7ULrQMy/gRtiTgHp1SfdChjgr6Os=;\n b=VQ9OBfHF2pc9bRA7JmoNlXqItrLVA8b48aCqso9ApwnX+9w0QOb/40yKNLPatpcTV9\n n7XLCznP8fy9uNJ5V+7VWBTW0v1xHCtYr+soB2Ig6Pf53e4r9K+MDRuGEHNondvj1mTK\n SobL5sGqq1GMfy/UT6P+L/Pr09Vz1QVP4OBhOU48hMvvbeUqcg+QnI2dEi8w+GLuJW5F\n CojV32MCgiECGNeIoECqccx7Pciy+KndFdpG1uOpRtQiadtPgYv+J3USC6oH90MUcbQD\n FSy8m2S+HYZgzPTgmOnpVFdMuoUf2+HcLHBkshWgOGU9hs9Ao4zvsixnIIOtrEasVOcv\n 4KUQ==","X-Gm-Message-State":"AOJu0Ywg5eG1DWIEvk8kTXqMPXRNJG2THqQdOxgtjfc8peztaYQrtRk9\n 2R+I2dYP4WKIHOmf2uWsRDxkLUlMX7OqjNKT6kn/JMwniqup+biq3+o3CIKs5KI/FBrA4BXRNq/\n 0WnMRaQ/7Lt/OPVclGjlH/8ocx7QephyiRVkZ","X-Gm-Gg":"AeBDiesmxOPd/xM/tWfzCwl0uwb4F9b7MzHGxEyIsVo/hd6RO2AqcVKvRWap0H7lzEd\n Sc0MVVbSwx9v7oclR0l23fTRm5Hua0GD9JD79aIIQsB4P7p34Iux7hnrNcZxHJlkH2ZfQN5oUdz\n aPZfei0aEEAZHfma2bkrfELpPZqmr3+3d7zBV+z5gIKztumhLKpfIrPpjbvtoLbv8EGxcgXmSm5\n rC9furbUp7jSI71xXQxFqhqs8J7kHzPy5GTSYqaVL3G5eiEWXYnvuRbXzDgdBGgOiJcSZ8zaTOD\n PdxxRIRaOmPDglXrflSfXGC4trUFQ6bPSjt5mXdUKFnN4lyYufz0FAzLPZieNQdzJ6qV8gftOQp\n Dj/qOZTF5QJ3+kk4hqA==","X-Received":"by 2002:a05:6214:4c8a:b0:89a:61bb:7314 with SMTP id\n 6a1803df08f44-8b028134366mr403633126d6.42.1776992191280; Thu, 23 Apr 2026\n 17:56:31 -0700 (PDT)","MIME-Version":"1.0","From":"Shamil Abdulaev ","Date":"Fri, 24 Apr 2026 03:55:54 +0300","X-Gm-Features":"AQROBzAhoOng6W0eoyCsqZlbDqozmdnbeYc6Hn1rl_GWDdeCuj78N9aED3Lc1bA","Message-ID":"\n ","Subject":"[PATCH v2] manual: clarify _FILE_OFFSET_BITS Y2038 implications [BZ\n #34095]","To":"libc-alpha@sourceware.org","Cc":"Paul Eggert ","Content-Type":"text/plain; charset=\"UTF-8\"","X-BeenThere":"libc-alpha@sourceware.org","X-Mailman-Version":"2.1.30","Precedence":"list","List-Id":"Libc-alpha mailing list ","List-Unsubscribe":",\n ","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n ","Errors-To":"libc-alpha-bounces~incoming=patchwork.ozlabs.org@sourceware.org"},"content":"Changes in v2:\n- Instead of removing the Y2038 note, clarify its relationship to\n_FILE_OFFSET_BITS\n- Explicitly document the transitive dependency: _TIME_BITS=64\nrequires _FILE_OFFSET_BITS=64\n- Address feedback from Mark Harris that the existing wording causes confusion\n\n---\n\nThe existing paragraph warning about _FILE_OFFSET_BITS default changes\ndue to Y2038 is correct but confusing, as it does not explicitly state\nwhy time_t concerns affect _FILE_OFFSET_BITS.\n\nClarify that _TIME_BITS=64 (needed for Y2038 safety) requires\n_FILE_OFFSET_BITS=64, so when systems migrate to 64-bit time_t by\ndefault, _FILE_OFFSET_BITS will also need to default to 64, even for\napplications that do not handle large files.\n\nThis addresses the confusion noted in the bug report while keeping the\nwarning in place, as the transitive dependency makes it relevant to\nthe _FILE_OFFSET_BITS documentation.\n\nSigned-off-by: Shamil Abdulaev \n---\n manual/creature.texi | 11 +++++++----\n 1 file changed, 7 insertions(+), 4 deletions(-)\n\n handling large files. On @w{64 bit} systems this macro has no effect\n--\n2.54.0","diff":"diff --git a/manual/creature.texi b/manual/creature.texi\nindex 90f9f8e35b..1a2c5e8f9d 100644\n--- a/manual/creature.texi\n+++ b/manual/creature.texi\n@@ -161,10 +161,13 @@ under different names (as they are with\n@code{_LARGEFILE64_SOURCE}).\n Instead the old function names now reference the new functions, e.g., a\n call to @code{fseeko} now indeed calls @code{fseeko64}.\n\n If the macro is not defined it currently defaults to @code{32}, but\n-this default is planned to change due to a need to update\n-@code{time_t} for Y2038 safety, and applications should not rely on\n-the default.\n+this default is planned to change in the future. This is because\n+@code{_TIME_BITS=64} (required for @code{time_t} Y2038 safety) can\n+only be used together with @code{_FILE_OFFSET_BITS=64}. When systems\n+migrate to 64-bit @code{time_t} by default, @code{_FILE_OFFSET_BITS}\n+will also need to default to @code{64}, even for applications that\n+do not handle large files. Applications should not rely on the\n+current default.\n\n This macro should only be selected if the system provides mechanisms for\n","prefixes":["v2"]}