]>
git.ipfire.org Git - thirdparty/man-pages.git/log
Michael Kerrisk [Sat, 10 Dec 2016 10:23:42 +0000 (11:23 +0100)]
environ.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sat, 10 Dec 2016 10:12:44 +0000 (11:12 +0100)]
mdoc.7: Add a cross-reference to groff_mdoc(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sat, 10 Dec 2016 10:11:28 +0000 (11:11 +0100)]
mdoc.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sat, 10 Dec 2016 09:58:51 +0000 (10:58 +0100)]
fsync.2: SEE ALSO: add fflush(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sat, 10 Dec 2016 09:57:02 +0000 (10:57 +0100)]
fsync.2: SEE ALSO: add fileno(3)
fileno(3) is useful if one is combining fflush(3)/fclose(3)
and fsync(2).
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sat, 10 Dec 2016 09:56:12 +0000 (10:56 +0100)]
fclose.3, fflush.3: SEE ALSO: add fileno(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sat, 10 Dec 2016 09:47:56 +0000 (10:47 +0100)]
fclose.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Fri, 9 Dec 2016 12:12:43 +0000 (13:12 +0100)]
clone.2: Remove ancient libc5 details
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Fri, 9 Dec 2016 12:06:43 +0000 (13:06 +0100)]
insque.3: Remove mention of ancient systems (libc4 and libc5)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Fri, 9 Dec 2016 12:05:29 +0000 (13:05 +0100)]
reboot.2: Remove mention of ancient libc4 and lib5
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Fri, 9 Dec 2016 12:03:59 +0000 (13:03 +0100)]
reboot.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Fri, 9 Dec 2016 12:00:46 +0000 (13:00 +0100)]
accept.2: Simplify the discussion of 'socklen_t'
We don't really need to list the old OSes in this discussion.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Fri, 9 Dec 2016 11:51:23 +0000 (12:51 +0100)]
bind.2, connect.2, getpeername.2, getsockname.2, getsockopt.2: Replace discussion of 'socklen_t' with reference to accept(2)
The discussion of 'socklen_t' editorializes and is repeated
across several pages. Replace it with a reference to accept(2),
where some details about this type are provided.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Fri, 9 Dec 2016 12:14:26 +0000 (13:14 +0100)]
libc.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Fri, 9 Dec 2016 11:43:15 +0000 (12:43 +0100)]
libc.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Fri, 9 Dec 2016 11:41:04 +0000 (12:41 +0100)]
libc.7: Add a note on why glibc 2.x uses the soname libc.so.6
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Fri, 9 Dec 2016 11:39:28 +0000 (12:39 +0100)]
libc.7: Add a few historical details on Linux libc4 and libc5
Just for historical interest. Details taken from
http://www.linux-m68k.org/faq/glibcinfo.html.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Fri, 9 Dec 2016 08:33:26 +0000 (09:33 +0100)]
setjmp.3: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Fri, 9 Dec 2016 08:28:51 +0000 (09:28 +0100)]
setjmp.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Fri, 9 Dec 2016 08:25:49 +0000 (09:25 +0100)]
setjmp.3: Improve description of pre-2.19 glibc default behavior
Make it clearer that the default FTM settings result in
BSD semantics for setjmp().
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Fri, 9 Dec 2016 08:06:11 +0000 (09:06 +0100)]
basename.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Thu, 8 Dec 2016 13:06:34 +0000 (14:06 +0100)]
mq_close.3: DESCRIPTION: add reference to mq_notify(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Thu, 8 Dec 2016 13:06:02 +0000 (14:06 +0100)]
tmpnam.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Thu, 8 Dec 2016 09:07:50 +0000 (10:07 +0100)]
close.2: Place discussion of error handling under a subheading in NOTES
No content changes.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Thu, 8 Dec 2016 08:59:23 +0000 (09:59 +0100)]
feature_test_macros.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Thu, 8 Dec 2016 08:38:08 +0000 (09:38 +0100)]
tmpnam.3: Properly document tmpnam_r(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Wainer dos Santos Moschetta [Wed, 7 Dec 2016 12:54:54 +0000 (10:54 -0200)]
strtod.3: SEE ALSO: add strfromd(3)
Signed-off-by: Wainer dos Santos Moschetta <wainersm@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Wainer dos Santos Moschetta [Wed, 7 Dec 2016 12:54:53 +0000 (10:54 -0200)]
printf.3: SEE ALSO: add strfromd(3)
Signed-off-by: Wainer dos Santos Moschetta <wainersm@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Wainer dos Santos Moschetta [Wed, 7 Dec 2016 12:54:52 +0000 (10:54 -0200)]
atof.3: SEE ALSO: add strfromd(3)
Signed-off-by: Wainer dos Santos Moschetta <wainersm@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Wainer dos Santos Moschetta [Wed, 7 Dec 2016 12:54:51 +0000 (10:54 -0200)]
strfroml.3: New link to strfromd(3)
Signed-off-by: Wainer dos Santos Moschetta <wainersm@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Wainer dos Santos Moschetta [Wed, 7 Dec 2016 12:54:50 +0000 (10:54 -0200)]
strfromf.3: New link to strfromd(3)
Signed-off-by: Wainer dos Santos Moschetta <wainersm@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Wed, 7 Dec 2016 15:36:22 +0000 (16:36 +0100)]
strfromd.3: Minor tweaks to Wainer dos Santos Moschetta's page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Wainer dos Santos Moschetta [Wed, 7 Dec 2016 12:54:49 +0000 (10:54 -0200)]
strfromd.3: New page documenting strfromd(3), strfromf(3), and strfroml(3)
The ISO/IEC TS 18661-1 specifies the strfrom() class
of functions that convert a float-point value to string.
The strfromd(), strfromf(), and strfroml() functions are
introduced (commit
6962682ffe5e ) in GNU C Library 2.25.
Signed-off-by: Wainer dos Santos Moschetta <wainersm@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Wed, 7 Dec 2016 15:03:07 +0000 (16:03 +0100)]
sock_diag.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Wed, 7 Dec 2016 14:50:47 +0000 (15:50 +0100)]
sock_diag.7: More minor fixes to Dmitry's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Wed, 7 Dec 2016 14:50:04 +0000 (15:50 +0100)]
sock_diag.7: ffix: better hanging lists
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Wed, 7 Dec 2016 14:43:47 +0000 (15:43 +0100)]
sock_diag.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Wed, 7 Dec 2016 14:40:29 +0000 (15:40 +0100)]
sock_diag.7: Tweaks to Dmitry Levin's page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Wed, 7 Dec 2016 14:23:33 +0000 (15:23 +0100)]
sock_diag.7: ffix: white space tweaks in example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Wed, 7 Dec 2016 14:18:48 +0000 (15:18 +0100)]
sock_diag.7: srcfix: rewrap long lines
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Wed, 7 Dec 2016 14:15:53 +0000 (15:15 +0100)]
netlink.7: Rework position of NETLINK_SOCK_DIAG in list
Essentially to fix a formatting issue, where the list head
item wrapped past the 80-column limit when rendered.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Dmitry V. Levin [Wed, 7 Dec 2016 14:00:15 +0000 (17:00 +0300)]
netlink.7: Add references to sock_diag(7)
Signed-off-by: Dmitry V. Levin <ldv@altlinux.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Dmitry V. Levin [Wed, 7 Dec 2016 13:59:58 +0000 (16:59 +0300)]
netlink.7: Document NETLINK_INET_DIAG rename to NETLINK_SOCK_DIAG
Signed-off-by: Dmitry V. Levin <ldv@altlinux.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Pavel Emelyanov [Wed, 7 Dec 2016 13:59:43 +0000 (16:59 +0300)]
sock_diag.7: New page documenting NETLINK_SOCK_DIAG interface
Co-authored-by: Dmitry V. Levin <ldv@altlinux.org>
Signed-off-by: Pavel Emelyanov <xemul@virtuozzo.com>
Signed-off-by: Dmitry V. Levin <ldv@altlinux.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Dmitry V. Levin [Wed, 7 Dec 2016 14:04:24 +0000 (17:04 +0300)]
netlink.7: ffix
Signed-off-by: Dmitry V. Levin <ldv@altlinux.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Wed, 7 Dec 2016 07:28:29 +0000 (08:28 +0100)]
close.2: Note that future POSIX plans to require that the FD is closed on error
See http://austingroupbugs.net/view.php?id=529#c1200.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Wed, 7 Dec 2016 07:26:44 +0000 (08:26 +0100)]
close.2: Further reworking of discussion of error return from close()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Tue, 6 Dec 2016 15:29:39 +0000 (16:29 +0100)]
close.2: srcfix: FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Tue, 6 Dec 2016 15:23:33 +0000 (16:23 +0100)]
close.2: Further clarify how to treat an error return
Further clarify that an error return should be used only
for diagnostic or remedial purposes.
Lifting Linus's words freely from
http://lkml.iu.edu/hypermail/linux/kernel/0207.2/0409.html
Re: close return value (was Re: [ANNOUNCE] Ext3 vs Reiserfs benchmarks)
Date: Wed Jul 17 2002 - 12:43:57 EST
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Tue, 6 Dec 2016 15:03:51 +0000 (16:03 +0100)]
close.2: Other UNIX implementations also close the FD, even if reporting an error
Looking at some historical source code (mostly from [1]) suggests
that the "close() always closes regardless of error return"
behavior has a long history, predating even POSIX.1-1990.
For example, in SVR4 for x86 (from the file sysvr4.tar.bz2 at
[1]), we see the following:
int
close(uap, rvp)
register struct closea *uap;
rval_t *rvp;
{
file_t *fp;
register int error;
if (error = getf(uap->fdes, &fp))
return error;
error = closef(fp);
setf(uap->fdes, NULLFP);
return error;
}
In the above, getf() can return EBADF. The other errors are
returned by closef(), but the file descriptor is deallocated
regardless of errors by setf().
A similar pattern seems to have been preserved into at least late
OpenSolaris days (verified from looking at the initial commit of
the illumos source code). There we find the following in
closeandsetf() (called by close()):
error = closef(fp);
setf(fd, newfp);
return (error);
Looking at the code of closef() in AIX 4.1.3 suggests that, as on
on Linux and FreeBSD, the open file is always released, regardless
of errors.
For Irix, 6.5.5, I'm not sure (the code is not so easy to quickly
read); it may be that it does return errors while leaving the FD
open.
[1] https://archive.org/download/various_operating_system_source_code
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Tue, 6 Dec 2016 14:48:54 +0000 (15:48 +0100)]
close.2: Minor text reworking
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Tue, 6 Dec 2016 14:45:24 +0000 (15:45 +0100)]
close.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Tue, 6 Dec 2016 14:42:36 +0000 (15:42 +0100)]
close.2: Minor text relocation
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Tue, 6 Dec 2016 14:40:05 +0000 (15:40 +0100)]
close.2: Clarify the variation in EINTR behavior per POSIX and other systems
See also https://news.ycombinator.com/item?id=
3363819
and http://www.daemonology.net/blog/2011-12-17-POSIX-close-is-broken.html
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Tue, 6 Dec 2016 14:13:21 +0000 (15:13 +0100)]
close.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Tue, 6 Dec 2016 14:09:55 +0000 (15:09 +0100)]
close.2: Rework initial paragraph in NOTES on checking close() errors
As Daniel Wagner noted, saying on the one hand that failing
to check the return value of close() is a "serious error"
seems contradicted by the next paragraph that notes that
the return value should be used for "just diagnostics".
Rework the text to resolve the apparent contradiction.
Reported-by: Daniel Wagner <wagi@monom.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Tue, 6 Dec 2016 14:00:59 +0000 (15:00 +0100)]
close.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Carlos O'Donell [Mon, 5 Dec 2016 16:09:54 +0000 (11:09 -0500)]
resolv.conf.5: Timeout does not map to resolver API calls
I'm posting this patch to clarify the timeout behaviour because
there have been developers who expect this timeout to mean
something it is not.
The timeout (and by proxy attempts) does not map to resolver API
calls. For example a single call to getent might involve multiple
resolution requests to the resolvers listed in resolv.conf and
each request will use TIMEOUT and be attempted at least ATTEMPT
times. A developer using the resolver API cannot easily compute
any given timeout because the implementation may change e.g. A and
AAAA queries made in parallel. A system administrator uses this
setting to ensure there is a desirable timeout on any request to
any of the nameservers listed in resolv.conf, but no guarantees
exist beyond that.
Reviewed-by: Florian Weimer <fweimer@redhat.com>
Signed-off-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 5 Dec 2016 15:07:12 +0000 (16:07 +0100)]
mmap.2: srcfix: FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 5 Dec 2016 14:59:38 +0000 (15:59 +0100)]
strerror.3: srcfix: FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 5 Dec 2016 14:57:37 +0000 (15:57 +0100)]
open.2: srcfix: FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 5 Dec 2016 14:54:59 +0000 (15:54 +0100)]
ptsname.3: Note that ptsname_r() is proposed for future inclusion in POSIX.1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 5 Dec 2016 14:52:20 +0000 (15:52 +0100)]
ptsname.3: CONFORMING TO:: clarify that only ptsname() is standardized (so far)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 5 Dec 2016 13:23:20 +0000 (14:23 +0100)]
close.2: Further clarify that close() should not be retried after an error
See Linus ancient comments re EINTR in
https://lkml.org/lkml/headers/2005/9/10/129
Date Sat, 10 Sep 2005 12:00:01 -0700 (PDT)
From Linus Torvalds <>
Subject Re: [patch 7/7] uml: retry host close() on EINTR
The FreeBSD 11.0 close() man page says similar:
In case of any error except EBADF, the supplied file
descriptor is deallocated and therefore is no longer valid.
For AIX:
http://publib16.boulder.ibm.com/doc_link/en_US/a_doc_lib/libs/basetrf1/close.htm
If the FileDescriptor parameter refers to a device and the
close subroutine actually results in a device close, and the
device close routine returns an error, the error is returned
to the application. However, the FileDescriptor parameter is
considered closed and it may not be used in any subsequent
calls.
See also:
http://austingroupbugs.net/view.php?id=529
and in particular:
http://austingroupbugs.net/view.php?id=529#c1200
Reported-by: Daniel Wagner <wagi@monom.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 5 Dec 2016 11:31:37 +0000 (12:31 +0100)]
symlink.7: SEE ALSO: add namei(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 5 Dec 2016 11:28:21 +0000 (12:28 +0100)]
credentials.7: SEE ALSO: add shadow(5)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 5 Dec 2016 08:18:40 +0000 (09:18 +0100)]
nice.2: Move discussion of handling the -1 success return to RETURN VALUE
This detail was rather hidden in NOTES. Also, rework the text
a little.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 5 Dec 2016 08:16:00 +0000 (09:16 +0100)]
nice.2: CONFORMING TO: Remove an ancient SVr4 detail on errno values
At this stage, vague details (when does EINVAL get returned?) of
ancient implementations are little more than noise in the page.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 5 Dec 2016 08:13:52 +0000 (09:13 +0100)]
nice.2: Rework discussion of nice() return value and standards conformance
Make the text a little clearer. In particular, clarify that the
raw system call (still) returns 0 on success.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 5 Dec 2016 07:59:31 +0000 (08:59 +0100)]
nice.2: Add mention of RLIMIT_NICE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 5 Dec 2016 07:17:23 +0000 (08:17 +0100)]
signal.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 5 Dec 2016 07:23:21 +0000 (08:23 +0100)]
getrlimit.2: Refer to sched(7) in discussion of RLIMIT_RTPRIO and RLIMIT_RTTIME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 5 Dec 2016 07:20:35 +0000 (08:20 +0100)]
getrlimit.2: SEE ALSO: add credentials(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 5 Dec 2016 07:12:43 +0000 (08:12 +0100)]
getrlimit.2: refer to sched(7) in the discussion of RLIMIT_NICE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 5 Dec 2016 07:12:03 +0000 (08:12 +0100)]
getrlimit.2: Minor wording fix for RLIMIT_NICE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Mon, 5 Dec 2016 07:10:29 +0000 (08:10 +0100)]
getrlimit.2: Describe the range of the RLIMIT_NICE limit
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Wed, 30 Nov 2016 17:19:14 +0000 (18:19 +0100)]
setsid.2: SEE ALSO: add sched(7)
List sched(7), because setsid(2) is part of the machinery
of autogrouping.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Kees Cook [Sat, 3 Dec 2016 04:37:29 +0000 (20:37 -0800)]
bpf.2: tfix
Changed to "will" instead of "with".
Signed-off-by: Kees Cook <keescook@chromium.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Wed, 30 Nov 2016 17:29:01 +0000 (18:29 +0100)]
nice.2: Warn that autogrouping voids the effect of 'nice' in many cases
Refer the reader to sched(7) for the details.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Wed, 30 Nov 2016 17:27:02 +0000 (18:27 +0100)]
getpriority.2: Warn that autogrouping voids the effect of 'nice' in many cases
Refer the reader to sched(7) for the details.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sun, 4 Dec 2016 10:53:16 +0000 (11:53 +0100)]
sched.7: Clarify that autogroup defaults on in various distros
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Fri, 2 Dec 2016 09:22:04 +0000 (10:22 +0100)]
sched.7: Note command that can be used to modify the autogroup nice value
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Tue, 29 Nov 2016 06:34:53 +0000 (07:34 +0100)]
sched.7: Improve section on nice value and group scheduling
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sun, 27 Nov 2016 21:56:12 +0000 (22:56 +0100)]
sched.7: Relocate discussion of group scheduling
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sun, 27 Nov 2016 21:45:22 +0000 (22:45 +0100)]
sched.7: Clarify details of autogroup nice value
Also clarify its interactions with the thread nice value.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sun, 27 Nov 2016 21:29:57 +0000 (22:29 +0100)]
sched.7: srcfix: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sun, 27 Nov 2016 21:28:02 +0000 (22:28 +0100)]
sched.7: Further clarify scheduling policies for which autogroup applied
Further clarify that autogroup groups only SCHED_OTHER/SCHED_NICE/
SCHED_IDLE processes.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sun, 27 Nov 2016 19:18:08 +0000 (20:18 +0100)]
sched.7: Add a subsection on group scheduling
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sun, 27 Nov 2016 19:20:01 +0000 (20:20 +0100)]
sched.7: Tweak description of cgroups overriding autogroup
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sat, 26 Nov 2016 14:17:27 +0000 (15:17 +0100)]
sched.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sat, 26 Nov 2016 14:16:29 +0000 (15:16 +0100)]
sched.7: Note error that occurs when writing invalid value to /proc/PID/autogroup
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Fri, 25 Nov 2016 14:54:20 +0000 (15:54 +0100)]
sched.7: Further clarify details of group scheduling
After comments by Mike Galbraith.
Reported-by: Mike Galbraith <efault@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Fri, 25 Nov 2016 13:03:35 +0000 (14:03 +0100)]
sched.7: wfix
Reported-by: Afzal Mohammed <afzal.mohd.ma@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Thu, 24 Nov 2016 21:17:17 +0000 (22:17 +0100)]
sched.7: srcfix: add details to FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Thu, 24 Nov 2016 20:20:03 +0000 (21:20 +0100)]
sched.7: Rework discussion of autogroups
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Wed, 23 Nov 2016 14:31:07 +0000 (15:31 +0100)]
sched.7: Rework discussion of autogroup nice value
Remove the text saying that setting the autogroup nice value
always lowers the group's priority. That was actually a
bug introduced in Linux 4.7.
Also make it clearer that the autogroup nice value has the same
meaning as the nice value set by setpriority(2).
Reported-by: Mike Galbraith <efault@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Tue, 22 Nov 2016 12:54:08 +0000 (13:54 +0100)]
proc.5: Add pointers to sched(7) for autogroup files
sched(7) describes /proc/sys/kernel/sched_autogroup_enabled
and /proc/PID/autogroup.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Tue, 22 Nov 2016 13:43:31 +0000 (14:43 +0100)]
sched.7: Document the autogroup feature
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Sun, 27 Nov 2016 14:55:51 +0000 (15:55 +0100)]
getpriority.2: The nice value supplied to setpriority() is clamped
Note that the nice value supplied to setpriority() is clamped
to the permitted range.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Michael Kerrisk [Tue, 29 Nov 2016 16:55:08 +0000 (17:55 +0100)]
namespaces.7: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>