LDP
/
man-pages
mirror of https://github.com/mkerrisk/man-pages
0
1
Fork 0
Code Releases Activity
22,943 Commits 1 Branch 197 Tags 93 MiB
Commit Graph

6948 Commits

Author SHA1 Message Date
Michael Kerrisk a26a803b4a Remove freadable, fwriteable, fwriting 2006-05-17 20:05:58 +00:00
Michael Kerrisk 4ff5a07b8d ffix 2006-05-17 19:37:53 +00:00
Michael Kerrisk b95582c7c8 ffix 2006-05-16 20:05:19 +00:00
Michael Kerrisk c3b8df7000 wfix 2006-05-15 20:52:20 +00:00
Michael Kerrisk 21038fa244 wfix 2006-05-15 09:23:14 +00:00
Michael Kerrisk a8e7c990dc Rename ftm.7 to feature_test_macros.7 2006-05-15 09:13:10 +00:00
Michael Kerrisk 8699b7dd38 wfix 2006-05-14 21:41:45 +00:00
Michael Kerrisk 3ed4fcbd33 tfix 2006-05-13 21:52:39 +00:00
Michael Kerrisk 0bfd9487fa New link to mq_getattr.3 2006-05-12 19:10:51 +00:00
Michael Kerrisk e2c271700e New link to mq_send.3 2006-05-12 19:10:31 +00:00
Michael Kerrisk 4673d55157 New link to mq_send.3 2006-05-12 19:10:14 +00:00
Michael Kerrisk d2b5344454 New page for rpmatch(3) 2006-05-12 18:49:41 +00:00
Michael Kerrisk 42b099302d Clarify meaning of IXANY. 
Clarify relationship of MIN with VMIN and TIME with VTIME.
Noted that CIBAUD, OFDEL, and DELECHO are not implemented on Linux.
Added explanatory paragraph for phrases "not in POSIX" and
"XSI".
 2006-05-08 21:37:17 +00:00
Michael Kerrisk 2d2c82e101 wfix 2006-05-08 21:27:27 +00:00
Michael Kerrisk 7c5bd0ebc2 Add missing "const" qualifies to cast in EXAMPLE. 
Slight rewording of comments in EXAMPLE.
 2006-05-08 06:41:59 +00:00
Michael Kerrisk bcd70adc0e Document 'm' (mmap) flag. 
Document 'c' (notcancel) flag.
 2006-05-03 23:52:08 +00:00
Michael Kerrisk 22e3b8b11c Add SEE ALSO references to new *at.2 pages 2006-05-02 00:03:35 +00:00
Michael Kerrisk 4f43f21f30 Rewrote RETURN VALUE discussion. 
Updated CONFORMING TO.
Removed BUGS.
 2006-05-01 05:53:15 +00:00
Michael Kerrisk 8888a90efe Various small changes. 2006-05-01 02:26:44 +00:00
Michael Kerrisk 9fcfcba05f Added SEE ALSO entry referring to setlocale.3 2006-05-01 01:52:57 +00:00
Michael Kerrisk 4c5dd86906 New page for adjtime(3). 2006-05-01 00:14:40 +00:00
Michael Kerrisk 6f57dde7d2 wfix 2006-05-01 00:05:18 +00:00
Michael Kerrisk 16e1b4721c wfix 2006-04-30 21:11:57 +00:00
Michael Kerrisk 7fe9faa251 Rewrote references to program_invocation_name 2006-04-28 20:03:47 +00:00
Michael Kerrisk 36e6dea5bc New link to new program_invocation_name.3. 2006-04-28 20:00:50 +00:00
Michael Kerrisk 900064d47c New page describing program_invocation_name and 
program_invocation_short_name variables.
 2006-04-28 19:59:46 +00:00
Michael Kerrisk a914ecb389 Remove documented functions 2006-04-28 19:56:45 +00:00
Michael Kerrisk 6ff9cf67aa minor changes 2006-04-28 19:19:03 +00:00
Michael Kerrisk e2daf71dbb New link to new error.3 2006-04-28 18:37:17 +00:00
Michael Kerrisk c768efc691 wfix 2006-04-28 08:18:23 +00:00
Michael Kerrisk 0143e6bcbc minor changes 2006-04-28 06:51:09 +00:00
Michael Kerrisk 37b6aec337 Add SEE ALSO referring to new error.3 2006-04-28 06:47:38 +00:00
Michael Kerrisk 921166c474 New page describing error () and error_at_line() 2006-04-28 06:44:37 +00:00
Michael Kerrisk eafd5ce11f Added SEE ALSO referring to new time.7 2006-04-26 07:26:36 +00:00
Michael Kerrisk 7f4f95858a The range of tm_sec is 0..60 (not 0..61). 2006-04-26 05:49:35 +00:00
Michael Kerrisk 6c98e32416 ffix 2006-04-26 05:49:24 +00:00
Michael Kerrisk bb47b54bfb Add SEE ALSO pointing to getline.3. 2006-04-25 21:31:05 +00:00
Michael Kerrisk cbd3458862 Updated FIXME 2006-04-23 23:34:59 +00:00
Michael Kerrisk 92452da5db ffix 2006-04-23 23:33:10 +00:00
Michael Kerrisk 66679b1f0f 4.x BSD --> 4.xBSD 2006-04-23 23:29:16 +00:00
Michael Kerrisk 96a67b1111 Remove old FIXME 2006-04-23 23:15:26 +00:00
Michael Kerrisk 21008754d7 New page. 2006-04-22 03:56:18 +00:00
Michael Kerrisk a5537674fd wfix 2006-04-21 19:07:17 +00:00
Michael Kerrisk 516f0680e4 Update FIXME 2006-04-21 19:01:55 +00:00
Michael Kerrisk 6dff8403b8 wfix 2006-04-21 19:01:43 +00:00
Michael Kerrisk 50e5322c85 Added SEE ALSO reference to ftm.7 2006-04-21 06:49:34 +00:00
Michael Kerrisk fb961f311e Simplified wording about requirement for _BSD_SOURCE macro. 2006-04-21 06:28:54 +00:00
Michael Kerrisk 2c5e151c7f ipc.7 --> svipc.7 2006-04-21 03:53:43 +00:00
Michael Kerrisk af5b2ef2cc fifo.4 --> fifo.7 2006-04-21 01:46:04 +00:00
Michael Kerrisk a8bda63671 complex.5 --> complex.7 2006-04-21 01:24:06 +00:00
Michael Kerrisk aa949e2d59 environ.5 --> environ.7 2006-04-21 00:45:46 +00:00
Michael Kerrisk 922436594f ipc.5 --> ipc.7 2006-04-21 00:38:38 +00:00
Michael Kerrisk 0acd0e5775 minor changes 2006-04-20 21:56:03 +00:00
Michael Kerrisk b776661a65 Updated FIXME 2006-04-20 20:20:01 +00:00
Michael Kerrisk 97b6cd4152 Add FIXME 2006-04-19 22:56:37 +00:00
Michael Kerrisk af8d55f9ce DESCRIPTION does not need to say "temporary file name" just "temporary 
file", since the name is in any case unavailable to the user.
See Debian bug 363518

In DESCRIPTION:
Change /automatically deleted when the program terminates normally/
to     /automatically deleted when the program terminates/
since that is the reality.
 2006-04-19 21:19:30 +00:00
Michael Kerrisk 690db71bff Fix typo in description 2006-04-19 20:33:31 +00:00
Michael Kerrisk c75ec721fb Add text noting that disabling output buffering using setbuf() 
may be useful to catch errors on output operations.
 2006-04-19 02:47:51 +00:00
Michael Kerrisk 5a1cae6b28 Added EXAMPLE section pointing to strtol.3, which provides an example 
of the use of the analogous strtol() function.
 2006-04-19 01:33:09 +00:00
Michael Kerrisk 56aee8683e Added an example program. 2006-04-19 01:31:51 +00:00
Michael Kerrisk fefe023ea5 Describe correct handling or errno in order to 
distinguish error from success after the call.
 2006-04-19 00:58:37 +00:00
Michael Kerrisk f1158c074c wfix 2006-04-18 09:02:55 +00:00
Michael Kerrisk 869ebe5b84 Document the feature test macros required to expose various flags. 
Clarify speed argument for cfsetispeed() text.
Note that LOBLK is not implemented on Linux.
Clarify arguments for cfsetspeed().
Various formatting changes
 2006-04-15 00:39:29 +00:00
Michael Kerrisk e7b0c1f1d7 Minor changes 2006-04-06 05:18:28 +00:00
Michael Kerrisk 91bf3fab3a New page for new mkfifoat.3. 2006-04-05 05:36:09 +00:00
Michael Kerrisk 641220734e Added SEE ALSO to new mkfifoat.3. 2006-04-05 05:34:56 +00:00
Michael Kerrisk 2c731798aa Pages describing POSIX semaphores API 2006-03-25 20:42:27 +00:00
Michael Kerrisk f3cbdba966 FIXME ffix 2006-03-23 03:29:05 +00:00
Michael Kerrisk 218e46f883 Small FIXME formatting fixes 2006-03-23 02:13:08 +00:00
Michael Kerrisk 777f5a9ef7 Updated FIXMEs 2006-03-20 04:46:28 +00:00
Michael Kerrisk f8bb81c576 spfix 2006-03-20 03:13:48 +00:00
Michael Kerrisk 7bc7af37cf Clean up description of EEXIST error. 
Debian bug 357893
 2006-03-20 03:13:41 +00:00
Michael Kerrisk 739b9bb1b3 spfix 2006-03-20 01:31:53 +00:00
Michael Kerrisk d18b568465 Add needed "#define _XOPEN_SOURCE" 2006-03-19 21:49:15 +00:00
Michael Kerrisk 96d64e9889 ffix 2006-03-19 21:32:39 +00:00
Michael Kerrisk f2665a55f6 Added comment on a glibc header bug 2006-03-12 00:14:51 +00:00
Michael Kerrisk 14eb7ff62e Link to shm_open.3 2006-03-09 04:37:30 +00:00
Michael Kerrisk b3d291f066 Removed some page names that are now documented. 2006-03-09 04:12:30 +00:00
Michael Kerrisk 4ed33e00ac Added SEE ALSO for fexecve.3 2006-03-06 04:55:51 +00:00
Michael Kerrisk 37ca720250 New page 2006-03-06 04:55:27 +00:00
Michael Kerrisk a6c95320cf Only available elsewhere on the BSDs. 2006-03-06 04:34:13 +00:00
Michael Kerrisk 9e1632fd75 futimes(3) 2006-03-06 02:43:48 +00:00
Michael Kerrisk c7da82ff53 ffix 2006-03-05 22:59:17 +00:00
Michael Kerrisk 06ec542b7f Updated FIXME 2006-03-05 20:44:02 +00:00
Michael Kerrisk 37f5831230 tfix 2006-03-02 03:11:54 +00:00
Michael Kerrisk 08140a81ac Minor changes 2006-03-02 02:04:20 +00:00
Michael Kerrisk 1cd27447fe New page. 2006-03-01 04:10:55 +00:00
Michael Kerrisk 80a99f39e6 New pages for POSIX message queues API 2006-03-01 03:21:20 +00:00
Michael Kerrisk efa25b17c6 Modify formatting of copyright notices 2006-02-15 23:19:08 +00:00
Michael Kerrisk 1130df606b Amend copyright notices, in particular those where I had significant 
authorship.
 2006-02-15 23:15:29 +00:00
Michael Kerrisk 73dc32f064 Expand explanation of FNM_PATHNAME. 2006-02-14 05:03:56 +00:00
Michael Kerrisk ef50679c63 Chage "file name" to "filename" 2006-02-12 22:23:18 +00:00
Michael Kerrisk 2d7195b8fb Change "path name" to "pathname" 2006-02-12 22:19:08 +00:00
Michael Kerrisk 2c5f10893e Change "file name" to "filename" 2006-02-12 22:15:41 +00:00
Michael Kerrisk 0febdb5ca1 Fix up discussion of EAGAIN/EACCESS errors. 2006-02-10 20:27:59 +00:00
Michael Kerrisk c533af9d27 Reformatted FIXMEs 2006-02-10 18:46:42 +00:00
Michael Kerrisk 1709027cdd Added SEE ALSO pointers to wide character equivalent functions 2006-02-09 20:57:44 +00:00
Michael Kerrisk dcec8eb551 Formatting fixes 2006-02-09 20:29:51 +00:00
Michael Kerrisk 9ff08aad91 Formatting fixes 2006-02-09 20:24:53 +00:00
Michael Kerrisk a0ddea8773 Add Linux-specific errors, and mark individual errors as being present 
in POSIX or C99

Hello Kurt,

Thanks for your message.

> man3/errno.3 was missing some errors. 

Indeed.

> This patch updates errno.3 based
> on /usr/include/linux/errno.h as of 2.6.16-rc2. 

I do not quite understand that last: /usr/include/linux/errno.h is a 
userland file -- it probably won't tie up too well to a 
specific kernel version (or am I missing something?).

> I also synced the error
> description in the man page with the error descriptions from the header
> file.

This generates some useful info, but also some things that are incorrect.
For example, since you are talking about a glibc header, does a 
particular error even occur on Linux.  (See some examples below.)

I think you also overlooked the fact that the page says that the listed 
errors are defined by POSIX.1-2001.  So it is not sufficient to just 
add new errors to the list.  On the other hand, it is irritating
that the current page does not list Linux-specific errors.
And you patch has finally pushed me to do something I've been 
thinking of for a while.  So I've changed the page to mark the 
errors that are POSIX, and added the Linux-specifc errors, 
integrating some of your patch.

> The patch was diffed against manpages-2.22.

Thanks -- many people forget to mention that detail.

> --- errno.3.orig    2005-12-14 07:09:39.000000000 -0500
> +++ errno.3    2006-02-06 23:45:52.000000000 -0500
> @@ -23,9 +23,11 @@
>  .\" 5 Oct 2002, Modified by Michael Kerrisk <mtk-manpages@gmx.net>
>  .\"     Updated for POSIX 1003.1 2001
>  .\" 2004-12-17 Martin Schulze <joey@infodrom.org>, mtk
> -.\"    Removed errno declaration prototype, added notes
> +.\"        Removed errno declaration prototype, added notes
> +.\" 7 Feb 2006, Modified by Kurt Wall <kwall@kurtwerks.com>
> +.\"     Add missing errors, sync to linux-2.6.16-rc2
>  .\"
> -.TH ERRNO 3 2004-12-17 "" "Library functions"
> +.TH ERRNO 3 2006-02-07 "" "Library functions"
>  .SH NAME
>  errno \- number of last error
>  .SH SYNOPSIS
> @@ -71,61 +73,95 @@
>  .\" FIXME The following list is far from complete
>  .TP
>  .B E2BIG
> -Arg list too long
> +Argument list too long

ok

>  .TP
>  .B EACCES
>  Permission denied
>  .TP
>  .B EADDRINUSE
> -Address in use
> +Address already in use

ok

>  .TP
>  .B EADDRNOTAVAIL
> -Address not available
> +Cannot assign requested address

ok

> +.TP
> +.B EADV
> +Advertise error

This is a HURD error.  As far as I can tell it does not occur on Linux.

>  .TP
>  .B EAFNOSUPPORT
> -Address family not supported
> +Address family not supported by protocol

POSIX differs.  I stayed with POSIX.

>  .TP
>  .B EAGAIN
> -Resource temporarily unavailable
> +Try again

This is wrong.  (i.e., it does not match POSIX and/or 
what perror(3) produces)

>  .TP
>  .B EALREADY
> -Connection already in progress
> +Operation already in progress

POSIX differs.  I stayed with POSIX.

> +.TP
> +.B EBADE
> +Invalid exchange

ok

>  .TP
>  .B EBADF
> -Bad file descriptor
> +Bad file number

This is wrong.

> +.TP
> +.B EBADFD
> +File descriptor in bad state

ok

>  .TP
>  .B EBADMSG
> -Bad message
> +Not a data message

This is wrong.

> +.TP
> +.B EBADR
> +Invalid request descriptor

ok

> +.TP
> +.B EBADRQC
> +Invalid request code

ok

> +.TP
> +.B EBADSLT
> +Invalid slot

ok

> +.TP
> +.B EBFONT
> +Bad font file format

As far as I can tell, this is not used on Linux.  Let me know 
if you find otherwise. (I didn't add it)

>  .TP
>  .B EBUSY
> -Resource busy
> +Device or resource busy

ok

>  .TP
>  .B ECANCELED
> -Operation canceled
> +Operation Canceled

Please review the output of automated scripts!
(not changed)

>  .TP
>  .B ECHILD
>  No child processes
>  .TP
> +.B ECHRNG
> +Channel number out of range

ok

> +.TP
> +.B ECOMM
> +Communication error on send

ok

> +.TP
>  .B ECONNABORTED
> -Connection aborted
> +Software caused connection abort

POSIX differs.  I stayed with POSIX.

>  .TP
>  .B ECONNREFUSED
>  Connection refused
>  .TP
>  .B ECONNRESET
> -Connection reset
> +Connection reset by peer

POSIX differs.  I stayed with POSIX.

>  .TP
>  .B EDEADLK
> -Resource deadlock avoided
> +Resource deadlock would occur

POSIX differs.  I stayed with POSIX.

> +.TP
> +.B EDEADLOCK
> +Resource deadlock would occur (might be the same value as
> +.BR EDEADLK)

I wrote just "Synonym for EDEADLK"

>  .TP
>  .B EDESTADDRREQ
>  Destination address required
>  .TP
>  .B EDOM
> -Domain error
> +Math argument out of domain of func

? Garbled

I wrote the POSIX defn: Mathematics argument out of domain of function

> +.TP
> +.B EDOTDOT
> +RFS specific error

This is defined, but appears not to be used.
(I didn't add it)

>  .TP
>  .B EDQUOT
> -Reserved
> +Quota exceeded

POSIX says "Reserved."  In this case better to go with
"Disk quota exceeded"

>  .TP
>  .B EEXIST
>  File exists
> @@ -136,8 +172,11 @@
>  .B EFBIG
>  File too large
>  .TP
> +.B EHOSTDOWN
> +Host is down

ok

> +.TP
>  .B EHOSTUNREACH
> -Host is unreachable
> +No route to host

POSIX differs.  I stayed with POSIX.

>  .TP
>  .B EIDRM
>  Identifier removed
> @@ -146,25 +185,70 @@
>  Illegal byte sequence
>  .TP
>  .B EINPROGRESS
> -Operation in progress
> +Operation now in progress

POSIX differs.  I stayed with POSIX.

>  .TP
>  .B EINTR
> -Interrupted function call
> +Interrupted system call

POSIX differs.  I stayed with POSIX.

>  .TP
>  .B EINVAL
>  Invalid argument
>  .TP
>  .B EIO
> -Input/output error
> +I/O error

POSIX differs.  I stayed with POSIX.

>  .TP
>  .B EISCONN
> -Socket is connected
> +Transport endpoint is already connected

POSIX differs.  I stayed with POSIX.

>  .TP
>  .B EISDIR
>  Is a directory
>  .TP
> +.B EISNAM
> +Is a named type file

ok

> +.TP
> +.B EKEYEXPIRED
> +Key has expired

ok

> +.TP
> +.B EKEYREJECTED
> +Key was rejected by service

ok

> +.TP
> +.B EKEYREVOKED
> +Key has been revoked

ok

> +.TP
> +.B EL2HLT
> +Level 2 halted

ok

> +.TP
> +.B EL2NSYNC
> +Level 2 not synchronized

ok

> +.TP
> +.B EL3HLT
> +Level 3 halted

ok

> +.TP
> +.B EL3RST
> +Level 3 reset

ok

> +.TP
> +.B ELIBACC
> +Can not access a needed shared library

ok

> +.TP
> +.B ELIBBAD
> +Accessing a corrupted shared library

ok

> +.TP
> +.B ELIBEXEC
> +Cannot exec a shared library directly

ok

> +.TP
> +.B ELIBMAX
> +Attempting to link in too many shared libraries

ok

> +.TP
> +.B ELIBSCN
> +.lib section in a.out corrupted

ok

> +.TP
> +.B ELNRNG
> +Link number out of range

This is defined, but appears not to be used.
(I didn't add it)

> +.TP
>  .B ELOOP
> -Too many levels of symbolic links
> +Too many symbolic links encountered

this is wrong

> +.TP
> +.B EMEDIUMTYPE
> +Wrong medium type
>  .TP
>  .B EMFILE
>  Too many open files
> @@ -173,32 +257,41 @@
>  Too many links
>  .TP
>  .B EMSGSIZE
> -Inappropriate message buffer length
> +Message too long

ok

>  .TP
>  .B EMULTIHOP
> -Reserved
> +Multihop attempted

ok
POSIX says "Reserved."  In this case better to go with
Linux.

>  .TP
>  .B ENAMETOOLONG
> -Filename too long
> +File name too long

Scripted output?
(no change)

> +.TP
> +.B ENAVAIL
> +No XENIX semaphores available

This is defined, but appears not to be used.
(I didn't add it)

>  .TP
>  .B ENETDOWN
>  Network is down
>  .TP
>  .B ENETRESET
> -Connection aborted by network
> +Network dropped connection because of reset

POSIX differs.  I stayed with POSIX.

>  .TP
>  .B ENETUNREACH
> -Network unreachable
> +Network is unreachable

POSIX differs.  I stayed with POSIX.

>  .TP
>  .B ENFILE
> -Too many open files in system
> +File table overflow

This is wrong

> +.TP
> +.B ENOANO
> +No anode

This is defined, but appears not to be used.
(I didn't add it)

>  .TP
>  .B ENOBUFS
>  No buffer space available
> +.TP
> +.B ENOCSI
> +No CSI structure available

This is defined, but appears not to be used.
(I didn't add it)

>  .\" ENODATA is part of XSR option
>  .TP
>  .B ENODATA
> -No message is available on the STREAM head read queue
> +No data available

POSIX differs.  I stayed with POSIX.

>  .TP
>  .B ENODEV
>  No such device
> @@ -209,17 +302,29 @@
>  .B ENOEXEC
>  Exec format error
>  .TP
> +.B ENOKEY
> +Required key not available

ok

> +.TP
>  .B ENOLCK
> -No locks available
> +No record locks available

This is wrong

>  .TP
>  .B ENOLINK
> -Reserved
> +Link has been severed

ok
POSIX says "Reserved."  In this case better to go with
Linux.

> +.TP
> +.B ENOMEDIUM
> +No medium found

ok

>  .TP
>  .B ENOMEM
> -Not enough space
> +Out of memory

POSIX differs.  I stayed with POSIX.

>  .TP
>  .B ENOMSG
> -No message of the desired type
> +No message of desired type

POSIX differs.  I stayed with POSIX.

> +.TP
> +.B ENONET
> +Machine is not on the network

ok

> +.TP
> +.B ENOPKG
> +Package not installed

ok

>  .TP
>  .B ENOPROTOOPT
>  Protocol not available
> @@ -229,17 +334,20 @@
>  .\" ENOSR is part of XSR option
>  .TP
>  .B ENOSR
> -No STREAM resources
> +Out of streams resources

POSIX differs.  I stayed with POSIX.

>  .\" ENOSTR is part of XSR option
>  .TP
>  .B ENOSTR
> -Not a STREAM
> +Device not a stream

POSIX differs.  I stayed with POSIX.

>  .TP
>  .B ENOSYS
>  Function not implemented
>  .TP
> +.B ENOTBLK
> +Block device required
> +.TP

ok

>  .B ENOTCONN
> -The socket is not connected
> +Transport endpoint is not connected

POSIX differs.  I stayed with POSIX.

>  .TP
>  .B ENOTDIR
>  Not a directory
> @@ -247,27 +355,33 @@
>  .B ENOTEMPTY
>  Directory not empty
>  .TP
> -.B ENOTSOCK
> -Not a socket
> +.B ENOTNAM
> +Not a XENIX named type file

This is defined, but appears not to be used.
(I didn't add it)

>  .TP
> -.B ENOTSUP
> -Not supported

No!  This exists.


> +.B ENOTSOCK
> +Socket operation on non-socket
>  .TP
>  .B ENOTTY
> -Inappropriate I/O control operation
> +Not a typewriter

this is wrong

> +.TP
> +.B ENOTUNIQ
> +Name not unique on network

ok

>  .TP
>  .B ENXIO
>  No such device or address
>  .TP
>  .B EOPNOTSUPP
> -Operation not supported on socket
> +Operation not supported on transport endpoint

POSIX differs.  I stayed with POSIX.

(In passing ENOTSUP and EOPNOTSUPP have the same value on Linux;
POSIX.1 does not permit this.)

>  .TP
>  .B EOVERFLOW
> -Value too large to be stored in data type
> +Value too large for defined data type

POSIX differs.  I stayed with POSIX.

>  .TP
>  .B EPERM
>  Operation not permitted
>  .TP
> +.B EPFNOSUPPORT
> +Protocol family not supported

ok

> +.TP
>  .B EPIPE
>  Broken pipe
>  .TP
> @@ -281,39 +395,76 @@
>  Protocol wrong type for socket
>  .TP
>  .B ERANGE
> -Result too large
> +Math result not representable

POSIX differs.  I stayed with POSIX.

> +.TP
> +.B EREMCHG
> +Remote address changed

ok

> +.TP
> +.B EREMOTE
> +Object is remote

ok

> +.TP
> +.B EREMOTEIO
> +Remote I/O error

ok

> +.TP
> +.B ERESTART
> +Interrupted system call should be restarted

ok

>  .TP
>  .B EROFS
>  Read-only file system
>  .TP
> +.B ESHUTDOWN
> +Cannot send after transport endpoint shutdown

ok

> +.TP
> +.B ESOCKTNOSUPPORT
> +Socket type not supported

ok

> +.TP
>  .B ESPIPE
> -Invalid seek
> +Illegal seek

POSIX differs.  I stayed with POSIX.

>  .TP
>  .B ESRCH
>  No such process
>  .TP
> +.B ESRMNT
> +Srmount error

This is defined, but appears not to be used.
(I didn't add it)

> +.TP
>  .B ESTALE
> -Stale file handle
> +Stale NFS file handle

Tricky -- you are right about the error message, 
but the message itself is wrong, because the error 
can occur on other file sytems also.
(not changed)

>  .\" Can occur for NFS and for other file systems
>  .\" ETIME is part of XSR option
>  .TP
> +.B ESTRPIPE
> +Streams pipe error

ok

> +.TP
>  .B ETIME
> -STREAM 
> -.BR ioctl () 
> -timeout
> +Timer expired

POSIX differs, but Linux doesn't have streams, and the error is 
used for various purposes.  Changed as you proposed.

>  .TP
>  .B ETIMEDOUT
> -Operation timed out
> +Connection timed out

ok

> +.TP
> +.B ETOOMANYREFS
> +Too many references: cannot splice

This is defined, but appears not to be used.
(I didn't add it)

>  .TP
>  .B ETXTBSY
>  Text file busy
>  .TP
> -.B EWOULDBLOCK
> -Operation would block (may be same value as
> -.BR EAGAIN )

Absolutely not!!

> +.B EUCLEAN
> +Structure needs cleaning

ok

> +.TP
> +.B EUNATCH
> +Protocol driver not attached

ok

> +.TP
> +.B EUSERS
> +Too many users

ok

> +.TP
> +.B EWOULDBLOCK    
> +Operation would block (might be same value as
> +.BR EAGAIN)

okay (except formatting was not quite right: .BR EAGAIN )

>  .TP
>  .B EXDEV
> -Improper link
> +Cross-device link
> +.TP
> +.B EXFULL
> +Exchange full

ok
 2006-02-08 18:26:38 +00:00
Michael Kerrisk 92057f4dbc Updated FIXMEs 2006-02-08 09:44:13 +00:00
Michael Kerrisk 23b3fc77bb Added cross-ref to locale.7 for 'struct lconv' defn. 
Other minor wording changes.
 2006-02-07 23:32:50 +00:00
Michael Kerrisk 48e1940d60 wfix 2006-02-07 22:54:01 +00:00
Michael Kerrisk 0087e7c432 Added SEE ALSO ref for nl_langinfo.3 
As per Debian bug 351831.
 2006-02-07 20:57:53 +00:00
Michael Kerrisk 6e888f06d1 Minor formatting & wording fixes. 2006-02-05 08:57:26 +00:00
Michael Kerrisk 43daf87dcd Minor formatting & wording fixes. 2006-02-05 08:54:26 +00:00
Michael Kerrisk 803ef3359c tfix 2006-01-23 06:43:04 +00:00
Michael Kerrisk 3f266a435b s/string must begin/string may begin/ 2006-01-19 18:45:50 +00:00
Michael Kerrisk 6e592244a8 Slight rewording of recent added text 2006-01-17 20:13:03 +00:00
Michael Kerrisk d0ac4fb3e2 Make clear that when calling getopt_long() and there are no 
short options, then 'optstring' should be "" not NULL.
 2006-01-16 22:48:21 +00:00
Michael Kerrisk 660dd25fee In glibc 2.0.92, openpty() was modified to return 
Unix 98 ptys instead of BSD ptys.
 2006-01-16 22:07:42 +00:00
Michael Kerrisk 48a1cb4903 Small rewording under EXAMPLE. 2006-01-16 19:48:56 +00:00
Michael Kerrisk cd6d114a27 new link to mmap.2 2006-01-15 20:40:32 +00:00
Michael Kerrisk a3a1166783 Some rewordings of recently added text 2006-01-15 01:08:56 +00:00
Michael Kerrisk 788be12467 Clarify how strcmp() should be used as the 'compar' 
function by providing an example.
 2006-01-14 18:25:27 +00:00
Michael Kerrisk ab95e95e01 Formatting fix 2006-01-14 17:14:10 +00:00
Michael Kerrisk 0ed29c540c Noted use of atexit() to register a function that is 
automatically called when a library is unloaded.
 2006-01-14 05:37:06 +00:00
Michael Kerrisk bba0618959 Added description of RTLD_DEEPBIND. 2006-01-14 05:14:39 +00:00
Michael Kerrisk 336e88f0f8 Rewrote discussion of dlopen() 'flag' argument; 
added description of RTLD_NOLOAD and RTLD_DELETE.
 2006-01-14 04:29:47 +00:00
Michael Kerrisk f6a5acc97f Add RETURN VALUE section. 2006-01-13 09:58:42 +00:00
Michael Kerrisk 80b50848d0 Replace "SYSV" by "System V" 2006-01-13 09:44:53 +00:00
Michael Kerrisk aa651b3950 Replace "SysV" by "System V" 2006-01-13 09:39:55 +00:00
Michael Kerrisk 845f2c47c6 Grammar/formatting fixes 2006-01-13 09:34:01 +00:00
Michael Kerrisk 28d88c1751 Global change to many pages... 
Various pages use inconsistent terms for 'null byte' (which
is the C99/SUSv3 term for the '\0' character).
To rectify this the following changes were made in these pages:

Replace 'zero byte' with 'null byte'.
Replace 'null character' with 'null byte'.
Replace 'nulls' with 'null bytes'.
Replace 'NUL-terminated' by 'null-terminated'.
Replace 'NUL' by 'null byte'.
Replace 'terminating NUL' by 'terminating null byte'.
Replace 'final NUL' by 'terminating null byte'.
Replace 'NUL character' by 'null byte'.
 2006-01-13 02:09:44 +00:00
Michael Kerrisk 89c9a3145e Rewrote substantial parts of the page, and relicensed under GPL. 2006-01-13 00:22:47 +00:00
Michael Kerrisk 47a1e7e424 Noted historical use of <stdio.h> to declare getopt(). 2006-01-12 19:46:24 +00:00
Michael Kerrisk b62a20b74d Noted that this function is available since glibc 2.2. 2006-01-01 12:00:09 +00:00
Michael Kerrisk 53948b0178 s/nulls/null bytes/ 2006-01-01 07:20:29 +00:00
Michael Kerrisk 89cc227528 Formatting fix 2005-12-19 10:33:47 +00:00
Michael Kerrisk a30e090e7c Added description of 'x' mode character (exclusive open). 2005-12-15 15:58:16 +00:00
Michael Kerrisk d7871cf963 Added err(3) to SEE ALSO 2005-12-14 12:09:39 +00:00
Michael Kerrisk 26b66d19a9 Added CONFORMING TO section noting that these are non-standard BSDisms. 2005-12-14 12:08:59 +00:00
Michael Kerrisk ed07f09aeb A few refinments to recent changes 2005-12-14 09:27:17 +00:00
Michael Kerrisk aca9215859 dded resolver(5) to SEE ALSO 2005-12-13 18:42:35 +00:00
Michael Kerrisk 6e84dfa12a Rewrote and extended the discussion of the two flavours of 
strerror_r(), and added some additional information on strerror().
 2005-12-13 18:42:16 +00:00
Michael Kerrisk ac1056b5c0 Remove cross references to resolv+(8); add cross references to 
resolv.conf(5).  (See also Debian Bug#214892)
 2005-12-13 15:23:07 +00:00
Michael Kerrisk 24268a723c Added references to nsswitch.conf(5); remove cross references 
to resolv+(8)
 2005-12-13 15:22:17 +00:00
Michael Kerrisk 010b1b8e1c Typo fix 2005-12-12 09:27:49 +00:00
Michael Kerrisk 86cfe9cb9e New documentation for the glibc specific fmemopen() and 
open_memstream().
 2005-12-08 16:15:17 +00:00
Michael Kerrisk a0aa388db9 Rearranged EAI_* list alphabetically. 2005-12-06 15:18:03 +00:00
Michael Kerrisk 6a7f0c48ab Formatting fix 2005-12-06 15:13:12 +00:00
Michael Kerrisk 9b7116b18f Added GLIBC NOTES describing feature test macros required 
to expose declaration of inet_aton().
 2005-12-06 10:34:54 +00:00
Michael Kerrisk fed1575042 Delete line that should have been deleted when applying 
2.08 fix for this page.
 2005-12-05 09:30:10 +00:00
Michael Kerrisk 456107929b Some text that should have been a comment was not .\"-ed. 2005-12-01 09:10:11 +00:00
Michael Kerrisk 500d7ebccb Various changes, notably more detail on FIXMEs 2005-11-30 13:33:11 +00:00
Michael Kerrisk ed149213f2 Minor changes 2005-11-29 17:59:53 +00:00
Michael Kerrisk 3bf6b2a437 Links to sigset.3 2005-11-29 17:42:57 +00:00
Michael Kerrisk 53191f2f12 New page describing Sysatem V signal API. 2005-11-29 17:40:16 +00:00
Michael Kerrisk 46c721e7b5 Added sigset(3) to SEE ALSO 2005-11-29 17:39:29 +00:00
Michael Kerrisk 9fe51d8dd9 Fixed SEE ALSO 2005-11-29 15:24:57 +00:00
Michael Kerrisk 40f5483976 Some minor wording fixes; clarified System V origins of 
X/Open flavour of this function.
 2005-11-29 15:13:21 +00:00
Michael Kerrisk 30ecea55d4 Changed SEE ALSO to reflect movement of sig* pages between sections. 2005-11-29 15:01:54 +00:00
Michael Kerrisk e3f86a1c91 Moved to section 3. 2005-11-29 14:58:23 +00:00
Michael Kerrisk 2368c06331 Links to sigvec.3 2005-11-29 14:54:39 +00:00
Michael Kerrisk 9c2866d728 New page describing BSD signal API. 2005-11-29 14:54:07 +00:00
Michael Kerrisk 1dba80288e [f]statvfs is now documented in Section 2. 2005-11-28 08:47:34 +00:00
Michael Kerrisk 7119b0d144 Added example program 2005-11-23 09:34:07 +00:00
Michael Kerrisk a4020d9ca4 Wording improvements for 'flag' and 'width' descriptions. 
Some wording changes to bring terminology closer to SUSv3.
 2005-11-23 09:01:15 +00:00
Michael Kerrisk ee14b2e09f Added GLIBC NOTES section describing padding and width specifiers. 2005-11-22 18:41:24 +00:00
Michael Kerrisk 8db74412a0 Add further text clarifying that %+ specifier is not supported 
in glibc2.
 2005-11-22 17:57:48 +00:00
Michael Kerrisk 29a7a0825a Remove description of non-existent %+ specifier. 2005-11-22 17:48:32 +00:00
Michael Kerrisk 3fa59745c5 Added FIXME 2005-11-22 15:54:50 +00:00
Michael Kerrisk c66f2b952d Added a GLIBC NOTES section describing sigisemptyset(), 
sigandset(), and sigorset().
 2005-11-21 14:50:40 +00:00
Michael Kerrisk 1279fe798c Fix typo 2005-11-21 08:52:27 +00:00
Michael Kerrisk 87cee315d8 An almost total rewrite! 2005-11-17 17:55:27 +00:00
Michael Kerrisk 817e5eab95 Formerly, the pge said that all systems declare memalign() in 
<malloc.h>.  In fact, many declare it in <stdlib.h>.
 2005-11-15 18:17:08 +00:00
Michael Kerrisk 55b447e61f Formatting fix 2005-11-15 17:57:53 +00:00
Michael Kerrisk f820196915 Although the glibc implementation returns -1 on error (and some 
other man pages (e.g., the BSDs) also document that value for 
error returns), SUSv3 merely says "non-zero" (and this is what 
manual pages on many implementations also say).
 2005-11-15 17:57:39 +00:00
Michael Kerrisk 054fccc0d1 Formatting fix 2005-11-15 17:56:36 +00:00
Michael Kerrisk a2af275c39 Fixed to point out that that frexp() returns a number whose 
*absolute* value is >= 0.5 and < 1.  Amended the example
program to demonstrate this.
 2005-11-14 14:19:52 +00:00
Michael Kerrisk 0bd5e3de9e Added comment 2005-11-03 14:29:44 +00:00
Michael Kerrisk 9a562e4236 New page taken from BSD (FreeBSD 5.4) 2005-11-03 14:27:02 +00:00
Michael Kerrisk bd12ab88af Formatting fixes 2005-11-03 12:47:27 +00:00
Michael Kerrisk 8478ee0279 Formatting fixes 2005-11-02 13:55:25 +00:00
Michael Kerrisk 836f07c1c3 Change things like "NULL-terminated string" to "null-terminated string" 2005-11-02 11:55:24 +00:00
Michael Kerrisk c02d27b62f space clean-up 2005-11-02 11:44:23 +00:00
Michael Kerrisk 31e9a9ec99 Change itacised function names and page xrefs to bold 2005-11-02 11:34:24 +00:00
Michael Kerrisk 8a9648b96f Formatting fixes 2005-11-02 11:10:24 +00:00
Michael Kerrisk 6e1ffb9817 Formatting fix 2005-10-28 13:43:45 +00:00
Michael Kerrisk a94dba21dc Formatting fixes 2005-10-28 13:35:35 +00:00
Michael Kerrisk bf93c935d1 s/GNU_SOURCE/_GNU_SOURCE/ 2005-10-28 13:27:52 +00:00
Michael Kerrisk d1a6e6ff04 Change <netinet/in.h> to <arpa/inet.h> in prototype; add text 
explaining that some systems need the former header.
As per Debian bug 265244
 2005-10-27 09:58:45 +00:00
Michael Kerrisk a749f870a8 s/XXX/FIXME/ 2005-10-26 11:27:52 +00:00
Michael Kerrisk 1e32103455 Formatting fixes 2005-10-20 15:11:10 +00:00
Michael Kerrisk f87925c6bf Formatting fixes 2005-10-19 16:30:05 +00:00
Michael Kerrisk bee2a27738 Fix capitalisations 2005-10-19 14:57:33 +00:00
Michael Kerrisk 4d52e8f81c Formatting fixes 2005-10-19 14:54:31 +00:00
Michael Kerrisk b5cc2ffbaa Formatting fixes 2005-10-19 14:48:35 +00:00
Michael Kerrisk 4a225b7a41 Formatting fixes 2005-10-19 14:16:57 +00:00
Michael Kerrisk 35e21ba7ca Formatting fixes 2005-10-19 13:48:50 +00:00
Michael Kerrisk d302a9a9c3 spelling fixx 2005-10-19 13:20:29 +00:00
Michael Kerrisk 9ef334c7cc remove parens from function name in .SH NAME section 2005-10-19 13:19:53 +00:00
Michael Kerrisk 27e59a1f0b Minor wording fix 2005-10-19 13:18:58 +00:00
Michael Kerrisk 826b3f2763 Formatting fix 2005-10-19 13:17:47 +00:00
Michael Kerrisk 1c4700c568 Minor change to RETURN VALUE text. 2005-10-19 13:15:49 +00:00
Michael Kerrisk 3382bd94ff Manual fixes of parentheses formatting 2005-10-19 08:35:30 +00:00
Michael Kerrisk e1d6264d9f Manual fixes for parentheses formatting 2005-10-19 07:29:28 +00:00
Michael Kerrisk 63aa9df02f Automated unformatting of parentheses using unformat_parens.sh 2005-10-19 07:07:02 +00:00
Michael Kerrisk e511ffb6bc Automated addition of parentheses by add_parens_for_own_funcs.sh 2005-10-19 06:54:38 +00:00
Michael Kerrisk 834fec09e7 Removed references to fropen() and fwopen(), which are 
BSDisms that don't appear in glibc.
As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=331174
 2005-10-12 14:11:30 +00:00
Michael Kerrisk 88ab292b0d Added SEE ALSO for pty.7 2005-10-10 13:14:12 +00:00
Michael Kerrisk 6546fec22c s/getrpcent/setrpcent/ (fix from Fedora man-pages-2.07-7). 2005-10-04 13:01:07 +00:00
Michael Kerrisk 6da0ad1883 Fix: s/acosh/atanh/ (fix from Fedora man-pages-2.07-7) 2005-10-04 12:48:05 +00:00
Michael Kerrisk 3302970d23 Typo fix: %Ry ==> %Ey [SUSv3 mentions...] (fix from Fedora man-pages-2.07-7). 2005-10-04 12:42:11 +00:00
Michael Kerrisk be9dccdff6 Improved "a+" description (fix from Fedora man-pages-2.07-7). 2005-10-04 12:35:17 +00:00
Michael Kerrisk 6b2fc2945f Add NOTES text describing relationship of pw_dir and HOME and 
pointing out that applications should preferentially
inspect HOME
 2005-09-21 12:02:23 +00:00
Michael Kerrisk 84a0a0510d Remove misleading text describing FreeBSD's sranddev() function. 
As per debian bug 328629
 2005-09-21 11:23:38 +00:00
Michael Kerrisk edac57cf3e Further fix of "one has..." test 2005-09-21 10:45:03 +00:00
Michael Kerrisk 52850de794 Change: 
One has carg(z) = atan(creal(z) / cimag(z))
to:
     One has carg(z) = atan(cimag(z) / creal(z))
 2005-09-19 14:08:50 +00:00
Michael Kerrisk 57734e8257 We don't have an rpc_secure.3 page in the set at the moment 2005-09-19 11:39:32 +00:00
Michael Kerrisk 9559eb50bb Mention "little endian" and "big endian". 
Added note about octal and hex interpretation of numbers-and-dots notation.
 2005-09-15 17:14:45 +00:00
Michael Kerrisk b8ebc9d9fe Added "#define _GNU_SOURCE" to prototype 2005-09-15 12:40:42 +00:00
Michael Kerrisk e4ce80c966 s/SOL_IP/IPPROTO_IP/ 2005-08-16 11:50:53 +00:00
Michael Kerrisk 279d6eeaee glibc 2.3.4 fixed the "name contains '='" bug 2005-08-12 11:41:25 +00:00
Michael Kerrisk 8d18d6ed08 Added descriptions of AI_ALL, AI_ADDRCONFIG, AI_V4MAPPED, and AI_NUMERICSERV. 
Some wording and formatting fixes.
1,$s/PF_/AF_/g
 2005-08-09 11:40:12 +00:00
Michael Kerrisk 8194de3393 Nowadays (since 2.3.4) glibc only sets the first ai_canonname 
field if AI_CANONNAME was specified (the current
behavior is all that SUSv3 requires).
 2005-08-09 10:10:29 +00:00
Michael Kerrisk 37894cb3e3 Add missing word 2005-08-04 14:01:47 +00:00
Michael Kerrisk f242322f35 s/-nostartupfiles/-nostartfiles/ 2005-07-20 07:53:07 +00:00
Michael Kerrisk 331da7c3a0 RFC references are now always writen as "RFC\ nnn" (not "RFC nnn" or 
"RFCnnn").
 2005-07-20 07:50:45 +00:00
Michael Kerrisk d355f1edc4 Formatting fixes 2005-07-19 16:23:19 +00:00
Michael Kerrisk 14ee3bff41 Formatting fixes 2005-07-19 15:38:39 +00:00
Michael Kerrisk a5e0a0e427 Formatting fixes. 2005-07-19 15:36:19 +00:00
Michael Kerrisk 34c97781c7 s/id/ID/ 2005-07-19 06:20:42 +00:00
Michael Kerrisk 5e8051e66d pseudotteudo-tty" terminology clean-up 2005-07-18 17:10:04 +00:00
Michael Kerrisk 357cf3fe97 id --> ID 2005-07-18 16:02:32 +00:00
Michael Kerrisk e75a454257 gid --> GID 2005-07-18 15:54:49 +00:00
Michael Kerrisk fdc196f51f uid --> UID 2005-07-18 15:51:22 +00:00
Michael Kerrisk b14d4aa5b8 Classical BSD versions are now always named x.yBSD (formerly 
there was a mix of x.yBSD and BSD x.y).
 2005-07-18 15:05:56 +00:00
Michael Kerrisk 880f5b4bc3 Consistent use of "set-user-ID" and "set-group-ID". 2005-07-18 14:25:42 +00:00
Michael Kerrisk df8a3cac32 hyphen/dash fixes 2005-07-18 12:43:00 +00:00
Michael Kerrisk 3413174560 Hyphen/dash fixes 2005-07-18 08:37:13 +00:00
Michael Kerrisk a8431b7bfb Added SEE ALSO for canonicalize_file_name(3) 2005-07-14 14:56:39 +00:00
Michael Kerrisk 4ff2a3ba99 Walter's version said too much 2005-07-14 14:55:50 +00:00
Michael Kerrisk bc69fad6f8 New page from Walter Harms 2005-07-14 13:55:28 +00:00
Michael Kerrisk 4897420e09 Fixed missing word. 2005-07-14 13:49:21 +00:00
Michael Kerrisk 991910a43a various parts substantially rewritten; added description of 
%n$ form; various text incorporated from the GNU C library
documentation ((C) The Free Software Foundation).
 2005-07-14 13:48:54 +00:00
Michael Kerrisk 3d85977518 fix hsearch_r() proto 2005-07-08 10:22:22 +00:00
Michael Kerrisk 8c383102d0 hyphen/dash fixes 2005-07-07 08:27:03 +00:00
Michael Kerrisk 2bc2f4798f hyphen/dash fixes 2005-07-06 12:57:38 +00:00
Michael Kerrisk fba59d25ec Eliminate consecutive duplicate words 2005-07-06 11:21:27 +00:00
Michael Kerrisk c65433e6a5 hyphen/dash fixes. 2005-07-06 08:00:30 +00:00
Michael Kerrisk 21cb07dc53 formatting fixes 2005-07-06 07:53:36 +00:00
Michael Kerrisk 4d9b698450 Hyphenation/dash fixes 2005-07-06 07:41:37 +00:00
Michael Kerrisk bf0cac282c Modified details of how user and group ownership of a new object are set. 
Various minor wording and formatting cleanups.
 2005-07-05 14:22:14 +00:00
Michael Kerrisk 61f4934a34 s/the the/the/ 2005-07-05 13:53:03 +00:00
Michael Kerrisk 05461740b0 Replace mention of /etc/shadow by refernces to 
"shadow password database", and LDAP and NIS.
As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=316117
Miscellaneous wording improvements
Consistent DESCRIPTION wording vis-a-vis getpwnam.3 etc.
 2005-07-04 08:59:13 +00:00
Michael Kerrisk f936cf268d Minor wording changes 2005-07-04 08:58:13 +00:00
Michael Kerrisk d2cf948954 Relocate misplaced text describing gai_strerror(). 2005-07-04 07:39:01 +00:00
Michael Kerrisk 88abec49a2 s/endservent/endnetent/ 2005-07-04 06:54:12 +00:00
Michael Kerrisk f2738b392c Replace mention of /etc/{passwd,group} by refernces to 
"passwd/group database", and LDAP and NIS.
As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=316117

Miscellaneous wording improvements
Consistent DESCRIPTION and ERRORS wording across these pages.
 2005-07-01 16:50:33 +00:00
Michael Kerrisk 95b18bae5c Fix typo 2005-07-01 14:35:51 +00:00
Michael Kerrisk c9c3b6f3aa Added SEE ALSO putgrent(3) 2005-06-28 07:26:52 +00:00
Michael Kerrisk b956004699 Spelling/typo fixes 2005-06-24 14:44:16 +00:00
Michael Kerrisk 9fdfa163e5 Typos fixes from A Costa (16 May 05, Debian "manpages"). 2005-06-24 14:17:21 +00:00
Michael Kerrisk 3243fedf10 The return value of isinf() changed in glibc 2.02 
to differentiate positive and neagtive infinity.
See: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=285765
 2005-06-24 12:38:56 +00:00
Michael Kerrisk 016c9c3d5c strtold() and strtof() need _ISOC99_SOURCE of _XOPEN_SOURCE=600 
As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=246668
 2005-06-24 11:29:39 +00:00
Michael Kerrisk b559f81802 Added tdestroy to .TH line 2005-06-23 14:17:03 +00:00
Michael Kerrisk dc59ae5332 New link to tsearch.3 2005-06-23 14:16:40 +00:00
Michael Kerrisk a03d317bf7 Added definition of Linux dirent structure. 
Some formatting cleanups.
 2005-06-23 14:08:59 +00:00
Michael Kerrisk 08f75afe48 Added #define _BSD_SOURCE to prototype 2005-06-23 13:50:48 +00:00
Michael Kerrisk 1b825ab4b4 Noted use of atexit() for establishing function to be invoked on shared library 
unload.
Noted that atexit()-registered functions are not invoked on abnormal
termination.
Formatting fixes.
 2005-06-23 10:01:26 +00:00
Michael Kerrisk 87ed9800a4 Formatting fixes 2005-06-23 09:58:22 +00:00
Michael Kerrisk a210091ced Reversed 2.04 introduction of the term "process termination function". 
Minor rewording and formatting fixes.
 2005-06-23 09:47:01 +00:00
Michael Kerrisk 18f2ce4067 Reversed 2.04 introduction of the term "process termination function". 2005-06-23 09:45:21 +00:00
Michael Kerrisk 4b4a8feb2d Minor fixes 2005-06-22 07:19:03 +00:00
Michael Kerrisk b6a37c735b Added ERANGE error 2005-06-21 16:03:30 +00:00
Michael Kerrisk 7747fbdca6 Fixed descriptotion of header file reqmts in prototype, 2005-06-21 14:44:34 +00:00
Michael Kerrisk f10e41020d Fix description of return value. 2005-06-21 13:47:59 +00:00
Michael Kerrisk 9331995aab Add log1p(3) to SEE ALSO. 
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=309578
 2005-06-21 13:00:02 +00:00
Michael Kerrisk 961abb97af Fix typo: "_SC_2_DEV" should be "_SC_2_C_DEV" 2005-06-21 11:30:37 +00:00
Michael Kerrisk 3678235c1f When specifying resolved_path as NULL, realpath() 
will (still) only allocate up to PATH_MAX bytes.
Plus other minor changes.
See also http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=239424
 2005-06-21 11:20:42 +00:00
Michael Kerrisk 6e657687f9 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=194842 
Because RAND_MAX is equal to INT_MAX, the following expression
contained in the manpage for rand(3) is slightly incorrect.
j=1+(int) (10.0*rand()/(RAND_MAX+1.0));

The correct expression should use parentheses to group the division
before the multiplication, thus yielding:
j=1+(int) (10.0*(rand()/(RAND_MAX+1.0)));

This is not an error where 10.0 is a floating point number, however
where 10.0 is replaced with an integer, this will cause the expression
to always evaluate to 1. (The addition of two parentheses would make
this bug a lot more difficult to make.)
 2005-06-21 09:22:02 +00:00
Michael Kerrisk 3876c0e522 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=118752 2005-06-21 08:55:14 +00:00
Michael Kerrisk 1b05fb00b3 Changed (char *) to (void *) in example. 
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=313607
 2005-06-17 13:34:00 +00:00
Michael Kerrisk 475f1bca2c Arg for %p is a pointer to _a pointer to_ void. 
As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=263109
 2005-06-17 13:06:58 +00:00
Michael Kerrisk 6a4c2e3618 freopen(3) can change file descriptor associations of stin/stdout/stderr 2005-06-16 16:10:05 +00:00
Michael Kerrisk b99cf1e0e8 strerror_r(3) requires #define _XOPEN_SOURCE 600 2005-06-16 16:09:25 +00:00
Michael Kerrisk 4f90a5f34e Removed erroneous description of makecontext() return value. 
As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=311800
 2005-06-16 14:37:57 +00:00
Michael Kerrisk 8729177b44 global edit s/ -1/ \\-1/g 2005-06-15 14:10:23 +00:00
Michael Kerrisk f59a3f1941 Global edit: s/nonzero/non-zero/ 2005-06-15 13:32:34 +00:00
Michael Kerrisk 54221c6a41 Various minor changes 2005-06-14 11:25:12 +00:00
Michael Kerrisk 027df6e02d Wording improvements 2005-06-14 11:22:23 +00:00
Michael Kerrisk 5af3e8eeee Wording improvements 2005-06-14 11:22:06 +00:00
Michael Kerrisk 5984622e7b Added_CS_GNU_LIBC_VERSION and_CS_GNU_LIBPTHREAD_VERSION. 2005-05-09 10:53:56 +00:00
Michael Kerrisk 0359df8c95 Added FIXME 2005-05-09 10:37:48 +00:00
Michael Kerrisk 704a18f06d Fixed typos and spelling mistakes 2005-04-18 13:35:29 +00:00
Michael Kerrisk c93df97462 Removed SEE ALSO reference to non-existent newctime(3) 2005-04-06 13:10:34 +00:00
Michael Kerrisk 7257eeb80e Added description of strcasestr(). 2005-04-05 14:01:07 +00:00
Michael Kerrisk bbcdba9c19 Link to strstr.3 2005-04-05 14:00:36 +00:00
Michael Kerrisk b6dd43ba57 Heikki Orsila <shd@modeemi.cs.tut.fi>: 
bcopy handles overlapping case, but memcpy does not,
so for consistency memmove should be also mentioned.
 2005-04-04 17:03:48 +00:00
Michael Kerrisk b4ab6f83e1 "may not" --> "should not", after suggestion from 
Sasa Stevanovic <mg94c18@alas.matf.bg.ac.yu>
 2005-04-04 09:27:23 +00:00
Michael Kerrisk d5d202ca89 Link to man3/getmntent.3 2005-03-31 14:17:46 +00:00
Michael Kerrisk 7f564f717e Noted that SUSv2 allowed a range of 00 to 61 for %S specifier. 2005-03-31 13:22:34 +00:00
Michael Kerrisk 3047394a62 Tony Crawford 
As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=270817
Formulae on the pages should be T = S / C not T = C / S.
 2004-12-20 13:43:09 +00:00
Michael Kerrisk dc23fde14f Pedro Zorzenon 
as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=242638
    Noted use of _XOPEN_SOURCE to get macros <sytdlib.h>
    as for wait(2).

mtk
    Changed name of argument from 'string' to 'command' (like POSIX).

    Noted that glibc does nowadays explicitly check for the existence
    of the shell if 'command' is NULL, rather than the older behaviour
    of assuming the shell exists and always returning 1 if
    'command' is NULL.

    Other wording and formatting clean-ups.
 2004-12-20 13:24:38 +00:00
Michael Kerrisk cca657e227 triggered by http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=283179 
The wording describing how errno is set was tidied up in a number of
pages.
 2004-12-20 12:24:06 +00:00
Michael Kerrisk 0c00f46ce7 Cartsen Hey 
as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=276248

    Changed range for "%S" from 0..61 to 0..60.

    SUSv3 says 0..60.  I think the manual page probably says
    0..61, because that's what SUSv2 said.
    (Some other implementations' man pages also say 0..61 --
    e.g., Solaris 8 & 9, Tru64 5.1B; FreeBSD 5.1 says 0..60.)

    The glibc manual currently says 0..60.

    Given that SUSv3 says 0..60, I've changed this the
    manual page to also say this:

        -The second as a decimal number (range 00 to 61).
        +The second as a decimal number (range 00 to 60).
        +(The range is up to 60 to allow for occasional leap seconds.)
 2004-12-20 11:22:11 +00:00
Michael Kerrisk d536842d52 Marek Habersack <grendel@debian.org> 
.SH "CONFORMING TO"
-BSD 4.4
+BSD 4.4, SUSv3
as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=234443
 2004-12-20 10:54:45 +00:00
Michael Kerrisk 50a0922f20 Johannes Berg / http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=226974 
-.BR POSIX2_FORT_RUN " - " _SC_2_FORT_DEV
        +.BR POSIX2_FORT_DEV " - " _SC_2_FORT_DEV<F2>
 2004-12-20 10:45:56 +00:00
Michael Kerrisk a2ef1094f4 Fix typo as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=224953 
Changed erroneous "aio_return(2)" to "aio_return(3)"
 2004-12-20 10:14:48 +00:00
Michael Kerrisk d49daffc1a Joshua Kwan 
Added _GNU_SOURCE to prototype
as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=213538
 2004-12-17 15:10:49 +00:00
Michael Kerrisk e03e2055bc add <fcntl.h> to synopsis 2004-12-17 14:05:55 +00:00
Michael Kerrisk 5f59e24802 Fix typo 2004-12-17 13:52:17 +00:00
Michael Kerrisk 4710caba23 New my mtk 2004-12-17 12:53:02 +00:00
Michael Kerrisk a856c2ea74 Changed SEE ALSO 2004-12-17 12:46:00 +00:00
Michael Kerrisk 85eb6f2852 Minor wording 2004-12-17 12:40:52 +00:00
Michael Kerrisk 0543288347 Martin Schulze, mtk 
Removed errno declaration from prototype, added notes
on historical need for this declaration.
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=174175
 2004-12-17 12:20:07 +00:00
Michael Kerrisk 3124d276bf Changed "pseudotty" to "pseudo-terminal" 2004-12-17 11:28:00 +00:00
Michael Kerrisk f677764ce0 Remove funtions that *are* documented. 2004-12-17 11:23:45 +00:00
Michael Kerrisk e0425d7a7c New link to ptsname.3 2004-12-17 11:23:16 +00:00
Michael Kerrisk 728976484c Added ptsname_r() and ERRORS 2004-12-17 11:22:41 +00:00
Michael Kerrisk b05200f368 Change section number in page from 2 to 3 2004-12-17 10:17:35 +00:00
Michael Kerrisk 2ff9c803a9 Added SEE ALSO cross refs 2004-12-15 16:42:57 +00:00
Michael Kerrisk 9c59ace465 Removed unused variable in EXAMPLE 
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=262567

[[
In va_arg(3), the example function foo (section EXAMPLES, not
COMPARISON) has an unused variable: char *p.
]]
 2004-12-15 16:23:30 +00:00
Michael Kerrisk 3d4d911624 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=229618 
getnameinfo() does not set errno, it returns a non-zero
value indicating the error.

added EAI_OVERFLOW error
 2004-12-15 16:10:55 +00:00
Michael Kerrisk 51c0e854fb Fix typo 2004-12-15 15:21:11 +00:00
Michael Kerrisk 7841ad4741 Added discussion of resolved_path == NULL 2004-12-15 15:18:55 +00:00
Michael Kerrisk 898e9a87df Hello Joey, 
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=205736

[[
This example contains the following line:

    if ((p = realloc (p, size)) == NULL)
       return NULL;

This is a very ill written code, since realloc returning
NULL do not deallocate the original memory block. Such a 
statement has a potential to become significant memory
hole. I suggest to correct this example since:

1. It may trick naive programmers to write bad code
2. It may lead skeptic observers to the believe 
   the whole Linux is written in a similar style.
   

Regards Jan Kuznik 
]]

This guy is right on the money!

I've changed that example, so that the above code has been replaced by:

    char *np;

    ...


    if ((np = realloc (p, size)) == NULL) {
        free(p);
        return NULL;
    } else {
        p = np;
    }

Cheers,

Michael
 2004-12-14 18:25:46 +00:00
Michael Kerrisk 2d5e8aeb73 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=271239 
[[
shm_open(3) refers to O_RWDR during discussion of the possible values of
oflags, and later refers to O_RDWR.  The reference to O_RWDR is
incorrect (likely a typo) and should be changed to O_RDWR.
]]
 2004-12-14 18:09:58 +00:00
Michael Kerrisk dae9ac9139 bugs.debian.org/cgi-bin/bugreport.cgi?bug=237305 
[[
*** cmsg.3.patch
151c151
<      cmsg = CMSG_NXTHDR(&msgh,cmsg) {
---
>      cmsg = CMSG_NXTHDR(&msgh,cmsg)) {

]]
 2004-12-14 18:04:59 +00:00
Michael Kerrisk 4c39c55c47 The assert failure messages goes to stderr not stdout. 
As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=284814
 2004-12-14 17:46:41 +00:00
Michael Kerrisk 3ba7aed4ab Minor wording changes 2004-12-13 15:39:11 +00:00
Michael Kerrisk 1043e25b6f New page from Andries Brouwer 2004-12-13 12:42:20 +00:00
Michael Kerrisk 67b715573a Richard.Kreckel@ginac.de 
Change "NULL" to "empty" when talking about the value of TZ.
http://sources.redhat.com/bugzilla/show_bug.cgi?id=601
 2004-12-08 14:54:16 +00:00
Michael Kerrisk 122dff10a6 Small fixes from mtk and Martin Schulze 2004-12-01 14:10:12 +00:00
Michael Kerrisk 6b79fcd53e small fixes from Martin Schulze 2004-12-01 13:56:47 +00:00
Michael Kerrisk 3e53c142b7 Noted that 0 tm_day == last day of preceding month 2004-11-16 13:35:20 +00:00
Michael Kerrisk 462a7bad96 Added "Compile with -std=c99" as suggested by Fabian Kreutz 2004-11-16 11:01:14 +00:00
Michael Kerrisk 4e050476e1 Change suggested by Fabian Kreutz 2004-11-15 13:11:26 +00:00
Michael Kerrisk 7440ec4c09 Fix typo 2004-11-15 12:35:29 +00:00
Michael Kerrisk 3626880689 Added SEE ALSO entries suggested by Fabian Kreutz 2004-11-15 11:59:59 +00:00
Michael Kerrisk d77a26b737 Added SEE ALSO fenv(3) 2004-11-15 11:41:22 +00:00
Michael Kerrisk 4022b76eb8 Added FLT_ROUNDS text as proposed by AEB/Fabian Kreutz 2004-11-15 10:55:23 +00:00
Michael Kerrisk fe71be4b36 fixed error noted by Fabian Kreutz 2004-11-15 08:24:41 +00:00
Michael Kerrisk b45280206e Updates as per suggestions from Fabian Kreutz and AEB 2004-11-12 18:01:15 +00:00
Michael Kerrisk 94426bbfe6 this function is not available in glibc2 (Fabian Kreutz/AEB) 2004-11-12 17:39:18 +00:00
Michael Kerrisk 9dc0b7df22 Added note emphasizing difference in type or return value and funtion argument, as suggested by Fabian Kreutz 2004-11-12 17:18:23 +00:00
Michael Kerrisk 2f5039e158 Added recommendation to use sprintf() as per suggestion of Fabian Kreutz 2004-11-12 16:48:44 +00:00
Michael Kerrisk e6a5772cab These links to frexp.3 were missing 2004-11-12 16:26:12 +00:00
Michael Kerrisk 608e2ed94f a formatting fix 2004-11-12 16:25:23 +00:00
Michael Kerrisk c81ed289dd Link as suggested by AEB/Fabian Kreutz 2004-11-12 14:50:51 +00:00
Michael Kerrisk ba283ad293 Added remquo(3) under SEE ALSO as per AEB's suggestion 2004-11-11 17:54:23 +00:00
Michael Kerrisk d39541ec41 Compressed synopsis as per Fabian Kreutz's suggestion 2004-11-11 17:28:42 +00:00
Michael Kerrisk 78f81fc786 Added sigqueueu(2) to SEE ALSO; changed CONFORMING TO 2004-11-11 14:07:09 +00:00
Michael Kerrisk 2c8d1c7d5e changed spelling of "super-user" to "superuser" 2004-11-10 18:17:26 +00:00
Michael Kerrisk 1bf89c6083 Formatting fix 2004-11-10 17:11:31 +00:00
Michael Kerrisk 305a0578bf Global change of email address for MTK (now: mtk-manpages@gmx.net) 2004-11-03 14:43:40 +00:00
Michael Kerrisk fea681dafb Import of man-pages 1.70 2004-11-03 13:51:07 +00:00