Commit Graph

1663 Commits

Author SHA1 Message Date
Alan Jenkins bfe9256a15 proc.5: Vmalloc information is no longer calculated (Linux 4.4)
See Linux commit a5ad88ce8c7fae7ddc72ee49a11a75aa837788e0,
"mm: get rid of 'vmalloc_info' from /proc/meminfo".

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-20 14:31:21 +01:00
Michael Kerrisk d6bec36eca clone.2, prctl.2, st.4, proc.5: Change references to '2.6.0-test*' series kernels to just '2.6.0'
The extra detail has little of noting with -test 2.6.0
added a particular feature has little value these days,
and is likely to confuse some readers who don't know
(and probably don't care) about the historical details.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-19 13:09:55 +01:00
Mike Rapoport a2463bae6f ioctl_userfaultfd.2, madvise.2, memfd_create.2, migrate_pages.2, mmap.2, shmget.2, subpage_prot.2, userfaultfd.2, malloc.3, proc.5, sysfs.5, tmpfs.5: Update paths for in-kernel memory management documentation files
Signed-off-by: Mike Rapoport <rppt@linux.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-17 07:29:53 +01:00
Michael Kerrisk eb8567a5c2 proc.5: ffix: break /proc/[pid]/task text into smaller paragraphs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05 21:57:20 +01:00
Michael Kerrisk 71b36dc767 proc.5: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05 21:22:19 +01:00
Michael Kerrisk 7fe3b32bc8 proc.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05 21:21:50 +01:00
Michael Kerrisk 37cd58d2d4 proc.5: Minor reworking of description of /proc/[tid] directories
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05 21:14:25 +01:00
Michael Kerrisk 71190dedfe proc.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05 21:02:18 +01:00
Michael Kerrisk 4641c596b3 proc.5: Document /proc/PID/status CoreDumping field
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05 12:40:46 +01:00
Michael Kerrisk 422425ff92 proc.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05 12:35:30 +01:00
Michael Kerrisk fcfac78d29 proc.5: /proc/[pid]/status VmPMD field was removed in Linux 4.15
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05 12:30:25 +01:00
Michael Kerrisk f7bbc79dbc proc.5: Document /proc/Meminfo LazyFree field
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05 12:25:57 +01:00
Michael Kerrisk f9326a24ff proc.5: Fix kernel source pathname for soft-dirty documentation
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05 12:21:46 +01:00
Michael Kerrisk 7375eaabfb proc.5: Document /proc/meminfo KReclaimable field
Added in Linux 4.20.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-05 12:05:08 +01:00
Michael Kerrisk 01df7b7046 proc.5: Document /proc/[pid]
See also https://bugzilla.kernel.org/show_bug.cgi?id=201441

Reported-by: Philip Dumont <phil@solidstatescientific.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-04 23:56:10 +01:00
Michael Kerrisk 3c7cfa32d7 proc.5: Add an overview section describing the groups of files under /proc
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-04 23:04:52 +01:00
Paul Eggert a312fa038d tzfile.5: Sync from tzdb upstream
Make tzfile.5 a copy of the upstream tzdb version, except that
the tzdb version's first line is replaced by man-pages
boilerplate.

This has the following effect:

Do some minor spec fixes, notably about time type 0
and empty TZ strings.  Omit some changes that were made on the
man-pages side, notably by changing some "timezone"s back to the
preferred-upstream "time zone" when talking about traditional
time zones as opposed to POSIX timezone settings.
Also, fix some formatting glitches.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-11-01 15:09:09 +01:00
Michael Kerrisk ebbbcd36d6 proc.5: srcfix: remove doubled .IP line
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-10-26 20:25:53 +02:00
Michael Kerrisk f0d6cc5ff2 proc.5: NOTES: improve text that suggests use of "tr '\000' '\n'"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-10-26 20:25:53 +02:00
Michael Kerrisk 295fe9e0aa proc.5: Minor wording fix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-10-26 20:25:53 +02:00
Michael Kerrisk 91433f3e5f proc.5: Remove bogus suggestion to use cat(1) to read files containing '\0'
Reported-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-10-26 20:25:53 +02:00
Michael Kerrisk d1081b23e1 proc.5: Use 'tr '\000' '\n' to display contents of /proc/PID/environ
This is in effect a revert of
commit 1391278030

Reported-by: Alexander E. Patrakov <patrakov@gmail.com>
Reported-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-10-26 20:25:53 +02:00
Michael Kerrisk 9b7956cfd8 proc.5: tfix
Reported-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-10-26 19:41:47 +02:00
Michael Kerrisk 0f0713a434 core.5: Add cross reference to vdso(7) where "virtaul DSO" is mentioned
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-08-21 09:04:13 +02:00
Jakub Wilk cb5a67a477 proc.5: tfix
Remove duplicated word.

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-08-20 14:45:21 +02:00
Lucas Werkmeister a6425049fa proc.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-08-19 21:33:55 +02:00
Michael Kerrisk 1cdbc3a60c proc.5: Reword /proc/PID/fdinfo timerfd field descriptions as a hanging list
And a few other minor tweaks to the text.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-08-18 10:03:45 +02:00
Michael Kerrisk 734ec506eb proc.5: Add a few details on /rpoc/PID/fdinfo timerfd
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-08-18 09:57:47 +02:00
Michael Kerrisk cd595f623f proc.5: Minor tweaks to Lukas Wermeister's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-08-18 09:52:05 +02:00
Lucas Werkmeister 340a16a6ba proc.5: Document fdinfo format for timerfd
Extended information for timerfd file descriptors in
/proc/[pid]/fdinfo was added in commit af9c4957cf21 ("timerfd:
Implement show_fdinfo method", 2014-07-16), to support
checkpoint/restore for such file descriptors (see also the
TFD_IOC_SET_TICKS ioctl which is documented in timerfd_create.2).

Signed-off-by: Lucas Werkmeister <mail@lucaswerkmeister.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-08-18 09:47:48 +02:00
Michael Kerrisk d512e7b49a proc.5: srcfix: rewrap source lines
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-08-13 16:51:30 +02:00
Elvira Khabirova b654747951 proc.5: Describe ambiguities in /proc/<pid>/maps
Pathname escaping is not done properly in /proc/<pid>/maps;
because of this, different pathnames may appear the same
(verified by experiment and reading the source code).

Further details from Elvira about the relevant location in
the kernel code:

    show_map_vma() from fs/proc/task_mmu.c uses seq_file_path()
    from fs/seq_file.c to print the dentry name, which in turn
    calls seq_path() from the same file.  seq_path() uses
    d_path() from fs/d_path.c to get the path name; this is
    where the " (deleted)" part comes from. This is followed by
    mangling the string with mangle_path() (fs/seq_file.c); this
    function only replaces those characters that were supplied
    in the "esc" argument and does not bother with escaping
    anything else ('\\', for example).  The value of this
    argument comes without modifications from the initial call
    of seq_file_path() by show_map_vma(), and that is "\n".

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-08-13 16:46:07 +02:00
Michael Kerrisk d1fa8ae9ff proc.5: tfix
Reported-by: Stan Schwertly <stan@schwertly.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-08-09 08:26:29 +02:00
Nikola Forró 45e5bb4bec resolv.conf.5: Document no-reload (RES_NPRELOAD) option
Signed-off-by: Nikola Forró <nforro@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-08-07 14:07:09 +02:00
Nikola Forró bf8fc2759b proc.5: Document /proc/[pid]/status Speculation_Store_Bypass field
Signed-off-by: Nikola Forró <nforro@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-08-04 10:19:30 +02:00
Michael Kerrisk b84a64f4c8 proc.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-08-04 09:23:36 +02:00
Keno Fischer 0aae409212 proc.5: Correct description of NStgid
The left-most pid namespace in a given procfs' `NStgid` does not
change based on the pid namespace of the reading process. Rather,
each procfs has an associated outer-most namespace, which gets
set when the procfs is mounted:

```
static struct dentry *proc_mount(struct file_system_type *fs_type,
	int flags, const char *dev_name, void *data)
{
	struct pid_namespace *ns;

	if (flags & MS_KERNMOUNT) {
		ns = data;
		data = NULL;
	} else {
		ns = task_active_pid_ns(current);
	}

	return mount_ns(fs_type, flags, data, ns, ns->user_ns, proc_fill_super);
}
```

i.e. either the root namespace for kernel mounts or the namespace
of the mounting process. This ns then gets saved in the fs' super
block and is the basis for most operations. It is this ns that the
left-most value of `NStgid` is relative to, not the reading process.

Reported-by: Robert O'Callahan <robert@ocallahan.org>
Signed-off-by: Keno Fischer <keno@juliacomputing.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-08-04 09:15:56 +02:00
Michael Kerrisk 78bffc453a utmp.5: ffix
Reported-by: Sam Varshavchik <mrsam@courier-mta.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-08-03 15:57:51 +02:00
Michael Kerrisk 8c420ed87d proc.5: Explain how to determine top-most mount in /proc/PID/mountinfo
Explain how to determine the top-most mount at a particular
location by inspecting /proc/PID/mountinfo.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-07-19 00:13:47 +02:00
Michael Kerrisk ae636827e6 proc.5: Fix description of /proc/PID/* ownership to account for user namespaces
Starting in Linux 4.11, if the process dumpable attribute is
not 1 and the process resides in a noninitial namespaces that
has valid mappings for UID 0 and GID 0, then the ownership of
/proc/PID/* is made the same as the root IDs of the namespace.

Determined by inspection of fs/proc/base.c
See also the following kernel commit:

    commit 68eb94f16227336a5773b83ecfa8290f1d6b78ce
    Author: Eric W. Biederman <ebiederm@xmission.com>
    Date:   Tue Jan 3 10:23:11 2017 +1300

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-07-05 18:38:14 +02:00
Michael Kerrisk e96ad1fd45 proc.5: Minor rewording
In preparation for next change

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-07-05 18:38:14 +02:00
Michael Kerrisk eada5570b0 proc.5: Setting dumpable to 1 reverts ownership of /proc/PID/* to effective IDs
The statement that resetting the dumpable attribute of a process
to 1 causes the ownership of files to revert the process's real
IDs looked suspect. And indeed it is at odds with the code in
fs/proc/base.c::task_dump_owner() (Linux 4.16 sources).
Further verified with a quick test that resetting dumpable to 1
causes the ownership of /proc/PID/* files to revert to the
process's effective IDs. Mea culpa for the original mistake.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-07-05 18:37:54 +02:00
Michael Kerrisk fb49322d22 proc.5: Minor rewording
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-07-05 11:35:48 +02:00
Michael Kerrisk 590ba7e5d0 open_by_handle_at.2, ctermid.3, getcwd.3, proc.5: Wording fix: prefer "pathname" over "path" 2018-06-26 06:47:26 +02:00
Lucas Werkmeister f8bfb68e68 proc.5: tfix
mlock() is a system call and documented in section 2, not 3.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-06-10 13:38:51 +02:00
Nikola Forró c8097a40f5 host.conf.5: Clarify glibc versions in which spoof options were removed
The nospoof, spoofalert and spoof options as well as the
RESOLV_SPOOF_CHECK environment variable were all removed
from glibc in version 2.25 (with commit
7d68cdaa4f748e87ee921f587ee2d483db624b3d).

Signed-off-by: Nikola Forró <nforro@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-06-01 09:08:14 +02:00
Michael Kerrisk 6f75225113 proc.5: Mention choom(1) in discussion of /proc/[pid]/oom_score_adj
This command was added to util-linux on 16 April 2019.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-05-01 11:07:11 +02:00
Michael Kerrisk 09b8afdc04 execve.2, fallocate.2, getrlimit.2, io_submit.2, membarrier.2, mmap.2, msgget.2, open.2, ptrace.2, readv.2, semget.2, shmget.2, shutdown.2, syscall.2, wait.2, wait4.2, crypt.3, encrypt.3, fseek.3, getcwd.3, makedev.3, pthread_create.3, puts.3, tsearch.3, elf.5, filesystems.5, group.5, passwd.5, sysfs.5, mount_namespaces.7, posixoptions.7, time.7, unix.7, vdso.7, xattr.7, ld.so.8: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-04-30 17:41:31 +02:00
Michael Kerrisk 29c0586f51 bpf.2, sched_setattr.2, crypt.3, elf.5, proc.5, fanotify.7, feature_test_macros.7, sched.7: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-04-27 14:48:33 +02:00
Michael Kerrisk 8f8b643d85 sysfs.5: Add brief note on /sys/fs/smackfs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-03-16 08:50:36 +01:00
Michael Kerrisk 4a870c6849 elf.5: SEE ALSO: add patchelf(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-03-02 14:34:41 +01:00
Michael Kerrisk a43454393f group.5: SEE ALSO: add vigr(8)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-02-10 07:22:56 +01:00
Michael Kerrisk a77696adca passwd.5: SEE ALSO: add vipw(8)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-02-10 07:22:56 +01:00
Michael Kerrisk 23fadc9b53 filesystems.5: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-02-10 07:22:53 +01:00
Michael Kerrisk 20894689e3 filesystems.5: Add an entry for tmpfs(5)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-02-09 07:20:11 +01:00
Michael Kerrisk 017b630f83 filesystems.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-02-09 07:15:30 +01:00
Michael Kerrisk 3115293a0e tmpfs.5: Update timestamp as marker of bad author commit
The author of 462a385e9a
was Mike Fryinger, not Carsten Grohmann. I (mtk) messed
while amending the commit.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-02-09 07:15:27 +01:00
Michael Kerrisk f2485f5ac7 tmpfs.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-02-04 10:05:14 +01:00
Michael Kerrisk b8847b59eb tmpfs.5: SEE ALSO: add set_mempolicy(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-02-04 09:43:55 +01:00
Michael Kerrisk a6fedca9ab tmpfs.5: SEE ALSO: add Documentation/vm/transhuge.txt
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-02-04 09:43:24 +01:00
Michael Kerrisk b230d246b2 tmpfs.5: Document 'huge' mount options
Based on text from Documentation/vm/transhuge.txt.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-02-04 09:40:48 +01:00
Michael Kerrisk e121158211 tmpfs.5: Document mpol=local mount option
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-02-04 09:40:48 +01:00
Michael Kerrisk ac02e57cc8 tmpfs.5: Describe 'mpol' mount options
Based on text from Documentation/filesystems/tmpfs.txt.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-02-04 09:40:48 +01:00
Michael Kerrisk a9e25912e5 tmpfs.5: Reformat 'huge' and 'mpol' mount option values as lists
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-02-04 09:40:42 +01:00
Michael Kerrisk 4777eb84a6 tmpfs.5: Remove reference to mount(8) for discussion of mount options
The mount options are now described in this page.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-02-04 08:33:41 +01:00
Michael Kerrisk d745d28302 tmpfs.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-02-04 07:32:04 +01:00
Carsten Grohmann 462a385e9a tmpfs.5: Document current mount options
Some of this content is moved from the mount(8) man page.
Style was based on proc(5) sections.

Signed-off-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-02-04 07:32:04 +01:00
Michael Kerrisk 475ceab130 sysfs.5: Refer to cgroups(7) for information about files in /sys/kernel/cgroup
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-01-10 00:35:47 +01:00
Michael Kerrisk 5a618adb97 utmp.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-01-06 22:59:46 +01:00
Michael Kerrisk 9d9f49e38a nologin.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-01-06 22:58:57 +01:00
Michael Kerrisk e810de90a6 motd.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-01-06 22:58:42 +01:00
Michael Kerrisk 6998e202c0 issue.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-01-06 22:58:25 +01:00
Michael Kerrisk 275723f9d9 group.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2018-01-06 22:58:04 +01:00
Michael Kerrisk 5d9b8ae9b9 sysfs.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-12-10 23:19:17 +01:00
Michael Kerrisk 1c6f59c276 getpid.2, pipe.2, abort.3, daemon.3, pthread_yield.3, stdio.3, sysconf.3, tty.4, shells.5, sysfs.5, fifo.7, hier.7, icmp.7, path_resolution.7, pid_namespaces.7, standards.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-26 12:38:46 +01:00
Jakub Wilk 1dbe854bc5 proc.5: tfix
Remove duplicated word.

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-22 17:40:58 +01:00
Michael Kerrisk 979a439b41 proc.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-20 14:37:12 +01:00
Michael Kerrisk 2927055043 proc.5: Rework the description of /proc/PID/mountinfo parent-ID field
After comments from Miklos, and further digging in the kernel
source that showed that chroot() can also result in "hidden"
parent-IDs in mountinfo, I've revised the description of
mountinfo.

In fs/proc_namespace.cs::how_mountinfo() there is:

        /* mountpoints outside of chroot jail will give SEQ_SKIP on this */
        err = seq_path_root(m, &mnt_path, &p->root, " \t\n\\");
        if (err)
                goto out;

I instrumented the 'if (err)' code path with printk()
to show that there is indeed a record corresponding to the
parent-ID for the process root that is being skipped.

Reported-by: Miklos Szeredi <mszeredi@redhat.com>
Reviewed-by: Miklos Szeredi <mszeredi@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-20 10:37:33 +01:00
Michael Kerrisk 35cf1b9397 proc.5: Correct the description of the parent mount ID for /proc/PID/mountinfo
I do not have an exact handle on the details, but I can see
roughly what is going on.  Internally, there seems to be one
("hidden") mount ID reserved to each mount namespace, and that ID
is the parent of the root mount point.

Looking through the (4.14) kernel source, mount IDs are allocated
by a kernel function called mnt_alloc_id() (in fs/namespace.c),
which is in turn called by alloc_vfsmnt() which is in turn called
by clone_mnt().

A new mount namespace is created by the kernel function
copy_mnt_ns() (in fs/namespace.c, called by
create_new_namespaces() in kernel/nsproxy.c). The copy_mnt_ns()
function calls copy_tree() (in fs/namespace.c), and copy_tree()
calls clone_mnt() in *two* places.  The first of these is the call
that creates the "hidden" mount ID that becomes the parent of the
root mount point. (I verified this by instrumenting the kernel
with a few printk() calls to display the IDs.)  The second place
where copy_tree() calls clone_mnt() is in a loop that replicates
each of the mount points (including the root mount point) in the
source mount namespace.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-20 10:13:00 +01:00
Michael Kerrisk 9b0e3937a9 proc.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-19 20:27:37 +01:00
Marcus Folkesson 5753354a3a proc.5: Update description of /proc/<pid>/oom_score
After Linux 2.6.36, the heuristic calculation of oom_score
has changed to only consider used memory and CAP_SYS_ADMIN.

See kernel commit a63d83f427fbce97a6cea0db2e64b0eb8435cd10.

Signed-off-by: Marcus Folkesson <marcus.folkesson@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-19 19:52:55 +01:00
Michael Kerrisk 52f842a571 proc.5: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-15 08:22:43 +01:00
Michael Kerrisk 8fb9b45adc proc.5: Since Linux 4.9, /proc/locks is filtered according to the PID namespace
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-15 08:10:53 +01:00
Michael Kerrisk f352b560f8 proc.5: Document /proc/locks
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-14 23:22:33 +01:00
Michael Kerrisk b0bd99827c proc.5: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-09 15:22:07 +01:00
Tyler Hicks 2577dbba2b proc.5, seccomp.2: Document the seccomp /proc interfaces added in Linux 4.14
Document the seccomp /proc interfaces in Linux 4.14:
/proc/sys/kernel/seccomp/actions_avail and
/proc/sys/kernel/seccomp/actions_logged.

Signed-off-by: Tyler Hicks <tyhicks@canonical.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-09 15:22:07 +01:00
Seonghun Lim 89211bfd3a acct.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-09 09:24:50 +01:00
Michael Kerrisk 39352d918f filesystems.5: Refer to VFAT as an extended FAT (not DOS) filesystem
Reported-by: Jonny Grant <jg@jguk.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-06 23:23:09 +01:00
Michael Kerrisk 23014116a5 filesystems.5: Replace crufty URL reference for 'smb' with up-to-date URL
Reported-by: Jonny Grant <jg@jguk.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-06 23:19:42 +01:00
Lucas Werkmeister 81c8aeb649 proc.5: Clarify permissions in /proc/[pid]/fd/
Since the symbolic links for pipes and sockets do not refer to real
files in the file system tree, it can be hard to discover that they
still have mode and ownership information (revealed e.g. by `stat -L`),
so let's point this out in the manpage.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-06 22:25:13 +01:00
Lucas Werkmeister d6bd89f3e5 proc.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-06 22:23:01 +01:00
Michael Kerrisk dc4674ac40 core.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-27 21:20:20 +02:00
Michael Kerrisk 8eb13afb83 proc.5: Add reference to pid_namespaces(7) for /proc/sys/kernel/ns_last_pid
Add reference to pid_namespaces(7) for the description of
/proc/sys/kernel/ns_last_pid.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-23 17:30:12 +02:00
G. Branden Robinson 9b13f7700e connect.2, ioprio_set.2, dbopen.3, group.5, fifo.7: tfix
Fix nonstandard usage.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-23 06:41:59 +02:00
Michael Kerrisk a23d8efafc capget.2, fanotify_init.2, fcntl.2, ioctl_tty.2, madvise.2, mbind.2, prctl.2, sched_setaffinity.2, hash.3, isgreater.3, posix_fallocate.3, sigvec.3, full.4, sd.4, wavelan.4, core.5, host.conf.5, epoll.7, signal.7, unix.7, user_namespaces.7: wfix (will fail --> fail/fails)
Reported-by: Pedro Alves <palves@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 16:36:57 +02:00
Michael Kerrisk b5b0d21ef5 proc.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-18 09:26:12 +02:00
Michael Kerrisk 9ea5bc667b clone.2, getcpu.2, shmget.2, syscall.2, dladdr.3, proc.5, vdso.7: Consistently use "x86-64", not "x86_64"
When referring to the architecture, consistently use "x86-64",
not "x86_64". Hitherto, there was a mixture of usages, with
"x86-64" predominant.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-18 09:26:12 +02:00
Michael Kerrisk 6e3b05feb5 core.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-12 21:08:37 +02:00
Michael Kerrisk 7629685cc3 core.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-12 21:08:37 +02:00
Michael Kerrisk 03c871367c core.5: Adds some notes on systemd and core dumps
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-12 21:08:37 +02:00
Michael Kerrisk 6c3d8859e6 core.5: Dumps are not produced if core_pattern is empty and core_uses_pid is 0
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-11 22:00:09 +02:00
Michael Kerrisk cb1b16309e core.5: SEE ALSO: add coredumpctl(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-11 18:04:42 +02:00
Michael Kerrisk 97839a765d core.5: RLIMIT_CORE is not enforced when piping core dump to a program
Reported-by: Per Böhlin <Per.Bohlin@zenterio.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-09 22:25:05 +02:00
Jakub Wilk 86be2c9292 proc.5: tfix
Remove duplicated word.

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-09 15:24:20 +02:00
Jakub Wilk e8b9e9a236 sysfs.5: tfix
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-05 20:37:09 +02:00
Michael Kerrisk d8a21977bf sysfs.5: Add brief description of /sys/kernel/debug/tracing
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-28 17:21:12 +02:00
Michael Kerrisk bbd6443407 shells.5: SEE ALSO: add pam_shells(8)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 13:55:53 +02:00
Michael Kerrisk a971f65268 core.5: SEE ALO: add systemd-coredump(8)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 13:51:12 +02:00
Michael Kerrisk 0e462d71de proc.5: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 09:19:18 +02:00
Oliver Ebert 55d68a947b proc.5: Document /proc/kpagecgroup
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 09:19:18 +02:00
Michael Kerrisk abfbcb56d8 proc.5: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 09:19:18 +02:00
Oliver Ebert 2e84528d50 proc.5: Add mmap-exclusive bit for /proc/[pid]/pagemap
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 09:19:18 +02:00
Michael Kerrisk c6f182bc5e proc.5: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 09:19:18 +02:00
Michael Kerrisk 5487da4c66 proc.5: Fix kernel version for KPF_BALLOON (amendment to Oliver Ebert's patch)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 09:19:17 +02:00
Oliver Ebert f38dfdf16a proc.5: Add KPF_BALLOON, KPF_ZERO_PAGE, and KPF_IDLE for /proc/kpageflags
See Linux commit 56873f43abdcd574b25105867a990f067747b2f4
and Linux commit f074a8f49eb87cde95ac9d040ad5e7ea4f029738

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 09:19:12 +02:00
Oliver Ebert d0ffc687c4 proc.5: tfix
See Linux commit 63f8e8d2a575ef62e5b705516b491a98a60517ff.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 08:17:56 +02:00
Michael Kerrisk 85f0310cb8 sysfs.5: Add a brief description of /sys/class/net
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-22 10:09:30 +02:00
Michael Kerrisk db419c969a sysfs.5: Add a description of /sys/kernel/mm/hugepages
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-22 08:44:18 +02:00
Michael Kerrisk cf4a2cfb02 sysfs.5: Add a brief description of /sys/kernel/mm
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-22 08:44:18 +02:00
Michael Kerrisk 59514c5619 sysfs.5: Add a brief explanation of /sys/kernel
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-22 08:44:18 +02:00
Jakub Wilk 21b07f83c3 proc.5: tfix
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-16 15:12:08 +02:00
Michael Kerrisk e0fe703de0 Removed trailing white space at end of lines 2017-09-15 12:50:14 +02:00
Michael Kerrisk 4b8c67d976 iconv.1, ldd.1, locale.1, localedef.1, memusage.1, memusagestat.1, mtrace.1, pldd.1, sprof.1, time.1, _syscall.2, add_key.2, alloc_hugepages.2, arch_prctl.2, bpf.2, cacheflush.2, capget.2, chdir.2, chmod.2, chown.2, chroot.2, clock_getres.2, clock_nanosleep.2, clone.2, close.2, connect.2, copy_file_range.2, create_module.2, delete_module.2, dup.2, epoll_create.2, epoll_ctl.2, epoll_wait.2, eventfd.2, execve.2, execveat.2, fallocate.2, fanotify_init.2, fcntl.2, flock.2, fork.2, fsync.2, futex.2, futimesat.2, get_kernel_syms.2, get_mempolicy.2, get_robust_list.2, getcpu.2, getdents.2, getdomainname.2, getgid.2, getgroups.2, gethostname.2, getitimer.2, getpagesize.2, getpeername.2, getpriority.2, getrandom.2, getresuid.2, getrlimit.2, getrusage.2, getsid.2, getsockname.2, getsockopt.2, gettid.2, gettimeofday.2, getuid.2, getunwind.2, init_module.2, inotify_add_watch.2, inotify_init.2, inotify_rm_watch.2, intro.2, io_cancel.2, io_destroy.2, io_getevents.2, io_setup.2, io_submit.2, ioctl_console.2, ioctl_fat.2, ioctl_ficlonerange.2, ioctl_fideduperange.2, ioctl_getfsmap.2, ioctl_iflags.2, ioctl_list.2, ioctl_ns.2, ioctl_tty.2, ioctl_userfaultfd.2, ioperm.2, iopl.2, ioprio_set.2, ipc.2, kcmp.2, kexec_load.2, keyctl.2, kill.2, link.2, listen.2, listxattr.2, llseek.2, lookup_dcookie.2, lseek.2, madvise.2, mbind.2, membarrier.2, memfd_create.2, migrate_pages.2, mincore.2, mkdir.2, mknod.2, mlock.2, mmap.2, mmap2.2, modify_ldt.2, move_pages.2, mprotect.2, mq_getsetattr.2, mremap.2, msgctl.2, msgget.2, msgop.2, msync.2, nanosleep.2, nfsservctl.2, nice.2, open.2, open_by_handle_at.2, outb.2, perf_event_open.2, perfmonctl.2, personality.2, pivot_root.2, pkey_alloc.2, poll.2, posix_fadvise.2, prctl.2, pread.2, process_vm_readv.2, ptrace.2, query_module.2, quotactl.2, read.2, readahead.2, readdir.2, readlink.2, readv.2, reboot.2, recv.2, recvmmsg.2, remap_file_pages.2, rename.2, request_key.2, restart_syscall.2, rt_sigqueueinfo.2, s390_pci_mmio_write.2, s390_runtime_instr.2, sched_get_priority_max.2, sched_rr_get_interval.2, sched_setaffinity.2, sched_setattr.2, sched_setparam.2, sched_setscheduler.2, sched_yield.2, seccomp.2, select.2, select_tut.2, semctl.2, semget.2, semop.2, send.2, sendfile.2, sendmmsg.2, set_mempolicy.2, set_thread_area.2, set_tid_address.2, seteuid.2, setfsgid.2, setfsuid.2, setgid.2, setns.2, setpgid.2, setresuid.2, setreuid.2, setsid.2, setuid.2, sgetmask.2, shmctl.2, shmget.2, shmop.2, sigaction.2, sigaltstack.2, signal.2, sigpending.2, sigprocmask.2, sigreturn.2, sigsuspend.2, sigwaitinfo.2, socket.2, socketcall.2, socketpair.2, splice.2, spu_create.2, spu_run.2, stat.2, statfs.2, statx.2, subpage_prot.2, swapon.2, symlink.2, sync.2, sync_file_range.2, syscall.2, syscalls.2, sysctl.2, sysfs.2, sysinfo.2, syslog.2, tee.2, time.2, timer_create.2, timer_getoverrun.2, timer_settime.2, timerfd_create.2, times.2, tkill.2, truncate.2, umask.2, umount.2, uname.2, unimplemented.2, unlink.2, unshare.2, uselib.2, userfaultfd.2, ustat.2, utime.2, utimensat.2, vfork.2, vmsplice.2, wait.2, wait4.2, write.2, CPU_SET.3, INFINITY.3, __ppc_get_timebase.3, __ppc_set_ppr_med.3, __ppc_yield.3, __setfpucw.3, acos.3, acosh.3, adjtime.3, aio_fsync.3, aio_init.3, aio_read.3, aio_return.3, aio_suspend.3, aio_write.3, alloca.3, argz_add.3, asin.3, asinh.3, asprintf.3, assert.3, assert_perror.3, atan.3, atan2.3, atanh.3, atexit.3, backtrace.3, basename.3, bindresvport.3, bsd_signal.3, bsearch.3, bswap.3, btree.3, byteorder.3, bzero.3, canonicalize_file_name.3, carg.3, cbrt.3, ccos.3, ccosh.3, ceil.3, cexp.3, cfree.3, clearenv.3, clock.3, clock_getcpuclockid.3, clog.3, clog10.3, clog2.3, cmsg.3, confstr.3, copysign.3, cos.3, cosh.3, crypt.3, csin.3, csinh.3, csqrt.3, ctan.3, ctanh.3, ctime.3, dbopen.3, dl_iterate_phdr.3, dladdr.3, dlerror.3, dlinfo.3, dlopen.3, dlsym.3, drand48.3, drand48_r.3, duplocale.3, encrypt.3, end.3, endian.3, envz_add.3, erf.3, erfc.3, err.3, errno.3, error.3, ether_aton.3, euidaccess.3, exec.3, exit.3, exp.3, exp10.3, exp2.3, expm1.3, fabs.3, fcloseall.3, fdim.3, fenv.3, ferror.3, fexecve.3, fflush.3, ffs.3, fgetc.3, fgetgrent.3, fgetpwent.3, finite.3, floor.3, fma.3, fmax.3, fmemopen.3, fmin.3, fmod.3, fmtmsg.3, fopen.3, fopencookie.3, fpclassify.3, fpurge.3, fputwc.3, fputws.3, frexp.3, fseek.3, fseeko.3, ftime.3, fts.3, ftw.3, futimes.3, gamma.3, gcvt.3, get_nprocs_conf.3, get_phys_pages.3, getaddrinfo.3, getaddrinfo_a.3, getauxval.3, getcontext.3, getcwd.3, getdate.3, getentropy.3, getenv.3, getfsent.3, getgrent.3, getgrent_r.3, getgrnam.3, getgrouplist.3, gethostbyname.3, gethostid.3, getifaddrs.3, getipnodebyname.3, getline.3, getlogin.3, getmntent.3, getnameinfo.3, getnetent.3, getnetent_r.3, getopt.3, getprotoent.3, getprotoent_r.3, getpw.3, getpwent.3, getpwent_r.3, getpwnam.3, getrpcent.3, getrpcent_r.3, getrpcport.3, gets.3, getservent.3, getservent_r.3, getspnam.3, getsubopt.3, getttyent.3, getumask.3, getutent.3, getwchar.3, glob.3, gnu_get_libc_version.3, grantpt.3, gsignal.3, hash.3, hsearch.3, hypot.3, iconv.3, iconv_close.3, iconv_open.3, if_nameindex.3, if_nametoindex.3, ilogb.3, inet.3, inet_net_pton.3, inet_ntop.3, inet_pton.3, initgroups.3, insque.3, intro.3, isalpha.3, isgreater.3, j0.3, key_setsecret.3, killpg.3, ldexp.3, lgamma.3, lio_listio.3, lockf.3, log.3, log10.3, log1p.3, log2.3, logb.3, login.3, lrint.3, lround.3, lsearch.3, lseek64.3, makecontext.3, makedev.3, mallinfo.3, malloc.3, malloc_get_state.3, malloc_info.3, malloc_stats.3, malloc_trim.3, malloc_usable_size.3, mallopt.3, matherr.3, mbsnrtowcs.3, mbsrtowcs.3, mbstowcs.3, mcheck.3, memccpy.3, memchr.3, memcmp.3, memcpy.3, mkfifo.3, mkstemp.3, mktemp.3, modf.3, mpool.3, mq_close.3, mq_getattr.3, mq_notify.3, mq_open.3, mq_receive.3, mq_send.3, mtrace.3, newlocale.3, nextafter.3, nextup.3, nl_langinfo.3, ntp_gettime.3, offsetof.3, on_exit.3, open_memstream.3, opendir.3, openpty.3, perror.3, popen.3, posix_fallocate.3, posix_madvise.3, posix_memalign.3, posix_openpt.3, posix_spawn.3, pow.3, pow10.3, printf.3, profil.3, program_invocation_name.3, psignal.3, pthread_atfork.3, pthread_attr_init.3, pthread_attr_setaffinity_np.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_setstackaddr.3, pthread_attr_setstacksize.3, pthread_cancel.3, pthread_cleanup_push.3, pthread_cleanup_push_defer_np.3, pthread_create.3, pthread_detach.3, pthread_exit.3, pthread_getattr_default_np.3, pthread_getattr_np.3, pthread_getcpuclockid.3, pthread_join.3, pthread_kill.3, pthread_kill_other_threads_np.3, pthread_self.3, pthread_setaffinity_np.3, pthread_setcancelstate.3, pthread_setconcurrency.3, pthread_setname_np.3, pthread_setschedparam.3, pthread_sigmask.3, pthread_sigqueue.3, pthread_testcancel.3, pthread_tryjoin_np.3, ptsname.3, putgrent.3, putpwent.3, qsort.3, random.3, random_r.3, rcmd.3, re_comp.3, readdir.3, realpath.3, recno.3, regex.3, remainder.3, remove.3, remquo.3, resolver.3, rexec.3, rint.3, round.3, rpc.3, rpmatch.3, rtime.3, scalb.3, scalbln.3, scandir.3, scanf.3, sched_getcpu.3, sem_close.3, sem_destroy.3, sem_getvalue.3, sem_init.3, sem_open.3, sem_wait.3, setaliasent.3, setbuf.3, setenv.3, setlocale.3, setlogmask.3, setnetgrent.3, shm_open.3, signbit.3, significand.3, sigpause.3, sigqueue.3, sigset.3, sigvec.3, sin.3, sincos.3, sinh.3, sleep.3, sockatmark.3, sqrt.3, statvfs.3, stdarg.3, stdin.3, strcasecmp.3, strcat.3, strchr.3, strcoll.3, strcpy.3, strdup.3, strerror.3, strfmon.3, strfromd.3, strftime.3, strptime.3, strsignal.3, strstr.3, strtod.3, strtok.3, strtol.3, strtoul.3, strverscmp.3, syslog.3, system.3, sysv_signal.3, tan.3, tanh.3, telldir.3, tempnam.3, termios.3, tgamma.3, timeradd.3, tmpnam.3, toupper.3, towlower.3, towupper.3, trunc.3, ttyslot.3, tzset.3, ualarm.3, ulimit.3, undocumented.3, unlocked_stdio.3, updwtmp.3, uselocale.3, usleep.3, wcrtomb.3, wcsdup.3, wcsnrtombs.3, wcsrtombs.3, wcstombs.3, wctob.3, wcwidth.3, wordexp.3, wprintf.3, xcrypt.3, xdr.3, y0.3, cciss.4, console_codes.4, dsp56k.4, fuse.4, hd.4, hpsa.4, initrd.4, intro.4, loop.4, random.4, rtc.4, sd.4, sk98lin.4, st.4, wavelan.4, acct.5, core.5, elf.5, filesystems.5, host.conf.5, hosts.5, locale.5, nologin.5, proc.5, resolv.conf.5, rpc.5, slabinfo.5, utmp.5, aio.7, arp.7, bootparam.7, capabilities.7, cgroup_namespaces.7, cgroups.7, charsets.7, cpuset.7, ddp.7, environ.7, epoll.7, fanotify.7, feature_test_macros.7, futex.7, inode.7, inotify.7, ip.7, ipv6.7, keyrings.7, locale.7, man-pages.7, man.7, math_error.7, mount_namespaces.7, mq_overview.7, namespaces.7, netdevice.7, netlink.7, packet.7, pipe.7, pkeys.7, pthreads.7, pty.7, raw.7, rtld-audit.7, rtnetlink.7, sched.7, session-keyring.7, signal.7, sock_diag.7, socket.7, spufs.7, suffixes.7, tcp.7, udp.7, udplite.7, unicode.7, units.7, unix.7, uri.7, user_namespaces.7, vdso.7, x25.7, xattr.7, iconvconfig.8, ld.so.8, ldconfig.8, sln.8: Update timestamps
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-15 12:44:56 +02:00
Eugene Syromyatnikov 550c368fb5 proc.5: Update pointer to in-kernel SysRq documentation
The location has been changed in Linux commit
v4.10-rc1~40^2~86^2~4.

* man5/proc.5 (.SS Files and directories)
  <.TP .I /proc/sys/kernel/sysrq, .TP .IR /proc/sysrq-trigger>:
  Amend pointer to Documentation/sysrq.txt with change introduced
  in Linux 4.10 (move to Documentation/admin-guide/sysrq.rst).

Signed-off-by: Eugene Syromyatnikov <evgsyr@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-11 13:15:47 +02:00
Eugene Syromyatnikov a8999e1fa2 proc.5: Update pointer to in-kernel MTRR documentation
The location of the file has been changed in Linux commit
v2.6.28-rc1~734^2^8~3.

* man5/proc.5 (.SS Files and directories) <.TP .I /proc/mtrr>:
  Amend pointer to in-kernel MTRR documentation with the
  location change happened in Linux 2.6.28.

Signed-off-by: Eugene Syromyatnikov <evgsyr@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-11 13:10:30 +02:00
Eugene Syromyatnikov e94de16843 proc.5: Update reference to kernel's crypto API documentation
DocBook documentation has been removed in commit
v4.13-rc1~34^2~21^2~11.  Crypto API has been converted to
ReStructured format during the Linux 4.10 development cycle
(see commits v4.10-rc1~40^2~8 and v4.10-rc1~40^2~7).

* man5/proc.5 (.SS Files and directories) <.TP .I /proc/crypto>:
  Amend the reference to the kernel's crypto API documentation
  with the new location, effective since Linux 4.10.

Signed-off-by: Eugene Syromyatnikov <evgsyr@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-11 13:09:18 +02:00
Eugene Syromyatnikov 6b3ead8f70 proc.5: Update pointer to in-kernel security keys documentation
The file has been moved twice since its mention on the man page.

* man5/proc.5 (.SS Files and directories)
  <.TP .IR /proc/[pid]/attr/keycreate>: Amend security keys
  documentation reference with the locations in different
  versions of Linux kernel tree.

Signed-off-by: Eugene Syromyatnikov <evgsyr@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-11 13:07:52 +02:00
Michael Kerrisk 84ed744c4e proc.5: Minor wording fixes to Eugene's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-11 13:05:39 +02:00
Eugene Syromyatnikov d3546d80e8 proc.5: Document removal of timer_stats file
timer_stats was removed in Linux commit commit v4.11-rc1~177^2~5
citing security concerns.

* man5/proc.5 (.SS Files and directories)
  <.TP .I /proc/timer_stats>: Mention the last Linux version where
  the file was available along with the reasons of removal.

Signed-off-by: Eugene Syromyatnikov <evgsyr@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-11 13:00:30 +02:00
Eugene Syromyatnikov 3f1144fc01 proc.5: Document removal of htab-reclaim sysctl file
This PPC-specific sysctl option has been removed in Linux 2.4.9.2,
according to historic Linux repository commit log.

* man5/proc.5 (.SS Files and directories)
  <.TP .I /proc/sys/kernel/htab-reclaim>: Mention the last Linux
  version where the option was available.

Signed-off-by: Eugene Syromyatnikov <evgsyr@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-11 12:58:31 +02:00
Eugene Syromyatnikov 96c11b3ffc initrd.4, proc.5, bootparam.7: Update pointer to in-kernel initrd documentation
Linux commit v4.10-rc1~40^2~86^2~4 moves initrd documentation from
Documentation/initrd.txt to Documentation/admin-quide/initrd.rst.

* man4/initrd.4 (.SS Changing the normal root filesystem,
  .SH SEE ALSO): Amend pointer to in-kernel initrd documentation
  with change introduced in Linux 4.10 (move to
  Documentation/admin-guide/initrd.rst).
* man5/proc.5 (.SS Files and directories)
  <.TP .I /proc/sys/kernel/real-root-dev>: Likewise.
* man7/bootparam.7 (.SS Boot arguments for ramdisk use)
  <.TP .B 'noinitrd'>: Likewise.

Signed-off-by: Eugene Syromyatnikov <evgsyr@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-11 12:55:40 +02:00
Michael Kerrisk 561fb695da proc.5: SEE ALSO: add sysfs(5)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-11 12:17:17 +02:00
Michael Kerrisk 6df684e0d3 sysfs.5: Various additions and improvements
Drawn from Documentation/filesystems/sysfs.txt, P. Mochel's OLS
paper, and some naive investigation.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-11 12:17:16 +02:00
Michael Kerrisk 46841acec3 sysfs.5: New page documenting the sysfs filesystem
Just a skeleton page so far, but perhaps it will be filled out
over time.

Reported-by: Mark Wielaard <mark@klomp.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-11 07:43:17 +02:00
Michael Kerrisk 31fa1fd2a6 proc.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-10 12:50:36 +02:00
Michael Kerrisk 64165e0118 proc.5: Explicitly note in intro that some /proc files are writable 2017-09-10 08:49:54 +02:00
Michael Kerrisk b574c52d85 proc.5: Show command used to mount /proc
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-10 08:49:54 +02:00
Michael Kerrisk 7e17465102 proc.5: Minor wording fix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-10 08:02:52 +02:00
Michael Kerrisk d7f23d0bd6 proc.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-03 02:12:25 +02:00
Eugene Syromyatnikov 76f6f10206 proc.5: Add description for softirq line in /proc/stat
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-03 02:11:20 +02:00
Eugene Syromyatnikov 46f6dbe83f proc.5: Add description for cpuN lines in /pro/stat
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-03 02:10:01 +02:00
Eugene Syromyatnikov 2d3fb75b7b proc.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-03 02:07:29 +02:00
Michael Kerrisk 11cabd5ae3 intro.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-25 21:41:03 +02:00
Michael Kerrisk 0fd98a89aa nologin.5: Add a sentence explaining why nologin is useful
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-25 21:41:03 +02:00
Michael Kerrisk e2c4b45d40 issue.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-25 21:41:03 +02:00
Michael Kerrisk 5daae26493 proc.5: Note Linux 4.9 changes to privileges for /proc/[pid]/timerslack_ns
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-22 02:14:38 +02:00
Michael Kerrisk 93f18cbb9c proc.5, charsets.7: ffix: use en-dash for ranges, not em-dash
A recent patch fixed the use of dashes in ranges in
various places, but mistakenly used em-dashes, rather than
en-dashes. Fix that.

Reported-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-22 01:50:54 +02:00
Michael Kerrisk 6cfabe200d resolv.conf.5: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 13:07:41 +02:00
Michael Kerrisk c9e069d681 proc.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 12:08:24 +02:00
Michael Kerrisk 68d8192fd3 host.conf.5: Add cross-reference to hosts(5)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 10:09:39 +02:00
Michael Kerrisk 3845a1207c host.conf.5: ffix + tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 10:09:39 +02:00
Michael Kerrisk b794d85ab1 ftpusers.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 10:03:29 +02:00
Michael Kerrisk 96eb7b8ec7 ftpusers.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 10:02:14 +02:00
Michael Kerrisk 9bc87ed07a ctime.3, drand48.3, fmtmsg.3, getnameinfo.3, gsignal.3, strftime.3, strptime.3, cciss.4, console_codes.4, sd.4, sk98lin.4, st.4, proc.5, charsets.7, cpuset.7, pty.7, suffixes.7, udplite.7, unix.7: Use en-dash for ranges
Based on a patch by Bjarni Ingi Gislason.

Reported-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-19 22:01:55 +02:00
Michael Kerrisk 9c40f2b9ba random.4, gai.conf.5, slabinfo.5, cgroup_namespaces.7, feature_test_macros.7, keyrings.7, locale.7, man-pages.7, sock_diag.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-19 13:47:27 +02:00
Michael Kerrisk a2b7a14421 sinh.3, sockatmark.3, stdarg.3, stpcpy.3, syslog.3, system.3, tanh.3, termios.3, wctrans.3, wctype.3, wcwidth.3, wordexp.3, cciss.4, fuse.4, initrd.4, loop.4, acct.5, hosts.5, nss.5, operator.7, unix.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-19 13:47:27 +02:00
Michael Kerrisk b8302363ed execve.2, ioctl_console.2, ioctl_iflags.2, ioctl_ns.2, ioctl_userfaultfd.2, kcmp.2, kexec_load.2, keyctl.2, link.2, listxattr.2, membarrier.2, memfd_create.2, mmap.2, modify_ldt.2, mprotect.2, msgctl.2, nanosleep.2, open_by_handle_at.2, perf_event_open.2, poll.2, posix_fadvise.2, process_vm_readv.2, ptrace.2, query_module.2, quotactl.2, readdir.2, readv.2, recv.2, recvmmsg.2, request_key.2, sched_rr_get_interval.2, sched_setaffinity.2, sched_setattr.2, sched_setscheduler.2, seccomp.2, select.2, select_tut.2, semctl.2, semop.2, send.2, sendmmsg.2, set_thread_area.2, setns.2, shmctl.2, shmget.2, sigaction.2, sigaltstack.2, signal.2, sigwaitinfo.2, stat.2, statfs.2, statx.2, sync_file_range.2, syscall.2, sysctl.2, sysinfo.2, tee.2, timer_create.2, timer_settime.2, timerfd_create.2, unshare.2, userfaultfd.2, ustat.2, utime.2, utimensat.2, vmsplice.2, wait.2, adjtime.3, aio_init.3, backtrace.3, basename.3, bswap.3, btree.3, clock_getcpuclockid.3, cmsg.3, confstr.3, dbopen.3, dl_iterate_phdr.3, dladdr.3, dlinfo.3, dlopen.3, duplocale.3, encrypt.3, end.3, endian.3, err.3, errno.3, ether_aton.3, fgetgrent.3, fgetpwent.3, fmemopen.3, frexp.3, ftime.3, fts.3, getaddrinfo.3, getaddrinfo_a.3, getdate.3, getfsent.3, getgrent.3, getgrent_r.3, getgrnam.3, getgrouplist.3, gethostbyname.3, getifaddrs.3, getipnodebyname.3, getmntent.3, getnameinfo.3, getnetent.3, getopt.3, getprotoent.3, getprotoent_r.3, getpw.3, getpwent.3, getpwent_r.3, getpwnam.3, getrpcent.3, getservent.3, getservent_r.3, getspnam.3, getttyent.3, glob.3, gnu_get_libc_version.3, hash.3, hsearch.3, if_nameindex.3, inet.3, inet_net_pton.3, inet_pton.3, insque.3, isalpha.3, makecontext.3, mallinfo.3, malloc_info.3, mallopt.3, matherr.3, mbstowcs.3, mcheck.3, memchr.3, mq_getattr.3, mq_open.3, mq_receive.3, mq_send.3, mtrace.3, newlocale.3, ntp_gettime.3, posix_openpt.3, printf.3, pthread_attr_init.3, pthread_attr_setschedparam.3, pthread_cancel.3, pthread_cleanup_push.3, pthread_cleanup_push_defer_np.3, pthread_create.3, pthread_getattr_default_np.3, pthread_getattr_np.3, pthread_getcpuclockid.3, pthread_setname_np.3, pthread_setschedparam.3, pthread_sigmask.3, pthread_tryjoin_np.3, readdir.3, realpath.3, recno.3, regex.3, rpc.3, scanf.3, sched_getcpu.3, sem_wait.3, setaliasent.3, sigqueue.3, statvfs.3, strcat.3, strcpy.3, strftime.3, strtok.3, strtol.3, strverscmp.3, toupper.3, ttyslot.3, xdr.3, fuse.4, loop.4, rtc.4, st.4, acct.5, core.5, elf.5, slabinfo.5, aio.7, arp.7, capabilities.7, cgroup_namespaces.7, cgroups.7, ddp.7, fanotify.7, feature_test_macros.7, inode.7, inotify.7, ip.7, keyrings.7, locale.7, mount_namespaces.7, namespaces.7, netdevice.7, netlink.7, packet.7, pkeys.7, pthreads.7, sched.7, session-keyring.7, sock_diag.7, socket.7, spufs.7, udplite.7, unix.7, user_namespaces.7, vdso.7, x25.7, ld.so.8: Use consistent markup for code snippets
Change .nf/.fi to .EX/.EE

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-19 13:47:27 +02:00
Michael Kerrisk e646a1bad9 ioctl_console.2, ioctl_getfsmap.2, ioctl_iflags.2, ioctl_list.2, ioctl_ns.2, kcmp.2, kexec_load.2, keyctl.2, link.2, mmap.2, modify_ldt.2, msgctl.2, poll.2, query_module.2, quotactl.2, recv.2, recvmmsg.2, sched_setscheduler.2, seccomp.2, select.2, semctl.2, semop.2, send.2, set_thread_area.2, setns.2, shmctl.2, shmget.2, sigaction.2, sysinfo.2, timer_create.2, timerfd_create.2, uname.2, unshare.2, userfaultfd.2, ustat.2, utimensat.2, vmsplice.2, wait.2, adjtime.3, backtrace.3, bswap.3, btree.3, clock_getcpuclockid.3, confstr.3, dbopen.3, dl_iterate_phdr.3, dlinfo.3, duplocale.3, encrypt.3, end.3, endian.3, err.3, errno.3, fmemopen.3, fopencookie.3, frexp.3, fts.3, ftw.3, getaddrinfo.3, getaddrinfo_a.3, getcontext.3, getgrouplist.3, getifaddrs.3, getipnodebyname.3, getnameinfo.3, getopt.3, getprotoent_r.3, getpwent_r.3, getrpcent.3, getservent_r.3, getttyent.3, getumask.3, glob.3, gnu_get_libc_version.3, hash.3, hsearch.3, inet.3, inet_pton.3, insque.3, isalpha.3, makecontext.3, mallopt.3, mbstowcs.3, mcheck.3, memchr.3, mq_getattr.3, mq_open.3, mtrace.3, newlocale.3, ntp_gettime.3, offsetof.3, posix_openpt.3, printf.3, pthread_setname_np.3, pthread_setschedparam.3, rpc.3, scanf.3, sched_getcpu.3, sem_wait.3, setaliasent.3, sigqueue.3, sigvec.3, stdarg.3, strcat.3, strcpy.3, strftime.3, strtol.3, toupper.3, ttyslot.3, fuse.4, loop.4, st.4, elf.5, cgroup_namespaces.7, cgroups.7, feature_test_macros.7, inode.7, inotify.7, keyrings.7, man-pages.7, math_error.7, mount_namespaces.7, mq_overview.7, pthreads.7, sched.7, session-keyring.7, udplite.7, unix.7, vdso.7: Use consistent markup for code snippets
The preferred form is

    .PP/.IP
    .in +4n
    .EX
    <code>
    .EE
    .in
    .PP/.IP

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-19 13:47:26 +02:00
Michael Kerrisk ee8655b59a arch_prctl.2, ioctl_fideduperange.2, ioctl_getfsmap.2, kexec_load.2, madvise.2, mbind.2, mmap.2, mmap2.2, mprotect.2, perf_event_open.2, process_vm_readv.2, set_mempolicy.2, shmget.2, subpage_prot.2, pthread_attr_init.3, pthread_create.3, pthread_getattr_np.3, regex.3, wavelan.4, filesystems.5, proc.5, bootparam.7, raw.7, tcp.7, units.7, ld.so.8: Add a non-breaking space between a number and a unit (prefix)
Based on a patch by Bjarni Ingi Gislason.

According to SI, ""The numerical value always precedes the unit,
and a space is always used to separate the unit from the number
[...] The only exceptions to this rule are for the unit symbols
for degree, minute, and second for plane angle."

Cowritten-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-18 12:12:59 +02:00
Michael Kerrisk 11ac5b5109 add_key.2, bpf.2, fcntl.2, futex.2, listxattr.2, perf_event_open.2, prctl.2, request_key.2, sigaltstack.2, __ppc_set_ppr_med.3, __ppc_yield.3, getw.3, setbuf.3, setjmp.3, lirc.4, core.5, securetty.5, inode.7, keyrings.7, process-keyring.7, user-keyring.7, ld.so.8: srcfix: use .PP instead of .P
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-18 01:13:44 +02:00
Michael Kerrisk dd3568a147 getent.1, intro.1, time.1, _exit.2, alloc_hugepages.2, arch_prctl.2, clock_getres.2, getitimer.2, getrusage.2, intro.2, ioctl_console.2, ioctl_list.2, ioctl_tty.2, kill.2, madvise.2, mlock.2, mmap.2, mount.2, open.2, outb.2, perf_event_open.2, ptrace.2, quotactl.2, reboot.2, recv.2, remap_file_pages.2, select.2, semctl.2, send.2, set_tid_address.2, seteuid.2, shmop.2, statfs.2, times.2, truncate.2, uname.2, uselib.2, vm86.2, wait.2, a64l.3, aio_cancel.3, aio_fsync.3, aio_read.3, aio_return.3, aio_suspend.3, aio_write.3, alloca.3, argz_add.3, atexit.3, basename.3, bindresvport.3, cacos.3, cacosh.3, carg.3, casin.3, casinh.3, catan.3, catanh.3, catgets.3, catopen.3, cexp.3, cfree.3, cimag.3, clog.3, conj.3, creal.3, ctime.3, des_crypt.3, dirfd.3, div.3, dlopen.3, envz_add.3, exit.3, fenv.3, flockfile.3, fmtmsg.3, fpclassify.3, fpurge.3, fseeko.3, ftime.3, ftok.3, ftw.3, getcontext.3, getcwd.3, getdate.3, getfsent.3, getgrent.3, getgrnam.3, gethostbyname.3, getipnodebyname.3, getlogin.3, getpwnam.3, getrpcent.3, getspnam.3, getutent.3, gsignal.3, hsearch.3, lockf.3, logb.3, login.3, lseek64.3, makecontext.3, malloc.3, malloc_hook.3, nan.3, nl_langinfo.3, openpty.3, posix_spawn.3, putenv.3, realpath.3, remainder.3, rint.3, rpc.3, rtime.3, scandir.3, setlogmask.3, shm_open.3, sigpause.3, statvfs.3, stdio_ext.3, strfmon.3, strftime.3, strptime.3, strtod.3, strtol.3, strtoul.3, swab.3, sysconf.3, syslog.3, tcgetpgrp.3, tempnam.3, termios.3, tmpfile.3, tmpnam.3, ttyslot.3, tzset.3, ualarm.3, usleep.3, wordexp.3, xcrypt.3, xdr.3, cciss.4, console_codes.4, full.4, hd.4, loop.4, mem.4, null.4, pts.4, ram.4, random.4, tty.4, ttyS.4, vcs.4, networks.5, nsswitch.conf.5, protocols.5, resolv.conf.5, slabinfo.5, termcap.5, ascii.7, boot.7, bootparam.7, charsets.7, icmp.7, inode.7, man.7, netdevice.7, posixoptions.7, ld.so.8: srcfix: use .PP instead of .LP
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-18 01:12:54 +02:00
Michael Kerrisk 37d5e69947 proc.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-18 01:11:26 +02:00
Michael Kerrisk 2dad4c59c8 cpuid.4, fd.4, full.4, initrd.4, lirc.4, msr.4, null.4, vcs.4, charmap.5, core.5, dir_colors.5, filesystems.5, gai.conf.5, hosts.equiv.5, locale.5, motd.5, networks.5, nscd.conf.5, nss.5, proc.5, protocols.5, repertoiremap.5, services.5, tmpfs.5, ttytype.5, intro.8, nscd.8: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-18 00:59:55 +02:00
Michael Kerrisk 6545cc56e0 dir_colors.5, feature_test_macros.7, glob.7, ip.7, ipv6.7, man-pages.7, man.7, netdevice.7, rtnetlink.7, socket.7, svipc.7, tcp.7, units.7, user_namespaces.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-18 00:55:49 +02:00
Michael Kerrisk bdd915e20f _syscall.2, capget.2, ioprio_set.2, semop.2, send.2, ctime.3, dysize.3, fenv.3, fmtmsg.3, ftok.3, ftw.3, getaddrinfo.3, getgrent_r.3, gethostbyname.3, getopt.3, getpw.3, getpwent_r.3, getsubopt.3, getutent.3, glob.3, if_nameindex.3, inet.3, lseek64.3, malloc_hook.3, mbrtowc.3, mkstemp.3, mq_receive.3, mq_send.3, posix_spawn.3, putgrent.3, putpwent.3, qsort.3, raise.3, rand.3, rtime.3, setaliasent.3, setbuf.3, shm_open.3, significand.3, sigqueue.3, statvfs.3, strfromd.3, strptime.3, strtol.3, strtoul.3, termios.3, tgamma.3, timeradd.3, tsearch.3, tzset.3, updwtmp.3, usleep.3, wcstok.3, console_codes.4, hd.4, hpsa.4, mem.4, null.4, ram.4, sd.4, ttyS.4, filesystems.5, group.5, passwd.5, shells.5, termcap.5, ttytype.5, tzfile.5, utmp.5, ascii.7, bootparam.7, complex.7, cpuset.7, epoll.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-17 23:40:17 +02:00
Michael Kerrisk e7d0bb4715 memusage.1, clone.2, eventfd.2, futex.2, getdents.2, ioctl_fat.2, ioctl_ns.2, kcmp.2, keyctl.2, mmap.2, mprotect.2, msgop.2, recvmmsg.2, request_key.2, sched_setaffinity.2, seccomp.2, setns.2, tee.2, timer_create.2, timerfd_create.2, unshare.2, userfaultfd.2, wait.2, __ppc_get_timebase.3, backtrace.3, bswap.3, clock_getcpuclockid.3, dl_iterate_phdr.3, dlinfo.3, dlopen.3, duplocale.3, end.3, endian.3, fmemopen.3, fopencookie.3, frexp.3, ftw.3, getdate.3, getgrouplist.3, getifaddrs.3, getprotoent_r.3, getservent_r.3, gnu_get_libc_version.3, if_nameindex.3, inet.3, inet_net_pton.3, inet_pton.3, insque.3, makecontext.3, mallinfo.3, malloc_info.3, mallopt.3, matherr.3, mbstowcs.3, mcheck.3, mq_getattr.3, mq_notify.3, newlocale.3, offsetof.3, posix_spawn.3, pthread_attr_init.3, pthread_cancel.3, pthread_cleanup_push.3, pthread_create.3, pthread_getattr_default_np.3, pthread_getattr_np.3, pthread_getcpuclockid.3, pthread_setname_np.3, pthread_setschedparam.3, pthread_sigmask.3, scandir.3, sem_wait.3, strcat.3, strftime.3, strtok.3, strtol.3, strverscmp.3, loop.4, core.5, aio.7, fanotify.7, feature_test_macros.7, inotify.7, pkeys.7, unix.7, user_namespaces.7: Use .EX/.EE for EXAMPLE programs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-16 10:44:33 +02:00
Michael Kerrisk eabf3ae555 acct.5, elf.5, hosts.5, resolv.conf.5, rpc.5, slabinfo.5, utmp.5: Formatting fix: replace blank lines with .PP/.IP
Blank lines shouldn't generally appear in *roff source (other
than in code examples), since they create large vertical
spaces between text blocks.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-16 03:06:54 +02:00
Michael Kerrisk a2923df043 proc.5: Minor fixes/additions to Benjamin Peterson's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-15 21:01:52 +02:00
Benjamin Peterson 99c68ff934 proc.5: Fix path to binfmt_misc docs
The documentation moved in linux
commit 9d85025b0418163fae079c9ba8f8445212de8568
("docs-rst: create an user's manual book").

Signed-off-by: Benjamin Peterson <bp@benjamin.pe>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-15 20:59:41 +02:00
Michael Kerrisk e3c8b3499a proc.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-15 16:35:34 +02:00
Michael Kerrisk c1a022dc6a proc.5, rpc.5, services.5, cgroups.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-15 16:34:53 +02:00
Michael Kerrisk 019d9ee872 getauxval.3, cciss.4, cpuid.4, msr.4, proc.5, tmpfs.5, man-pages.7, pid_namespaces.7, ld.so.8, nscd.8: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-15 16:15:21 +02:00
Michael Kerrisk a4e45e13c3 nsswitch.conf.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-15 15:49:54 +02:00
Michael Kerrisk 3c0e88e400 tzfile.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-12 21:53:47 +02:00
Michael Kerrisk 2061865fb4 tzfile.5: Minor tweaks
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-12 21:53:47 +02:00
Paul Eggert 72942d65ad tzfile.5: Sync from tzdb upstream
This makes tzfile.5 a copy of the tzdb version, except that the
tzdb version's first line is replaced by man-pages boilerplate.
The new version documents version 3 format, among other things.
Also, it removes the "Summary of the timezone information file
format" section, which should no longer be needed due to
improvements in the the part of the man page.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-12 21:53:47 +02:00
Marko Myllynen a581f7593b locale.5: Refer to existing locales for encoding details
Mike Fabian and Rafał Luzynski were recently named as glibc
localedata maintainers [1] and after that there's been active
development on this front, including discussion whether it would
be ok to use ASCII or some other encoding as values for actual
locate data.

Since I don't think it would make sense to try to have different
explanation for each glibc version on the locale(5) man page, I'm
proposing that we apply the below patch so that we refer to
existing locale definition files in general and not spell out the
exact format or any certain locale as a definitive guideline.

If the situation changes in the future or new a new convention
meant to last forever is created then perhaps Mike and Rafał can
provide an update then as needed.

1) https://sourceware.org/ml/libc-alpha/2017-07/msg00477.html
2) https://sourceware.org/ml/libc-alpha/2017-07/msg00807.html

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-12 21:53:47 +02:00
Jakub Wilk 690e8267ac tmpfs.5: ffix
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-05 10:18:30 +02:00
Michael Kerrisk 4040b0a506 slabinfo.5: SEE ALSO: add some references to relevant kernel source files
Reported-by: Jorge Nerin <jnerin@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-30 05:47:53 +02:00
Michael Kerrisk fe340cde31 tmpfs.5: SEE ALSO: add memfd_create(2), mmap(2), shm_open(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-26 14:38:55 +02:00
Michael Kerrisk e0a73a311f proc.5: Document that 'iowait' field of /proc/stat is unreliable
Text taken from Chao Fan's kernel commit 9c240d757658a3ae996.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-22 14:01:33 +02:00
Michael Kerrisk 3d5ea0476d proc.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-22 13:57:19 +02:00
Michael Kerrisk 83baec65e3 elf.5: SEE ALSO: add dl_iterate_phdr(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-12 13:04:22 +02:00
Michael Kerrisk 61506ebe6b rpc.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-09 16:08:03 +02:00
Michael Kerrisk abbd528af9 rpc.5: ffix
Reported-by: G. Branden Robinson <g.branden.robinson@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-09 16:08:03 +02:00
G. Branden Robinson b54a3883c3 rpc.5: ffix
* Remove nop argument from HP macros.
* Remove nop DT macro.
* Replace LP macro with more commonly-used PP macro.

The above do not change the output whatsoever (confirmed with -Z).

* Use .I macro instead of font escapes, obtaining italic correction.

To see the above distinction, use -Tps, -Tpdf, or similar before and
after the change.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-09 16:07:43 +02:00
DJ Delorie fc69ee442c nsswitch.conf.5: Clarify group merge rules
This minor patch clarifies when merging is not done, and how duplicate
entries are merged.

Found while extending glibc's NSS test suite, discussed with glibc
team and Stephen Gallagher.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-08 10:59:28 +02:00
Michael Kerrisk 99cf16816c Removed trailing white space at end of lines 2017-05-03 19:28:59 +02:00
Michael Kerrisk 734882f4c4 _exit.2, alarm.2, chmod.2, clone.2, epoll_ctl.2, fcntl.2, fork.2, fsync.2, getdents.2, getpid.2, ioctl.2, ioctl_console.2, ioctl_list.2, ioctl_ns.2, ioctl_tty.2, ioctl_userfaultfd.2, kexec_load.2, lseek.2, mincore.2, mkdir.2, mknod.2, mmap.2, open.2, poll.2, posix_fadvise.2, prctl.2, rename.2, sched_setaffinity.2, select.2, select_tut.2, sigaction.2, signalfd.2, sigprocmask.2, sigwaitinfo.2, socketcall.2, stat.2, statx.2, syscalls.2, truncate.2, umask.2, unshare.2, userfaultfd.2, utime.2, utimensat.2, wait.2, bzero.3, cfree.3, exit.3, getentropy.3, grantpt.3, insque.3, shm_open.3, syslog.3, termios.3, ttyname.3, wcsdup.3, console_codes.4, tty.4, vcs.4, elf.5, nsswitch.conf.5, proc.5, slabinfo.5, tmpfs.5, bootparam.7, environ.7, hostname.7, inotify.7, mailaddr.7, man-pages.7, namespaces.7, pid_namespaces.7, pthreads.7, pty.7, sem_overview.7, signal.7, socket.7, tcp.7, termio.7, user_namespaces.7, xattr.7, ld.so.8, zdump.8: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-03 19:27:48 +02:00
Michael Kerrisk 09e223c8de elf.5: SEE ALSO: add elfedit(1), nm(1), size(1), strings(1), and strip(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-02 07:45:59 +02:00
Jakub Wilk 9d224152f1 slabinfo.5: tfix
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-28 10:04:59 +02:00
Michael Kerrisk 2f4765212d slabinfo.5: Rudimentary documentation of 'batchcount'
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-24 11:37:23 +02:00
Michael Kerrisk 35737fdb0a slabinfo.5: Note constraints for values written to slabinfo
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-24 11:37:23 +02:00
Michael Kerrisk fa6cebc821 slabinfo.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-24 11:37:23 +02:00
Michael Kerrisk e00b5ddbbb proc.5: Simplify /proc/slabinfo entry
Don't repeat (out-of-date) info from slabinfo(5); just defer to
that page.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-24 11:37:23 +02:00
Michael Kerrisk 2b5139c524 slabinfo.5: /proc/meminfo 'Slab' shows total memory used by SLAB/SLUB cache
Verified by experiment (summing [pagesperslab * num_slabs] across
all records in /proc/slabinfo).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-24 11:37:23 +02:00
Michael Kerrisk 27e78df197 slabinfo.5: Rewrite to try to bring the content close to current reality
There's still gaps to fill in, but the existing page
was in any case hugely out of date.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-24 11:37:23 +02:00
Michael Kerrisk 42cfcef15e proc.5: Refer to namespaces(7) for discussion of /proc/sys/user/* files
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-19 15:52:04 +02:00
Florian Weimer 6c1f939f08 nsswitch.conf.5: Mention sudoers
It turns out that sudo drops things into nsswitch.conf, too.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-10 13:47:50 +02:00
Michael Kerrisk e867555833 proc.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-10 13:47:50 +02:00