Commit Graph

8456 Commits

Author SHA1 Message Date
Michael Kerrisk c634028ab5 intro.1, time.1, _syscall.2, accept.2, brk.2, capget.2, faccessat.2, futimesat.2, gethostname.2, intro.2, ioprio_set.2, kill.2, madvise.2, mlock.2, mount.2, msgget.2, perf_event_open.2, poll.2, readv.2, sched_rr_get_interval.2, sched_setscheduler.2, select.2, select_tut.2, shmget.2, stat.2, timer_create.2, ustat.2, vfork.2, wait.2, alloca.3, atexit.3, catopen.3, crypt.3, dbopen.3, fenv.3, fopen.3, getaddrinfo_a.3, gethostbyname.3, getutent.3, intro.3, login.3, mallopt.3, queue.3, regex.3, sigpause.3, sigsetops.3, stdio.3, strftime.3, strptime.3, sysconf.3, ttyslot.3, undocumented.3, cciss.4, console_codes.4, hpsa.4, initrd.4, intro.4, rtc.4, st.4, tty_ioctl.4, wavelan.4, acct.5, charmap.5, dir_colors.5, hosts.5, intro.5, termcap.5, utmp.5, intro.6, armscii-8.7, boot.7, bootparam.7, capabilities.7, cpuset.7, credentials.7, ddp.7, epoll.7, glob.7, intro.7, ip.7, ipv6.7, iso_8859-1.7, iso_8859-10.7, iso_8859-11.7, iso_8859-13.7, iso_8859-14.7, iso_8859-15.7, iso_8859-16.7, iso_8859-2.7, iso_8859-3.7, iso_8859-4.7, iso_8859-5.7, iso_8859-6.7, iso_8859-7.7, iso_8859-8.7, iso_8859-9.7, koi8-r.7, koi8-u.7, man-pages.7, man.7, math_error.7, netlink.7, numa.7, packet.7, path_resolution.7, pipe.7, pthreads.7, raw.7, rtnetlink.7, signal.7, socket.7, spufs.7, svipc.7, tcp.7, time.7, udp.7, udplite.7, unicode.7, unix.7, uri.7, utf-8.7, x25.7, intro.8: Global fix: use consistent capitalization in .SS headings
Capitalization in .SS sections across pages (and sometimes even
within a single page) is wildly inconsistent. Make it consistent.
Capitalize first word in heading, but otherwise use lower case,
except where English usage (e.g., proper nouns) or programming
language requirements (e.g., identifier names) dictate otherwise.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-24 15:08:38 +01:00
Denys Vlasenko 40d0af61c4 ptrace.2: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-18 18:57:12 +01:00
Michael Kerrisk 2a243c9e6a inotify.7, rtld-audit.7: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-18 18:56:07 +01:00
Michael Kerrisk 6f5ce08575 scanf.3, aio.7: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-18 18:53:39 +01:00
Michael Kerrisk 6a86fae5bd sched_setscheduler.2, mallinfo.3, pthread_setname_np.3, nss.5, boot.7, numa.7, udplite.7: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-18 18:50:48 +01:00
Michael Kerrisk 6b4dbb25e9 delete_module.2, epoll_create.2, getpeername.2, getpriority.2, getrlimit.2, getunwind.2, init_module.2, kcmp.2, mmap.2, perf_event_open.2, perfmonctl.2, prctl.2, s390_runtime_instr.2, timerfd_create.2, vfork.2, getaddrinfo_a.3, getenv.3, if_nameindex.3, if_nametoindex.3, mcheck.3, pthread_setname_np.3, scanf.3, cciss.4, hpsa.4, core.5, gai.conf.5, networks.5, nscd.conf.5, nss.5, aio.7, arp.7, numa.7, socket.7, udplite.7: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-18 18:45:32 +01:00
Michael Kerrisk 7aa48d58c5 man-pages.7: Minor rewording in DESCRIPTION
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-18 16:05:06 +01:00
Michael Kerrisk a6e088090b rtld-audit.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-18 15:52:12 +01:00
Michael Kerrisk 366ffff433 nss.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-18 13:06:38 +01:00
Michael Kerrisk 86270a28cc gai.conf.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-18 13:05:52 +01:00
Michael Kerrisk 191a77d46e accept.2: NAME: Add "accept4"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-18 12:58:37 +01:00
Michael Kerrisk 42a6569e35 malloc_info.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-18 12:54:15 +01:00
Michael Kerrisk 159cdf0a62 if_nameindex.3: Minor fix: Remove redundant SEE ALSO entry
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-18 12:52:57 +01:00
Michael Kerrisk 27a6247be3 getnameinfo.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-18 12:31:52 +01:00
Michael Kerrisk 0e40804cd8 open.2: Clarify list of file creation flags
POSIX.1-2008 TC1 clarified this, so that O_CLOEXEC,
O_DIRECTORY, and O_NOFOLLOW are also in this list.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-18 09:10:08 +01:00
Michael Kerrisk 1bb72c9605 open.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-18 09:10:07 +01:00
Michael Kerrisk 94b8263d15 rtc.4: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-18 15:22:07 +01:00
Michael Kerrisk e157849173 fflush.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-18 15:21:14 +01:00
Michael Kerrisk 9824735b35 fclose.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-18 15:21:09 +01:00
Michael Kerrisk bce0482fee open.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-18 15:18:52 +01:00
Michael Kerrisk 26f24c264f Changes.old: Minor fixes to 3.47 changelog
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-16 09:27:56 +01:00
Michael Kerrisk c1c1f8a399 Changes.old: Properly attribute Vince Weaver for 3.47 changelog
I misapplied Vince's patch, so that his name was not recorded
as the author in the git log. We can at least fix it in the
manual changelog.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-16 09:23:10 +01:00
Michael Kerrisk 7c81ac9ced read.2: Remove crufty text about O_NONBLOCK on files
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=700529

Reported-by: Marc Lehmann <debian-reportbug@plan9.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-14 02:13:20 +01:00
Michael Kerrisk b0a6a72e8d ip.7: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-14 01:24:47 +01:00
Michael Kerrisk 5eab557e9f exit.3: Note that a call to execve() clears exit handler registrations
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-13 21:27:05 +01:00
Michael Kerrisk 4a38498543 getrpcent.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-13 00:15:00 +01:00
Michael Kerrisk ad46346175 perfmonctl.2: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-12 23:09:38 +01:00
Michael Kerrisk f2b29ffec5 perfmonctl.2: Briefly document PFM_GET_FEATURES, PFM_DEBUG, PFM_GET_PMC_RESET_VAL
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-12 23:09:38 +01:00
Michael Kerrisk 88a657084c perfmonctl.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-12 23:09:38 +01:00
Michael Kerrisk 3dfb8d01cd perfmonctl.2: Minor reorganization
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-12 23:09:38 +01:00
Michael Kerrisk 0609db2aa2 perfmonctl.2: Rework discussion of PFM_CREATE_CONTEXT
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-12 23:09:38 +01:00
Michael Kerrisk f25e7c8ecc perfmonctl.2: Fix argument types for PFM_WRITE_PMCS, PFM_WRITE_PMDS, PFM_READ_PMDS
The types that were being used don't exist!

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-12 23:09:32 +01:00
Michael Kerrisk 65d669f4b0 perfmonctl.2: Minor rewording in RETURN VALUE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-12 23:09:30 +01:00
Michael Kerrisk 439335f701 perfmonctl.2: Note that there is no glibc wrapper
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-12 23:09:30 +01:00
Michael Kerrisk 39e10583d8 perfmonctl.2: Add VERSIONS and CONFORMING TO
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-12 23:09:30 +01:00
Michael Kerrisk 06a2b63182 perfmonctl.2: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-12 23:09:30 +01:00
Michael Kerrisk 734fd1f2ab perfmonctl.2: Remove PFM_CREATE_EVTSETS, PFM_DELETE_EVTSETS, PFM_GETINFO_EVTSETS
These don't exist, and it appears they never have.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-12 23:09:30 +01:00
Michael Kerrisk 3c7e310c16 perfmonctl.2: Various minor fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-12 23:09:30 +01:00
Ivana Varekova 55b9301b8f perfmonctl.2: New page documenting IA-64-specific perfmonctl(2)
Taken from Red Hat downstream man pages

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-12 23:09:30 +01:00
Michael Kerrisk b887a9d250 nss.5: Minor fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-12 23:09:30 +01:00
Ulrich Drepper f387a2942a nss.conf.5: New page describing nss.conf
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-12 23:09:29 +01:00
Michael Kerrisk fe828902eb getunwind.2: Much rewriting
Some text taken from arch/ia64/kernel/unwind.c.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-12 23:09:29 +01:00
Marcela Maslanova 4288c61864 getunwind.2: New page documenting getunwind(2)
Taken from Red Hat downstream man pages set

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-12 23:09:13 +01:00
Michael Kerrisk 625526ef06 getaddrinfo.3: SEE ALSO: Add gai.conf(5)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-12 23:00:10 +01:00
Michael Kerrisk 5f86385e27 gai.conf.5: Minor fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-12 23:00:10 +01:00
Ulrich Drepper d97d06f750 gai.conf.5: New page documenting gai.conf
Taken from Red Hat downstream pages

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-12 23:00:10 +01:00
Michael Kerrisk c534b25d95 ip.7: Minor fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-12 22:50:57 +01:00
Flavio Leitner 0a03fceb09 ip.7: Improve explanation about calling listen() or connect()
Problem:
When connect(2) is executed, the local port number may duplicate.

How reproducible:
When using parameter "net.ipv4.ip_local_port_range", a client may use
the same port to connect to the different sessions on the localhost.

Steps to Reproduce:
1.Change "net.ipv4.ip_local_port_range".
  [Example]
  net.ipv4.ip_local_port_range = 32768 32770

2.Connect to any two ports of LISTEN by telnet command.
  [Example]
  # netstat -antp | grep LISTEN
  tcp        0      0 0.0.0.0:139                 0.0.0.0:*                   LISTEN      2828/smbd
  tcp        0      0 0.0.0.0:21                  0.0.0.0:*                   LISTEN      2800/vsftpd
  #
  # telnet 127.0.0.1 139
  # telnet 127.0.0.1 21
  # telnet 127.0.0.1 21

3.Duplication of a local transmission port.
  [Example]
  # netstat -antp
  tcp        0      0 127.0.0.1:32769      127.0.0.1:139      ESTABLISHED 18147/telnet
  tcp        0      0 127.0.0.1:32769      127.0.0.1:21       ESTABLISHED 18157/telnet

Actual results:
The local port number may duplicate.

Expected results:
The local port number doesn't duplicate.

Additional info:
[Investigation]
"man 7 ip" contains following text:
-----------------------------------------------------------------
When listen(2) or connect(2) are called on an unbound socket, it
is automatically bound to a random  free  port  with the local
address set to INADDR_ANY.
-----------------------------------------------------------------

Although indicated as "it is automatically bound to a random free
port", the port number which is not free like in a reproduce
procedure may be bound.  Therefore, based on the description of
this "man 7 ip", it can be judged that it is bug to use the local
port where the process duplicated.

--- Comment by Leitner, Flavio on 2/7/2012 2:55 PM ---

It's allowed to have multiple tasks using the same port (as a
result of calling connect(2)) as long as the other connection
information (4-tuple) differs to resolve the conflict.  Thus,
it must be an unique 4-tuple consisting of source and
destination IP addresses and port numbers to not conflict.

In the example, the dest port is different.
          tcp        0      0 127.0.0.1:32769      127.0.0.1:139      ESTABLISHED 18147/telnet
          tcp        0      0 127.0.0.1:32769      127.0.0.1:21       ESTABLISHED 18157/telnet

Reported-by: Peter Schiffer <pschiffe@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-12 22:50:57 +01:00
Michael Kerrisk 5ab77f3dab read.2: Clarify interaction of count==0 and error checking
POSIX deliberately leaves this case open, so the man
page should be less specific about what happens.

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

Reported-by: Zack Weinberg <zackw@panix.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-12 22:50:51 +01:00
Michael Kerrisk dc0e450b3e read.2: Clarify details for seekable files
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-12 22:25:08 +01:00