Commit Graph

1243 Commits

Author SHA1 Message Date
Michael Kerrisk 10cbe8453b elf.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-28 10:44:01 +01:00
Chris Pick 1d8595fd1e elf.5: Remove erroneous, duplicate SHN_* section
The ELF header section's e_shstrndx contained a duplicate
description of the SHN_* special section header indices.
Remove them.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-28 10:43:49 +01:00
Michael Kerrisk 0ea48b19d5 core.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-27 17:18:14 +01:00
Michael Kerrisk c72249c562 fork.2, read.2, sendfile.2, splice.2, write.2, aio_read.3, aio_write.3, proc.5: Wording fix: "current file offset" ==> "file offset"
"File offset" is the preferred POSIX terminology.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-26 10:13:47 +01:00
Nikola Forró 85a7acd768 nsswitch.conf.5: Update NSS compatibility mode description
From the current description of NSS compatibility mode it seems
that /etc/passwd is the only file where special entries are
permitted.  But "compat" service can also be specified for group
and shadow databases, so this needs to be changed.

The list of special entries is for passwd database only, group
and shadow databases are not mentioned.  Because group database
does not support netgroup special entries and it deals with
groups, not users, it is better to make a separate list
of entries for it.

It is true that the default source for the compat pseudo-databases
is "nis", but it can be overridden by any NSS service, not just
"nisplus". Even "compat" itself can be specified as the source for
the pseudo-databases, but doing that of course leads to infinite
recursion, so it makes sense to disallow that.

The information was obtained from glibc source code, namely from
the following files:
nis/nss_compat/compat-pwd.c
nis/nss_compat/compat-grp.c
nis/nss_compat/compat-spwd.c

Signed-off-by: Nikola Forró <nforro@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-17 16:51:39 +01:00
Michael Kerrisk d9cb0d7d3f Various pages: Word "descriptor" more precisely
Use either "file descriptor" or message queue descriptor".

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-01-01 12:29:37 +01:00
Michael Kerrisk 7e1c8de044 slabinfo.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-30 16:10:26 +01:00
Michael Kerrisk 23289769d6 hosts.equiv.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-30 16:09:58 +01:00
Michael Kerrisk ba40f6a2c9 nscd.conf.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-30 16:09:39 +01:00
Michael Kerrisk a7af04ef44 hosts.equiv.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-30 16:09:15 +01:00
Michael Kerrisk 40bbe387a5 proc.5: Reaching /proc/sys/fs/file-max limit normally produces an ENFILE error
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-27 17:05:07 +01:00
Michael Kerrisk 6f3c74a8b9 mremap.2, open.2, perf_event_open.2, prctl.2, ptrace.2, reboot.2, seccomp.2, signalfd.2, syscalls.2, __ppc_set_ppr_med.3, daemon.3, dirfd.3, fgetgrent.3, fgetpwent.3, getauxval.3, getspnam.3, mallinfo.3, mallopt.3, posix_fallocate.3, termios.3, tty_ioctl.4, core.5, nsswitch.conf.5, proc.5, aio.7, capabilities.7, path_resolution.7, pipe.7, rtld-audit.7, signal.7, tcp.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-05 10:46:28 +01:00
Michael Kerrisk 6112ea9782 proc.5: Document 'CapAmb' in /proc/PID/status
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-04 14:57:55 +01:00
Michael Kerrisk 9242ecfe97 core.5: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-02 21:21:34 +01:00
Ross Zwisler db02982a48 core.5: Add info about DAX coredump filtering flags
Kernel 4.4 added two new core dump filtering flags,
MMF_DUMP_DAX_PRIVATE and MMF_DUMP_DAX_SHARED.

These flags allow us to explicitly filter DAX mappings.
This is desirable because DAX mappings, like hugetlb
mappings, have the potential to be very large.

Signed-off-by: Ross Zwisler <ross.zwisler@linux.intel.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-02 21:14:24 +01:00
Nikola Forró 2e8536833c nsswitch.conf.5: Add list of files being read when "files" service is used
This is not mentioned anywhere. Users can assume that the file
being read is something like /etc/$DATABASE, but that's not
always the case. It's better to explicitly specify which
file is read for each respective database.  The list of
files was acquired from glibc source code.

Signed-off-by: Nikola Forró <nforro@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-02 20:38:54 +01:00
Michael Kerrisk cf71273de1 proc.5: Add reference to ptrace(2) for /proc/sys/kernel/yama/ptrace_scope
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-10-08 13:01:33 +01:00
Michael Kerrisk e8aa7100f5 proc.5: wfix + tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-09-11 13:35:36 +02:00
Heinrich Schuchardt 84ff8c1e2d proc.5: /proc/sys: Describe whitespace characters
Suggested patch
https://lkml.org/lkml/2015/8/24/171
indicates missing documentation.

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

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-09-11 13:16:01 +02:00
Michael Kerrisk 54d5fd1e44 elf.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:44 +02:00
Michael Kerrisk a547929c7f elf.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:44 +02:00
Michael Kerrisk 8cc4d07100 Removed trailing white space at end of lines 2015-07-23 16:15:22 +02:00
Michael Kerrisk 5722c835ab intro.1, locale.1, _exit.2, access.2, bpf.2, brk.2, capget.2, chmod.2, chroot.2, clock_getres.2, clone.2, eventfd.2, fallocate.2, fork.2, getgroups.2, gethostname.2, getpid.2, getpriority.2, getrlimit.2, getrusage.2, gettid.2, iopl.2, ioprio_set.2, killpg.2, mlock.2, mprotect.2, perf_event_open.2, poll.2, posix_fadvise.2, pread.2, ptrace.2, read.2, readv.2, recv.2, rename.2, sched_setaffinity.2, sched_setattr.2, seccomp.2, select.2, send.2, seteuid.2, setgid.2, setresuid.2, setreuid.2, setuid.2, sigaltstack.2, signalfd.2, sigpending.2, sigprocmask.2, sigreturn.2, sigsuspend.2, sigwaitinfo.2, socket.2, stat.2, timer_create.2, uname.2, utimensat.2, wait.2, wait4.2, write.2, MB_LEN_MAX.3, __ppc_get_timebase.3, clearenv.3, dl_iterate_phdr.3, error.3, fexecve.3, fpurge.3, fread.3, fts.3, getaddrinfo.3, getaddrinfo_a.3, getauxval.3, getgrent_r.3, gethostbyname.3, getifaddrs.3, getnameinfo.3, getnetent_r.3, getprotoent.3, getprotoent_r.3, getpw.3, getpwent_r.3, getrpcent.3, getrpcent_r.3, getrpcport.3, getservent.3, getservent_r.3, gsignal.3, key_setsecret.3, malloc_get_state.3, malloc_info.3, malloc_stats.3, malloc_trim.3, memcpy.3, mq_notify.3, mq_open.3, perror.3, profil.3, psignal.3, pthread_attr_init.3, pthread_attr_setaffinity_np.3, pthread_cancel.3, pthread_cleanup_push.3, pthread_create.3, pthread_detach.3, pthread_getattr_np.3, pthread_join.3, pthread_setname_np.3, pthread_tryjoin_np.3, putgrent.3, rcmd.3, rpc.3, rpmatch.3, sem_close.3, sem_open.3, setaliasent.3, shm_open.3, sigqueue.3, strfmon.3, xcrypt.3, xdr.3, console_codes.4, null.4, core.5, host.conf.5, hosts.equiv.5, locale.5, repertoiremap.5, locale.7, man-pages.7, pty.7, rtld-audit.7, sched.7, vdso.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 16:12:28 +02:00
Michael Kerrisk 618f699492 proc.5: Refer to bpf(2) for explanation of /proc/sys/net/core/bpf_jit_enable
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-23 16:08:33 +02:00
Michael Kerrisk eb5367ada7 hosts.equiv.5: Minor improvement to text
As discussed with Carlos O'Donell.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-21 16:02:53 +02:00
Michael Kerrisk 087dd22bfd locale.5: Remove BUGS section saying man page is not complete
To some degree, this is true of many pages. And anyway, this
page is much better after recent work by Marko.

Reported-by: Marko Myllynen <myllynen@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-16 19:29:35 +02:00
Marko Myllynen 5ca8b4fa32 locale.5: document era keywords
This patch completes the LC_TIME section - since these era
keywords are so tightly coupled, I'm providing them as a
single patch.

Based on
http://pubs.opengroup.org/onlinepubs/009695399/basedefs/xbd_chap07.html
http://www.open-std.org/jtc1/SC22/WG20/docs/n972-14652ft.pdf

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-16 19:29:35 +02:00
Michael Kerrisk 7b28cf6636 core.5: Mention 'coredump_filter' boot option
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-26 11:07:43 +02:00
Michael Kerrisk 7065339f71 hosts.equiv.5: Improve explanation in EXAMPLE
Reported-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-18 21:19:38 +02:00
Michael Kerrisk 62184395b3 proc.5: Document /proc/sys/kernel/sysctl_writes_strict
Based on text in Documentation/sysctl/kernel.txt.

Cowritten-by: Kees Cook <keescook@chromium.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-18 08:34:16 +02:00
Michael Kerrisk ba5ed753c5 hosts.equiv.5: Improve explanation in EXAMPLE
Reported-by: Arjun Shankar <arjun@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-18 08:34:15 +02:00
Michael Kerrisk e7fd5cc233 hosts.equiv.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-18 08:34:15 +02:00
Michael Kerrisk 9e7cff750b hosts.equiv.5: Tweak's to Carlos's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-17 10:46:06 +02:00
Carlos O'Donell 427cee53f0 hosts.equiv.5: Fix format, clarify IdM needs, and provide examples.
In some recent work with a Red Hat customer I had the opportunity
to discuss the fine nuances of the ruserok() function and related
API which are used to implement rlogin and rsh.

It came to my attention after working with QE on some automated
internal testing that there were no good examples in the hosts.equiv
manual page showing how the format was supposed to work for this
file and for ~/.rhosts, worse the "format" line showed that there
should be spaces between arguments when that would clearly lead
to incorrect behaviour. In addition some things that the format
allows you to write are just wrong like "-host -user" which makes
no sense since the host is already rejected, and should be written
as "host -user" instead. I added notes in the example to make it
clear that "-host -user" is invalid.

I fixed three things:

(a) The format line.
- Either +, or [-]hostname, or +@netgrp or -@netgrp.
- Either +, or [-]username, or +@netgrp or -@netgrp.
- You must specify something in the hostname portion so remove
  optional brackets.

(b) Clarify language around credentials
- If the host is not trusted you must provide credentials to
  the login system and that could be anything really and it
  depends on your configuration e.g. PAM or whatever IdM you have.

(c) Provide real-world examples
- Provide several real world examples and some corner case
  examples for how you would write something. Hopefully others
  can add examples as they see fit.

Signed-off-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-17 08:34:18 +02:00
Michael Kerrisk 6e9c8c174f host.conf.5: Wording fix: s/resolv+/the resolver library/
The term "resolv+" seems to be historical cruft.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-16 13:20:54 +02:00
Michael Kerrisk 4839256aff locale.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 18:45:53 +02:00
Michael Kerrisk 7bc58733c5 locale.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 18:45:53 +02:00
Marko Myllynen 861c753ae3 locale.5: tfix / minor clarification
The subject says it all, for reference see e.g. ja_JP.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 18:45:53 +02:00
Marko Myllynen b3834a454f locale.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 18:45:50 +02:00
Marko Myllynen e4bcd97145 locale.5: Sort according to the standard
Sort the options so that those defined in POSIX are listed first,
then followed by those defined in ISO/IEC TR 14652 in the order
of common convention in many widely used glibc locales.

Actual descriptions are unchanged.

http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap07.html

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 18:31:19 +02:00
Marko Myllynen cc7279ff2e locale.5: Remove the FIXME for timezone
The timezone of LC_TIME is not in POSIX, only 6 (out of ~300)
glibc locales define it, the glibc code comment below from
glibc.git/programs/ld-time.c seems to suggest it's not a good
idea, and there's been a proposal in upstream [1] to remove the
existing timezone definitions from glibc locales so I think
it's actually better to leave this one undocumented:

/* XXX We don't perform any tests on the timezone value since this is
   simply useless, stupid $&$!@...  */

1) https://sourceware.org/ml/libc-alpha/2015-06/msg00098.html

Move the remaining LC_COLLATE FIXMEs together while at it.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 18:30:09 +02:00
Marko Myllynen ea7208a6aa locale.5: Refer to strftime(3) where appropriate
The relationship between the locale time format syntax
and strftime() cannot be considered as obvious.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 18:27:55 +02:00
Marko Myllynen ab601e67b9 locale.5: Refer to locale(7) more prominently
It's probably a good idea to refer to locale(7) so that a reader
can check what a category is about before describing them in
detail.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-06-12 18:27:14 +02:00
Michael Kerrisk a41c3eccb2 elf.5: wfix
Reported-by: Hack NDo <hackndo@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-29 20:31:41 +02:00
Marko Myllynen d850c7e08f repertoiremap.5: Symbolic names AKA mnemonics
A long time ago in glibc, repertoire maps were used (but they
were removed already in 2000), those mapping files were named
as mnemonics, so "mnemonic" is a term that would almost
certainly come up if somebody studies glibc side (perhaps even
the related standards like ISO 9945 [which I don't have access
to]) so I thought it's worth to mention to term in the man page
to make sure we're talking about the same thing, otherwise
someone might wonder is that something different or not.

IOW, symbolic names and mnemonics are often used interchangeably,
let's mention the other often used term in the page, too.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-15 16:20:37 +02:00
Michael Kerrisk 6aeda2ec3f locale.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-15 16:03:26 +02:00
Marko Myllynen 89fca3422e charmap.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-15 15:49:55 +02:00
Michael Kerrisk 577c0e20bb proc.5: Add /proc/crypto entry with a pointer to further information
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-15 15:42:07 +02:00
Michael Kerrisk 3434fb0b46 proc.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-15 11:27:58 +02:00
Michael Kerrisk b1aad373f2 proc.5: Move misordered /proc/[pid]/timers entry
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-15 09:28:05 +02:00
Michael Kerrisk 40e259bc36 proc.5: Tweak /proc/vmstat text
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-15 09:24:18 +02:00
Michael Kerrisk 1693f1368a proc.5: List /proc/vmstat fields
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-14 23:21:27 +02:00
Marko Myllynen 3dc4e84019 locale.5: Add iconv(1) reference
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-13 17:11:36 +02:00
Michael Kerrisk b8a2e38e00 locale.5: ffix
Reported-by: Marko Myllynen <myllynen@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-13 16:55:27 +02:00
Michael Kerrisk f18d16a9c5 repertoiremap.5: ffix
Reported-by: Marko Myllynen <myllynen@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-13 16:52:07 +02:00
Marko Myllynen 979494409a proc.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-13 14:05:40 +02:00
Michael Kerrisk 35a2f8868e locale.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-12 16:32:27 +02:00
Marko Myllynen d8826256c6 locale.5: Fix country_isbn format
Both plain numbers and Unicode code points are used in glibc locales but checking the code reveals that country_isbn is handled like the rest of its category expect for country_num which was clarified earlier.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-12 16:24:42 +02:00
Marko Myllynen 1f4f51b5b3 locale.5: Document class in LC_CTYPE
See e.g. the locale zh_CN and

http://en.cppreference.com/w/cpp/string/wide/towctrans
http://en.cppreference.com/w/cpp/string/wide/wctrans

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-12 16:24:42 +02:00
Marko Myllynen 6077885a06 locale.5: Document default_missing
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-12 16:24:42 +02:00
Marko Myllynen 4e3b0c16e1 locale.5: Document character transliteration
See e.g. da_DK for reference.

(Not sure should we actually provide an example here?)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-12 16:24:42 +02:00
Marko Myllynen f863ce4f60 locale.5: Document map "totitle"
See e.g. locales/i18n for reference.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-12 16:24:38 +02:00
Marko Myllynen af7ad104e1 locale.5: Copy is not exclusive in LC_CTYPE and LC_COLLATE
See e.g. da_DK for reference.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-12 16:24:10 +02:00
Marko Myllynen 0ef30d8d20 locale.5: Document map to_inpunct, map to_outpunct
See e.g. fa_IR for reference.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-12 16:24:06 +02:00
Marko Myllynen 89257a53db locale.5: Document outdigit and alt_digits
See e.g. fa_IR for reference.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-12 16:24:01 +02:00
Marko Myllynen ae91a0d63c locale.5: Document charclass and charconv
See e.g. the locales ja_JP and ko_KR and

http://en.cppreference.com/w/cpp/string/wide/towctrans
http://en.cppreference.com/w/cpp/string/wide/wctrans

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-12 16:23:55 +02:00
Michael Kerrisk fba4548539 proc.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-08 20:31:14 +02:00
Michael Kerrisk a77b10560e proc.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-08 20:30:54 +02:00
Michael Kerrisk 67d2c6873c add_key.2, chown.2, epoll_ctl.2, epoll_wait.2, execve.2, fcntl.2, get_mempolicy.2, getxattr.2, ioctl.2, keyctl.2, listxattr.2, mkdir.2, mknod.2, mmap.2, msync.2, nfsservctl.2, open.2, prctl.2, removexattr.2, request_key.2, sendfile.2, set_mempolicy.2, setxattr.2, shmget.2, shutdown.2, sigaction.2, syslog.2, truncate.2, umask.2, CPU_SET.3, atexit.3, bsearch.3, cmsg.3, err.3, gethostid.3, getmntent.3, getopt.3, iconv_close.3, inet_ntop.3, longjmp.3, lsearch.3, mcheck.3, on_exit.3, putpwent.3, regex.3, resolver.3, setbuf.3, setjmp.3, setlocale.3, setlogmask.3, sleep.3, strsignal.3, sysconf.3, undocumented.3, tty_ioctl.4, proc.5, resolv.conf.5, tzfile.5, aio.7, bootparam.7, capabilities.7, fanotify.7, inotify.7, ip.7, packet.7, pthreads.7, raw.7, signal.7, socket.7, unix.7, ld.so.8, nscd.8: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-07 08:26:32 +02:00
Regid Ichira e23f2a23cd gai.conf.5: Minor wording fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-06 18:36:19 +02:00
Michael Kerrisk 73b9cbe1ca proc.5: Improve description of /proc/PID/status
Reported-by: Kirill A. Shutemov <kirill.shutemov@linux.intel.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-05 18:35:54 +02:00
Michael Kerrisk fee59977e0 proc.5: Document /proc mount options
Document the 'hidepid' and 'gid' mount options that were added in
Linux 3.3.  See https://bugzilla.kernel.org/show_bug.cgi?id=90641
Based on text by Vasiliy Kulikov in
Documentation/filesystems/proc.txt.

Reported-by: Cameron Norman <camerontnorman@gmail.com>
Cowritten-by: Vasiliy Kulikov <segooon@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-05 18:00:26 +02:00
Guillem Jover 7e3c767ad6 proc.5: Document /proc/PID/exe behaviour on unlinked pathnames
Signed-off-by: Guillem Jover <guillem@hadrons.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-04 11:11:39 +02:00
Michael Kerrisk 06dd061c07 proc.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-04 11:10:22 +02:00
Michael Kerrisk 7291261fc4 tzfile.5: Rework text describing header as a list
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-02 09:59:01 +02:00
Sam Varshavchik f09abf6d41 tzfile.5: Add various details on version 2 format
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-02 09:54:33 +02:00
Michael Kerrisk 64fcb6e1ce proc.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-30 22:04:33 +02:00
Michael Kerrisk 56961a8c42 resolv.conf.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-30 21:39:21 +02:00
Michael Kerrisk e28af9cd1c proc.5: Document /proc/PID/status VmPMD
Reported-by: Weijie Yang <weijie.yang@samsung.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-30 11:16:16 +02:00
Michael Kerrisk 8ea2ddccb7 attr.5: Adjust link target to be "attr.7"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 14:38:56 +02:00
Michael Kerrisk 1dea597b7a proc.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 12:04:26 +02:00
Michael Kerrisk f2d607ee95 proc.5: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 12:04:26 +02:00
Michael Kerrisk 253932b11e filesystems.5: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 12:04:26 +02:00
Stéphane Aulery 1400187052 resolv.conf.5: ffix
Signed-off-by: Stéphane Aulery <saulery@free.fr>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 12:04:26 +02:00
Stéphane Aulery f6ab153e73 resolv.conf.5: Document RES_SNGLKUPREOP
Fix Ubuntu bug #1110781:
https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/1110781
This bug have been partially resolved by commit
aa87a3f3f8 and tagged
fixed-upstream by Simon Paillard for Debian bug #699387.

The Ubuntu bug #1110781 report is more comprehensive and passing
I saw that RES_SNGLKUPREOP was missed.

Reported-by: Thomas Hood <jdthood@gmail.com>
Signed-off-by: Stéphane Aulery <saulery@free.fr>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 12:04:26 +02:00
Michael Kerrisk 174dfad254 resolv.conf.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 11:08:02 +02:00
Stéphane Aulery 7d9f4717fd resolv.conf.5: Document use-vc option added to glibc 2.14
Fix Ubuntu bug #1110781:
https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/1110781

Reported-by: Thomas Hood <jdthood@gmail.com>
Signed-off-by: Stéphane Aulery <saulery@free.fr>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 11:07:35 +02:00
Michael Kerrisk 5d993ac57d attr.5: New link to attr(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-22 08:40:37 +02:00
Michael Kerrisk ed948c28b3 chown.2, execve.2, prctl.2, truncate.2, proc.5, capabilities.7, ld.so.8: Tighter wording: 'mode bit' rather than 'permission bit'
For sticky, set-UID, and set-GID mode bits (as used in POSIX).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 14:36:59 +02:00
Michael Kerrisk fce2114916 proc.5: Enhance discussion of /proc/PID/status 'VmSwap' field
Based on https://lwn.net/Articles/634978/

Cowritten-by: Vlastimil Babka <vbabka@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-19 09:51:49 +02:00
Michael Kerrisk 5fec7fe59a proc.5: Document /proc/sys/kernel/randomize_va_space
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-19 09:51:49 +02:00
Michael Kerrisk 58d375dd8a proc.5: Document /proc/PID/fdinfo epoll format
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-18 13:20:39 +02:00
Michael Kerrisk 6e7622ee53 proc.5: Describe /proc/PID/fdinfo eventfd format
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-18 13:20:39 +02:00
Michael Kerrisk f8a14cac3c proc.5: Document /proc/PID/fdinfo signalfd format
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-18 13:20:39 +02:00
Michael Kerrisk 0275956d88 proc.5: Describe "mnt_id" field of /proc/PID/fdinfo
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-18 13:20:39 +02:00
Michael Kerrisk a405066e3d proc.5: Update description /proc/sys/unix 'Type' field
The existing text was very crufty. UNIX domain sockets
support more than SOCK_STREAM for a _very_ long time now.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-06 16:13:54 +02:00
Michael Kerrisk 8f8a46fbcb proc.5: Note that abstract sockets are included in /proc/net/unix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-06 16:13:54 +02:00
Michael Kerrisk 756f55f601 proc.5: Reformat /proc/net/unix information as a list
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-06 16:13:54 +02:00
Michael Kerrisk dbe6f88bf8 proc.5: Add some detail to /proc/PID/timers
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-06 16:13:54 +02:00
Michael Kerrisk 7f1ea8fbde proc.5: /proc/PID/timers fix
Minor fix to description.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-06 16:13:54 +02:00
Michael Kerrisk 93691c1ef8 proc.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-06 16:13:54 +02:00
Michael Kerrisk 5734da6d61 proc.5: Note that /proc/PID/timers requires CONFIG_CHECKPOINT_RESTORE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-06 16:13:54 +02:00
Michael Kerrisk 1e64c86bbf intro.1, ldd.1, clone.2, getgroups.2, getpid.2, getsockopt.2, ioctl_list.2, msgop.2, open.2, seccomp.2, setgid.2, setresuid.2, setreuid.2, setuid.2, sigaction.2, sigpending.2, sigprocmask.2, sigreturn.2, sigsuspend.2, sigwaitinfo.2, socket.2, syscall.2, syscalls.2, umount.2, clock.3, dlopen.3, fmemopen.3, fpathconf.3, fputwc.3, fputws.3, fseek.3, fseeko.3, gcvt.3, getline.3, getwchar.3, hypot.3, if_nameindex.3, initgroups.3, popen.3, resolver.3, strcoll.3, strdup.3, tzset.3, ulimit.3, wcstombs.3, wctob.3, xdr.3, console_codes.4, random.4, filesystems.5, host.conf.5, hosts.5, proc.5, resolv.conf.5, securetty.5, credentials.7, feature_test_macros.7, hier.7, ipv6.7, packet.7, pthreads.7, raw.7, signal.7, tcp.7, user_namespaces.7, ld.so.8, ldconfig.8: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-29 22:30:09 +02:00
Michael Kerrisk 20d7c60b35 nsswitch.conf.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-27 12:21:34 +01:00
Stéphane Aulery 8528c9890b hosts.5: Mention 127.0.1.1 for FQDN and IPv6 examples
See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=562890

Reported-by: Vincent Lefevre <vincent@vinc17.net>
Signed-off-by: Stéphane Aulery <saulery@free.fr>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-22 20:20:58 +01:00
Michael Kerrisk f6d0868784 host.conf.5: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-10 08:19:07 +01:00
Stéphane Aulery e51f148aa1 host.conf.5: Rework discussion of nospoof, spoofalert, spoof and RESOLV_SPOOF_CHECK
The keywords and environment variables "nospoof", "spoofalert",
"spoof" and RESOLV_SPOOF_CHECK were added to glibc 2.0.7 but
never implemented

Move descriptions to historical section and reorder it for clarity

See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=773443

Reported-by: <ygrex@ygrex.ru>
by: Stéphane Aulery <saulery@free.fr>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-10 08:19:07 +01:00
Michael Kerrisk 51dea63adf proc.5: Document (the obsolete) /proc/PID/seccomp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-09 16:15:02 +01:00
Stéphane Aulery 4bc79d5d48 resolv.conf.5: tfix
Signed-off-by: Stéphane Aulery <saulery@free.fr>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-09 08:09:48 +01:00
Stéphane Aulery 520c3a8b9d securetty.5: Note that the pam_securetty module also uses this file
See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=528015

This patch is a modified version of the one proposed without
parts specific to Debian.

Reported-by: Nicolas FRANCOIS <nicolas.francois@centraliens.net>
Signed-off-by: Stéphane Aulery <saulery@free.fr>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-08 09:52:13 +01:00
Stéphane Aulery ea36508af1 filesystems.5: ffix
Order the list of filesystems by name

Signed-off-by: Stéphane Aulery <saulery@free.fr>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-08 09:52:13 +01:00
Stéphane Aulery 7b46b4fae3 host.conf.5, hosts.5, resolv.conf.5: Cross references of these pages.
See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=298259

Reported-by: Paul E Condon <pecondon@mesanetworks.net>
Signed-off-by: Stéphane Aulery <saulery@free.fr>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-08 09:51:54 +01:00
Michael Kerrisk b37c3036bb filesystems.5: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-06 22:33:45 +01:00
Michael Kerrisk b7a89be42c filesystems.5: Remove dubious claim about comparative performance of ext2
Perhaps it was the best filesystem performance-wise in
the 20th century, when that text was written. That probaly
ceased to be true quite a long time ago, though.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-06 22:29:55 +01:00
Stéphane Aulery eaf096254c filesystems.5: Add cross references for ext filesystems
Signed-off-by: Stéphane Aulery <saulery@free.fr>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-06 22:25:40 +01:00
Michael Kerrisk 7566936006 filesystems.5: Fixup: Reverse earlier change to case of filesystem names
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-06 14:56:34 +01:00
Stéphane Aulery c2c247dc56 filesystems.5: ffix
Highlight all file systems citations

Signed-off-by: Stéphane Aulery <saulery@free.fr>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-06 14:56:34 +01:00
Stéphane Aulery c8375cf207 filesystems.5: wfix
XIA filesystem Linux module name is xiafs

Signed-off-by: Stéphane Aulery <saulery@free.fr>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-06 14:56:34 +01:00
Stéphane Aulery 895fe6f029 filesystems.5: ffix
All filesystems in lowercase

Signed-off-by: Stéphane Aulery <saulery@free.fr>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-06 14:56:34 +01:00
Stéphane Aulery 5bc93c9f3d filesystems.5: Specifies the scope of this list and its limits.
Signed-off-by: Stéphane Aulery <saulery@free.fr>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-06 14:56:34 +01:00
Stéphane Aulery 1258e3251b filesystems.5: srcfix
Remove useless quotes

Signed-off-by: Stéphane Aulery <saulery@free.fr>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-06 14:56:34 +01:00
Michael Kerrisk d06a6170dd proc.5: Replace description of 'uid_map' with a reference to user_namespaces(7)
All of the information in proc(5) was also present in
user_namespaces(7), but the latter was more detailed
and up to date.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-04 15:11:02 +01:00
Michael Kerrisk ab28dba9a0 proc.5, user_namespaces.7: Migrate description of /proc/PID/setgroups to user_namespaces(7)
It makes sense to have the description of this file
in the general discussion of user namespaces.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-04 15:11:02 +01:00
Michael Kerrisk a0726dbfdd proc.5: Tweaks to /proc/PID/setgroups text
After comments from Eric Biederman

Cowritten-by: Eric W. Biederman <ebiederm@xmission.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-04 15:11:02 +01:00
Michael Kerrisk 6bb49a3266 proc.5: Tweak's to Eric Biederman's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-03 15:49:39 +01:00
Michael Kerrisk de04dd4df3 proc.5: Add some details on /proc/PID/setgroups
And generally rework the text.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-03 15:49:39 +01:00
Michael Kerrisk 5c92b1b761 proc.5: Tweaks to Eric Biederman's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-03 15:49:39 +01:00
Eric W. Biederman d520465b99 proc.5: Document /proc/[pid]/setgroups
Signed-off-by: Eric W. Biederman <ebiederm@xmission.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-03 15:49:39 +01:00
Michael Kerrisk 1622fc979b proc.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-03 15:49:39 +01:00
Taisuke Yamada 157890398b proc.5: Document /proc/PID/status VmPin field
See https://bugs.launchpad.net/bugs/1071746

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-02 17:22:26 +01:00
Michael Kerrisk b6620a255b proc.5: tfix + srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-02 17:22:26 +01:00
Taisuke Yamada fd44bdc797 proc.5: Fix SELinux /proc/pid/attr/current example
Since the /proc/pid/attr API was added to the kernel, there
have been a couple of changes to the SELinux handling of
/proc/pid/attr/current.  Fix the SELinux /proc/pid/attr/current
example text to reflect these changes and note which kernel
versions first included the changes.

Signed-off-by: Stephen Smalley <sds@tycho.nsa.gov>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-02 17:22:26 +01:00
Michael Kerrisk 6d322d5fc7 time.1, access.2, arch_prctl.2, cacheflush.2, capget.2, clone.2, execve.2, fcntl.2, fork.2, getpid.2, getxattr.2, ioctl.2, ioctl_fat.2, killpg.2, listxattr.2, madvise.2, migrate_pages.2, modify_ldt.2, mprotect.2, msgget.2, msgop.2, perf_event_open.2, ptrace.2, sched_setattr.2, semget.2, semop.2, sendfile.2, set_thread_area.2, setxattr.2, stat.2, statfs.2, wait.2, wait4.2, encrypt.3, mktemp.3, pthread_attr_setschedparam.3, resolver.3, statvfs.3, syslog.3, tzset.3, core.5, host.conf.5, intro.5, proc.5, resolv.conf.5, pthreads.7, socket.7, unix.7, ld.so.8, ldconfig.8: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-02-21 09:26:52 +01:00
Simon Paillard 0921ce4ab0 resolver.3, host.conf.5: host.conf 'order' option deprecated, replaced by nsswitch.conf(5)
http://www.sourceware.org/bugzilla/show_bug.cgi?id=2389
b9c65d0902

Reported at http://bugs.debian.org/270368,
http://bugs.debian.org/396633, and http://bugs.debian.org/344233.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-02-21 08:32:15 +01:00
Michael Kerrisk 94a4f58a7a resolv.conf.5: SEE ALSO: add nsswitch.conf(5)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-02-21 08:32:15 +01:00
Michael Kerrisk 7672e08e00 proc.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-02-21 08:32:12 +01:00
Michael Kerrisk c3b494c295 proc.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-02-21 08:32:12 +01:00
Michael Kerrisk 2702dc2175 proc.5: (Briefly) document /proc/PID/attr/socketcreate
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-02-21 07:58:28 +01:00
Michael Kerrisk 666db07e1a proc.5: (Briefly) document /proc/PID/attr/keycreate
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-02-21 07:58:28 +01:00
Michael Kerrisk b7a425679b proc.5: Document /proc/PID/attr/{current,exec,fscreate,prev}
Heavily based on Stephen Smalley's text in
    https://lwn.net/Articles/28222/
    From:    Stephen Smalley <sds@epoch.ncsc.mil>
    To:      LKML and others
    Subject: [RFC][PATCH] Process Attribute API for Security Modules
    Date:    08 Apr 2003 16:17:52 -0400

Cowritten-by: Stephen Smalley <sds@tycho.nsa.gov>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-02-21 07:58:28 +01:00
Michael Kerrisk c261b0e5a5 proc.5: Document /proc/sys/kernel/auto_msgmni
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-02-21 07:58:28 +01:00
Michael Kerrisk 12618ce888 intro.5: Remove words "and protocols"
There are no protocol descriptions in Section 5. Protocols are
in Section 7.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-02-21 07:58:28 +01:00
Michael Kerrisk f2aa4dcc8e proc.5: Note that CAP_SYS_ADMIN is required to list /proc/PID/map_files
This might however change in the future; see the Jan 2015 LKML thread:

        Re: [RFC][PATCH v2] procfs: Always expose /proc/<pid>/map_files/
                            and make it readable

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-02-21 07:58:27 +01:00
Michael Kerrisk e81e6a4721 proc.5: Add reference to prctl(2) in discussion of /proc/sys/fs/suid_dumpable
And note that /proc/sys/fs/suid_dumpable defines the
value assigned to the process "dumpable" flag in certain
circumstances.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-02-21 07:58:27 +01:00
Michael Kerrisk 60a119dd2a core.5: Executing a file that has capabilities also prevents core dumps
Reported-by: Bill McConnaughey <mcconnau@biochem.wustl.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-02-15 16:44:23 +01:00
Michael Kerrisk e04ae86d7b core.5: Document "%i" and "%I" core_pattern specifiers
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-02-15 16:44:23 +01:00
Michael Kerrisk 9dc53e71c2 kexec_load.2, personality.2, prctl.2, reboot.2, socket.2, fflush.3, getopt.3, random.3, termios.3, random.4, passwd.5, capabilities.7, signal.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-02-01 17:14:12 +01:00
Michael Kerrisk 64f7f61e8c passwd.5: SEE ALSO: add chfn(1), chsh(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-02-01 09:25:53 +01:00
Michael Kerrisk 112434e4ae repertoiremap.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-01-28 10:33:39 +01:00
Michael Kerrisk f33774c483 proc.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-01-28 10:33:22 +01:00
Michael Kerrisk 8392a3b33f _exit.2, dup.2, execve.2, execveat.2, fallocate.2, fcntl.2, get_robust_list.2, getrlimit.2, mbind.2, memfd_create.2, mmap.2, open.2, ptrace.2, readv.2, select.2, sigaction.2, syscall.2, syscalls.2, truncate.2, utimensat.2, write.2, errno.3, exec.3, fclose.3, fexecve.3, fmemopen.3, fopencookie.3, getgrent_r.3, getline.3, getmntent.3, getpw.3, getpwent_r.3, getspnam.3, malloc_info.3, posix_fallocate.3, putgrent.3, shm_open.3, locale.5, proc.5: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-01-22 23:29:25 +01:00
Elie De Brauwer 73ba31a9ca proc.5: tfix
Signed-off-by: Elie De Brauwer <eliedebrauwer@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-01-22 21:55:26 +01:00
Elie De Brauwer 4f747ba0b2 proc.5: Document /proc/sys/vm/compact_memory
Since 2.6.36 [1] CONFIG_COMPACTION is supported in Linux (for a
detailed explanation see [2]). But in essence the contents of
/proc/buddyinfo shows how much contiguous areas of a certain
size are available. These numbers are not actually up to date
as the Linux kernel will implicitly trigger compaction
(+- defragmentation) when an allocation is done.  This makes it
difficult since you can't predict upfront whether or not a large
allocation will succeed or not.  By using
/proc/sys/vm/compact_memory you can explicitly trigger compaction
to occur and /proc/buddyinfo will give a more realistic view on
the available memory in contiguous areas.

This patch updates proc.5 to explain the usage of this file and is
inspired by Documentation/systcl/vm.txt [3]

[1] http://kernelnewbies.org/Linux_2_6_35#head-9cb0a1275559d40296da42efb7977896ac9edab7
[2] http://lwn.net/Articles/368869/
[3] http://lxr.free-electrons.com/source/Documentation/sysctl/vm.txt#L100

Signed-off-by: Elie De Brauwer <eliedebrauwer@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-01-22 21:54:02 +01:00
Michael Kerrisk b62298e37d resolv.conf.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-01-16 07:55:40 +01:00
Akihiro Motoki 6ba56b5cd0 locale.5: Correct variable name
I think "positive_sign" is used.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-01-16 07:54:02 +01:00
Michael Kerrisk 4e1438e3cb proc.5: Remove bogus statement about NR_OPEN being a ceiling for file-max
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-01-13 11:26:44 +01:00
Michael Kerrisk c290e5637b proc.5: Document /proc/sys/fs/nr_open
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-01-13 11:15:05 +01:00
Michael Kerrisk 1fb61947c2 proc.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-01-10 09:38:10 +01:00
Michael Kerrisk 039b6546fd proc.5: Document "Seccomp" field of /proc/PID/status
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-01-10 09:38:10 +01:00
Michael Kerrisk 360d311681 Removed trailing white space at end of lines 2014-12-31 07:46:42 +01:00
Michael Kerrisk 0649afd45a localedef.1, adjtimex.2, clock_nanosleep.2, epoll_ctl.2, ioctl.2, madvise.2, open.2, posix_fadvise.2, prctl.2, restart_syscall.2, sched_setaffinity.2, select.2, semop.2, setsid.2, sgetmask.2, sigaction.2, sigreturn.2, splice.2, syscall.2, syscalls.2, tee.2, tkill.2, abort.3, cmsg.3, exp10.3, ftw.3, getopt.3, ilogb.3, memcmp.3, mq_open.3, pow.3, pthread_setschedparam.3, sigvec.3, sysconf.3, termios.3, tgamma.3, wordexp.3, locale.5, proc.5, resolv.conf.5, cp1251.7, credentials.7, fanotify.7, inotify.7, locale.7, man-pages.7, signal.7, unix.7, ld.so.8: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-12-31 07:01:38 +01:00
Sven Hoexter ac4b0eb36e proc.5: Cosmetic changes for VmSwap to keep the layout consistent
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-12-30 21:29:11 +01:00
Michael Kerrisk 4158771432 proc.5: Revise description of /proc/PID/status 'VmSwap' entry
Reported-by: Kamezawa Hiroyuki <kamezawa.hiroyu@jp.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-12-26 07:35:25 +01:00
Michael Kerrisk 1ddc16655d proc.5: Note kernel version that added "VmSwap" to /proc/PID/status
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-12-26 07:35:25 +01:00
Sven Hoexter 49f6dda794 proc.5: Add "VmSwap" to /proc/[pid]/status
Documented as is in Documentation/filesystems/proc.txt of Linux 3.18.

Signed-off-by: Sven Hoexter <sven@stormbind.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-12-26 07:35:25 +01:00
Michael Kerrisk c7383f92d4 proc.5: srcfix: Note commit that introduced /proc/thread-self
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-11-09 20:29:43 +01:00
Bernhard Walle 0ad6ad9c0c proc.5: Document /proc/thread-self
/proc/thread-self has been introduced in Linux 3.17 with
commit 0097875bd41528922fb3bb5f348c53f17e00e2fd.

Signed-off-by: Bernhard Walle <bernhard@bwalle.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-11-09 20:25:39 +01:00
Michael Kerrisk ee56674428 proc.5: tfix
Reported-by: Huxiaoxiang <huxiaoxiang@huawei.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-11-08 13:24:10 +01:00
Marko Myllynen 73d11aabbb locale.5: Fix miscoded character
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-28 20:32:16 +01:00
Michael Kerrisk 984bf8fc33 locale.5: Minor fixes to Marko Myllynnen's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-28 15:23:15 +01:00
Marko Myllynen f809007b99 locale.5: Describe the formats of values
locale(5) describes what a locale should define but doesn't
spell out how (in what format). The patch attempts to address
this, it also has few trivial additional enhancements.

* Reference to locale(7) for category descriptions.
* Clarify first_workday in NOTES a bit.
* Add upstream BZ reference for two missing LC_ADDRESS fields.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-28 15:18:21 +01:00
Florian Westphal ed8de0e44e proc.5: Document /proc/net/netfilter/nfnetlink_queue
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-28 14:55:29 +01:00
Jan Chaloupka f246d84728 resolv.conf.5: Add missing no-tld-query option
Based on commit [1], ithe no-tld-query option exists for
resolv.conf configuration file.  Description of this option
is provided in [2]. This patch just copies this option
into resolv.conf.5 man page. Plus changes 'a' member
into 'an' before 'unqualified name as if it ...'
on the third line of [2]. Based on [3], this option
was added in glibc 2.14 as solving [4] bug.

[1] https://sourceware.org/git/?p=glibc.git;a=commitdiff;h=f87dfb1f11c01f2ccdc40d81e134cd06b32e28e8
[2] http://www.daemon-systems.org/man/resolv.conf.5.html man page.
[3] https://sourceware.org/git/?p=glibc.git;a=blob;f=NEWS;h=952f32af17e7fb49c4c1a305de673a13075bfaf5;hb=f87dfb1f11c01f2ccdc40d81e134cd06b32e28e8
[4] https://sourceware.org/bugzilla/show_bug.cgi?id=12734

Signed-off-by: Jan Chaloupka <jchaloup@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-28 12:59:23 +01:00
Michael Kerrisk e890609356 capget.2, ptrace.2, vhangup.2, wait.2, ttyslot.3, console.4, proc.5, utmp.5, boot.7: tfix: page xrefs for init 2014-10-03 08:47:03 +02:00
Michael Kerrisk 859503c33e proc.5: Mention pmap(1) in discussion of /proc/PID/smaps
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-02 23:10:41 +02:00
Michael Kerrisk b96ddae00e proc.5: Minor tweaks to Elie De Brauwer's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-01 11:56:47 +02:00
Elie De Brauwer eb7097c2c4 proc.5: Document /proc/buddyinfo
This patch adds a short description about the contents of
/proc/buddyinfo and how this file can be used to assist
in checking for memory fragmentation issues.

Signed-off-by: Elie De Brauwer <eliedebrauwer@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-10-01 11:56:47 +02:00
Michael Kerrisk f5d401ddda Removed trailing white space at end of lines 2014-09-21 11:24:24 +02:00
Michael Kerrisk daf084cc33 clone.2, flock.2, getpid.2, getunwind.2, mount.2, reboot.2, semop.2, seteuid.2, setgid.2, setns.2, setresuid.2, setreuid.2, setuid.2, uname.2, unshare.2, clock.3, drand48.3, proc.5, capabilities.7, credentials.7, mq_overview.7, namespaces.7, pid_namespaces.7, svipc.7, user_namespaces.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-21 11:23:07 +02:00
Michael Kerrisk 4effb5bec3 getpid.2, mount.2, uname.2, proc.5, credentials.7, mq_overview.7, svipc.7: SEE ALSO: add namespaces(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:57 -07:00
Michael Kerrisk b81acb1504 proc.5, namespaces.7: Move /proc/[pid]/{gid_map,uid_map} text from proc.5 to namespaces.7
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:57 -07:00
Michael Kerrisk cf8bfe6d2a proc.5, namespaces.7: Move /proc/[pid]/mountstat text from proc.5 to namespaces.7
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:57 -07:00
Michael Kerrisk 4716a1dd65 proc.5, namespaces.7: Move /proc/[pid]/mountstats from proc.5 to namespaces.7
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:57 -07:00
Michael Kerrisk 357002ecdf proc.5, namespaces.7: Move /proc/[pid]/mounts from proc.5 to namespaces.7
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:57 -07:00
Michael Kerrisk 0bafc69241 proc.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:56 -07:00
Michael Kerrisk fbb59ce750 proc.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:56 -07:00
Michael Kerrisk 84d22d07fc proc.5: Document change of /proc/PID/ns/* files to symlinks in Linux 3.8
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:56 -07:00
Michael Kerrisk d41f83cce4 proc.5: Add detail on /proc/PID/ns bind mounted files
Opening a file bind mounted to a /proc/PID/ns/xxx file
also yields a descriptor that can be passed to setns().

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:55 -07:00
Michael Kerrisk 91935e7807 proc.5: Rework discussion of /proc/PIC/ns/* files
Rather than repeat the same text six times,
refactor it to occur in just one place.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:55 -07:00
Michael Kerrisk f34f018219 proc.5: srcfix: Added FIXME (/proc/PID/projid_map)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:55 -07:00
Michael Kerrisk 6b1eaf53bc proc.5: Further improvements to /proc/PID/{uid_map,gid_map} text
After review by Eric Biederman.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:55 -07:00
Michael Kerrisk a2f479dee9 proc.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:55 -07:00
Michael Kerrisk 98ea417334 proc.5: Clarify details of nonoverlapping ranges for /proc/PID/{uid_map,gid_map}
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:55 -07:00
Michael Kerrisk 3d33f6ceb7 proc.5: Note capability requirements for writing to /proc/PID/{uid_map,gid_map}
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:55 -07:00
Michael Kerrisk d0ebf39885 proc.5: Rework text describing line limit in /proc/PID/{uid_map,gid_map}
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:55 -07:00
Michael Kerrisk 23be33af33 proc.5: Clarify mapping provided by uid_map and gid_map
Add a sentence to emphasize that these files provide a mapping
based on the user namespace of the file opener.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:55 -07:00
Eric W. Biederman ec1dd85da2 proc.5: Document /proc/PID/ns/{user,pid,mnt}
Signed-off-by: Eric W. Biederman <ebiederm@xmission.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-13 20:15:55 -07:00