Commit Graph

1077 Commits

Author SHA1 Message Date
Michael Kerrisk d91ca9d3b7 fifo.7: minor: note that "ls -l" indicates FIFOs with the file type 'p'
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:29:00 -05:00
Michael Kerrisk c4e7b71426 getpeername.2, getsockname.2, getsockopt.2, recv.2, send.2, shutdown.2, sockatmark.3, socket.7, udplite.7: SYNOPSIS: Rename socket file descriptor argument to 'sockfd'
Many sockets man pages use the name 'sockfd' already.
For consistency, changes the others to do so as well.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:56 -05:00
Michael Kerrisk 77e75b9077 unix.7: Unix domain sockets don't support the recv() MSG_TRUNC flag
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:44 -05:00
Michael Kerrisk 238534b031 tcp.7: Document MSG_TRUNC flag for TCP sockets
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:18:09 -05:00
Michael Kerrisk c24995b98f socket.7: SEE ALSO: add tcp(7) and udp(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:18:09 -05:00
Michael Kerrisk 89c9c9537b udp.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:18:08 -05:00
Michael Kerrisk 19e19f5f8a unix.7: Retitled subsection "(Un)supported features" to "Sockets API"
This is consistent with the recent change in tcp(7).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:18:08 -05:00
Michael Kerrisk de092003b7 tcp.7: Note that MSG_PEEK can be used on out-of-band data
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:18:08 -05:00
Michael Kerrisk d888f6a3a6 tcp.7: Relocate out-of-band data discussion
Move to a new subsection entitled "Sockets API".

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:18:08 -05:00
Michael Kerrisk 1bc510f506 unix.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:18:08 -05:00
Drake Wilson f169a862d2 capabilities.7: Various minor fixes as per Debian bug 471029
The relevant pieces of
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=471029 are:

  - Delete duplicate subentry for KEYCTL_CHOWN/KEYCTL_SETPERM
    operations in the CAP_SYS_ADMIN entry.  (It feels like that
    capability entry should be converted to a list, but I've left it
    in semicolon-delimited form for now.)

  - Remove text about ENFILE from the text about the
    /proc/sys/fs/file-max limit in the CAP_SYS_ADMIN entry, since
    this is already described in the man pages for the relevant
    ofile-creating system calls.

  - Correct or clarify a few other bits of grammar and such; see the
    diff file itself for details.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-28 09:57:56 -05:00
Michael Kerrisk a113945faa Removed trailing white space at end of lines 2008-11-25 21:44:53 -05:00
Michael Kerrisk acae032272 ipv6.7: minor: wording and grammar fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:29 -05:00
Michael Kerrisk f08b799c9c ipv6.7: ffix 2008-11-25 20:54:28 -05:00
Michael Kerrisk f35067be23 arp.7: spfix 2008-11-25 20:54:28 -05:00
Michael Kerrisk 32fb5652a9 arp.7: Document /proc file retrans_time_ms (new in Linux 2.6.12)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:28 -05:00
Michael Kerrisk 5adbf2d415 arp.7: Document /proc file base_reachable_time_ms (new in Linux 2.6.12)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:28 -05:00
Michael Kerrisk 665baea53a arp.7: Add kernel version numbers for /proc interfaces
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:28 -05:00
Michael Kerrisk 35300c3d15 icmp.7: minor: Fix kernel version number for /proc files
s/2.4.10/2.4.9/

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:27 -05:00
Michael Kerrisk 707420475b icmp.7: Document icmp_ignore_bogus_error_responses (new in Linux 2.2)
Text taken from Documentation/networking/ip-sysctl.txt

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:25 -05:00
Michael Kerrisk f5d246e18e icmp.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:25 -05:00
Michael Kerrisk 7f5a74f7a1 icmp.7: Document icmp_echo_ignore_broadcasts (new in Linux 2.6.12)
Text taken from Documentation/networking/ip-sysctl.txt

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:25 -05:00
Michael Kerrisk ed64be7664 icmp.7: ffix 2008-11-25 20:54:24 -05:00
Michael Kerrisk 730f3ab294 icmp.7: Document icmp_ratelimit and icmp_ratemask (new in Linux 2.4.10)
Text taken from Documentation/networking/ip-sysctl.txt

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:24 -05:00
Michael Kerrisk 920a509fdf icmp.7: Add kernel version numbers to /proc file descriptions
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:24 -05:00
Michael Kerrisk 7aaa4c67a5 pthreads.7: srcfix: added FIXME 2008-11-25 20:54:24 -05:00
Michael Kerrisk 88a800a6a8 ip.7: Relocate info about Linux-specific sockopts to NOTES
Also add some source comments about non-standard Linux-specific
options that are not yet documented.
2008-11-25 20:54:23 -05:00
Michael Kerrisk 42d663bb2c ip.7: Remove mention of kernel header from description of IP_RECVERR
Looks like glibc has had this definition since about version 2.1.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:23 -05:00
Michael Kerrisk e77995bdf5 ip.7: srcfix: updated FIXME 2008-11-25 20:54:23 -05:00
Michael Kerrisk 4ebab2e6dd ip.7: srcfix: Add/update FIXMEs for undocumented IP_* socket options
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:23 -05:00
Michael Kerrisk 554805f99b ip.7: Relocate kernel version information for ip_mreqn structure
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:23 -05:00
Michael Kerrisk 161aba8d31 ip.7: Relocate kernel version information for IP_PMTUDISC_PROBE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:22 -05:00
Michael Kerrisk 02f6363733 ip.7: Added kernel version numbers for IP_* socket options
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:22 -05:00
Michael Kerrisk 21ba63ee0e ip.7: Add kernel version numbers for /proc/sys/net/ipv4/ip_* files
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:22 -05:00
Michael Kerrisk 7cd1cc4a53 ip.7: Reorder socket options alphabetically
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:22 -05:00
Michael Kerrisk 119a1824d4 ip.7: srcfix: join short source lines
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:22 -05:00
Michael Kerrisk b5b5f08b4d ip.7: wfix 2008-11-25 20:54:21 -05:00
Michael Kerrisk 28ae1c901c ip.7: grfix 2008-11-25 20:54:21 -05:00
Michael Kerrisk 7af3794fda ip.7: wfix 2008-11-25 20:54:21 -05:00
Michael Kerrisk f971627f8a ip.7: grfix 2008-11-25 20:54:21 -05:00
Michael Kerrisk 39a165e08f ip.7: ffix 2008-11-25 20:54:21 -05:00
Michael Kerrisk caf5129c82 arp.7: grfix 2008-11-25 20:54:20 -05:00
Michael Kerrisk fc59cb811b raw.7: grfix 2008-11-25 20:54:20 -05:00
Michael Kerrisk 2a4ed4153d tcp.7: srcfix: updated comment in changelog 2008-11-25 20:54:20 -05:00
Michael Kerrisk 95e6bcfc3b tcp.7: ffix 2008-11-25 20:54:20 -05:00
Michael Kerrisk 418d8232f0 udp.7: Document /proc files udp_mem, udp_rmem_min, and udp_wmem_min
All of these are new in Linux 2.6.25

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:20 -05:00
Michael Kerrisk fe10db363b udp.7: grfix 2008-11-25 20:54:19 -05:00
Michael Kerrisk 93de498adc udp.7: grfix 2008-11-25 20:54:19 -05:00
Michael Kerrisk dbf6263de2 udp.7: ffix 2008-11-25 20:54:19 -05:00
Michael Kerrisk 963ca80f68 udp.7: srcfix: Updated FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:19 -05:00
Michael Kerrisk 5b91ca2520 tcp.7: srcfix: Source code comment to indicate page is updated for 2.6.27
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:19 -05:00
Michael Kerrisk 8c6515a324 tcp.7: srcfix: remove out-of-date FIXME 2008-11-25 20:54:18 -05:00
Michael Kerrisk 9defcb669e tcp.7: Clarify that tcp_mem measures in units of the system page size
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:18 -05:00
Michael Kerrisk ec3f42253b tcp.7: Update description of tcp_wmem defaults for Linux 2.6
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:18 -05:00
Michael Kerrisk 4bd48784d9 tcp.7: wfix 2008-11-25 20:54:18 -05:00
Michael Kerrisk 48a2a0bf5b tcp.7: Update description of tcp_rmem defaults for Linux 2.6
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:18 -05:00
Michael Kerrisk 412a6fd924 tcp.7: srcfix: Join short source lines into single lines
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:18 -05:00
Michael Kerrisk a93868fd3b tcp.7: Update tcp_frto description for 2.6.22 changes
Linux 2.6.22 added a mode value 2 ("Enable SACK-enhanced
F-RTO if flow uses SACK").

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:17 -05:00
Michael Kerrisk c833891e41 tcp.7: Fix alphabetical order in /proc file list
A few entries were slightly out of order.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:17 -05:00
Michael Kerrisk 867ccae351 tcp.7: tcp_vegas_cong_avoid disappeared in Linux 2.6.13
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:17 -05:00
Michael Kerrisk e965b1ce24 tcp.7: tcp_westwood /proc file disappeared in Linux 2.6.13
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:17 -05:00
Michael Kerrisk eb90a877e9 tcp.7: srcfix: removed some redundant source comments 2008-11-25 20:54:16 -05:00
Michael Kerrisk 6cb9682d8e tcp.7: The tcp_bic* proc files disappeared in Linux 2.6.13
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:16 -05:00
Michael Kerrisk feb3713a80 tcp.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:16 -05:00
Michael Kerrisk d4bf0241f4 tcp.7: Document /proc file tcp_tso_win_divisor (new in Linux 2.6.9)
Text taken from Documentation/networking/ip-sysctl.txt

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:16 -05:00
Michael Kerrisk 6a48d4b1d3 tcp.7: Document /proc file tcp_dma_copybreak (new in Linux 2.6.24)
Text taken from Documentation/networking/ip-sysctl.txt

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:16 -05:00
Michael Kerrisk e604d9fabb tcp.7: Document /proc file tcp_workaround_signed_windows (new in Linux 2.6.26)
Text taken from Documentation/networking/ip-sysctl.txt

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:16 -05:00
Michael Kerrisk 4b1ab5b30f tcp.7: Document /proc file tcp_frto_response (new in Linux 2.6.22)
Text taken from Documentation/networking/ip-sysctl.txt

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:15 -05:00
Michael Kerrisk ccaf91b50b tcp.7: Add kernel version numbers for each /proc interface
Note kernel version where each /proc interface first appeared

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:15 -05:00
Michael Kerrisk cac74e26a1 tcp.7: Remove obsolete statement about /proc from VERSIONS
Much of the text has been updated to 2.6.27 or so,
so this statement no longer applies.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:15 -05:00
Michael Kerrisk 95a6e137c8 tcp.7: Remove mention of /proc in VERSIONS
This information is not indicated for each /proc interface

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:15 -05:00
Michael Kerrisk 3838a9ed42 tcp.7: srcfix: updated FIXME 2008-11-25 20:54:15 -05:00
Michael Kerrisk 20e770a003 tcp.7: ffix 2008-11-25 20:54:14 -05:00
Michael Kerrisk f064eb89cf tcp.7: Document /proc file tcp_available_congestion_control (new in Linux 2.4.20)
Text taken from Documentation/networking/ip-sysctl.txt

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:14 -05:00
Michael Kerrisk d6d5865622 tcp.7: Document /proc file tcp_allowed_congestion_control (new in Linux 2.4.20)
Text taken from Documentation/networking/ip-sysctl.txt

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:14 -05:00
Michael Kerrisk e0190be611 tcp.7: srcfix: update FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:14 -05:00
Michael Kerrisk 59a1005a1b tcp.7: srcfix: update FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:14 -05:00
Michael Kerrisk 527abe77fe tcp.7: Add kernel version numbers for TCP_* socket options
Note kernel version were each socket option first appeared.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:14 -05:00
Michael Kerrisk 9c39fcfcc7 tcp.7: srcfix: Added FIXME: document TCP_MD5SIG
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:13 -05:00
Michael Kerrisk 6a7b04aa93 tcp.7: srcfix: remove out-of-date FIXMEs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:13 -05:00
Michael Kerrisk 92f58f2e21 tcp.7: Add mention of RFC 4138 for 'tcp_frto' /proc file
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:13 -05:00
Michael Kerrisk 976cad9d7d tcp.7: Document /proc file tcp_congestion_control (new in Linux 2.4.13)
Text taken from Documentation/networking/ip-sysctl.txt

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:13 -05:00
Michael Kerrisk 63f8799fc9 tcp.7: Clarify that RTO == Retransmission Timeout
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:13 -05:00
Michael Kerrisk 650d7ce060 tcp.7: Document /proc file tcp_mtu_probing (new in Linux 2.6.17)
Text taken from Documentation/networking/ip-sysctl.txt

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:12 -05:00
Michael Kerrisk 98eaadb06b tcp.7: Document /proc file tcp_no_metrics_save (new in Linux 2.6.6)
Text taken from Documentation/networking/ip-sysctl.txt

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:12 -05:00
Michael Kerrisk 8efc4ff594 tcp.7: wsfix 2008-11-25 20:54:12 -05:00
Michael Kerrisk 20233a76d6 tcp.7: Document /proc file tcp_slow_start_after_idle (new in Linux 2.6.18)
Text taken from Documentation/networking/ip-sysctl.txt

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:12 -05:00
Michael Kerrisk 77ec27dd68 tcp.7: Document /proc file tcp_moderate_rcvbuf (new in Linux 2.4.17/2.6.7)
Text taken from Documentation/networking/ip-sysctl.txt

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:11 -05:00
Michael Kerrisk f35985c0cc tcp.7: Document /proc file tcp_abc (new in Linux 2.6.15)
Text taken from Documentation/networking/ip-sysctl.txt

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:11 -05:00
Michael Kerrisk 407d2d3918 tcp.7: Document /proc file tcp_base_mss (new in Linux 2.6.17)
Text taken from Documentation/networking/ip-sysctl.txt

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:11 -05:00
Michael Kerrisk 5a2ff571fb connect.2, listen.2, send.2, uname.2, cmsg.3, proc.5, arp.7, ddp.7, icmp.7, ip.7, raw.7, socket.7, tcp.7, udp.7: Global fix: eliminate mention of the obsolete sysctl(2) interface
Many pages still mention use of the obsolete sysctl(2) system
call, or used the term "sysctls"; rewrite these mentions to
instead be in terms of /proc interfaces.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:11 -05:00
Michael Kerrisk cabf996a6b arp.7, ddp.7, icmp.7, ip.7, socket.7, tcp.7: ffix: Convert /proc file names from bold to italic
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=506335
Reported-by: Eugen Dedu <Eugen.Dedu@pu-pm.univ-fcomte.fr>
2008-11-25 20:54:10 -05:00
Michael Kerrisk 732e54dd96 clone.2, mount.2, unshare.2, proc.5, path_resolution.7: Global fix: s/mount-point namespace/mount namespace/
This is more consistent with the term "mounts namespace"
used in the 2008 ACM SIGOPS paper, "Virtual servers
and and checkpoint/restart in mainstream Linux".
(I avoided the "s", because using the plural strikes me
as klunky English, and anyway we don't talk about
the "PIDs namespace" or the "networks namespace", etc..)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:09 -05:00
Michael Kerrisk 6e6231c1dc inotify_rm_watch.2, inotify.7: srcfix: updated FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:09 -05:00
Michael Kerrisk 1d93bc5315 numa.7: tfix 2008-11-25 20:54:07 -05:00
Michael Kerrisk 4df2eb09d1 clone.2, mount.2, unshare.2, proc.5, path_resolution.7: Global fix: s/namespace/mount-point namespace/, as appropriate
In recent times, a number of other namespace flags have been
added to clone(2).  As such, it is no longer clear to use
the generic term "namespace" to refer to the particular
namespace controlled by CLONE_NEWNS; instead, use the
term "mount-point namespace".

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:07 -05:00
Michael Kerrisk 24bbe02c17 inotify_rm_watch.2, inotify.7: srcfix: Add FIXMEs for argument/field types
I submitted a patch to fix this.  See the LKML thread
"[patch] Fix type errors in inotify interfaces", 18 Nov 2008
If/when these patches are accepted, the pages need to be updated.
2008-11-25 20:54:04 -05:00
Vegard Nossum 31546b461b inotify.7: Fix description of max_user_watches
It seems that inotify(7) is wrong here:

"/proc/sys/fs/inotify/max_user_watches
    This specifies a limit on the number of watches that can be
    associated with each inotify instance."

On my system, the default value for this variable is 8192. But I
cannot create more than 8192 watches in total for the same UID
even when they are on different inotify instances. So I suggest
to rephrase this as: "This specifies an upper limit on the
number of watches that can be created per real user ID."

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:04 -05:00
Michael Kerrisk 8bfd40a95e pthreads.7: Add ref to signal(7) for further info on use of real-time signals
signal(7) provides some further details on the use of real-time
signals by the two Linux threading implementations.

Signed-off-by: Michael Kerrisk <michael.kerrisk@gmail.com>
2008-11-25 20:54:04 -05:00
Michael Kerrisk 1e68d71623 cpuset.7: SEE ALSO: add CPU_SET(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-13 08:56:56 -05:00
Michael Kerrisk d1d8780179 epoll.7: Note glibc version that added epoll support
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-11 21:22:58 -05:00
Vegard Nossum 6304255391 netlink.7: Fix incorrect variable names in example code
s/snl/sa/ * 2

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-11 14:54:06 -05:00
Michael Kerrisk 48011c24d7 netlink.7: wsfix 2008-11-11 14:54:06 -05:00
Michael Kerrisk bfc40b3d71 pthreads.7: SEE ALSO: add pthread_attr_init() and pthread_cancel() 2008-11-11 14:54:06 -05:00
Michael Kerrisk ac7bef3d3d pthreads.7: tstamp 2008-11-11 14:54:06 -05:00
Michael Kerrisk 447cd9e76e pthreads.7: Rework, and fix small error in, thread-safe function list
Integrate the changes that occurred in POSIX.1-2008 into the
main list (to be consistent with the list, elsewhere on this
page, of functions that are cancellation points).

Also, fix an error that said that strerror() was added to
the list in POSIX.1-2008.  It was strsignal() that was
added.  (strerror() was already in the list in POSIX.1-2001.)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-11 14:53:10 -05:00
Michael Kerrisk 7fd4e74c1c pthreads.7: Tweak text on sigpause() cancellation point
In POSIX.1-2009, this function moves from the "must be"
to the "may be" list.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-11 14:51:04 -05:00
Michael Kerrisk ffe8c4ae77 pthreads.7: Add section on cancellation points
This section includes a list of the functions that must and
may be cancellation points.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-10 12:00:51 -05:00
Michael Kerrisk ecdd9a10bb pthreads.7: spfix 2008-11-06 16:49:25 -05:00
Michael Kerrisk 84ee6c22e3 pthreads.7: Add a section describing thread IDs
In particular, note that in each pthreads function that takes
a thread ID argument, that ID by definition refers to a thread
in the same process as the caller.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-06 16:49:13 -05:00
Michael Kerrisk 40c75945ad epoll.7: Add error handling for epoll_wait() call in example code
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-04 10:59:13 -05:00
Michael Kerrisk 15277745c3 epoll.7: Fix error handling after accept() in example code
Simply continuing after an error is in most cases wrong,
and can lead to infinite loops (e.g., for EMFILE).
So handle an error by terminating.

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

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Olaf van der Spek <olafvdspek@gmail.com>
2008-11-04 10:58:58 -05:00
Michael Kerrisk 66132b5e47 epoll.7: Improve example code
Fill in some gaps in example code (variable declarations,
adding listening socket to epoll set).
Give variables more meaningful names.
Other minor changes.

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

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Olaf van der Spek <OlafvdSpek@gmail.com>
2008-11-01 14:30:05 -05:00
Lefteris Dimitroulakis 289bb92874 iso_8859-7.7: Add characters for Drachma and Greek Ypogegrammeni
Lines for these two characters were added in the previous patch,
but the actual characters were not included in the 4th column
of the table.  This fixes that.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-30 11:08:19 -05:00
Michael Kerrisk c5571b613b Removed trailing white space at end of lines 2008-10-29 15:43:44 -05:00
Michael Kerrisk 08c9b488f4 timerfd_create.2, ctime.3, frexp.3, strftime.3, strtok.3, tty_ioctl.4, iso_8859-7.7: tstamp 2008-10-29 15:36:12 -05:00
Lefteris Dimitroulakis ebc15016f1 iso_8859-7.7: Add Drachma, Euro, and Greek Ypogegrammeni
Also, amend description of characters 0241 and 0242.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:25 -05:00
Michael Kerrisk 6dd5c68a3d ip.7: Detail EINVAL error for IP_ADD_MEMBERSHIP socket option
In response to:
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=216092

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Christian Grigis <glove@earthling.net>
2008-10-29 14:54:25 -05:00
Michael Kerrisk b43a3b301e eventfd.2, execve.2, getdents.2, ioprio_set.2, mprotect.2, signalfd.2, timerfd_create.2, wait.2, backtrace.3, clock_getcpuclockid.3, end.3, fmemopen.3, fopencookie.3, frexp.3, getdate.3, getgrouplist.3, getprotoent_r.3, getservent_r.3, gnu_get_libc_version.3, inet.3, inet_pton.3, makecontext.3, malloc.3, matherr.3, offsetof.3, pthread_attr_init.3, pthread_create.3, pthread_getattr_np.3, sem_wait.3, strftime.3, strtok.3, strtol.3, core.5, proc.5, cpuset.7, mq_overview.7: Global fix: Format user input in shell sessions in boldface
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:23 -05:00
Michael Kerrisk 7e1d89c9b2 man-pages.7: spfix 2008-10-29 14:54:23 -05:00
Michael Kerrisk b8463199bb man-pages.7: Example shell sessions should have user input boldfaced
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:23 -05:00
Michael Kerrisk 0b8a445926 socket.7: SEE ALSO: add unix(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:13 -05:00
Michael Kerrisk 67db0c8390 pthreads.7: tstamp 2008-10-29 14:54:11 -05:00
Michael Kerrisk 63c22325ed pthreads.7: Describe return value from pthreads functions
Describe the usual success (0) and failure (non-zero) returns,
and note that POSIX.1-2001 specifies that pthreads functions
can never fail with the error EINTR.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:11 -05:00
Michael Kerrisk 4697f7a7ae signal.7: ffix 2008-10-29 14:54:10 -05:00
Michael Kerrisk 4f6d71a1fc signal.7: Timeouts make socket interfaces non-restartable
If setsockopt() is used to set a timeout on a socket(),
then the various socket interfaces are not automatically
restarted, even if SA_RESTART is specified when
establishing the signal handler.  Analogous behavior occurs
for the "stop signals" case.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Didier <did447@gmail.com>
2008-10-29 14:54:10 -05:00
Michael Kerrisk 9d0f3fcb0d epoll.7: Mention epoll_create1() as part of epoll API
epoll_create1() was added in Linux 2.6.27, and extends the
functionality of epoll_create().

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-11 07:49:40 +02:00
Michael Kerrisk 43bb5fafb5 inotify.7: Mention inotify_init1() in overview of API
Discuss the new inotify_init1() system call in the overview of
the inotify API.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-11 07:49:38 +02:00
Michael Kerrisk 2411effea2 signal.7: improve description in NAME section
Reported-by: Gergely Soos <sogerc1@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-06 10:12:00 +02:00
Michael Kerrisk eeccef1df0 signal.7: Add mention of sigaltstack(2).
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-05 07:46:09 +02:00
Michael Kerrisk e66d51d1ba signal.7: Describe syscalls that synchronously wait for a signal,
(sigwait(), sigwaitinfo(), sigtimedwait(), signalfd)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-05 07:41:29 +02:00
Michael Kerrisk 22fe4981c2 signal.7: Give overview of syscalls that block until a signal is caught
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-05 07:30:24 +02:00
Michael Kerrisk 4704a09b80 signal.7: ffix 2008-10-05 07:29:00 +02:00
Michael Kerrisk 7a414038ea signal.7: Add overview of interfaces for sending signals.
(kill(), killpg(), tgkill(), sigqueue(), raise(), etc.)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-05 07:23:58 +02:00
Michael Kerrisk d5c8829874 signal.7: describe semantics w.r.t. fork() and execve()
Include text describing semantics of fork() and execve() for
signal dispositions, signal mask, and pending signal set.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-04 08:33:53 +02:00
Nicolas Franois 44e5793157 Typo and wording fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-09-29 11:00:36 +02:00
Michael Kerrisk 12e86dbff5 mq_overview.7: add mq_notify() to list of lib. functions and syscalls in MQ API 2008-09-29 06:05:04 +02:00
Michael Kerrisk d0cb7cc649 grfix: s/null terminated string/null-terminated string/ 2008-09-26 07:13:25 +02:00
Michael Kerrisk ade562fbcc grfix 2008-09-10 03:40:20 +00:00
Michael Kerrisk 99d8a684b3 start new sentence on new source line 2008-09-10 03:33:15 +00:00
Michael Kerrisk 1614be9f1f Update FIXME. 2008-09-09 10:48:13 +00:00
Michael Kerrisk 5b0dc1baed s/time zone/timezone/ for consistency across pages and with POSIX.1. 2008-09-07 04:17:25 +00:00
Michael Kerrisk b1587ca86e Since glibc 2.8, _GNU_SOURCE must be defined in order to get
the definition of the ucred structure from <sys/socket.h>.
2008-09-01 14:57:49 +00:00
Michael Kerrisk 6f0ab035e6 Explain bug that occurred in coalescing identical events in
kernels before 2.6.25.
(See commit 1c17d18e3775485bf1e0ce79575eb637a94494a2
"A potential bug in inotify_user.c" in the 2.6.25 Changelog.)
2008-08-27 04:21:29 +00:00
Michael Kerrisk 3424352d58 SEE ALSO: add proc(5). 2008-08-24 05:46:38 +00:00
Michael Kerrisk a126897a7a Remove FIXME 2008-08-21 08:53:45 +00:00
Michael Kerrisk 82245f7a31 spfix 2008-08-21 07:18:36 +00:00
Michael Kerrisk 1cf8945c76 spfix 2008-08-21 07:00:07 +00:00
Michael Kerrisk 8fb853ba83 Update thread-safe functions list with changes in POSIX.1-2008. 2008-08-21 06:44:26 +00:00
Michael Kerrisk a0f7c7d8ba Update list of async-sygnal-safe functions for POSIX.1-2008. 2008-08-21 06:38:19 +00:00
Michael Kerrisk 6b042551e7 Fix C Lameter's email address 2008-08-13 13:25:08 +00:00
Michael Kerrisk 1dc5933fac spfix 2008-08-13 13:23:07 +00:00
Michael Kerrisk dae645c6c8 Remove old FIXME 2008-08-13 11:14:29 +00:00
Michael Kerrisk 7d817ee341 A new page giving overview details for the Linux NUMA interfaces.
Incorporates some material from mbind.2, and the description
of /proc/PID/numa_maps from proc.5.
2008-08-13 08:12:07 +00:00
Michael Kerrisk 6021646873 SEE ALSO: add numa(7). 2008-08-13 08:08:05 +00:00
Michael Kerrisk 00df6756ac Rewrite introductory paragraph.
Point out that a NaN is commonly returned by functions that report
a domain error.
2008-08-11 16:35:43 +00:00
Michael Kerrisk edf60acbe8 SEE ALSO: Add clock_getcpuclockid(3). 2008-08-11 10:55:31 +00:00
Michael Kerrisk 1dd4e8b006 Document the Linux implementation of the UDP-Lite protocol,
new in Linux 2.6.20.
2008-08-08 16:55:07 +00:00
Michael Kerrisk 64bfda2738 SEE ALSO: add udplite(7). 2008-08-08 16:50:10 +00:00
Michael Kerrisk d4c8c97c31 s/PF_/AF_/ for socket family constants. Reasons: the AF_ and
PF_ constants have always had the same values; there never has
been a protocol family that had more than one address family,
and POSIX.1-2001 only specifies the AF_* constants.
2008-08-08 16:47:53 +00:00
Michael Kerrisk 77117f4fc5 Reverting blunder in commit 4699 2008-08-08 16:41:48 +00:00
Michael Kerrisk 10874173db s/PF_/AF_/ for socket family conistants. Reasons: the AF_ and
PF_ constants have always had the same values; there never has
been a protocol family that had more than one address family,
and POSIX.1-2001 only specifies the AF_* constants.
2008-08-08 16:28:06 +00:00
Michael Kerrisk e2858a6d2c Updated details for POSIX.1-2008, and noted that if
POSIX.1-2001 is listed in the CONFORMING TO section of a man
page, then the read can assume that the interface is also
specified in POSIX.1-2008, unless otherwise noted.
2008-08-07 06:50:57 +00:00
Michael Kerrisk bb5baf62e8 NOTES: Summarize the state of glibc support for exceptions
and errno for error reporting.
2008-07-30 07:16:18 +00:00
Michael Kerrisk 547768b4eb Reverse order of SYNOPSIS and NAME sections. 2008-07-24 03:59:56 +00:00
Michael Kerrisk 88fb350113 A description of how math functions report errors.
See http://thread.gmane.org/gmane.linux.man/249.
2008-07-23 14:05:42 +00:00
Michael Kerrisk c45bd688fd s/floating point/floating-point/ when used attributively. 2008-07-23 02:57:20 +00:00
Michael Kerrisk 21dcaf8b91 spfix 2008-07-18 13:31:56 +00:00
Michael Kerrisk f7ceac86b1 wfix 2008-07-18 03:59:02 +00:00
Michael Kerrisk 04a315392a tweaks 2008-07-17 18:38:22 +00:00
Michael Kerrisk fd7193f57a Removed trailing white space at end of lines 2008-07-16 13:11:30 +00:00
Michael Kerrisk 574b9f446a fix alpha order in suffix list 2008-07-15 17:34:33 +00:00
Michael Kerrisk 59220720c5 tfix 2008-07-15 17:33:20 +00:00
Michael Kerrisk 44a2c3286c Even when the CONFORMING TO section is just a list of standards,
they should be terminated by a period.
2008-07-15 13:39:17 +00:00
Michael Kerrisk ebc2edd17d A list of standards in the CONFORMING TO list should be terminated by a period.
The list of pages in a SEE ALSO list should not be terminated by a period.
2008-07-15 13:30:35 +00:00
Michael Kerrisk db55c5c599 Small wording fix 2008-07-15 13:24:00 +00:00
Michael Kerrisk f0c34053bc Put SEE ALSO section into alphabetical order. 2008-07-14 15:52:21 +00:00
Michael Kerrisk decede0c28 tfix 2008-07-14 15:15:02 +00:00
Michael Kerrisk c4bb193f3c s/parameter/argument/ when talking about the things given
to a function call, for consistency with majority usage.
2008-07-10 20:53:08 +00:00
Michael Kerrisk 164be4fc3c wfix 2008-07-10 09:38:08 +00:00
Michael Kerrisk c04c44f86d wfix 2008-07-09 15:41:19 +00:00
Michael Kerrisk 58f4fca643 Correct a detail for sysctl_tcp_adv_win_scale.
Formatting fixes.
Small wording fixes.
2008-07-09 15:38:37 +00:00
Michael Kerrisk 87174b3ae2 Small wording fixes 2008-07-09 15:36:44 +00:00
Michael Kerrisk 8ee190da4a s/UNIX/Unix/, when not used as part of a trademark,
for consistency with majority usage in pages.
2008-07-09 14:17:06 +00:00
Michael Kerrisk 2914a14d30 Removed trailing white space at end of lines 2008-07-09 13:55:24 +00:00
Michael Kerrisk c8e6851294 Reword discussion of CAP_LINUX_IMMUTABLE to be file-system neutral. 2008-07-09 12:11:50 +00:00
Michael Kerrisk 02cd273d55 ffix 2008-07-09 04:30:26 +00:00
Michael Kerrisk 012c8c66df ffix 2008-07-09 04:29:20 +00:00
Michael Kerrisk a93b491cb7 ffix 2008-07-09 04:28:25 +00:00
Michael Kerrisk bf5a72471e Added "Copyright" string to lines that had "([Cc])" for copyright. 2008-07-08 14:32:54 +00:00
Michael Kerrisk 07d72ca89d remove duplicate sigvec(3) in SEE ALSO;
put sockatmark() is right alphabetical order in list of
async-sig-safe functions
2008-07-08 13:39:48 +00:00
Michael Kerrisk 83ee9237b6 Since Linux 2.6.25, CAP_SYS_ADMIN is no longer required for
ioprio_set() to set IOPRIO_CLASS_IDLE class.
2008-07-08 10:16:26 +00:00
Michael Kerrisk c17a5c8b30 Removed trailing white space at end of lines 2008-07-07 07:46:36 +00:00
Michael Kerrisk 72710182cd tweaks 2008-07-07 04:16:16 +00:00
Michael Kerrisk 495edd812c tweaks 2008-07-04 20:07:45 +00:00
Michael Kerrisk 72ee5ec277 tweaks + update async-signal-safe function to that given in POSIX.1-2004 2008-07-04 19:40:51 +00:00
Michael Kerrisk 0005e334d7 wfix 2008-07-04 19:33:18 +00:00
Michael Kerrisk b24473a39b wfix 2008-07-04 16:24:13 +00:00
Michael Kerrisk 01538d0d51 ERRORS: Added reference to signal(7) in dicussion of EINTR. 2008-07-04 15:50:36 +00:00
Michael Kerrisk c1667735e0 tfix 2008-07-04 15:16:26 +00:00
Michael Kerrisk 8c69c9232a Note a few more architectures on which signal numbers are valid.
SEE ALSO: added a number of pages.
2008-07-04 15:09:27 +00:00
Michael Kerrisk 743bc3957a tweaks 2008-07-04 14:36:28 +00:00
Michael Kerrisk 48b9ec3fe1 Describe the aberrant Linux behavior whereby a stop signal
plus SIGCONT can interrupt some system calls, even if no
signal handler has been established, and note the system
calls that behave this way.
2008-07-04 13:15:12 +00:00
Michael Kerrisk af3c87d084 Add a section describing system call restarting, and noting
which system calls are affected by SA_RESTART, and which
system calls are never restarted.
2008-07-04 13:13:35 +00:00
Michael Kerrisk 6a665dfb6e wfix 2008-07-03 20:29:12 +00:00
Michael Kerrisk 506bee474a tstamp 2008-07-03 20:14:38 +00:00
Michael Kerrisk 0de5014fe0 Document cpuset mechanism for confining processes to processors and nodes. 2008-07-03 19:57:17 +00:00
Michael Kerrisk 7c85aa6ba5 SEE ALSO: Add sigwait(3). 2008-07-02 13:30:54 +00:00
Michael Kerrisk 4564433c99 Note that the delivery order of multiple pending standard
signals is unspecified.
2008-07-02 12:54:59 +00:00
Michael Kerrisk 095e060410 Overview of POSIX shared memory API. 2008-07-02 05:03:46 +00:00
Michael Kerrisk 27e8d1a56d ffix 2008-07-01 16:32:22 +00:00
Michael Kerrisk 0425de01c7 s/ / / 2008-07-01 14:15:13 +00:00
Michael Kerrisk 18701562c1 s/user name/username/ 2008-06-30 14:36:59 +00:00
Michael Kerrisk 6387216bb2 Wrap lines at sentence breaks. 2008-06-28 04:57:20 +00:00
Michael Kerrisk ddaec46d7f s/host name/hostname/ 2008-06-27 03:37:56 +00:00
Michael Kerrisk e6e731d1f4 ffix 2008-06-26 13:38:01 +00:00
Michael Kerrisk 5b8dbfd4d0 ffixes 2008-06-26 13:23:48 +00:00
Michael Kerrisk 2f6b8245d1 ffix 2008-06-26 13:19:40 +00:00
Michael Kerrisk 027ebd3c4b Enhanced the dscussion of font conventions. 2008-06-26 13:15:49 +00:00
Michael Kerrisk 9085070854 ffix 2008-06-26 12:56:53 +00:00
Michael Kerrisk 73858a07dd Wfix 2008-06-24 14:05:49 +00:00
Michael Kerrisk 9bb26f2df6 Note that HRTs are not supported on all h/w. 2008-06-23 11:21:18 +00:00
Michael Kerrisk 46f14bc7b0 Added some details about where jiffies come into play.
Added section on high-resolution timers.
Mentioned a few other time-related interfaces at various points in the page.
2008-06-23 09:19:45 +00:00
Michael Kerrisk 61792fc66b ffix 2008-09-18 12:30:41 +00:00
Michael Kerrisk 8cacdebdab tstamp 2008-06-18 09:37:15 +00:00
Michael Kerrisk 7eb11a9fe7 formatting and wording improvements 2008-06-18 09:36:55 +00:00
Michael Kerrisk 2fadbfb588 For consistency, "fix" cases where aregument of .B or .I was on the following source line. 2008-06-18 08:57:49 +00:00
Michael Kerrisk f4b5a0b0c8 Updated text referring to syscalls(2). 2008-06-16 10:08:53 +00:00
Michael Kerrisk a1d5601bee Removed trailing white space at end of lines 2008-06-12 11:52:08 +00:00
Michael Kerrisk 905c9e1c05 tstamp 2008-06-12 11:47:27 +00:00
Michael Kerrisk 6b84b38312 tstamp 2008-06-12 11:46:50 +00:00
Michael Kerrisk 305865606d Note that Linux supports ACLs on POSIX named semaphores since 2.6.19. 2008-06-11 22:32:40 +00:00
Michael Kerrisk 8f36e23f07 Linux does not currently support ACLs for POSIX message queues. 2008-06-11 22:31:48 +00:00
Michael Kerrisk ad22ad5568 ffix 2008-06-11 22:19:03 +00:00
Michael Kerrisk 94b40171e1 Provide a clear description of the three types of address that can
appear in the sockaddr_un structure: pathname, unnamed, and abstract.
2008-06-11 22:11:06 +00:00
Michael Kerrisk a9cfde1dbc SEE ALSO: add symlink.7 2008-06-11 21:50:53 +00:00
Michael Kerrisk 2b061b28a6 Minor tweaks 2008-06-11 21:50:28 +00:00
Michael Kerrisk eae3689b44 A description of symbolic links, taken from FreeBSD 6.2 and heavily edited. 2008-06-11 21:25:12 +00:00
Michael Kerrisk 06b00cff20 A description of hostnames, taken from FreeBSD. 2008-06-11 21:24:46 +00:00
Michael Kerrisk 294544e7b2 Expand description of VERSIONS section. 2008-06-11 13:41:00 +00:00
Michael Kerrisk 9708eb3749 Quote fixes 2008-06-10 12:29:07 +00:00
Michael Kerrisk 8bb93cd4bb Control character names (^X) are writte boldface, without quotes. 2008-06-10 08:44:34 +00:00
Michael Kerrisk c45660d7d7 wrap long source lines 2008-06-09 21:12:25 +00:00
Michael Kerrisk 8062a09161 Add FIXME 2008-06-09 21:07:39 +00:00
Michael Kerrisk 333a424b0e Try and bring some consistency to quotes. 2008-06-09 21:03:52 +00:00
Michael Kerrisk f81fb4445b s/\\'/\\(aq/ 2008-06-09 15:49:35 +00:00
Michael Kerrisk 84c517a450 Change use of quote characters to get better UTF-8 rendering. 2008-06-05 20:14:50 +00:00
Michael Kerrisk b8b45978b0 /'/\\'/ to produce better UTF rendering 2008-06-05 19:01:25 +00:00
Michael Kerrisk 9377e6281a ffix 2008-06-05 18:53:46 +00:00
Michael Kerrisk f8a07a2154 s/'/\\'/ to improve rendering in UTF-8. 2008-06-05 17:52:37 +00:00