653836fb74
proc.5: Add entries for "keys" files that refer reader to keyrings(7)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 09:36:20 +01:00
6e01a8b826
intro.5: Document the reality that by now Section 5 also covers filesystems
...
There are by now, from various filesystem projects, various
pages in Section 5 that document differnt filesystems.
Change intro(5) to reflect that.
Documented after following: http://bugs.debian.org/847998
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-16 14:53:27 +01:00
6c0ed8735b
proc.5: Document /proc/PID/status 'NoNewPrivs' filed
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-15 08:38:55 +01:00
091771e94b
filesystems.5: SEE ALSO: add btrfs(5), nfs(5), tmpfs(5)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-13 12:11:36 +01:00
35deeb8703
bind.2, chmod.2, chown.2, chroot.2, clock_getres.2, clone.2, connect.2, dup.2, fallocate.2, get_mempolicy.2, getpeername.2, getpriority.2, getsockname.2, getsockopt.2, gettimeofday.2, ioctl_ficlonerange.2, ioctl_fideduperange.2, kill.2, mbind.2, mmap.2, mount.2, mprotect.2, nfsservctl.2, nice.2, open.2, perf_event_open.2, pipe.2, pkey_alloc.2, prctl.2, ptrace.2, quotactl.2, remap_file_pages.2, sched_setscheduler.2, set_mempolicy.2, signal.2, signalfd.2, swapon.2, sync_file_range.2, syscalls.2, timer_create.2, timerfd_create.2, utime.2, utimensat.2, wait.2, atof.3, ctime.3, errno.3, fclose.3, fflush.3, insque.3, malloc_get_state.3, mallopt.3, mbsnrtowcs.3, mq_close.3, mq_open.3, mq_receive.3, mq_send.3, printf.3, pthread_attr_init.3, pthread_create.3, pthread_setaffinity_np.3, ptsname.3, remainder.3, strtod.3, tgamma.3, timegm.3, tmpnam.3, ttyname.3, console_ioctl.4, elf.5, filesystems.5, proc.5, utmp.5, capabilities.7, cgroups.7, credentials.7, ddp.7, feature_test_macros.7, fifo.7, inotify.7, libc.7, mount_namespaces.7, namespaces.7, netlink.7, pid_namespaces.7, pkeys.7, shm_overview.7, standards.7, uri.7, user_namespaces.7: tstamp
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:45:24 +01:00
4675c4ed93
filesystems.5: SEE ALSO: add fuse(4)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:35:43 +01:00
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
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
969b3dd60b
elf.5: Minor fixes
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-28 22:19:31 +01:00
bdd5d782a1
elf.5: Minor fixes
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-28 22:17:38 +01:00
51c705cd36
elf(5): Further details on Notes
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-28 22:13:31 +01:00
d84631b325
elf.5: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-27 12:06:34 +01:00
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
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
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
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
573ae2a478
proc.5: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-22 13:53:24 +01:00
40382e5ec4
proc.5: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-21 08:31:01 +01:00
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
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
e8840edfbd
proc.5: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-11 09:29:14 +01:00
f12f1b9b0b
proc.5: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-11 09:27:58 +01:00
54c7242d7d
elf.5: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-11 09:23:22 +01:00
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
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
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
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
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
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
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
43d42cc0a0
proc.5: srcfix: FIXME tidy-up
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-29 13:43:30 +02:00
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
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
c3d59262f3
proc.5: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-13 12:57:06 +02:00
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
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
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
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
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
89f929055e
proc(5): ffix
2016-10-07 22:49:38 +02:00
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
4c58028a28
proc.5: srcfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-07 14:30:54 +02:00
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
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
15869389bf
proc.5: Document /proc/PID/seccomp
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-07 11:17:01 +02:00
3ed7270ea2
proc.5: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-07 11:17:01 +02:00
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
948f0ff4fe
proc.5: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-10-07 11:17:01 +02:00
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
f1a5d77ac3
proc.5: srcfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-21 12:46:09 +02:00
Michael Kerrisk