]> git.ipfire.org Git - thirdparty/man-pages.git/log
thirdparty/man-pages.git
4 years agointptr_t.3: New link to system_data_types(7)
Alejandro Colomar [Thu, 1 Oct 2020 10:15:58 +0000 (12:15 +0200)] 
intptr_t.3: New link to system_data_types(7)

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Add 'intptr_t'
Alejandro Colomar [Thu, 1 Oct 2020 10:15:57 +0000 (12:15 +0200)] 
system_data_types.7: Add 'intptr_t'

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: srcfix
Alejandro Colomar [Thu, 1 Oct 2020 10:15:48 +0000 (12:15 +0200)] 
system_data_types.7: srcfix

We used .br to force a simple line break (with no extra blank line)
after the tag.

Recently, we added .RS/.RS, and .RS comes just after the tag,
and I realized by accident that .RS already forces a simple line break.

Therefore, .br is completely redundant here, and can be removed.

This way we get rid of "raw" *roff requests in this page.

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: srcfix
Alejandro Colomar [Thu, 1 Oct 2020 10:15:47 +0000 (12:15 +0200)] 
system_data_types.7: srcfix

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: srcfix
Alejandro Colomar [Thu, 1 Oct 2020 10:15:46 +0000 (12:15 +0200)] 
system_data_types.7: srcfix

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agomalloc_get_state.3: ffix
Alejandro Colomar [Thu, 1 Oct 2020 10:15:45 +0000 (12:15 +0200)] 
malloc_get_state.3: ffix

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agofeature_test_macros.7: Update list of macros that inhibit default definitions
Jakub Wilk [Thu, 1 Oct 2020 09:54:19 +0000 (11:54 +0200)] 
feature_test_macros.7: Update list of macros that inhibit default definitions

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Improve "Include" wording and format, and explain it in NOTES
Alejandro Colomar [Tue, 29 Sep 2020 14:22:19 +0000 (16:22 +0200)] 
system_data_types.7: Improve "Include" wording and format, and explain it in NOTES

The previous format/wording for the includes wasn't very clear.
Improve it a bit following Branden's proposal.
It also helps reduce lines of code.

Add a subsection in NOTES explaining the conventions used.

Remove the comment for helping maintain the page,
as the NOTES section is now clear enough.

Reported-by: G. Branden Robinson <g.branden.robinson@gmail.com>
Reported-by: Dave Martin <Dave.Martin@arm.com>
Reported-by: Michael Kerrisk <mtk.manpages@gmail.com>
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoopenat2.2: tfix: fix minor reference typo
Aleksa Sarai [Tue, 29 Sep 2020 22:35:09 +0000 (08:35 +1000)] 
openat2.2: tfix: fix minor reference typo

Signed-off-by: Aleksa Sarai <cyphar@cyphar.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosched_getattr.2: Update to include changed size semantics
Aleksa Sarai [Tue, 29 Sep 2020 22:35:08 +0000 (08:35 +1000)] 
sched_getattr.2: Update to include changed size semantics

Due to a userspace breakage, commit 1251201c0d34 ("sched/core: Fix
uclamp ABI bug, clean up and robustify sched_read_attr() ABI logic
and code") changed the semantics of sched_getattr(2) when the
userspace struct is smaller than the kernel struct. Now, any
trailing non-zero data in the kernel structure is ignored when
copying to userspace. We also document the original error code
correctly (it was EFBIG not E2BIG) in the BUGS section.

Ref: 1251201c0d34 ("sched/core: Fix uclamp ABI bug, clean up and
                 robustify sched_read_attr() ABI logic and code")

Signed-off-by: Aleksa Sarai <cyphar@cyphar.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoman_show_fixme.sh: Fix misquoted double quotes in regexps
Michael Kerrisk [Wed, 30 Sep 2020 07:29:59 +0000 (09:29 +0200)] 
man_show_fixme.sh: Fix misquoted double quotes in regexps

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoxdr.3: ffix
Michael Kerrisk [Tue, 29 Sep 2020 20:01:46 +0000 (22:01 +0200)] 
xdr.3: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agorpc.3: ffix
Michael Kerrisk [Tue, 29 Sep 2020 20:00:26 +0000 (22:00 +0200)] 
rpc.3: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agofeature_test_macros.7: ffix
Michael Kerrisk [Tue, 29 Sep 2020 19:33:20 +0000 (21:33 +0200)] 
feature_test_macros.7: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agogetutent.3: ffix
Michael Kerrisk [Tue, 29 Sep 2020 19:31:39 +0000 (21:31 +0200)] 
getutent.3: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoperf_event_open.2: srcfix
Michael Kerrisk [Tue, 29 Sep 2020 14:41:26 +0000 (16:41 +0200)] 
perf_event_open.2: srcfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoproc.5: ffix + srcfix
Michael Kerrisk [Tue, 29 Sep 2020 14:26:52 +0000 (16:26 +0200)] 
proc.5: ffix + srcfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoadjtimex.2, futex.2, semop.2, slabinfo.5, feature_test_macros.7, keyrings.7: srcfix
Michael Kerrisk [Tue, 29 Sep 2020 14:17:52 +0000 (16:17 +0200)] 
adjtimex.2, futex.2, semop.2, slabinfo.5, feature_test_macros.7, keyrings.7: srcfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agostrftime.3: ffix
Michael Kerrisk [Tue, 29 Sep 2020 13:42:42 +0000 (15:42 +0200)] 
strftime.3: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoFILE.3: New link to system_data_types(7)
Alejandro Colomar [Sun, 27 Sep 2020 21:13:45 +0000 (23:13 +0200)] 
FILE.3: New link to system_data_types(7)

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Add 'FILE'
Tycho Andersen [Tue, 29 Sep 2020 13:33:03 +0000 (15:33 +0200)] 
system_data_types.7: Add 'FILE'

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years ago_exit.2, access.2, acct.2, brk.2, chdir.2, chmod.2, chown.2, chroot.2, clock_getres...
Michael Kerrisk [Tue, 29 Sep 2020 13:06:31 +0000 (15:06 +0200)] 
_exit.2, access.2, acct.2, brk.2, chdir.2, chmod.2, chown.2, chroot.2, clock_getres.2, clock_nanosleep.2, fsync.2, futimesat.2, getdomainname.2, getgroups.2, gethostname.2, getpagesize.2, getrlimit.2, getsid.2, gettimeofday.2, kill.2, link.2, madvise.2, mincore.2, mkdir.2, mknod.2, nanosleep.2, nice.2, open.2, posix_fadvise.2, pread.2, process_vm_readv.2, readlink.2, readv.2, rename.2, select.2, semop.2, seteuid.2, setpgid.2, setreuid.2, sigaction.2, sigaltstack.2, sigpending.2, sigprocmask.2, sigsuspend.2, sigwaitinfo.2, stat.2, stime.2, symlink.2, sync.2, syscall.2, timer_create.2, timer_delete.2, timer_getoverrun.2, timer_settime.2, truncate.2, unlink.2, utimensat.2, vfork.2, vhangup.2, wait.2, wait4.2, a64l.3, abs.3, acos.3, acosh.3, addseverity.3, adjtime.3, asin.3, asinh.3, atan.3, atan2.3, atanh.3, atoi.3, bsd_signal.3, cbrt.3, ceil.3, cfree.3, clearenv.3, clock_getcpuclockid.3, confstr.3, copysign.3, cos.3, cosh.3, ctermid.3, ctime.3, daemon.3, dirfd.3, div.3, drand48.3, drand48_r.3, duplocale.3, dysize.3, ecvt.3, ecvt_r.3, endian.3, erf.3, erfc.3, exec.3, exp.3, exp2.3, expm1.3, fabs.3, fdim.3, ferror.3, fexecve.3, ffs.3, fgetgrent.3, fgetpwent.3, finite.3, flockfile.3, floor.3, fma.3, fmax.3, fmemopen.3, fmin.3, fmod.3, fopen.3, fpclassify.3, frexp.3, fseeko.3, ftw.3, futimes.3, fwide.3, gamma.3, gcvt.3, getaddrinfo.3, getcwd.3, getdate.3, getdirentries.3, getdtablesize.3, getentropy.3, getenv.3, getgrent.3, getgrent_r.3, getgrnam.3, getgrouplist.3, gethostbyname.3, gethostid.3, getline.3, getloadavg.3, getlogin.3, getmntent.3, getnameinfo.3, getnetent_r.3, getopt.3, getpass.3, getprotoent_r.3, getpwent.3, getpwent_r.3, getpwnam.3, getrpcent_r.3, getservent_r.3, getspnam.3, getsubopt.3, getusershell.3, getw.3, grantpt.3, group_member.3, gsignal.3, hypot.3, ilogb.3, inet.3, inet_net_pton.3, initgroups.3, insque.3, isalpha.3, isfdtype.3, isgreater.3, iswblank.3, j0.3, killpg.3, ldexp.3, lgamma.3, lockf.3, log.3, log10.3, log1p.3, log2.3, logb.3, lrint.3, lround.3, malloc.3, mbsnrtowcs.3, memchr.3, mkdtemp.3, mkfifo.3, mkstemp.3, mktemp.3, modf.3, mq_receive.3, mq_send.3, nan.3, newlocale.3, nextafter.3, nl_langinfo.3, on_exit.3, open_memstream.3, opendir.3, perror.3, popen.3, posix_fallocate.3, posix_madvise.3, posix_memalign.3, posix_openpt.3, pow.3, printf.3, profil.3, psignal.3, pthread_attr_setstack.3, pthread_cleanup_push_defer_np.3, pthread_kill.3, pthread_mutex_consistent.3, pthread_mutexattr_setrobust.3, pthread_rwlockattr_setkind_np.3, pthread_sigmask.3, pthread_sigqueue.3, pthread_spin_init.3, pthread_spin_lock.3, ptsname.3, putenv.3, putpwent.3, qecvt.3, qsort.3, rand.3, random.3, random_r.3, rcmd.3, readdir_r.3, realpath.3, remainder.3, remquo.3, rint.3, round.3, rpmatch.3, scalb.3, scalbln.3, scandir.3, scanf.3, sched_getcpu.3, seekdir.3, sem_wait.3, setbuf.3, setenv.3, setjmp.3, setnetgrent.3, siginterrupt.3, signbit.3, significand.3, sigqueue.3, sigset.3, sigsetops.3, sigvec.3, sigwait.3, sin.3, sinh.3, sockatmark.3, sqrt.3, stpcpy.3, stpncpy.3, strdup.3, strerror.3, strfromd.3, strnlen.3, strsep.3, strsignal.3, strtod.3, strtok.3, strtol.3, strtoul.3, syslog.3, tan.3, tanh.3, telldir.3, tempnam.3, termios.3, tgamma.3, timegm.3, timeradd.3, tmpnam.3, toascii.3, toupper.3, towlower.3, towupper.3, trunc.3, ttyslot.3, tzset.3, ualarm.3, unlocked_stdio.3, unlockpt.3, uselocale.3, usleep.3, wcpcpy.3, wcpncpy.3, wcscasecmp.3, wcsdup.3, wcsncasecmp.3, wcsnlen.3, wcsnrtombs.3, wordexp.3, wprintf.3, y0.3: srcfix: use better macros in SYNOPSIS

Around the text:
"Feature Test Macro Requirements for glibc..."
replace ".in -4n/.in" with ".RS -4/.RE".
The latter form is more idiomatic use of man macros.
The nroff output is unchanged.

Reported-by: G. Branden Robinson <g.branden.robinson@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agochmod.2, connect.2, recv.2: srcfix
Michael Kerrisk [Tue, 29 Sep 2020 12:26:18 +0000 (14:26 +0200)] 
chmod.2, connect.2, recv.2: srcfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoclone.2, io_submit.2, select.2, shmget.2, getcontext.3, malloc_info.3, mtrace.3,...
Michael Kerrisk [Tue, 29 Sep 2020 12:24:12 +0000 (14:24 +0200)] 
clone.2, io_submit.2, select.2, shmget.2, getcontext.3, malloc_info.3, mtrace.3, posix_spawn.3, strfromd.3, proc.5: srcfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Minor edits to Alejandro Colomar's patch
Michael Kerrisk [Tue, 29 Sep 2020 11:48:52 +0000 (13:48 +0200)] 
system_data_types.7: Minor edits to Alejandro Colomar's patch

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agouint8_t.3, uint16_t.3, uint32_t.3, uint64_t.3, uintN_t.3: New links to system_data_ty...
Alejandro Colomar [Tue, 29 Sep 2020 10:30:30 +0000 (12:30 +0200)] 
uint8_t.3, uint16_t.3, uint32_t.3, uint64_t.3, uintN_t.3: New links to system_data_types(7)

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Add uintN_t family of types
Alejandro Colomar [Tue, 29 Sep 2020 10:30:29 +0000 (12:30 +0200)] 
system_data_types.7: Add uintN_t family of types

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoint8_t.3, int16_t.3, int32_t.3, int64_t.3, intN_t.3: New links to system_data_types(7)
Alejandro Colomar [Tue, 29 Sep 2020 10:30:28 +0000 (12:30 +0200)] 
int8_t.3, int16_t.3, int32_t.3, int64_t.3, intN_t.3: New links to system_data_types(7)

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Add intN_t family of types
Alejandro Colomar [Tue, 29 Sep 2020 10:30:27 +0000 (12:30 +0200)] 
system_data_types.7: Add intN_t family of types

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agouintmax_t.3: New link to system_data_types(7)
Alejandro Colomar [Tue, 29 Sep 2020 10:30:26 +0000 (12:30 +0200)] 
uintmax_t.3: New link to system_data_types(7)

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Add 'uintmax_t'
Alejandro Colomar [Tue, 29 Sep 2020 10:30:25 +0000 (12:30 +0200)] 
system_data_types.7: Add 'uintmax_t'

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agointmax_t.3: New link to system_data_types(7)
Alejandro Colomar [Tue, 29 Sep 2020 10:30:24 +0000 (12:30 +0200)] 
intmax_t.3: New link to system_data_types(7)

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Add 'intmax_t'
Alejandro Colomar [Tue, 29 Sep 2020 10:30:23 +0000 (12:30 +0200)] 
system_data_types.7: Add 'intmax_t'

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agostatx.2: Minor edits to Ira Weiny's
Michael Kerrisk [Tue, 29 Sep 2020 08:25:02 +0000 (10:25 +0200)] 
statx.2: Minor edits to Ira Weiny's

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agostatx.2: Add STATX_ATTR_DAX
Ira Weiny [Tue, 5 May 2020 00:20:16 +0000 (17:20 -0700)] 
statx.2: Add STATX_ATTR_DAX

Linux 5.8 adds STATX_ATTR_DAX support.

https://lore.kernel.org/lkml/20200428002142.404144-4-ira.weiny@intel.com/
https://lore.kernel.org/lkml/20200504161352.GA13783@magnolia/

Add the text to the statx man page.

Signed-off-by: Ira Weiny <ira.weiny@intel.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoioctl_fslabel.2: ffix
Michael Kerrisk [Mon, 28 Sep 2020 10:40:13 +0000 (12:40 +0200)] 
ioctl_fslabel.2: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: ffix
Alejandro Colomar [Sun, 27 Sep 2020 21:13:43 +0000 (23:13 +0200)] 
system_data_types.7: ffix

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agova_list.3: New link to system_data_types(7)
Alejandro Colomar [Sat, 26 Sep 2020 17:08:15 +0000 (19:08 +0200)] 
va_list.3: New link to system_data_types(7)

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Add va_list
Alejandro Colomar [Sat, 26 Sep 2020 17:08:14 +0000 (19:08 +0200)] 
system_data_types.7: Add va_list

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoseccomp.2: ffix
Michael Kerrisk [Sat, 26 Sep 2020 13:49:32 +0000 (15:49 +0200)] 
seccomp.2: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agortld-audit.7: srcfix: semantic newlines
Michael Kerrisk [Fri, 25 Sep 2020 10:48:52 +0000 (12:48 +0200)] 
rtld-audit.7: srcfix: semantic newlines

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agortld-audit.7: Clarify la_version handshake
Florian Weimer [Fri, 25 Sep 2020 08:48:37 +0000 (10:48 +0200)] 
rtld-audit.7: Clarify la_version handshake

Returning its argument without further checks is almost always
wrong for la_version.

Reviewed-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Florian Weimer <fweimer@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Minor tweaks to Alejandro Colomar's float_t/double_t patches
Michael Kerrisk [Fri, 25 Sep 2020 11:58:47 +0000 (13:58 +0200)] 
system_data_types.7: Minor tweaks to Alejandro Colomar's float_t/double_t patches

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: srcfix
Alejandro Colomar [Fri, 25 Sep 2020 11:28:23 +0000 (13:28 +0200)] 
system_data_types.7: srcfix

The contents of each type are a logical block that is indented as
a block.  They are not separate paragraphs that happen to be
indented separately, but a set of continuous paragraphs, all at
the same level, indented as a block from the list entry--the name
of the type--.  Therefore, it makes more sense to use block
indentation, represented by .RS/.RE, rather than indenting each
paragraph separately.  That way it's also easier to further indent
a separate paragraph inside a block, which happens for example in
the case of float_t & double_t.  It's simply much easier now to
use .IP specifically in those cases where you want to indent just
a single paragraph.

Also added an ending separator comment line just after the last
type.

[mtk: minor edits to commit message]

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agodouble_t.3: New link to system_data_types(7)
Alejandro Colomar [Fri, 25 Sep 2020 07:31:38 +0000 (09:31 +0200)] 
double_t.3: New link to system_data_types(7)

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Add double_t
Alejandro Colomar [Fri, 25 Sep 2020 11:22:18 +0000 (13:22 +0200)] 
system_data_types.7: Add double_t

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agofloat_t.3: New link to system_data_types(7)
Alejandro Colomar [Fri, 25 Sep 2020 07:31:36 +0000 (09:31 +0200)] 
float_t.3: New link to system_data_types(7)

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Add float_t
Alejandro Colomar [Fri, 25 Sep 2020 11:19:23 +0000 (13:19 +0200)] 
system_data_types.7: Add float_t

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: srcfix
Alejandro Colomar [Fri, 25 Sep 2020 08:03:30 +0000 (10:03 +0200)] 
system_data_types.7: srcfix

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoseccomp.2: Use ARRAY_SIZE() macro instead of raw sizeof division
Alejandro Colomar [Fri, 25 Sep 2020 07:31:40 +0000 (09:31 +0200)] 
seccomp.2: Use ARRAY_SIZE() macro instead of raw sizeof division

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoseccomp.2: Remove unneeded cast
Alejandro Colomar [Fri, 25 Sep 2020 07:31:39 +0000 (09:31 +0200)] 
seccomp.2: Remove unneeded cast

From the email discussion:

> Hi Alex,
>
> On 9/25/20 9:31 AM, Alejandro Colomar wrote:
>> Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
>> ---
>>   man2/seccomp.2 | 2 +-
>>   1 file changed, 1 insertion(+), 1 deletion(-)
>>
>> diff --git a/man2/seccomp.2 b/man2/seccomp.2
>> index 58033da1c..d6b856c32 100644
>> --- a/man2/seccomp.2
>> +++ b/man2/seccomp.2
>> @@ -1101,7 +1101,7 @@ install_filter(int syscall_nr, int t_arch, int f_errno)
>>       };
>>
>>       struct sock_fprog prog = {
>> -        .len = (unsigned short) (sizeof(filter) / sizeof(filter[0])),
>> +        .len = sizeof(filter) / sizeof(filter[0]),
>>           .filter = filter,
>>       };
>
> I have a small doubt about this change. With the change,
> there are no compilation warnings.
>
> But, if we change the code to something slightly different:
>
> [[
>      size_t x = (sizeof(filter) / sizeof(filter[0]));
>      struct sock_fprog prog = {
>          .len = x,
>          .filter = filter,
>      };
> ]]
>
> The "cc -Wconversion" gives us the following warning:
>
>      warning: conversion from â€˜size_t’ {aka â€˜long unsigned int’}
>      to â€˜short unsigned int’ may change value
>
> Presumably we don't get a warning for an assignment of the form
>
>      .len = (sizeof(filter) / sizeof(filter[0]))
>
> because the compiler is smart enough to work out that the
> value of the constant expression is within the range of
> "unsigned short".
>
> Your thoughts?

Hi Michael,

I'd say that the cast doesn't fix any problems at all.  It silences a
valid warning, and I'd use a pragma for that (to be more explicit about
the intention of silencing a warning) if I do want -Wconversion enabled
(which usually I don't want, because it's too noisy) and I'm sure that
this won't overflow.  I'd limit the use casts to only when I *really*
need to.

I guess that if you enable -O3, the warning will vanish again because
the compiler will optimize away 'x' (but I didn't test).

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agolconv.3: New link to system_data_types(7)
Alejandro Colomar [Fri, 25 Sep 2020 07:31:34 +0000 (09:31 +0200)] 
lconv.3: New link to system_data_types(7)

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Add lconv
Alejandro Colomar [Fri, 25 Sep 2020 07:31:33 +0000 (09:31 +0200)] 
system_data_types.7: Add lconv

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agogetgrent_r.3: Declare variables with different types in different lines
Alejandro Colomar [Fri, 25 Sep 2020 07:31:41 +0000 (09:31 +0200)] 
getgrent_r.3: Declare variables with different types in different lines

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: ffix
Alejandro Colomar [Fri, 25 Sep 2020 07:31:32 +0000 (09:31 +0200)] 
system_data_types.7: ffix

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agolldiv_t.3: New link to system_data_types(7)
Alejandro Colomar [Thu, 24 Sep 2020 10:13:09 +0000 (12:13 +0200)] 
lldiv_t.3: New link to system_data_types(7)

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Add lldiv_t
Alejandro Colomar [Thu, 24 Sep 2020 10:13:08 +0000 (12:13 +0200)] 
system_data_types.7: Add lldiv_t

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoldiv_t.3: New link to system_data_types(7)
Alejandro Colomar [Thu, 24 Sep 2020 10:13:07 +0000 (12:13 +0200)] 
ldiv_t.3: New link to system_data_types(7)

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Add ldiv_t
Alejandro Colomar [Thu, 24 Sep 2020 10:13:06 +0000 (12:13 +0200)] 
system_data_types.7: Add ldiv_t

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agodiv_t.3: New link to system_data_types(7)
Alejandro Colomar [Thu, 24 Sep 2020 10:13:05 +0000 (12:13 +0200)] 
div_t.3: New link to system_data_types(7)

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Add div_t
Alejandro Colomar [Thu, 24 Sep 2020 10:13:04 +0000 (12:13 +0200)] 
system_data_types.7: Add div_t

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoimaxdiv_t.3: New link to system_data_types(7)
Alejandro Colomar [Thu, 24 Sep 2020 09:58:55 +0000 (11:58 +0200)] 
imaxdiv_t.3: New link to system_data_types(7)

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Add imaxdiv_t
Alejandro Colomar [Thu, 24 Sep 2020 09:58:54 +0000 (11:58 +0200)] 
system_data_types.7: Add imaxdiv_t

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agostrfromd.3: tfix
Michael Kerrisk [Thu, 24 Sep 2020 08:02:00 +0000 (10:02 +0200)] 
strfromd.3: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agocore.5: srcfix
Michael Kerrisk [Thu, 24 Sep 2020 08:00:16 +0000 (10:00 +0200)] 
core.5: srcfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agocore.5: ffix
Michael Kerrisk [Thu, 24 Sep 2020 07:59:57 +0000 (09:59 +0200)] 
core.5: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoldd.1: Minor tweak to 'ldd' output example
Michael Kerrisk [Thu, 24 Sep 2020 07:57:27 +0000 (09:57 +0200)] 
ldd.1: Minor tweak to 'ldd' output example

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoptrace.2: ffix
Michael Kerrisk [Thu, 24 Sep 2020 07:47:55 +0000 (09:47 +0200)] 
ptrace.2: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agopldd.1, bpf.2, clone.2, dup.2, ioctl_fat.2, nfsservctl.2, open_by_handle_at.2, perf_e...
Michael Kerrisk [Thu, 24 Sep 2020 07:32:31 +0000 (09:32 +0200)] 
pldd.1, bpf.2, clone.2, dup.2, ioctl_fat.2, nfsservctl.2, open_by_handle_at.2, perf_event_open.2, pivot_root.2, request_key.2, sched_setaffinity.2, seccomp.2, select.2, statx.2, dl_iterate_phdr.3, dlinfo.3, dlopen.3, insque.3, newlocale.3, printf.3, pthread_setname_np.3, rpc.3, stdarg.3, strfmon.3, veth.4, proc.5, slabinfo.5, cgroup_namespaces.7, cgroups.7, cpuset.7, fanotify.7, inotify.7, mount_namespaces.7, sock_diag.7, user_namespaces.7, ld.so.8: Use \(aq instead of ' inside monospace fonts

Use \(aq to get an unslanted single quote inside monospace code
blocks. Using a simple ' results in a slanted quote inside PDFs.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoopen.2: ffix
Michael Kerrisk [Thu, 24 Sep 2020 07:02:29 +0000 (09:02 +0200)] 
open.2: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoioctl_ns.2, stat.2: Fix signedness of printf specifiers
Alejandro Colomar [Wed, 23 Sep 2020 14:54:26 +0000 (16:54 +0200)] 
ioctl_ns.2, stat.2: Fix signedness of printf specifiers

These variables are either of an unsigned integer type per POSIX;
or of an integer type per POSIX, that Linux defines as an unsigned integer type.

Print them with 'uintmax_t' instead of 'intmax_t' to avoid
big positive numbers being printed as negative numbers.

Bug report:
From: Konstantin Bukin @ 2020-09-13 15:04 UTC
  To: mtk.manpages; +Cc: Konstantin Bukin, linux-man

inode numbers are expected to be positive. Casting them to a signed type
may result in printing negative values. E.g. running example program on
the following file:

$ ls -li test.txt
9280843260537405888 -r--r--r-- 1 kbukin hardware 300 Jul 21 06:36 test.txt

results in the following output:

$ ./example test.txt
ID of containing device:  [0,480]
File type:                regular file
I-node number:            -9165900813172145728
Mode:                     100444 (octal)
Link count:               1
Ownership:                UID=2743   GID=30
Preferred I/O block size: 32768 bytes
File size:                300 bytes
Blocks allocated:         8
Last status change:       Tue Jul 21 06:36:50 2020
Last file access:         Sat Sep 12 14:13:38 2020
Last file modification:   Tue Jul 21 06:36:50 2020

Such erroneous reporting happens for inode values greater than maximum
value which can be stored in signed long. Casting does not seem to be
necessary here. Printing inode as unsigned long fixes the issue.

Reported-by: Konstantin Bukin <kbukin@gmail.com>
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agofexcept_t.3: New link to system_data_types(7)
Alejandro Colomar [Wed, 23 Sep 2020 13:17:07 +0000 (15:17 +0200)] 
fexcept_t.3: New link to system_data_types(7)

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Add 'fexcept_t'
Alejandro Colomar [Wed, 23 Sep 2020 13:17:06 +0000 (15:17 +0200)] 
system_data_types.7: Add 'fexcept_t'

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Reword description of fenv_t to avoid simply quoting POSIX text
Michael Kerrisk [Wed, 23 Sep 2020 08:38:45 +0000 (10:38 +0200)] 
system_data_types.7: Reword description of fenv_t to avoid simply quoting POSIX text

The existing text comes straight from POSIX. In copyright terms,
this is at least a gray area, and in any case, simply reproducing
the text of the standard has limited value, since people can
consult the standard directly.  So, rewrite the text, to simply
quote the description from fenv(3).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: ffix
Alejandro Colomar [Tue, 22 Sep 2020 08:58:14 +0000 (10:58 +0200)] 
system_data_types.7: ffix

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agoid_t.3: New link to system_data_types(7)
Michael Kerrisk [Tue, 22 Sep 2020 08:39:33 +0000 (10:39 +0200)] 
id_t.3: New link to system_data_types(7)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Add 'id_t'
Michael Kerrisk [Tue, 22 Sep 2020 08:38:42 +0000 (10:38 +0200)] 
system_data_types.7: Add 'id_t'

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Add self to copyright notice
Michael Kerrisk [Tue, 22 Sep 2020 08:29:04 +0000 (10:29 +0200)] 
system_data_types.7: Add self to copyright notice

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agogid_t.3: New link to system_data_types(7)
Michael Kerrisk [Tue, 22 Sep 2020 08:29:39 +0000 (10:29 +0200)] 
gid_t.3: New link to system_data_types(7)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Add 'gid_t'
Michael Kerrisk [Tue, 22 Sep 2020 08:28:08 +0000 (10:28 +0200)] 
system_data_types.7: Add 'gid_t'

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agouid_t.3: New link to system_data_types(7)
Michael Kerrisk [Tue, 22 Sep 2020 08:23:14 +0000 (10:23 +0200)] 
uid_t.3: New link to system_data_types(7)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Add 'uid_t'
Michael Kerrisk [Tue, 22 Sep 2020 08:22:35 +0000 (10:22 +0200)] 
system_data_types.7: Add 'uid_t'

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agokcmp.2: tfix
Michael Kerrisk [Tue, 22 Sep 2020 08:08:14 +0000 (10:08 +0200)] 
kcmp.2: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agocredentials.7: SEE ALSO: add system_data_types(7)
Michael Kerrisk [Tue, 22 Sep 2020 08:03:07 +0000 (10:03 +0200)] 
credentials.7: SEE ALSO: add system_data_types(7)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: tfix
Michael Kerrisk [Tue, 22 Sep 2020 07:59:57 +0000 (09:59 +0200)] 
system_data_types.7: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Add further POSIX details for size_t, ssize_t, and suseconds_t
Michael Kerrisk [Tue, 22 Sep 2020 07:56:03 +0000 (09:56 +0200)] 
system_data_types.7: Add further POSIX details for size_t, ssize_t, and suseconds_t

The implementation shall support one or more programming
environments where these types are no wider than 'long'.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agopid_t.3: New link to system_data_types(7)
Michael Kerrisk [Tue, 22 Sep 2020 07:52:08 +0000 (09:52 +0200)] 
pid_t.3: New link to system_data_types(7)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Document pid_t
Michael Kerrisk [Tue, 22 Sep 2020 07:51:41 +0000 (09:51 +0200)] 
system_data_types.7: Document pid_t

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosigset_t.3: New link to system_data_types.7
Michael Kerrisk [Tue, 22 Sep 2020 07:31:14 +0000 (09:31 +0200)] 
sigset_t.3: New link to system_data_types.7

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Add description of sigset_t
Michael Kerrisk [Tue, 22 Sep 2020 07:30:31 +0000 (09:30 +0200)] 
system_data_types.7: Add description of sigset_t

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Add brief description of regmatch_t
Michael Kerrisk [Tue, 22 Sep 2020 07:18:41 +0000 (09:18 +0200)] 
system_data_types.7: Add brief description of regmatch_t

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agofenv_t.3: New link to new documented type in system_data_types(7)
Alejandro Colomar [Mon, 21 Sep 2020 15:25:17 +0000 (17:25 +0200)] 
fenv_t.3: New link to new documented type in system_data_types(7)

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Document fenv_t
Alejandro Colomar [Mon, 21 Sep 2020 15:25:16 +0000 (17:25 +0200)] 
system_data_types.7: Document fenv_t

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: wfix
Alejandro Colomar [Mon, 21 Sep 2020 14:47:15 +0000 (16:47 +0200)] 
system_data_types.7: wfix

A limit can be defined by other than POSIX

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Minor tweaks to Alejandro Colomar's patch
Michael Kerrisk [Mon, 21 Sep 2020 14:08:18 +0000 (16:08 +0200)] 
system_data_types.7: Minor tweaks to Alejandro Colomar's patch

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Describe use of printf()/scanf() modifiers for integer data...
Alejandro Colomar [Mon, 21 Sep 2020 13:32:57 +0000 (15:32 +0200)] 
system_data_types.7: Describe use of printf()/scanf() modifiers for integer data types

Add note about length modifiers and conversions to [u]intmax_t,
and add a corresponding example.

Reported-by: Michael Kerrisk <mtk.manpages@gmail.com>
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Minor tweaks to Alejandro Colomar's patch
Michael Kerrisk [Sun, 20 Sep 2020 20:14:51 +0000 (22:14 +0200)] 
system_data_types.7: Minor tweaks to Alejandro Colomar's patch

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Specify the length modifiers for the variables that have them
Alejandro Colomar [Sun, 20 Sep 2020 18:14:08 +0000 (20:14 +0200)] 
system_data_types.7: Specify the length modifiers for the variables that have them

Reported-by: Florian Weimer <fweimer@redhat.com>
Reported-by: Paul Eggert <eggert@cs.ucla.edu>
Reviewed-by: Paul Eggert <eggert@cs.ucla.edu>
Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosiginfo_t.3: New link to new documented type in system_data_types(7)
Alejandro Colomar [Sun, 20 Sep 2020 18:05:52 +0000 (20:05 +0200)] 
siginfo_t.3: New link to new documented type in system_data_types(7)

Signed-off-by: Alejandro Colomar <colomar.6.4.3@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
4 years agosystem_data_types.7: Defer to sigaction(2) for further information on siginfo_t
Michael Kerrisk [Sun, 20 Sep 2020 20:07:11 +0000 (22:07 +0200)] 
system_data_types.7: Defer to sigaction(2) for further information on siginfo_t

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>