From patchwork Fri May 10 19:51:25 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Max Filippov X-Patchwork-Id: 1098313 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=none (mailfrom) smtp.mailfrom=uclibc-ng.org (client-ip=89.238.66.15; helo=helium.openadk.org; envelope-from=devel-bounces@uclibc-ng.org; receiver=) Authentication-Results: ozlabs.org; dmarc=fail (p=none dis=none) header.from=gmail.com Authentication-Results: ozlabs.org; dkim=fail reason="signature verification failed" (2048-bit key; unprotected) header.d=gmail.com header.i=@gmail.com header.b="V4DkpqNV"; dkim-atps=neutral Received: from helium.openadk.org (helium.openadk.org [89.238.66.15]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 45117M1m7Yz9sBp for ; Sat, 11 May 2019 05:51:43 +1000 (AEST) Received: from helium.openadk.org (localhost [IPv6:::1]) by helium.openadk.org (Postfix) with ESMTP id 0DE70102B3; Fri, 10 May 2019 21:51:39 +0200 (CEST) X-Original-To: devel@uclibc-ng.org Delivered-To: devel@helium.openadk.org Received: from mail-lf1-f67.google.com (mail-lf1-f67.google.com [209.85.167.67]) by helium.openadk.org (Postfix) with ESMTPS id 05BF81015A; Fri, 10 May 2019 21:51:37 +0200 (CEST) Received: by mail-lf1-f67.google.com with SMTP id w23so4956957lfc.9; Fri, 10 May 2019 12:51:38 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:date:message-id; bh=35WEDsr5coRGIFyIoAXIx1KQFPb0JWfCwKFK6UecsiQ=; b=V4DkpqNVQPf6WD3h3xDKiZcipo/kNQg/HxXfUiDPS9++6mLoy7T3AAXIVdikdmoXTc m1YCAyLSCu7W1W6ogASjkU4cGen7V/Ascs34X+L3s3YT1J/kYOfvOTrA86sfl8rmEhrz 7maEcSNBKDluMACd+TTEjX2GdXDb1ok6JI/Sb4mWi/QjBzQFKv7T8fTmsPK5KQp1EZ2+ Dv1XumFt57tfsVvsby/I5eYYlAEa1B7wA5VmcoLi3I47xRzjkoZsSIiZm2TqfSdahwyB ivMGnDuVqfPMLx0oZba47WJFP0e7KlX7K/75qx4pqS2ecao24F9nWJwlo+gqKJHXBGU7 0OxA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id; bh=35WEDsr5coRGIFyIoAXIx1KQFPb0JWfCwKFK6UecsiQ=; b=cxGZHIFMOuW8WIUUZ9dWdAMfEYDRtofHgtxea759K0xEBQSoH7bE0tDEGdthMduLx3 pulk7QNq9e/7evYJHSasVeEeuU5LParsFxBcgnhHebwydoNtvS/NgLa3liy48UjruGqD 6oe4Q+if+L8tEM7BGf/aGjcDtiY+5dVnyzfXFS5UCoOFxGCJUZAPwQGmOnCj6wiSamtW 1M9nLvD/q/bt0ApOwFFU86FwRo+O0auZAWuaPyBtxOmCz1rYAWpIRM3sY2NWlfjwAdVJ mjh9HGXjCNLRNyS2M6XWdO2khHGdt1TXB0FsSkqZeG3oDssrqstInwV7/bAnLDCfX7CM WtSA== X-Gm-Message-State: APjAAAU+BNj3hD98l2bIgKgF9VZLDjzjzYbTeWouTCkrX36wvSML+EzO o7+hbeOdgZZgr7TflXQOYjr8sx1F6do= X-Google-Smtp-Source: APXvYqzj5xJswLIRAw/dthkTidDa+ymy1QO4q9aJOQfh862obgyU08T6zugJPKLZEKXK3ZD2x5kKIQ== X-Received: by 2002:ac2:483c:: with SMTP id 28mr6978717lft.93.1557517897578; Fri, 10 May 2019 12:51:37 -0700 (PDT) Received: from octofox.cadence.com (jcmvbkbc-1-pt.tunnel.tserv24.sto1.ipv6.he.net. [2001:470:27:1fa::2]) by smtp.gmail.com with ESMTPSA id y186sm1884137lfa.14.2019.05.10.12.51.35 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Fri, 10 May 2019 12:51:37 -0700 (PDT) From: Max Filippov To: devel@uclibc-ng.org Date: Fri, 10 May 2019 12:51:25 -0700 Message-Id: <20190510195125.29443-1-jcmvbkbc@gmail.com> X-Mailer: git-send-email 2.11.0 Cc: linux-xtensa@linux-xtensa.org, Chris Zankel Subject: [uclibc-ng-devel] [PATCH v2] docs/defines.txt: clarify LFS-related macros X-BeenThere: devel@uclibc-ng.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: uClibc-ng Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Errors-To: devel-bounces@uclibc-ng.org Sender: "devel" Add description for _LARGEFILE_SOURCE, _LARGEFILE64_SOURCE, _FILE_OFFSET_BITS and __USE_LARGEFILE, __USE_LARGEFILE64 and __USE_FILE_OFFSET64 macros. Signed-off-by: Max Filippov --- Changes v1->v2: - fix subject line docs/defines.txt | 23 ++++++++++++++++++++--- 1 file changed, 20 insertions(+), 3 deletions(-) diff --git a/docs/defines.txt b/docs/defines.txt index b23fac9c0036..6af44bdd809f 100644 --- a/docs/defines.txt +++ b/docs/defines.txt @@ -10,11 +10,28 @@ __USE_GNU, __USE_BSD, __USE_XOPEN[2K], __USE_SVID, __USE_POSIX... If defined, user program which included us requests compat additions from relevant standard or Unix flavor. See features.h for full list. -__USE_FILE_OFFSET64 +_LARGEFILE_SOURCE + If defined, headers will provide functions fseeko and ftello. +_LARGEFILE64_SOURCE + If defined, headers will in addition to data types, constants and + functions named xxx (e.g. off_t, struct stat, F_SETLK, ftruncate()) + supply data types, constants and functions named xxx64 (e.g. off64_t, + struct stat64, F_SETLK64, ftruncate64()) known as an interface for + 64-bit file offsets. __USE_LARGEFILE[64] -_LARGEFILE[64]_SOURCE + Defined to 1 and used internally when built with _LARGEFILE[64]_SOURCE. + Undefined otherwise. + _FILE_OFFSET_BITS - ??? + Select default filesystem interface. When defined as 64 the data types, + constants and functions mentioned in _LARGEFILE64_SOURCE as xxx are + aliased to the corresponding xxx64 data types, constants and functions. + _FILE_OFFSET_BITS=64 enables both __USE_LARGEFILE and __USE_LARGEFILE64. + This flag does not affect the way libc itself is built, it only affects + what declarations are provided to library user. +__USE_FILE_OFFSET64 + Defined to 1 and used internally when built with _FILE_OFFSET_BITS=64. + Undefined otherwise. __THROW Function annotation "I do not throw anything".