nointr.h

/*
 * nointr - convenience routines to retry system calls if errno == EINTR
 *
 * Copyright (c) 2010, Glue Logic LLC. All rights reserved. code()gluelogic.com
 *
 *  This file is part of mcdb.
 *
 *  mcdb is free software: you can redistribute it and/or modify it under
 *  the terms of the GNU Lesser General Public License as published by
 *  the Free Software Foundation, either version 2.1 of the License, or
 *  (at your option) any later version.
 *
 *  mcdb is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU Lesser General Public License for more details.
 *
 *  You should have received a copy of the GNU Lesser General Public License
 *  along with mcdb.  If not, see <http://www.gnu.org/licenses/>.
 */

#ifndef INCLUDED_NOINTR_H
#define INCLUDED_NOINTR_H

#include "plasma/plasma_feature.h"
#include "plasma/plasma_attr.h"
#include "plasma/plasma_stdtypes.h"
PLASMA_ATTR_Pragma_once

#ifdef __cplusplus
extern "C" {
#endif

/* Note: please do not use these routines indescriminantly.
 * There are times when a library call should be interrupted by EINTR and
 * processed as-is.  One such example is read(), where the data read should
 * be processed, unless a certain amount of data is required and it is
 * reasonable to block and wait longer.
 */

__attribute_nothrow__
__attribute_warn_unused_result__
int
nointr_dup(const int fd);

__attribute_nonnull__()
__attribute_nothrow__
__attribute_warn_unused_result__
int
nointr_open(const char * const restrict fn, const int flags, const mode_t mode);

__attribute_nothrow__
int
nointr_close(const int fd);

__attribute_nonnull__()
__attribute_nothrow__
__attribute_warn_unused_result__
ssize_t
nointr_write(const int fd, const char * restrict buf, size_t sz);

/* caller must #define _XOPEN_SOURCE >= 500 for XSI-compliant ftruncate() */
#if defined(_XOPEN_SOURCE) && _XOPEN_SOURCE-0 >= 500
__attribute_nothrow__
int
nointr_ftruncate(const int fd, const off_t sz);
#endif

/* caller must #define _ATFILE_SOURCE on Linux for openat() */
#if (defined(_XOPEN_SOURCE) && _XOPEN_SOURCE-0 >= 700) \
 || defined(_ATFILE_SOURCE)
__attribute_nonnull__()
__attribute_nothrow__
__attribute_warn_unused_result__
int
nointr_openat(const int dfd, const char * const restrict fn,
              const int flags, const mode_t mode);
#endif


#ifdef __cplusplus
}
#endif

#endif