Updated FIXMEs

This commit is contained in:
Michael Kerrisk 2007-06-13 21:48:16 +00:00
parent 0724fd8f28
commit 0e1ad98ccf
17 changed files with 25 additions and 25 deletions

View File

@ -118,7 +118,7 @@ The root directory is left unchanged by
FreeBSD has a stronger
.BR jail ()
system call.
.\" FIXME -- eventually say something about containers,
.\" FIXME . eventually say something about containers,
.\" virtual servers, etc.?
.SH "SEE ALSO"
.BR chdir (2),

View File

@ -147,7 +147,7 @@ On Linux this command can only change the
and
.BR O_NONBLOCK
flags.
.\" FIXME According to POSIX.1-2001, O_SYNC should also be modifiable
.\" FIXME . According to POSIX.1-2001, O_SYNC should also be modifiable
.\" via fcntl(2), but currently Linux does not permit this
.\" See http://bugzilla.kernel.org/show_bug.cgi?id=5994
.SS "Advisory locking"
@ -915,11 +915,10 @@ that is, the return value of
will be \-1, and
.I errno
will contain the (positive) process group ID.
.\" FIXME Dec 04: some limited testing on alpha and ia64 seems to
.\" mtk, Dec 04: some limited testing on alpha and ia64 seems to
.\" indicate that ANY negative PGID value will cause F_GETOWN
.\" to misinterpret the return as an error. Some other architectures
.\" seem to have the same range check as x86. Must document
.\" the reality on other architectures -- MTK
.\" seem to have the same range check as x86.
In Linux 2.4 and earlier, there is bug that can occur
when an unprivileged process uses

View File

@ -30,7 +30,7 @@ get_mempolicy \- Retrieve NUMA memory policy for a process
.BI " unsigned long " maxnode ", unsigned long " addr ,
.BI " unsigned long " flags );
.fi
.\" FIXME rewrite this. it is confusing.
.\" FIXME rewrite this DESCRIPTION. it is confusing.
.SH DESCRIPTION
.BR get_mempolicy ()
retrieves the NUMA policy of the calling process or of a memory address,
@ -121,7 +121,7 @@ on error, \-1 is returned and
.I errno
is set to indicate the error.
.\" .SH ERRORS
.\" FIXME writeme -- no errors are listed on this page
.\" FIXME -- no errors are listed on this page
.\" .
.\" .TP
.\" .B EINVAL

View File

@ -51,7 +51,8 @@ sets the port access permission bits for the calling process for
If \fIturn_on\fP is non-zero, the calling process must be privileged
.RB ( CAP_SYS_RAWIO ).
.\" FIXME is the following still true? Looking at changes in
.\" FIXME is the following ("Only the first 0x3ff I/O ports can be
.\" specified in this manner") still true? Looking at changes in
.\" include/asm-i386/processor.h between 2.4 and 2.6 suggests
.\" that the limit is different in 2.6.
Only the first 0x3ff I/O ports can be specified in this manner.

View File

@ -60,7 +60,7 @@ and
.I bytecount
must equal the size of this structure.
.\"
.\" FIXME, say something about func == 2 ans func == 0x11?
.\" FIXME ? say something about func == 2 and func == 0x11?
.\" In Linux 2.4, func == 2 returned "the default ldt"
.\" In Linux 2.6, func == 2 is a nop, returning a zeroed out structure.
.\" Linux 2.4 and 2.6 implement an operation for func == 0x11

View File

@ -242,7 +242,7 @@ This flag is intended for use by indexing or backup programs,
where its use can significantly reduce the amount of disk activity.
This flag may not be effective on all filesystems.
One example is NFS, where the server maintains the access time.
.\" FIXME? The O_NOATIME flag also affects the treatment of st_atime
.\" The O_NOATIME flag also affects the treatment of st_atime
.\" by mmap() and readdir(2), MTK, Dec 04.
.TP
.B O_NOCTTY
@ -396,7 +396,7 @@ refers to a regular file, too large to be opened; see O_LARGEFILE above.
(POSIX.1-2001 specifies the error
.B EOVERFLOW
for this case.)
.\" FIXME Maybe this deviation from the standard will get repaired.
.\" FIXME . Maybe this deviation from the standard will get repaired.
.\" See http://bugzilla.kernel.org/show_bug.cgi?id=7253
.\" "Open of a large file on 32-bit fails with EFBIG, should be EOVERFLOW"
.\" Reported 2006-10-03
@ -589,7 +589,7 @@ when calling
use
.BR fcntl (2)
to enable this flag.
.\" FIXME Check bugzilla report on open(O_ASYNC)
.\" FIXME . Check bugzilla report on open(O_ASYNC)
.\" See http://bugzilla.kernel.org/show_bug.cgi?id=5993
.SH "SEE ALSO"
.BR close (2),

View File

@ -150,7 +150,7 @@ The
.I flags
parameter is the bitwise OR
of zero or more of the following flags.
.\" FIXME? document MSG_PROXY (which went away in 2.3.15)
.\" FIXME ? document MSG_PROXY (which went away in 2.3.15)
.TP
.BR MSG_CONFIRM " (Linux 2.3+ only)"
Tell the link layer that forward progress happened: you got a successful

View File

@ -113,7 +113,7 @@ on error, \-1 is returned and
.I errno
is set to indicate the error.
.\" .SH ERRORS
.\" FIXME writeme -- no errors are listed on this page
.\" FIXME no errors are listed on this page
.\" .
.\" .TP
.\" .B EINVAL

View File

@ -116,7 +116,7 @@ in the parent process depended on knowing which variables are
held in a register.
.SH "CONFORMING TO"
4.3BSD, POSIX.1-2001.
.\" FIXME Mar 07: in the draft of the next POSIX revision, the spec for
.\" FIXME . Mar 07: in the draft of the next POSIX revision, the spec for
.\" vfork() has been removed. See if this remains so in final version.
The requirements put on
.BR vfork ()

View File

@ -121,7 +121,7 @@ This byte is
included in the size value stored at
.IR sizeloc .
.\"
.\" FIXME The glibc info doc has text like the following, but it appears
.\" FIXME . The glibc info doc has text like the following, but it appears
.\" not to be true: http://sourceware.org/bugzilla/show_bug.cgi?id=1996
.\" The stream's file position can be changed with
.\" .BR fseek (3)

View File

@ -6,7 +6,7 @@
netlink \- Netlink macros
.SH SYNOPSIS
.nf
.\" FIXME what will glibc 2.1 use here?
.\" FIXME . what will glibc 2.1 use here?
.\" May 2007: glibc 2.5, things look to be unchanged -- the header file
.\" is still linux/netlink.h -- mtk
.B #include <asm/types.h>
@ -54,7 +54,7 @@ NLMSG_DATA
Return a pointer to the payload associated with the passed
.IR nlmsghdr .
.TP
.\" FIXME this is bizarre, maybe the interface should be fixed.
.\" this is bizarre, maybe the interface should be fixed.
NLMSG_NEXT
Get the next
.I nlmsghdr

View File

@ -78,7 +78,7 @@ bytes of data.
.SH BUGS
This manual page is lacking and incomplete.
.SH EXAMPLE
.\" FIXME would be better to use libnetlink in the EXAMPLE code here
.\" FIXME ? would be better to use libnetlink in the EXAMPLE code here
Creating a rtnetlink message to set a MTU of a device.
.nf

View File

@ -121,7 +121,7 @@ On error,
returns \-1, with
.I errno
set to indicate the error.
.\" FIXME But as at 2.3.5, glibc's sigset() is broken for the
.\" FIXME . But as at 2.3.5, glibc's sigset() is broken for the
.\" SIG_HOLD case: it will only return SIG_HOLD if 'disp' is
.\" SIG_HOLD; if the signal is blocked, then sigset() should return
.\" SIG_HOLD even if 'disp' is specified as something other than
@ -236,7 +236,7 @@ the return value of a successful
should be
.BR SIG_HOLD .
Instead, the previous disposition of the signal is returned.
.\"FIXME This has been reported on 30 Nov 05 -- mtk
.\" FIXME . This has been reported on 30 Nov 05 -- mtk
.\" See http://sourceware.org/bugzilla/show_bug.cgi?id=1951
.\"
.\" The POSIX.1-2001 disposition of sigset() says:

View File

@ -50,6 +50,6 @@ C99.
.BR imaxdiv (3),
.BR strtoimax (3),
.BR strtoumax (3),
.\" FIXME the pages referred to by the following xrefs are not yet written
.\" FIXME . the pages referred to by the following xrefs are not yet written
.BR wcstol (3),
.BR wcstoul (3)

View File

@ -215,7 +215,7 @@ and you should retry with a bigger buffer to get all addresses.
When no error occurs the ioctl returns 0;
otherwise \-1.
Overflow is not an error.
.\" FIXME Slaving isn't supported in 2.2
.\" Slaving isn't supported in 2.2
.\" .
.\" .TP
.\" .BR SIOCGIFSLAVE ", " SIOCSIFSLAVE

View File

@ -34,7 +34,7 @@ sockets.
It is based on netlink messages, see
.BR netlink (7)
for more information.
.\" FIXME all these macros could be moved to rtnetlink(3)
.\" FIXME ? all these macros could be moved to rtnetlink(3)
.SS "Routing Attributes"
Some rtnetlink messages have optional attributes after the initial header:

View File

@ -165,7 +165,7 @@ Urgent data arrived.
.B SIGURG
is sent then.
T}
.\" FIXME The following is not true currently:
.\" FIXME . The following is not true currently:
.\" It is no I/O event when the connection
.\" is broken from the local end using
.\" .BR shutdown (2)