stdio.h revision d8e34837cd6c88c42b3ecdb9107a43ecf8252e79
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence/*
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence * Copyright (C) 2000 Internet Software Consortium.
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence *
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence * Permission to use, copy, modify, and distribute this software for any
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence * purpose with or without fee is hereby granted, provided that the above
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence * copyright notice and this permission notice appear in all copies.
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence *
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence * THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM DISCLAIMS
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence * ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence * OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL INTERNET SOFTWARE
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence * CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence * ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence * SOFTWARE.
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence */
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence#include <stdio.h>
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence#include <isc/result.h>
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrenceisc_result_t
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrenceisc_stdio_open(const char *filename, const char *mode, FILE **fp);
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrenceisc_result_t
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrenceisc_stdio_close(FILE *f);
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrenceisc_result_t
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrenceisc_stdio_seek(FILE *f, long offset, int whence);
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrenceisc_result_t
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrenceisc_stdio_read(void *ptr, size_t size, size_t nmemb, FILE *f,
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence size_t *nret);
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrenceisc_result_t
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrenceisc_stdio_write(const void *ptr, size_t size, size_t nmemb, FILE *f,
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence size_t *nret);
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrenceisc_result_t
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrenceisc_stdio_flush(FILE *f);
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence/*
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence * These functions are wrappers around the corresponding stdio functions,
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence * returning a detailed error code in the form of an an isc_result_t. ANSI C
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence * does not guarantee that stdio functions set errno, hence these functions
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence * must use platform dependent methods (e.g., the POSIX errno) to construct the
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence * error code.
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence */
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrenceisc_result_t
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrenceisc_stdio_sync(FILE *f);
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence/*
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence * Invoke fsync() on the file descriptor underlying an stdio stream, or an
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence * equivalent system-dependent operation. Note that this function has no
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence * direct counterpart in the stdio library.
d8e34837cd6c88c42b3ecdb9107a43ecf8252e79David Lawrence */