Commit Graph

14622 Commits

Author SHA1 Message Date
Mike Frysinger bb6adc5828 user_namespaces.7: tfix
Signed-off-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-09-13 09:52:05 +02:00
Michael Kerrisk b4b436adfb ptrace.2: Minor tweaks to Tycho's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-09-11 14:00:59 +02:00
Tycho Andersen e3cfeba2ff ptrace.2: Document PTRACE_O_SUSPEND_SECCOMP flag
Signed-off-by: Tycho Andersen <tycho.andersen@canonical.com>
CC: Kees Cook <keescook@chromium.org>
CC: Andy Lutomirski <luto@amacapital.net>
CC: Oleg Nesterov <oleg@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-09-11 14:00:31 +02:00
Eric B Munson a0742a27be mremap.2: Add note about mremap() with locked areas
When mremap() is used to move or expand a mapping that is locked
with mlock() or equivalent it will attempt to populate the new
area.  However, like mmap(MAP_LOCKED), mremap() will not fail if
the area cannot be populated.  Also like mmap(MAP_LOCKED) this
might come as a surprise to users and should be noted.

Signed-off-by: Eric B Munson <emunson@akamai.com>
Acked-by: Michal Hocko <mhocko@suse.com>
Cc: Michal Hocko <mhocko@suse.cz>
Cc: David Rientjes <rientjes@google.com>
Cc: linux-man@vger.kernel.org
Cc: linux-mm@kvack.org
Cc: linux-kernel@vger.kernel.org
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-09-11 13:45:35 +02:00
Michael Kerrisk e8aa7100f5 proc.5: wfix + tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-09-11 13:35:36 +02:00
Heinrich Schuchardt 84ff8c1e2d proc.5: /proc/sys: Describe whitespace characters
Suggested patch
https://lkml.org/lkml/2015/8/24/171
indicates missing documentation.

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-09-11 13:32:26 +02:00
Michael Kerrisk 2e2b236434 proc.5: wfix + ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-09-11 13:30:05 +02:00
Michael Kerrisk 004b062d87 proc.5: Note kernel version that introduced threads-max range checks
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-09-11 13:27:41 +02:00
Heinrich Schuchardt 6fb0f56f98 proc.5: Add details for threads-max
Add detail information for threads-max.
The checks for minimum and maximum values exist since kernel 4.1.
https://lkml.org/lkml/2015/3/15/96

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-09-11 13:16:01 +02:00
Michael Kerrisk adce1084de signal.7: Note async-signal-safe functions added by POSIX.1-2008 TC1
Reported-by: Michael Hocko <mhocko@kernel.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-09-11 12:58:55 +02:00
Michael Kerrisk 3a09fae856 getspnam.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-09-11 12:09:57 +02:00
Zeng Linggang b6c73e0bdf termios.3: srcfix: add FIXME
Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-09-11 12:07:24 +02:00
Zeng Linggang eabb7166a9 sigpause.3: srcfix: add FIXME
Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-09-11 12:07:02 +02:00
Zeng Linggang c32cf2684a mallinfo.3: ATTRIBUTES: Note function that is not thread-safe
The marking matches glibc marking.
The marking of functions in glibc is:
- mallinfo: MT-Unsafe init const:mallopt

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-09-11 12:06:44 +02:00
Zeng Linggang 557d7d9682 getspnam.3: ATTRIBUTES: Note functions that are/aren't thread-safe
After research, We think
* getspnam(),
* getspent(),
* setspent(),
* endspent(),
* getspent_r(),
* fgetspent(),
* sgetspent(),
are not thread-safe. And
* putspent(),
* getspnam_r(),
* sgetspent_r(),
* lckpwdf(),
* ulckpwdf(),
* fgetspent_r(),
are thread-safe. But, there are not
markings of them in glibc document.

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-09-11 12:06:23 +02:00
Zeng Linggang 1ec27c36ff fgetpwent.3: ATTRIBUTES: Note function that is not thread-safe
The marking matches glibc marking.
marking of function in glibc is:
- fgetgrent: MT-Unsafe race:fpwent

ps: We think race:fpwent in glibc maybe hard for users to understand,
and have sent a patch to the GNU libc community for changing it to
race:fgetpwent, however, something about the copyright impeded the progress.
Here we mark it "race:fgetpwent", so there is a little different.

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-09-11 12:06:08 +02:00
Zeng Linggang 098cd28bbf fgetgrent.3: ATTRIBUTES: Note function that is not thread-safe
The marking matches glibc marking.
marking of function in glibc is:
- fgetgrent: MT-Unsafe race:fgrent

ps: We think race:fgrent in glibc maybe hard for users to understand,
and have sent a patch to the GNU libc community for changing it to
race:fgetgrent, however, something about the copyright impeded the progress.
Here we mark it "race:fgetgrent", so there is a little different.

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-09-11 12:05:11 +02:00
Michael Kerrisk 48453bada1 tcp.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-09-11 11:15:31 +02:00
Michael Kerrisk 935181bb5c tcp.7: Add some version details for 'tcp_ecn' changes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-09-11 11:15:31 +02:00
Daniel Borkmann b95e7457d2 tcp.7: Improve paragraphs on tcp_ecn and add tcp_ecn_fallback bullet
Improve description of tcp_ecn, fix the RFC number and it's
not a boolean anymore since long time, and add a description
for tcp_ecn_fallback.

See also kernel doc under Documentation/networking/ip-sysctl.txt
on tcp_ecn and tcp_ecn_fallback.

Signed-off-by: Daniel Borkmann <daniel@iogearbox.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-09-11 10:49:13 +02:00
Jakub Wilk 0d28496a14 getent.1: ffix
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-09-11 10:44:40 +02:00
Ville Skyttä 2b91715912 man-pages.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-09-05 09:02:09 +02:00
Michael Kerrisk d74503a55a seccomp.2: Note why all filters in a set are executed even after SECCOMP_RET_KILL
Reported-by: Kees Cook <keescook@chromium.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-09-05 09:00:02 +02:00
Michael Kerrisk 755a656a49 seccomp.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-09-05 08:51:37 +02:00
Michael Kerrisk 712551eaad seccomp.2: Describe use of 'instruction_pointer' data field
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-09-05 08:43:31 +02:00
Michael Kerrisk 944a31e27f seccomp.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-09-05 08:31:14 +02:00
Tobias Stoeckmann 9933634495 setsid.2: tfix
it -> its

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-30 05:07:22 -07:00
Michael Kerrisk b72bd8d1c0 mallopt.3: Minor wording fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-30 05:02:25 -07:00
Michael Kerrisk bb1ee72e6f mallopt.3: Minor tweaks to Carlos's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-30 05:02:25 -07:00
Carlos O'Donell 9d116bd272 mallopt.3: Document M_ARENA_TEST and M_ARENA_MAX
In 2013 I brought up the discussion if M_ARENA_MAX and M_ARENA_TEST
were public parameters:
https://sourceware.org/ml/libc-alpha/2013-03/msg00376.html
Consensus among Siddhesh and myself was that they should be
public, and in fact they were already in the public header.
Therefore there may already be applications uses these constants
and expecting them to work. At best we could limit mallopt()'s
acceptance of the options, but that seems like a bad solution
that could lead to unexpected behavior for user applications.
A quick google search shows that there are packages relying on
these constants to tune the glibc malloc implementation.

Since glibc 2.10 the M_ARENA_TEST and M_ARENA_MAX features
have been part of the public interface with
--enable-experimental-malloc.

Since glibc 2.15 the experimental allocator has been on by default
and M_ARENA_TEST and M_ARENA_MAX have been more broadly used.

There are environment variables, without trailing underscore, that
can also be used to adjust these values at runtime i.e.
MALLOC_ARENA_MAX, and MALLOC_ARENA_TEST.

This change describes these two options in the mallopt(3) man page
along with their environment variables.

Tested with glibc master on x86_64 to verify it works as expected.

Signed-off-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-30 03:09:38 -07:00
Michael Kerrisk 3f81631283 signalfd.2: Describe semantics with respect to SCM_RIGHTS
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-19 14:19:56 -07:00
Michael Kerrisk 15fb5d0374 open.2: Remove accidental mention of O_TTY_INIT
An earlier edit mentioned O_TTY_INIT as a file creation flag.
That's true, according POSIX, but Linux does not implement
this flag, so remove mention of it.

Reported-by: David Drysdale <drysdale@google.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-14 18:04:52 +02:00
Michael Kerrisk a58feaee8b mq_overview.7: Document QSIZE bug that appeared in 3.5 and was fixed in 4.2
Reported-by: Arto Bendiken <arto@bendiken.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-09 13:22:54 +02:00
Michael Kerrisk 98955680b3 Changes.old: tfix in 4.02 changelog
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-09 08:12:54 +02:00
Michael Kerrisk 422dc09a18 Start of man-pages-4.03: updating Changes and Changes.old 2015-08-08 18:24:47 +02:00
Michael Kerrisk ef5b79437a Start of man-pages-4.03: updating .Announce and .lsm files 2015-08-08 18:24:47 +02:00
Michael Kerrisk cf2e2eae63 Start of man-pages-4.03: renaming .Announce and .lsm files 2015-08-08 18:24:47 +02:00
Michael Kerrisk 91db769b89 Ready for 4.02 2015-08-08 18:24:03 +02:00
Michael Kerrisk 30ea59e720 Removed trailing white space at end of lines 2015-08-08 18:23:54 +02:00
Michael Kerrisk d6dcb338fc mktemp.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 18:22:46 +02:00
Michael Kerrisk 460495ca58 ldd.1, sprof.1, accept.2, alarm.2, bind.2, chdir.2, clock_nanosleep.2, close.2, connect.2, dup.2, execve.2, fsync.2, getgid.2, getpeername.2, getsid.2, getsockname.2, getsockopt.2, getuid.2, io_getevents.2, kill.2, listen.2, lseek.2, mmap.2, msgctl.2, msgget.2, msgop.2, msync.2, nanosleep.2, nice.2, pause.2, pipe.2, rmdir.2, sched_get_priority_max.2, sched_rr_get_interval.2, sched_setparam.2, sched_setscheduler.2, sched_yield.2, select_tut.2, semctl.2, semop.2, setsid.2, shmctl.2, shmget.2, shmop.2, shutdown.2, sigaction.2, signal.2, socketpair.2, sync.2, timer_delete.2, timer_getoverrun.2, timer_settime.2, times.2, truncate.2, umask.2, MB_CUR_MAX.3, a64l.3, abs.3, assert.3, atexit.3, atof.3, atoi.3, basename.3, bsearch.3, btowc.3, byteorder.3, catgets.3, catopen.3, clock.3, clock_getcpuclockid.3, closedir.3, confstr.3, crypt.3, ctermid.3, difftime.3, div.3, dladdr.3, dlerror.3, dlinfo.3, dlopen.3, dlsym.3, drand48.3, encrypt.3, exit.3, fclose.3, ffs.3, fgetc.3, fgetwc.3, fgetws.3, flockfile.3, fmtmsg.3, fnmatch.3, fopen.3, fpathconf.3, fpclassify.3, fputwc.3, fputws.3, fseek.3, fseeko.3, ftok.3, fwide.3, getdate.3, getenv.3, getgrent.3, getgrnam.3, gethostid.3, getlogin.3, getnetent.3, getopt.3, getpwent.3, getpwnam.3, getsubopt.3, getutent.3, getwchar.3, grantpt.3, hsearch.3, iconv.3, iconv_close.3, iconv_open.3, if_nameindex.3, inet.3, inet_ntop.3, inet_pton.3, insque.3, isatty.3, isgreater.3, iswalnum.3, iswalpha.3, iswblank.3, iswcntrl.3, iswctype.3, iswdigit.3, iswgraph.3, iswlower.3, iswprint.3, iswpunct.3, iswspace.3, iswupper.3, iswxdigit.3, lockf.3, longjmp.3, lsearch.3, malloc.3, mblen.3, mbrlen.3, mbrtowc.3, mbsinit.3, mbsrtowcs.3, mbstowcs.3, mbtowc.3, memccpy.3, memchr.3, memcmp.3, memmove.3, memset.3, mktemp.3, mq_close.3, mq_getattr.3, mq_receive.3, mq_send.3, mq_unlink.3, offsetof.3, popen.3, posix_memalign.3, posix_openpt.3, printf.3, pthread_attr_setdetachstate.3, pthread_attr_setguardsize.3, pthread_attr_setinheritsched.3, pthread_attr_setschedparam.3, pthread_attr_setschedpolicy.3, pthread_attr_setscope.3, pthread_attr_setstack.3, pthread_attr_setstacksize.3, pthread_equal.3, pthread_exit.3, pthread_getcpuclockid.3, pthread_kill.3, pthread_self.3, pthread_setcancelstate.3, pthread_setconcurrency.3, pthread_setschedparam.3, pthread_setschedprio.3, pthread_sigmask.3, pthread_testcancel.3, ptsname.3, putenv.3, puts.3, putwchar.3, qsort.3, raise.3, random.3, readdir.3, regex.3, remove.3, rewinddir.3, seekdir.3, sem_destroy.3, sem_getvalue.3, sem_unlink.3, sem_wait.3, setenv.3, setjmp.3, setlocale.3, setlogmask.3, signbit.3, sigpause.3, sigset.3, sigsetops.3, sigwait.3, sleep.3, sockatmark.3, statvfs.3, strcat.3, strchr.3, strcmp.3, strcoll.3, strcpy.3, strlen.3, strpbrk.3, strptime.3, strspn.3, strstr.3, strtod.3, strtoimax.3, strtok.3, strtol.3, strtoul.3, strxfrm.3, swab.3, sysconf.3, system.3, tcgetpgrp.3, tcgetsid.3, telldir.3, tmpfile.3, towctrans.3, tsearch.3, ttyname.3, tzset.3, ungetwc.3, unlocked_stdio.3, unlockpt.3, wcrtomb.3, wcscat.3, wcschr.3, wcscmp.3, wcscpy.3, wcscspn.3, wcslen.3, wcsncat.3, wcsncmp.3, wcsncpy.3, wcspbrk.3, wcsrchr.3, wcsrtombs.3, wcsspn.3, wcsstr.3, wcstoimax.3, wcstok.3, wcstombs.3, wcswidth.3, wctob.3, wctomb.3, wctrans.3, wctype.3, wcwidth.3, wmemchr.3, wmemcmp.3, wmemcpy.3, wmemmove.3, wmemset.3, wordexp.3, wprintf.3, fanotify.7, mq_overview.7, nptl.7, sem_overview.7, shm_overview.7, sigevent.7, symlink.7, ld.so.8: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 18:21:22 +02:00
Michael Kerrisk 7008decb00 Changes: Ready for 4.02
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 18:19:08 +02:00
Michael Kerrisk 80bf84f684 nl_langinfo.3: srcfix (copyright)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:59:17 +02:00
Michael Kerrisk 3fc0259556 dlinfo.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:38:51 +02:00
Michael Kerrisk 78f2bf20fb dlinfo.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:38:37 +02:00
Michael Kerrisk 0fdbc11423 dlopen.3: Note a case where dlmopen() provides better isolation than RTLD_LOCAL
Cowritten-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:45 +02:00
Michael Kerrisk 6fd1b6ebb7 dlopen.3: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:45 +02:00
Michael Kerrisk 438168a249 dlopen.3: wfix
Reported-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:45 +02:00
Michael Kerrisk ce65f81e7a dladdr.3: Minor wording fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:45 +02:00
Michael Kerrisk 51f796a450 dlinfo.3: ATTRIBUTES: Note function that is thread-safe
After research, we think
* dlinfo()
is thread-safe. But, there are not markings of it in
glibc document.

[mtk: split out of a larger dlopen() patch]

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:45 +02:00