Messages in this thread | ![/](/images/icornerl.gif) | | Subject | Re: [PATCH 1/2] system_data_types.7: Add 'off_t' | From | "Michael Kerrisk (man-pages)" <> | Date | Wed, 7 Oct 2020 08:53:52 +0200 |
| |
On 10/6/20 12:12 AM, Alejandro Colomar wrote: > Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Hi Alex,
Thanks, patch applied. And I trimmed the "See also" a little. I'd hold off on documenting loff_t and off64_t for the moment. As you note in another mail, the *lseek* man page situation is a bit of a mess. I'm not yet sure what to do.
Thanks,
Michael
> --- > man7/system_data_types.7 | 50 ++++++++++++++++++++++++++++++++++++++++ > 1 file changed, 50 insertions(+) > > diff --git a/man7/system_data_types.7 b/man7/system_data_types.7 > index b8cbc8ffe..916efef08 100644 > --- a/man7/system_data_types.7 > +++ b/man7/system_data_types.7 > @@ -629,6 +629,56 @@ C99 and later; POSIX.1-2001 and later. > See also: > .BR lldiv (3) > .RE > +.\"------------------------------------- off_t ------------------------/ > +.TP > +.I off_t > +.RS > +Include: > +.IR <sys/types.h> . > +Alternatively, > +.IR <aio.h> , > +.IR <fcntl.h> , > +.IR <stdio.h> , > +.IR <sys/mman.h> , > +.IR <sys/stat.h.h> , > +or > +.IR <unistd.h> . > +.PP > +Used for file sizes. > +According to POSIX, > +this shall be a signed integer type. > +.PP > +Versions: > +.I <aio.h> > +and > +.I <stdio.h> > +define > +.I off_t > +since POSIX.1-2008. > +.PP > +Conforming to: > +POSIX.1-2001 and later. > +.PP > +See also: > +.BR fallocate (2), > +.BR lseek (2), > +.BR mmap (2), > +.BR mmap2 (2), > +.BR posix_fadvise (2), > +.BR pread (2), > +.BR preadv (2), > +.BR truncate (2), > +.BR fseeko (3), > +.BR getdirentries (3), > +.BR lockf (3), > +.BR posix_fallocate (3) > +.\".PP TODO: loff_t, off64_t > +.\"See also the > +.\".I loff_t > +.\"and > +.\".I off64_t > +.\"types in this page. > +.RE > .\"------------------------------------- pid_t ------------------------/ > .TP > .I pid_t >
-- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ Linux/UNIX System Programming Training: http://man7.org/training/
| ![\](/images/icornerr.gif) |