From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on inbox.vuxu.org X-Spam-Level: X-Spam-Status: No, score=-3.3 required=5.0 tests=MAILING_LIST_MULTI, RCVD_IN_DNSWL_MED,T_SCC_BODY_TEXT_LINE autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 20935 invoked from network); 28 Jun 2023 17:53:47 -0000 Received: from second.openwall.net (193.110.157.125) by inbox.vuxu.org with ESMTPUTF8; 28 Jun 2023 17:53:47 -0000 Received: (qmail 5962 invoked by uid 550); 28 Jun 2023 17:53:42 -0000 Mailing-List: contact musl-help@lists.openwall.com; run by ezmlm Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-ID: Reply-To: musl@lists.openwall.com Received: (qmail 5921 invoked from network); 28 Jun 2023 17:53:41 -0000 Date: Wed, 28 Jun 2023 13:53:30 -0400 From: Rich Felker To: linux-man@vger.kernel.org Cc: musl@lists.openwall.com, libc-alpha@sourceware.org, libc-coord@lists.openwall.com Message-ID: <20230628175329.GA16113@brightrain.aerifal.cx> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.5.21 (2010-09-15) Subject: [musl] regression in man pages for interfaces using loff_t https://github.com/mkerrisk/man-pages/commit/9bebb17e5b5794e495ba8e6c0a75266c65b9d2d7 https://github.com/mkerrisk/man-pages/commit/76c5631fb442f1c7c0b5ec8c653e84f2997249c8 and perhaps related changes for other functions introduced a breaking change in the documentation for the way applications should call libc functions for Linux-specific APIs that always take a 64-bit file offset. The type for this is loff_t, not off64_t, which is an LFS64 type which only exists when LFS64 is supported and enabled. Applications following the documentation change will not compile on musl libc, and in theory would not compile even on glibc if it followed reasonable policy for exposing visibility of off64_t, though it might happen to be that on glibc, all feature profiles that expose the relevant functions also expose LFS64. The whole reason loff_t exists is to avoid this problem and make a type that's "always full width offset, regardless of _FILE_OFFSET_BITS or _LARGEFILE64_SOURCE" to match with the kernel expectation for these interfaces. For an example of the breakage resulting from following the change in documentation, see: https://gcc.gnu.org/bugzilla/show_bug.cgi?id=110462 Please revert this. Rich