Carlos O'Donell
dd9454a654
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>
2016-12-06 11:40:16 +01:00
Michael Kerrisk
39b35179bc
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>
2016-11-29 21:50:15 +01:00
Michael Kerrisk
969b3dd60b
elf.5: Minor fixes
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-28 22:19:31 +01:00
Michael Kerrisk
bdd5d782a1
elf.5: Minor fixes
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-28 22:17:38 +01:00
Mike Frysinger
51c705cd36
elf(5): Further details on Notes
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-28 22:13:31 +01:00
Michael Kerrisk
d84631b325
elf.5: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-27 12:06:34 +01:00
Michael Kerrisk
31ea6b8427
elf.5: srcfix: rewrap some long source lines
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-27 12:05:32 +01:00
Michael Kerrisk
08e6d52431
elf.5: A few tweaks to Mike Frysinger's text (Mike to check)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-27 11:59:17 +01:00
Michael Kerrisk
d00f97b555
elf.5: Minor fixes to Mike Frysinger's patch
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-27 11:59:17 +01:00
Mike Frysinger
9c72e3cad8
elf(5): document notes
...
Document the Elf{32,64}_Nhdr structure, the sections/segments that
contain notes, and how to interpret them. I've been lazy and only
included the GNU extensions here, especially as others are not
defined in the elf.h header file as shipped by glibc.
I've mostly used binutils, glibc, breakpad, and the GABI ELF spec
as sources of data for these fields.
Signed-off-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-27 11:15:37 +01:00
Michael Kerrisk
573ae2a478
proc.5: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-22 13:53:24 +01:00
Michael Kerrisk
40382e5ec4
proc.5: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-21 08:31:01 +01:00
Michael Kerrisk
215f434628
elf.5: Minor tweaks to Mike Frysinger's patch
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-17 16:41:36 +01:00
Mike Frysinger
98ec6ed789
elf(5): Add subsection headers at major points
...
The current pages dumps all the content into one big DESCRIPTION
with no real visual break up between logically independent
sections. Add some subsection headers to make it easier to
read and scan.
Signed-off-by: Mike Frysinger <vapier@gentoo.org>
2016-11-17 16:38:37 +01:00
Michael Kerrisk
e8840edfbd
proc.5: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-11 09:29:14 +01:00
Michael Kerrisk
f12f1b9b0b
proc.5: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-11 09:27:58 +01:00
Michael Kerrisk
54c7242d7d
elf.5: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-11 09:23:22 +01:00
Michael Kerrisk
37ad14c2fb
utmp.5: SEE ALSO: add users(1)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-10 11:21:04 +01:00
Michael Kerrisk
9f1002a1c4
proc.5: Mention lslocks(8) in discussion of /proc/locks
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-10 08:55:19 +01:00
Michael Kerrisk
4e07c70f90
fallocate.2, fcntl.2, lseek.2, madvise.2, memfd_create.2, mmap.2, remap_file_pages.2, swapon.2, proc.5, cgroups.7, shm_overview.7, user_namespaces.7: Fix cross references to new tmpfs(5) page
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-07 16:21:41 +01:00
Michael Kerrisk
eb775c04e7
proc.5: Describe Shmem field of /proc/meinfo
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-07 16:21:37 +01:00
Michael Kerrisk
244b15d4dc
tmpfs.5: New page documenting the tmpfs filesystem
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-07 15:44:50 +01:00
Michael Kerrisk
63e56c4b77
proc.5: Add /proc/sys/fs/pipe-user-pages-{hard,soft} entries
...
The entries defer to pipe(7).
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-06 13:14:07 -07:00
Michael Kerrisk
33dc4b59be
proc.5, pipe.7: Move /proc/sys/fs/pipe-max-size content from proc(5) to pipe(7)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-06 13:14:07 -07:00
Michael Kerrisk
43d42cc0a0
proc.5: srcfix: FIXME tidy-up
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-29 13:43:30 +02:00
Michael Kerrisk
2f05728103
proc.5: Add example ProtectionKey output for 'smaps' file
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-17 14:04:06 +02:00
Dave Hansen
be729d667d
proc.5: Describe new ProtectionKey 'smaps' field
...
Signed-off-by: Dave Hansen <dave.hansen@linux.intel.com>
2016-10-17 14:03:28 +02:00
Michael Kerrisk
c3d59262f3
proc.5: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-13 12:57:06 +02:00
Michael Kerrisk
6861f8f0c7
proc.5: Improve description of the KernelPageSize and MMUPageSize 'smaps' fields
...
Rework the text, make it clearer that MMUPageSize is a separate
line, add kernel version numbers, and example output.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-13 12:57:00 +02:00
Michael Kerrisk
eb8487082c
proc.5: Rework 'smaps' VmFlags text, and add kernel version and example output
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-13 11:32:13 +02:00
Michael Kerrisk
9b780b0654
proc.5: Rework 'smaps' ProtectionKey text and add some details
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-13 11:32:08 +02:00
Michael Kerrisk
f64cc74595
killpg.2, crypt.3, mbsinit.3, printf.3, rpc.3, ulimit.3, wprintf.3, xdr.3, fd.4, elf.5, group.5: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-12 16:03:38 +02:00
Michael Kerrisk
b8efb41432
memusage.1, memusagestat.1, pldd.1, accept.2, adjtimex.2, arch_prctl.2, bdflush.2, bpf.2, close.2, epoll_ctl.2, epoll_wait.2, execve.2, execveat.2, fanotify_init.2, fanotify_mark.2, fcntl.2, fsync.2, get_kernel_syms.2, getdomainname.2, getgroups.2, gethostname.2, getrandom.2, getrlimit.2, getrusage.2, getsid.2, getunwind.2, io_getevents.2, ioctl_fat.2, kexec_load.2, killpg.2, listxattr.2, lseek.2, madvise.2, memfd_create.2, mknod.2, mlock.2, modify_ldt.2, msgctl.2, msgget.2, msgop.2, readlink.2, readv.2, reboot.2, recvmmsg.2, rename.2, request_key.2, restart_syscall.2, sched_setaffinity.2, sched_setattr.2, sched_setparam.2, seccomp.2, select_tut.2, semctl.2, semget.2, semop.2, set_thread_area.2, seteuid.2, setgid.2, setpgid.2, setresuid.2, setreuid.2, setsid.2, setuid.2, shmctl.2, shmget.2, shmop.2, sigaction.2, sigprocmask.2, stat.2, symlink.2, syscall.2, sysctl.2, unlink.2, bindresvport.3, byteorder.3, dlopen.3, endian.3, error.3, ffs.3, fmemopen.3, getcwd.3, getlogin.3, getnetent.3, getprotoent.3, getservent.3, getumask.3, getutent.3, glob.3, isalpha.3, lio_listio.3, login.3, mbsinit.3, mbstowcs.3, mbtowc.3, mkstemp.3, nextup.3, ntp_gettime.3, posix_fallocate.3, posix_spawn.3, pthread_join.3, pthread_rwlockattr_setkind_np.3, random.3, rcmd.3, realpath.3, resolver.3, setjmp.3, setnetgrent.3, sigvec.3, strerror.3, strverscmp.3, system.3, toupper.3, towlower.3, towupper.3, wcstombs.3, wordexp.3, cciss.4, loop.4, mouse.4, random.4, core.5, group.5, hosts.5, resolv.conf.5, ascii.7, environ.7, epoll.7, glob.7, ip.7, mq_overview.7, packet.7, pipe.7, raw.7, sched.7, signal.7, socket.7, symlink.7, ld.so.8, sln.8: tstamp
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-08 14:08:23 +02:00
Mike Frysinger
89f929055e
proc(5): ffix
2016-10-07 22:49:38 +02:00
Michael Kerrisk
750653a812
getrusage.2, madvise.2, memfd_create.2, mlock.2, mount.2, getauxval.3, core.5, capabilities.7, pid_namespaces.7, symlink.7, user_namespaces.7: Consistently use /proc/[pid] (not /proc/PID)
...
Reported-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-07 22:47:23 +02:00
Michael Kerrisk
4c58028a28
proc.5: srcfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-07 14:30:54 +02:00
Michael Kerrisk
4389c7abff
core.5: Tweaks to Mike Frysinger's patch
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-07 11:17:01 +02:00
Mike Frysinger
5c3ce796e7
core(5): Add more details for output paths and the crash handler
...
People sometimes assume that the crash handler runs in the same context
as the crashing process. They would be incorrect :).
Signed-off-by: Mike Frysinger <vapier@gentoo.org>
2016-10-07 11:17:01 +02:00
Michael Kerrisk
15869389bf
proc.5: Document /proc/PID/seccomp
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-07 11:17:01 +02:00
Michael Kerrisk
3ed7270ea2
proc.5: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-07 11:17:01 +02:00
Michael Kerrisk
a77efd582f
proc.5: Expand discussion of /proc/[pid]/root
...
Add a shell example showing that /proc/[pid]/root is more
than a symlink. Based on an example provided by Mike Frysinger
in an earlier commit message.
Cowritten-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-07 11:17:01 +02:00
Michael Kerrisk
948f0ff4fe
proc.5: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-07 11:17:01 +02:00
Mike Frysinger
2b3122418d
proc(5): Clarify the root symlink and mount namespaces
...
If the target process is in a different mount namespace, the root
symlink actually shows that view of the filesystem. As an example:
/* Terminal 1 */
$ unshare -Urnm
# mount -t tmpfs tmpfs /etc
# mount --bind /bin /dev
# echo $$
17168
/* Terminal 2 */
# ls /etc # Normal view of /etc files.
# ls /proc/17168/root/etc # Empty view of the tmpfs.
# ls /dev # Normal view of /dev files.
# ls /proc/17168/root/dev # Contents of /bin files.
Signed-off-by: Mike Frysinger <vapier@gentoo.org>
2016-10-07 11:17:01 +02:00
Michael Kerrisk
f1a5d77ac3
proc.5: srcfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-21 12:46:09 +02:00
Michael Kerrisk
5681553cb8
proc.5: Note that 'suid_dumpable' mode 1 is insecure
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-21 11:48:32 +02:00
Michael Kerrisk
c3c64ee6e3
proc.5: Add reference to core(5) in discussion of 'suid_dumpable'
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-21 11:48:32 +02:00
Michael Kerrisk
8a71b4bb86
proc.5: Refer to ptrace(2) for info on effect of suid_dumpable on ptraceability
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-21 11:48:32 +02:00
Michael Kerrisk
3bdb8ec5e8
proc.5: Explain rules determining ownership of /proc/PID/* files
...
Describe the effect of the "dumpable" attribute on ownership
of /proc/PID files.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-21 11:48:32 +02:00
Michael Kerrisk
1e6a8e2f4f
proc.5: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-21 11:48:32 +02:00
Michael Kerrisk
748f7283bf
proc.5: Note effect of 'suid_dumpable' on ownership of /proc/PID files
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-21 11:48:32 +02:00