Commit Graph

1257 Commits

Author SHA1 Message Date
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
Michael Kerrisk 6f858d5ccc lirc.4, proc.5, netlink.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-16 12:42:20 +02:00
Michael Kerrisk 956e74b43f proc.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-16 12:40:55 +02:00
Michael Kerrisk 78230722aa proc.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-16 12:38:57 +02:00
Michael Kerrisk a5a3e91bf9 proc.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-12 20:41:08 +01:00
Michael Kerrisk 0989246ebd proc.5: Minor tweaks to Namhyung Kim's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-12 20:40:39 +01:00
Namhyung Kim dfdf642ebb proc.5: Add description of CLEAR_REFS_MM_HIWATER_RSS
The Linux kernel commit 695f05593693 ("fs/proc/task_mmu.c: add
user-space support for resetting mm->hiwater_rss (peak RSS)") added a
way to reset peak RSS of a process but missed to update manpage.

Cc: Petr Cermak <petrcermak@chromium.org>
Acked-by: Petr Cermak <petrcermak@chromium.org>
Signed-off-by: Namhyung Kim <namhyung@gmail.com>
2016-09-12 20:38:44 +01:00
Michael Kerrisk 58afe6afe1 proc.5: Clarify user namespace requirements for /proc/sys/fs/protected_hardlinks
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-12 20:34:22 +01:00
Michael Kerrisk d133b9b3d8 proc.5: Clarify description of /proc/PID/statm 'lib' and 'dt' fields
These fields are always zero since Linux 2.6.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-10 10:20:25 +01:00
Michael Kerrisk 4e6fa35246 proc.5: Clarify that /proc/PID/statm 'shared' field counts *resident* pages
See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=741360

Reported-by: Zefram <zefram@fysh.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-10 10:19:22 +01:00
Michael Kerrisk c364070664 proc.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-10 10:08:57 +01:00
Michael Kerrisk e546617e9c proc.5: Document /proc/PID/status 'RssAnon', 'RssFile', and 'RssShmem' fields
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-09-10 10:07:36 +01:00