Move AIO manual pages to librt.
authorSascha Wildner <saw@online.de>
Mon, 24 Dec 2012 22:24:03 +0000 (23:24 +0100)
committerSascha Wildner <saw@online.de>
Mon, 24 Dec 2012 22:24:59 +0000 (23:24 +0100)
While doing it, remove aio_waitcomplete(), as it has no librt (or POSIX)
counterpart.

Makefile_upgrade.inc
lib/libc/sys/Makefile.inc
lib/libc/sys/aio_waitcomplete.2 [deleted file]
lib/librt/Makefile
lib/librt/aio_cancel.3 [moved from lib/libc/sys/aio_cancel.2 with 96% similarity]
lib/librt/aio_error.3 [moved from lib/libc/sys/aio_error.2 with 96% similarity]
lib/librt/aio_read.3 [moved from lib/libc/sys/aio_read.2 with 98% similarity]
lib/librt/aio_return.3 [moved from lib/libc/sys/aio_return.2 with 96% similarity]
lib/librt/aio_suspend.3 [moved from lib/libc/sys/aio_suspend.2 with 96% similarity]
lib/librt/aio_write.3 [moved from lib/libc/sys/aio_write.2 with 98% similarity]

index 273870c..2c68093 100644 (file)
@@ -2103,6 +2103,20 @@ TO_REMOVE+=/usr/share/man/man9/VFS_INIT.9.gz
 TO_REMOVE+=/sbin/mknod
 TO_REMOVE+=/usr/share/man/cat8/mknod.8.gz
 TO_REMOVE+=/usr/share/man/man8/mknod.8.gz
+TO_REMOVE+=/usr/share/man/cat2/aio_cancel.2.gz
+TO_REMOVE+=/usr/share/man/man2/aio_cancel.2.gz
+TO_REMOVE+=/usr/share/man/cat2/aio_error.2.gz
+TO_REMOVE+=/usr/share/man/man2/aio_error.2.gz
+TO_REMOVE+=/usr/share/man/cat2/aio_read.2.gz
+TO_REMOVE+=/usr/share/man/man2/aio_read.2.gz
+TO_REMOVE+=/usr/share/man/cat2/aio_return.2.gz
+TO_REMOVE+=/usr/share/man/man2/aio_return.2.gz
+TO_REMOVE+=/usr/share/man/cat2/aio_suspend.2.gz
+TO_REMOVE+=/usr/share/man/man2/aio_suspend.2.gz
+TO_REMOVE+=/usr/share/man/cat2/aio_waitcomplete.2.gz
+TO_REMOVE+=/usr/share/man/man2/aio_waitcomplete.2.gz
+TO_REMOVE+=/usr/share/man/cat2/aio_write.2.gz
+TO_REMOVE+=/usr/share/man/man2/aio_write.2.gz
 
 .if ${MACHINE_ARCH} == "x86_64"
 TO_REMOVE+=/usr/sbin/stlstats
index a3c3158..367dbe6 100644 (file)
@@ -57,8 +57,6 @@ ${SPSEUDO}:
 
 .if ${LIB} == "c"
 MAN+=  _exit.2 accept.2 access.2 acct.2 adjtime.2 \
-       aio_cancel.2 aio_error.2 aio_read.2 aio_return.2 \
-       aio_suspend.2 aio_waitcomplete.2 aio_write.2 \
        bind.2 brk.2 \
        sys_checkpoint.2 chdir.2 chflags.2 \
        chmod.2 chown.2 chroot.2 clock_gettime.2 close.2 closefrom.2 \
diff --git a/lib/libc/sys/aio_waitcomplete.2 b/lib/libc/sys/aio_waitcomplete.2
deleted file mode 100644 (file)
index 5be885d..0000000
+++ /dev/null
@@ -1,138 +0,0 @@
-.\" Copyright (c) 1999 Christopher M Sedore.
-.\" All rights reserved.
-.\"
-.\" Redistribution and use in source and binary forms, with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\" 1. Redistributions of source code must retain the above copyright
-.\"    notice, this list of conditions and the following disclaimer.
-.\" 2. Redistributions in binary form must reproduce the above copyright
-.\"    notice, this list of conditions and the following disclaimer in the
-.\"    documentation and/or other materials provided with the distribution.
-.\"
-.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND
-.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
-.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
-.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
-.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
-.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
-.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
-.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\" $FreeBSD: src/lib/libc/sys/aio_waitcomplete.2,v 1.1.2.6 2001/12/14 18:34:00 ru Exp $
-.\" $DragonFly: src/lib/libc/sys/aio_waitcomplete.2,v 1.3 2004/03/11 12:28:51 hmp Exp $
-.\"
-.Dd January 19, 2000
-.Dt AIO_WAITCOMPLETE 2
-.Os
-.Sh NAME
-.Nm aio_waitcomplete
-.Nd wait for the next completion of an aio request
-.Sh LIBRARY
-.Lb libc
-.Sh SYNOPSIS
-.In aio.h
-.Ft int
-.Fn aio_waitcomplete "struct aiocb **iocbp" "struct timespec *timeout"
-.Sh DESCRIPTION
-The
-.Fn aio_waitcomplete
-function waits for completion of an asynchronous I/O request.
-Upon completion,
-.Fn aio_waitcomplete
-returns the result of the function and sets
-.Fa iocbp
-to point to the structure associated with the original request.
-If an asynchronous I/O request is completed before
-.Fn aio_waitcomplete
-is called, it returns immediately with the completed request.
-.Pp
-If
-.Fa timeout
-is a non-NULL pointer, it specifies a maximum interval to wait for a
-asynchronous I/O request to complete.
-If
-.Fa timeout
-is a NULL pointer,
-.Fn aio_waitcomplete
-waits indefinitely.
-To effect a poll, the
-.Fa timeout
-argument should be non-NULL, pointing to a zero-valued timeval structure.
-.Pp
-The
-.Fn aio_waitcomplete
-function also serves the function of
-.Fn aio_return ,
-thus
-.Fn aio_return
-should not be called for the control block returned in
-.Fa iocbp .
-.Sh RETURN VALUES
-If an asynchronous I/O request has completed,
-.Fa iocbp
-is set to point to the control block passed with the original request,
-and the status is returned as described in
-.Xr read 2 ,
-.Xr write 2 ,
-or
-.Xr fsync 2 .
-On failure,
-.Fn aio_waitcomplete
-returns
-.Dv -1 ,
-sets iocbp to
-.Dv NULL
-and sets
-.Va errno
-to indicate the error condition.
-.Sh ERRORS
-The
-.Fn aio_waitcomplete
-function fails if:
-.Bl -tag -width Er
-.It Bq Er EINVAL
-The specified time limit is invalid.
-.It Bq Er EAGAIN
-The process has not yet called
-.Fn aio_read
-or
-.Fn aio_write .
-.It Bq Er EINTR
-A signal was delivered before the timeout expired and before any
-asynchronous I/O requests completed.
-.It Bq Er EWOULDBLOCK
-.It Bq Er EINPROGRESS
-The specified time limit expired before any asynchronous I/O requests
-completed.
-.El
-.Sh SEE ALSO
-.Xr aio_cancel 2 ,
-.Xr aio_error 2 ,
-.Xr aio_read 2 ,
-.Xr aio_return 2 ,
-.Xr aio_suspend 2 ,
-.Xr aio_write 2 ,
-.Xr fsync 2 ,
-.Xr read 2 ,
-.Xr write 2
-.Sh STANDARDS
-The
-.Fn aio_waitcomplete
-function is specific to
-.Fx
-and
-.Dx .
-.Sh HISTORY
-The
-.Fn aio_waitcomplete
-function first appeared in
-.Fx 4.0 .
-.Sh AUTHORS
-The
-.Fn aio_waitcomplete
-function and this manual page were written by
-.An Christopher M Sedore Aq cmsedore@maxwell.syr.edu .
index a645306..74e951c 100644 (file)
@@ -9,6 +9,9 @@ SRCS+= mq.c aio.c
 MAN+=  mq_close.2 mq_getattr.2 mq_notify.2 mq_open.2 mq_receive.2 \
        mq_send.2 mq_setattr.2 mq_unlink.2
 
+MAN+=  aio_cancel.3 aio_error.3 aio_read.3 aio_return.3 \
+       aio_suspend.3 aio_write.3
+
 MLINKS+=mq_receive.2 mq_timedreceive.2 \
        mq_send.2 mq_timedsend.2
 
similarity index 96%
rename from lib/libc/sys/aio_cancel.2
rename to lib/librt/aio_cancel.3
index b285319..62bfcca 100644 (file)
 .\" SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/lib/libc/sys/aio_cancel.2,v 1.5.2.6 2001/12/14 18:34:00 ru Exp $
-.\" $DragonFly: src/lib/libc/sys/aio_cancel.2,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd January 19, 2000
-.Dt AIO_CANCEL 2
+.Dt AIO_CANCEL 3
 .Os
 .Sh NAME
 .Nm aio_cancel
 .Nd cancel an outstanding asynchronous I/O operation (REALTIME)
 .Sh LIBRARY
-.Lb libc
+.Lb librt
 .Sh SYNOPSIS
 .In aio.h
 .Ft int
similarity index 96%
rename from lib/libc/sys/aio_error.2
rename to lib/librt/aio_error.3
index 037f1c2..44a47f4 100644 (file)
 .\" SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/lib/libc/sys/aio_error.2,v 1.6.2.6 2001/12/14 18:34:00 ru Exp $
-.\" $DragonFly: src/lib/libc/sys/aio_error.2,v 1.3 2007/06/30 19:03:52 swildner Exp $
 .\"
 .Dd June 2, 1999
-.Dt AIO_ERROR 2
+.Dt AIO_ERROR 3
 .Os
 .Sh NAME
 .Nm aio_error
 .Nd retrieve error status of asynchronous I/O operation (REALTIME)
 .Sh LIBRARY
-.Lb libc
+.Lb librt
 .Sh SYNOPSIS
 .In aio.h
 .Ft int
similarity index 98%
rename from lib/libc/sys/aio_read.2
rename to lib/librt/aio_read.3
index 95f4fc6..c5ceb6a 100644 (file)
 .\" SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/lib/libc/sys/aio_read.2,v 1.6.2.5 2002/12/29 16:35:34 schweikh Exp $
-.\" $DragonFly: src/lib/libc/sys/aio_read.2,v 1.3 2008/05/02 02:05:04 swildner Exp $
 .\"
 .Dd November 17, 1998
-.Dt AIO_READ 2
+.Dt AIO_READ 3
 .Os
 .Sh NAME
 .Nm aio_read
 .Nd asynchronous read from a file (REALTIME)
 .Sh LIBRARY
-.Lb libc
+.Lb librt
 .Sh SYNOPSIS
 .In time.h
 .In aio.h
similarity index 96%
rename from lib/libc/sys/aio_return.2
rename to lib/librt/aio_return.3
index b0288fd..1c308fb 100644 (file)
 .\" SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/lib/libc/sys/aio_return.2,v 1.5.2.6 2001/12/14 18:34:00 ru Exp $
-.\" $DragonFly: src/lib/libc/sys/aio_return.2,v 1.4 2007/06/30 19:03:52 swildner Exp $
 .\"
 .Dd June 2, 1999
-.Dt AIO_RETURN 2
+.Dt AIO_RETURN 3
 .Os
 .Sh NAME
 .Nm aio_return
 .Nd retrieve return status of asynchronous I/O operation (REALTIME)
 .Sh LIBRARY
-.Lb libc
+.Lb librt
 .Sh SYNOPSIS
 .In aio.h
 .Ft int
similarity index 96%
rename from lib/libc/sys/aio_suspend.2
rename to lib/librt/aio_suspend.3
index b896f39..80d80e6 100644 (file)
 .\" SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/lib/libc/sys/aio_suspend.2,v 1.8.2.5 2001/12/14 18:34:00 ru Exp $
-.\" $DragonFly: src/lib/libc/sys/aio_suspend.2,v 1.3 2006/02/17 19:35:06 swildner Exp $
 .\"
 .Dd June 2, 1999
-.Dt AIO_SUSPEND 2
+.Dt AIO_SUSPEND 3
 .Os
 .Sh NAME
 .Nm aio_suspend
 .Nd suspend until asynchronous I/O operations or timeout complete (REALTIME)
 .Sh LIBRARY
-.Lb libc
+.Lb librt
 .Sh SYNOPSIS
 .In aio.h
 .Ft int
similarity index 98%
rename from lib/libc/sys/aio_write.2
rename to lib/librt/aio_write.3
index fd91949..073d783 100644 (file)
 .\" SUCH DAMAGE.
 .\"
 .\" $FreeBSD: src/lib/libc/sys/aio_write.2,v 1.4.2.5 2001/12/14 18:34:00 ru Exp $
-.\" $DragonFly: src/lib/libc/sys/aio_write.2,v 1.3 2008/05/02 02:05:04 swildner Exp $
 .\"
 .Dd June 2, 1999
-.Dt AIO_WRITE 2
+.Dt AIO_WRITE 3
 .Os
 .Sh NAME
 .Nm aio_write
 .Nd asynchronous write to a file (REALTIME)
 .Sh LIBRARY
-.Lb libc
+.Lb librt
 .Sh SYNOPSIS
 .In aio.h
 .Ft int