From owner-cvs-src@FreeBSD.ORG Fri Jan 7 01:57:01 2005 Return-Path: Delivered-To: cvs-src@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 8BE1216A4CE; Fri, 7 Jan 2005 01:57:01 +0000 (GMT) Received: from mail04.syd.optusnet.com.au (mail04.syd.optusnet.com.au [211.29.132.185]) by mx1.FreeBSD.org (Postfix) with ESMTP id E808F43D2D; Fri, 7 Jan 2005 01:57:00 +0000 (GMT) (envelope-from PeterJeremy@optushome.com.au) Received: from cirb503493.alcatel.com.au (c211-30-75-229.belrs2.nsw.optusnet.com.au [211.30.75.229]) j071uwq1000756 (version=TLSv1/SSLv3 cipher=EDH-RSA-DES-CBC3-SHA bits=168 verify=NO); Fri, 7 Jan 2005 12:56:59 +1100 Received: from cirb503493.alcatel.com.au (localhost.alcatel.com.au [127.0.0.1])j071uwxP041249; Fri, 7 Jan 2005 12:56:58 +1100 (EST) (envelope-from pjeremy@cirb503493.alcatel.com.au) Received: (from pjeremy@localhost)j071uwQp041248; Fri, 7 Jan 2005 12:56:58 +1100 (EST) (envelope-from pjeremy) Date: Fri, 7 Jan 2005 12:56:58 +1100 From: Peter Jeremy To: Pawel Jakub Dawidek Message-ID: <20050107015658.GD39552@cirb503493.alcatel.com.au> References: <200501070006.j0706Kd5059956@repoman.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <200501070006.j0706Kd5059956@repoman.freebsd.org> User-Agent: Mutt/1.4.2i cc: cvs-src@freebsd.org cc: src-committers@freebsd.org cc: cvs-all@freebsd.org Subject: Re: cvs commit: src/include fts.h X-BeenThere: cvs-src@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: CVS commit messages for the src tree List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 07 Jan 2005 01:57:01 -0000 On Fri, 2005-Jan-07 00:06:20 +0000, Pawel Jakub Dawidek wrote: > Introduce new field 'fts_bignum' which is 64bit long and will allow to > make utilities like du(1) 64bit-clean. > When this field is used, one cannot use 'fts_number' and 'fts_pointer' > fields. Can you please document this in fts(3). Something along the lines of: Index: fts.3 =================================================================== RCS file: /usr/ncvs/src/lib/libc/gen/fts.3,v retrieving revision 1.20 diff -u -r1.20 fts.3 --- fts.3 2 Jul 2004 23:52:10 -0000 1.20 +++ fts.3 7 Jan 2005 01:56:10 -0000 @@ -147,6 +147,7 @@ int fts_errno; /* file errno */ long fts_number; /* local numeric value */ void *fts_pointer; /* local address value */ + int64_t fts_bignum; /* local 64-bit numeric value */ struct ftsent *fts_parent; /* parent directory */ struct ftsent *fts_link; /* next file structure */ struct ftsent *fts_cycle; /* cycle structure */ @@ -295,6 +296,8 @@ .Nm functions. It is initialized to 0. +Note that this field is overlaid by +.Fa fts_bignum . .It Fa fts_pointer This field is provided for the use of the application program and is not modified by the @@ -302,6 +305,18 @@ functions. It is initialized to .Dv NULL . +Note that this field is overlaid by +.Fa fts_bignum . +.It Fa fts_bignum +This field is provided for the use of the application program and is +not modified by the +.Nm +functions. +It is initialized to 0. +Note that this field overlays +.Fa fts_number +and +.Fa fts_pointer . .It Fa fts_parent A pointer to the .Vt FTSENT @@ -311,6 +326,7 @@ A parent structure for the initial entry point is provided as well, however, only the .Fa fts_level , +.Fa fts_bignum , .Fa fts_number and .Fa fts_pointer @@ -372,6 +388,13 @@ .Fa fts_name field is always .Dv NUL Ns -terminated . +.Pp +Note that the use of +.Fa fts_bignum +is mutually exclusive with the use of +.Fa fts_number +or +.Fa fts_pointer . .Sh FTS_OPEN The .Fn fts_open -- Peter Jeremy