[Bug 26762] New: io_cancel manpage documented required headers are incomplete/wrong

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



https://bugzilla.kernel.org/show_bug.cgi?id=26762

           Summary: io_cancel manpage documented required headers are
                    incomplete/wrong
           Product: Documentation
           Version: unspecified
          Platform: All
        OS/Version: Linux
              Tree: Mainline
            Status: NEW
          Severity: normal
          Priority: P1
         Component: man-pages
        AssignedTo: documentation_man-pages@xxxxxxxxxxxxxxxxxxxx
        ReportedBy: yanegomi@xxxxxxxxx
        Regression: No


io_cancel(2) claims:

IO_CANCEL(2)               Linux Programmerâs Manual              IO_CANCEL(2)

NAME
       io_cancel - cancel an outstanding asynchronous I/O operation

SYNOPSIS
       #include <libaio.h>

       int io_cancel(aio_context_t ctx_id, struct iocb *iocb,
                     struct io_event *result);

       Link with -laio.

This doesn't compile though:

$ gcc -c test_iocancel.c
test_iocancel.c: In function âmainâ:
test_iocancel.c:5: error: âaio_context_tâ undeclared (first use in this
function)
test_iocancel.c:5: error: (Each undeclared identifier is reported only once
test_iocancel.c:5: error: for each function it appears in.)
test_iocancel.c:5: error: expected â;â before âctxâ
test_iocancel.c:9: error: âctxâ undeclared (first use in this function)
$ cat test_iocancel.c 
#include <libaio.h>
int
main(void)
{
    aio_context_t ctx;
    struct iocb cb;
    struct io_event res;

    return io_cancel(ctx, &cb, &res);
}
$ grep -r aio_context_t /usr/include/
/usr/include/linux/aio_abi.h:typedef unsigned long    aio_context_t;
$

The manpages are based off of Fedora 13, as is the image that I'm currently
running in VMware fusion.

$ yum list installed libaio
Loaded plugins: presto, refresh-packagekit
Installed Packages
libaio.i686                 0.3.109-2.fc13                
@released/$releasever

-- 
Configure bugmail: https://bugzilla.kernel.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are watching the assignee of the bug.--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html


[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux