124 lines
4.1 KiB
C
124 lines
4.1 KiB
C
/****************************************************************************
|
|
* libs/libc/uio/lib_readv.c
|
|
*
|
|
* Licensed to the Apache Software Foundation (ASF) under one or more
|
|
* contributor license agreements. See the NOTICE file distributed with
|
|
* this work for additional information regarding copyright ownership. The
|
|
* ASF licenses this file to you under the Apache License, Version 2.0 (the
|
|
* "License"); you may not use this file except in compliance with the
|
|
* License. You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
|
|
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
|
|
* License for the specific language governing permissions and limitations
|
|
* under the License.
|
|
*
|
|
****************************************************************************/
|
|
|
|
/****************************************************************************
|
|
* Included Files
|
|
****************************************************************************/
|
|
|
|
#include <sys/types.h>
|
|
#include <sys/uio.h>
|
|
#include <unistd.h>
|
|
|
|
/****************************************************************************
|
|
* Public Functions
|
|
****************************************************************************/
|
|
|
|
/****************************************************************************
|
|
* Name: readv()
|
|
*
|
|
* Description:
|
|
* The readv() function is equivalent to read(), except as described below.
|
|
* The readv() function places the input data into the 'iovcnt' buffers
|
|
* specified by the members of the 'iov' array: iov[0], iov[1], ...,
|
|
* iov['iovcnt'-1]. The 'iovcnt' argument is valid if greater than 0 and
|
|
* less than or equal to IOV_MAX as defined in limits.h.
|
|
*
|
|
* Each iovec entry specifies the base address and length of an area in
|
|
* memory where data should be placed. The readv() function will always
|
|
* fill an area completely before proceeding to the next.
|
|
*
|
|
* TODO: pon successful completion, readv() will mark for update the
|
|
* st_atime field of the file.
|
|
*
|
|
* Input Parameters:
|
|
* filedes - The open file descriptor for the file to be read
|
|
* iov - Array of read buffer descriptors
|
|
* iovcnt - Number of elements in iov[]
|
|
*
|
|
* Returned Value:
|
|
* Upon successful completion, readv() will return a non-negative integer
|
|
* indicating the number of bytes actually read. Otherwise, the functions
|
|
* will return -1 and set errno to indicate the error. See read() for the
|
|
* list of returned errno values. In addition, the readv() function will
|
|
* fail if:
|
|
*
|
|
* EINVAL.
|
|
* The sum of the iov_len values in the iov array overflowed an ssize_t
|
|
* or The 'iovcnt' argument was less than or equal to 0, or greater than
|
|
* IOV_MAX (Not implemented).
|
|
*
|
|
****************************************************************************/
|
|
|
|
ssize_t readv(int fildes, FAR const struct iovec *iov, int iovcnt)
|
|
{
|
|
ssize_t ntotal;
|
|
ssize_t nread;
|
|
size_t remaining;
|
|
FAR uint8_t *buffer;
|
|
int i;
|
|
|
|
/* Process each entry in the struct iovec array */
|
|
|
|
for (i = 0, ntotal = 0; i < iovcnt; i++)
|
|
{
|
|
/* Ignore zero-length reads */
|
|
|
|
if (iov[i].iov_len > 0)
|
|
{
|
|
buffer = iov[i].iov_base;
|
|
remaining = iov[i].iov_len;
|
|
|
|
/* Read repeatedly as necessary to fill buffer */
|
|
|
|
do
|
|
{
|
|
/* NOTE: read() is a cancellation point */
|
|
|
|
nread = read(fildes, buffer, remaining);
|
|
|
|
/* Check for a read error */
|
|
|
|
if (nread < 0)
|
|
{
|
|
return nread;
|
|
}
|
|
|
|
/* Check for an end-of-file condition */
|
|
|
|
else if (nread == 0)
|
|
{
|
|
return ntotal;
|
|
}
|
|
|
|
/* Update pointers and counts in order to handle partial
|
|
* buffer reads.
|
|
*/
|
|
|
|
buffer += nread;
|
|
remaining -= nread;
|
|
ntotal += nread;
|
|
}
|
|
while (remaining > 0);
|
|
}
|
|
}
|
|
|
|
return ntotal;
|
|
}
|