Commit Graph

508 Commits

Author SHA1 Message Date
Michael Kerrisk 486fccf2e7 nologin.5: nologin must not only exist, but *be readable* to be effective
Reported-by: Tetsuo Handa <penguin-kernel@i-love.sakura.ne.jp>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-17 23:09:04 +12:00
Michael Kerrisk 7534ecb2ca nsswitch.conf.5: Minor fix-ups after comments from Mark Bannister
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-14 11:37:22 +12:00
Michael Kerrisk 9aa96150d0 nsswitch.conf.5: Light edits to Mark Bannister's changes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-14 11:37:22 +12:00
Mark R Bannister 79e2fba2d9 nsswitch.conf.5: Significant rewrites and improvements
This patch applies to nsswitch.conf.5 in man-pages-3.36.

My changes almost completely rewrite large sections of the
man page. They are needed to add clarity, correct grammar,
reduce confusion, and bring up-to-date with the latest glibc.
I have checked the man page against the nss source code in
glibc 2.14.90.

Historical notes are demoted to the footer.

The rewrite makes the man page much clearer to
understand, more authoratitive, and easier to read.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-14 11:37:22 +12:00
Akihiro MOTOKI a9d8228059 elf.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-24 11:59:07 +13:00
Michael Kerrisk 156f55f623 passwd.5: s/asterisk/asterisk (*)/ to improve clarity
Reported-by: Walter Haidinger <walter.haidinger@gmx.at>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-14 07:22:01 +13:00
Michael Kerrisk 98afd65767 resolv.conf.5: Describe syntax used for comments
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=656994

Reported-by: Slaven Rezic <srezic@iconmobile.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-08 07:29:23 +13:00
Michael Kerrisk c1b273fce8 passwd.5: Correct note on passwd field value when shadowing is enabled
When password shadowing is enabled, the password field
contains an 'x' (not a "8').

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-08 07:01:11 +13:00
Elie De Brauwer 78fc91ec1b proc.5: Fix description of fourth field of /proc/loadavg
SIgned-off-by: Elie De Brauwer <eliedebrauwer@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-02-08 06:21:20 +13:00
Michael Kerrisk d7e34031fb core.5: Document %E specifier for core_pattern
Reported-by: Junjiro Okajima <jro@mx3.ttcn.ne.jp>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-01-17 21:36:44 +13:00
Michael Kerrisk 2c4201f01a proc.5: srcfix: Added pointer to a commit
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-05 07:38:45 +02:00
Michael Kerrisk c409c4ffa3 Removed trailing white space at end of lines 2011-10-04 08:34:28 +02:00
Michael Kerrisk 41acdb62c9 Changes, setns.2, stat.2, proc.5, capabilities.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-04 08:32:21 +02:00
Michael Kerrisk 80e6365593 proc.5: Some edit's to Eric Biederman's /proc/[pid]/ns/ additions
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-03 08:36:41 +02:00
Eric W. Biederman b4a185e5cc proc.5: Document /proc/[pid]/ns/
Signed-off-by: Eric W. Biederman <ebiederm@xmission.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-03 08:36:41 +02:00
Michael Kerrisk 9948b994bc nsswitch.conf.5: wfix
Reported-by: Kevin Lyda <kevin@ie.suberic.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-03 07:55:37 +02:00
Michael Kerrisk 71d9e7ae77 gets.3, mbtowc.3, printf.3, puts.3, scanf.3, stpcpy.3, stpncpy.3, strcat.3, strlen.3, strnlen.3, strsep.3, strstr.3, strxfrm.3, utmp.5: Global fix: consistent use of "null byte"
Bring more consistency to the discussion of
"[terminating] null byte"
by writing (at least in the initial use in a page)
"[terminating] null byte ('\0')".

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-28 06:20:52 +02:00
Michael Kerrisk 836830b4c9 readlink.2, getsubopt.3, termcap.5, tzfile.5, unix.7: srcfix: change single quote to "\(aq"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-28 04:56:17 +02:00
Michael Kerrisk 4e83614439 clock_getres.2, clone.2, mbind.2, set_mempolicy.2, atan2.3, getipnodebyname.3, ilogb.3, lgamma.3, elf.5, capabilities.7, math_error.7: srcfix: Remove double space
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-27 05:17:10 +02:00
David Prévot fb30b09644 lseek.2, inet_pton.3, tzfile.5: tfix
Please find attach a consistency fix: there were only five
"zeroes" but twenty four "zeros" in those manual pages.
(Make all instances "zeros".)

Signed-off-by: David Prévot <taffit@debian.org>
2011-09-23 07:02:06 +02:00
Michael Kerrisk f81c6cc693 fcntl.2, recv.2, crypt.3, err.3, strtoul.3, proc.5: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:02:06 +02:00
Simon Paillard c3074d7061 fallocate.2, kexec_load.2, poll.2, spu_run.2, atan2.3, cbrt.3, clock_getcpuclockid.3, end.3, frexp.3, getgrouplist.3, getifaddrs.3, matherr.3, modf.3, pow.3, pthread_getattr_np.3, pthread_getcpuclockid.3, sched_getcpu.3, tgamma.3, mouse.4, proc.5, feature_test_macros.7, spufs.7: Global fix: properly escape minus sign
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:48 +02:00
Michael Kerrisk 6ee625ebd6 proc.5: Add description of 'SigQ' field of /proc/PID/status
Reported-by: Stan Sieler <sieler@me.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:46 +02:00
Michael Kerrisk a1bc91d55e proc.5: Add description of 'PPid' field of /proc/PID/status
Reported-by: Stan Sieler <sieler@me.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:46 +02:00
Michael Kerrisk e9b7792542 core.5: Change single quote to double quote in shell session example
The example section has a sample shell session containing:

But $PWD won't be expanded in single quotes. It should be double
quotes around the entire argument or some other form.

Reported-by: Roger Pate <roger@qxxy.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-15 07:19:26 +01:00
A. Costa 37a2356720 proc.5: spfix
See  http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=603134

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-15 07:02:06 +01:00
Michael Kerrisk 3e5c319e24 clock_nanosleep.2, getpriority.2, kexec_load.2, nanosleep.2, nice.2, sched_setaffinity.2, timer_create.2, timer_delete.2, timer_settime.2, utime.2, btowc.3, futimes.3, log.3, pthread_attr_setguardsize.3, pthread_kill_other_threads_np.3, pthread_setaffinity_np.3, pthread_setcancelstate.3, pthread_setschedparam.3, pthread_setschedprio.3, pthread_tryjoin_np.3, strcoll.3, strcpy.3, string.3, strxfrm.3, networks.5, aio.7, sigevent.7, udplite.7: SEE ALSO: Place entries in correct order
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-11-01 06:35:42 +01:00
David Prevot eebc6bfc7f hosts.5, protocols.5, spufs.7, termio.7: Remove definite article from NAME section
Please find inline another tiny patch in order to shrink
the definite article from some other pages (found with
"rgrep -i ' \\\- the' man*").

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-30 07:38:50 +02:00
Michael Kerrisk fde39195fa proc.5: Add reference to mlock(2) for further info on /proc/PID/status VmLck
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-30 07:33:57 +02:00
Michael Kerrisk df0c9b98a7 passwd.5: Various minor rewordings
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-21 11:43:32 +02:00
Michael Kerrisk 91567885b5 group.5: Various minor rewordings
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-21 11:43:32 +02:00
Michael Kerrisk 056247673c group.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-21 10:51:39 +02:00
Michael Kerrisk f03743fde2 passwd.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-21 10:50:45 +02:00
Michael Kerrisk b218b02329 open.2, poll.2, select_tut.2, getpt.3, openpty.3, posix_openpt.3, ptsname.3, unlockpt.3, pts.4, tty_ioctl.4, proc.5, pty.7: spfix: s/psuedoterminal/psuedoterminal/g
Reported-by: Denis Barbier <bouzim@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-13 05:32:15 +02:00
Michael Kerrisk 662b2137e8 open.2, poll.2, select_tut.2, getpt.3, grantpt.3, openpty.3, posix_openpt.3, ptsname.3, unlockpt.3, pts.4, tty_ioctl.4, proc.5, pty.7: Global fix: s/pseudo-terminal/pseudoterminal/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-12 06:51:51 +02:00
Michael Kerrisk fef0efe40b ttytype.5: wfix (s/Unixes/UNIX systems/)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-12 06:49:35 +02:00
Michael Kerrisk 008f1ecc43 intro.1, time.1, accept.2, bind.2, connect.2, execve.2, flock.2, getdents.2, getpriority.2, getuid.2, intro.2, ioctl.2, mincore.2, mknod.2, personality.2, ptrace.2, read.2, recv.2, select_tut.2, send.2, sendfile.2, shmctl.2, sigaction.2, signal.2, stat.2, times.2, truncate.2, umask.2, wait.2, MB_CUR_MAX.3, MB_LEN_MAX.3, argz_add.3, btowc.3, clearenv.3, clock.3, cmsg.3, end.3, endian.3, errno.3, exit.3, fgetwc.3, fgetws.3, fopen.3, fputwc.3, fputws.3, fseek.3, fwide.3, getfsent.3, getgrnam.3, gethostid.3, getipnodebyname.3, getmntent.3, getpwnam.3, getwchar.3, grantpt.3, iconv.3, iconv_close.3, iconv_open.3, insque.3, intro.3, iswalnum.3, iswalpha.3, iswblank.3, iswcntrl.3, iswctype.3, iswdigit.3, iswgraph.3, iswlower.3, iswprint.3, iswpunct.3, iswspace.3, iswupper.3, iswxdigit.3, malloc.3, mblen.3, mbrlen.3, mbrtowc.3, mbsinit.3, mbsnrtowcs.3, mbsrtowcs.3, mbstowcs.3, mbtowc.3, mkstemp.3, mktemp.3, nl_langinfo.3, openpty.3, posix_openpt.3, printf.3, ptsname.3, putwchar.3, qecvt.3, rcmd.3, readdir.3, rexec.3, rpc.3, setnetgrent.3, shm_open.3, sigpause.3, stdin.3, stpcpy.3, strftime.3, strptime.3, syslog.3, towctrans.3, towlower.3, towupper.3, ttyslot.3, ungetwc.3, unlocked_stdio.3, wcpcpy.3, wcpncpy.3, wcrtomb.3, wcscasecmp.3, wcscat.3, wcschr.3, wcscmp.3, wcscpy.3, wcscspn.3, wcsdup.3, wcslen.3, wcsncasecmp.3, wcsncat.3, wcsncmp.3, wcsncpy.3, wcsnlen.3, wcsnrtombs.3, wcspbrk.3, wcsrchr.3, wcsrtombs.3, wcsspn.3, wcsstr.3, wcstok.3, wcstombs.3, wcswidth.3, wctob.3, wctomb.3, wctrans.3, wctype.3, wcwidth.3, wmemchr.3, wmemcmp.3, wmemcpy.3, wmemmove.3, wmemset.3, wprintf.3, console_ioctl.4, pts.4, elf.5, filesystems.5, hosts.5, proc.5, ttytype.5, boot.7, capabilities.7, credentials.7, epoll.7, glob.7, koi8-r.7, path_resolution.7, pty.7, signal.7, suffixes.7, time.7, unicode.7, unix.7, uri.7, utf-8.7: global fix: s/Unix/UNIX/
The man pages were rather inconsistent in the use of "Unix"
versus "UNIX". Let's go with the trademark usage.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-12 06:49:17 +02:00
Michael Kerrisk 5fab2e7c9c Changes.old, clone.2, execve.2, fcntl.2, futex.2, getitimer.2, getpriority.2, mmap.2, mount.2, mprotect.2, sched_setscheduler.2, select_tut.2, setuid.2, sigaltstack.2, vfork.2, div.3, fenv.3, fmod.3, memchr.3, pthread_attr_setstackaddr.3, pthread_attr_setstacksize.3, pthread_getattr_np.3, queue.3, scanf.3, trunc.3, st.4, proc.5, services.5, utmp.5, bootparam.7, capabilities.7, feature_test_macros.7, futex.7, glob.7, man.7, netlink.7, unicode.7: Switch to American usage: "-wards" ==> "-ward"
American English uses "afterward" in preference to "afterwards",
and so on

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-26 07:34:47 +02:00
Michael Kerrisk 64fb5aedb0 tzfile.5: Add information on version 2 format timezone files
Updated using information from the tzcode 2010l release at
ftp://elsie.nci.nih.gov/pub.
(It's an open question whether or not a version of tzfile.5
should live independently in man-pages. It was added to the
man-pages set many years ago. For now, I'll follow a
conservative course that causes least pain to downstream,
by continuing to maintain a separate copy in man-pages.)

See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=594219

Reported-by: Yitzchak Gale <gale@sefer.org>
Signed-off-by: Michael Kerrisk <mtk@konstanz.(none)>
2010-08-31 07:58:38 +02:00
Michael Kerrisk 825e3c0f07 termcap.5: Minor fix: clarify "null character"
Signed-off-by: Michael Kerrisk <mtk@konstanz.(none)>
2010-08-29 08:59:05 +02:00
Michael Kerrisk 6596d27062 proc.5: Minor wording fix
Signed-off-by: Michael Kerrisk <mtk@konstanz.(none)>
2010-08-29 08:55:29 +02:00
Michael Kerrisk b911dcb076 Removed trailing white space at end of lines 2010-06-20 06:43:23 +02:00
Daisuke HATAYAMA 6866d935b3 elf.5: Document PN_XNUM extension
In linux-2.6.34-rc1, an ELF core extension was added; user-land tools
manipulating ELF core dump such as gdb and binutils has already been
modified before; so elf.5 needs to be modified accordingly.

You can follow information on the ELF extension via the LKML post:
http://lkml.org/lkml/2010/1/3/103
Date	Mon, 04 Jan 2010 10:06:07 +0900 (JST)
Subject	[RESEND][mmotm][PATCH v2, 0/5] elf coredump: Add extended numbering support

This Linux-specific extension was added in kernel 2.6.34.

Reviewed-by: Petr Baudis <pasky@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-06-19 13:10:51 +02:00
Michael Kerrisk eed79eed5b elf.5: Remove words under '.note': "described below"
The existing text is broken, because there is
no '"Note Section" format' describe below. Simplest
solution is to remove the words "described below".

Reported-by: Yuri Kozlov <yuray@komyakino.ru>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-06-19 13:10:51 +02:00
Yuri Kozlov 888e004861 elf.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-06-19 13:10:51 +02:00
Michael Kerrisk b520dffcc6 elf.5: Remove EI_BRAND
As reported by Yuri Kozlov  and confirmed by Mike Frysinger, EI_BRAND is
not in GABI (http://www.sco.com/developers/gabi/latest/ch4.eheader.html)
It looks to be a BSDism

Reported-by: Yuri Kozlov <yuray@komyakino.ru>
Reported-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-06-19 13:10:51 +02:00
Michael Kerrisk b2d3abb847 proc.5: Improve description of /proc/sys/fs/pipe-max-size
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-06-19 04:40:23 +02:00
Michael Kerrisk 7191605652 proc.5: Document /proc/sys/fs/pipe-max-size
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-06-17 00:31:58 +02:00
Michael Kerrisk 49236d3c71 proc.5: Simplify description of /proc/sys and /proc/sys/fs
In the description of these directories, there's no need
to list all the files and subdirectories that they contain;
that information is provided by the entries that follow.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-06-17 00:23:56 +02:00
Michael Kerrisk c7fb034b88 proc.5: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-06-12 13:37:20 +02:00