Commit Graph

22934 Commits

Author SHA1 Message Date
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 66231752c9 2004-12-17 15:28:44 +00:00
Michael Kerrisk cf257cc501 Adjusted descriptors of argument file tyypes to be closer to
2.6 reality.
Wording and formatting changes
2004-12-17 15:27:42 +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 f54bed586e Initial setup for 2.01 release 2004-12-17 08:56:04 +00:00
Michael Kerrisk 105a35bc69 Changed size 2004-12-16 16:34:39 +00:00
Michael Kerrisk db81675e71 2004-12-16 15:39:14 +00:00
Michael Kerrisk 2180930213 2004-12-16 15:38:14 +00:00
Michael Kerrisk dde6ab6cd5 Changed size 2004-12-16 15:08:45 +00:00
Michael Kerrisk 063ef8c3a7 2.00 release files 2004-12-16 14:54:51 +00:00
Michael Kerrisk 9fe6a80667 2004-12-16 14:51:54 +00:00
Michael Kerrisk 168df94099 Enrico Zini
Added text to clarify that S_IS*() macros should be applied
to st_mode field.
as per: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=249698
2004-12-16 14:45:45 +00:00
Michael Kerrisk 8deb0f0d5b After bug report from John V. Belmonte
Updated init and quit scripts to reflect kernel 2.4/2.6 reality
     (Scripts taken from drivers/char/random.c)
     as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=247779
2004-12-16 14:24:00 +00:00
Michael Kerrisk d4e39a3e0a Renamed for 2.00 release 2004-12-15 17:33:21 +00:00
Michael Kerrisk 0ca68756a9 Changed CONFORMING TO 2004-12-15 17:30:03 +00:00
Michael Kerrisk 5c7ed5050a 2004-12-15 17:29:38 +00:00
Michael Kerrisk 3f800aa873 This is the change log of the current release! 2004-12-15 17:04:46 +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 631f43ca2d Added 'const' to declaration of 'my_addr' in prototype.
as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=239762
2004-12-15 15:35:02 +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 5d6d14a0c4 updated statm, and fixed error in order of list 2004-12-15 14:12:30 +00:00
Michael Kerrisk a7001bac67 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=210704
[[.TP  
 .B IP_TTL
 -Set or retrieve the current time to live field that is send in every
 packet
 -send from this socket.
 +Set or retrieve the current time to live field that is used in every
 packet
 +sent from this socket.
  
 .TP
 .B IP_HDRINCL
]]
2004-12-15 13:41:16 +00:00
Michael Kerrisk 526f4e1ffe Formatting fixes plus additional material in ERRORS 2004-12-15 13:37:09 +00:00
Michael Kerrisk e28334cee7 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=204292
[[
swapon(2) indicates that EINVAL wil lbe returned only if the path
specified does not exist or is not a block device.

The kernel will also return EINVAL is a swap signature is not detected
on the indicated path as well.
]]
2004-12-15 13:24:42 +00:00
Michael Kerrisk c6c4abc835 Fix typo 2004-12-14 18:39:17 +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 48dd5a6767 Changed
.TH UNIMPLEMENTED
to:
    .TH UNDOCUMENTED
as per
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=220741
2004-12-14 18:00:43 +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 4b62ba5094 Fixed as per: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=222145 2004-12-14 17:14:19 +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 8505c1f1d6 Date: Mon, 13 Dec 2004 12:09:43 +0100 (MET)
From: "Michael Kerrisk" <mtk-manpages@gmx.net>
To: Andries Brouwer <Andries.Brouwer@cwi.nl>
Subject: Re: errno

Hi Andries,

> On Fri, Dec 10, 2004 at 05:07:36PM +0100, Michael Kerrisk wrote:
> 
> > I added this text to fcntl.2:
> > 
> >     BUGS
> >        A  limitation of the Linux system call conventions means that
> >        if a (negative) process group ID to be returned  by  F_GETOWN
> >        falls  in  the  range  -1  to -4095, then the return value is
> >        wrongly interpreted by glibc as an error in the system  call;
> >        that  is,  the  return value of fcntl() will be -1, and errno
> >        will contain the (positive) process group ID.
> 
> Yes.
> 
> (Maybe glibc always did this, early libc considered any negative
> return value an error. On the other hand, not all the world is an i386 -
> IBM has just decided that we don't need any i386's anymore
> and sold their stuff to the Chinese - we must use PPC, as Linus
> does already - and on other architectures we do not have this
> ugliness, I think.)
> 
> You might consider adding "i386" somewhere:
>  A limitation of the Linux i386 system call conventions ...

Some testing on ia64 (RedHat EL 3.0, 2.4.21) and 
alpha (2.4.18, Debian 3.0) showed that any negative PGID value
causes F_GETOWN to fail.

My limited reading of the ia64 source:

sysdeps/unix/sysv/linux/ia64/sysdep.h

shows that there is a comment about the -4095 value there, 
but that doesn't seem to reflect the reality of the code.

Reading the source, the -4095 limit seems to hold on some 
other architectures, e.g.:

sysdeps/unix/sysv/linux/m68k/sysdep.h
sysdeps/unix/sysv/linux/hppa/sysdep.h
sysdeps/unix/sysv/linux/s390/s390-32/sysdep.h
sysdeps/unix/sysv/linux/s390/s390-64/sysdep.h
sysdeps/unix/sysv/linux/x86_64/sysdep.h

Unfortunately, I have no non-x86 systems other than the above 
alpha and ia64 (HP-testdrive) on which I can test.

I modified the text a little:

   BUGS
       A  limitation  of the Linux system call conventions on some
       architectures (notably x86) means that if a (negative) pro&#8208;
       cess group ID to be returned by F_GETOWN falls in the range
       -1 to -4095, then the return value is  wrongly  interpreted
       by  glibc  as  an  error  in  the system call; that is, the
       return value of fcntl() will be -1, and errno will  contain
       the (positive) process group ID.

I've left a FIXME in the man page source noting that details have
yet to be sorted out for ia64, alpha, etc.
2004-12-13 11:32:37 +00:00
Michael Kerrisk d3c8b3e9b7 minor wording chnages 2004-12-13 08:58:09 +00:00