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

475 Commits

Author SHA1 Message Date
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