1/* Substitute for and wrapper around <unistd.h>. 2 Copyright (C) 2004-2007 Free Software Foundation, Inc. 3 4 This program is free software; you can redistribute it and/or modify 5 it under the terms of the GNU General Public License as published by 6 the Free Software Foundation; either version 2, or (at your option) 7 any later version. 8 9 This program is distributed in the hope that it will be useful, 10 but WITHOUT ANY WARRANTY; without even the implied warranty of 11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 12 GNU General Public License for more details. 13 14 You should have received a copy of the GNU General Public License 15 along with this program; if not, write to the Free Software Foundation, 16 Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. */ 17 18#ifndef _GL_UNISTD_H 19 20/* The include_next requires a split double-inclusion guard. */ 21#if @HAVE_UNISTD_H@ 22# if @HAVE_INCLUDE_NEXT@ 23# include_next <unistd.h> 24# else 25# include @ABSOLUTE_UNISTD_H@ 26# endif 27#endif 28 29#ifndef _GL_UNISTD_H 30#define _GL_UNISTD_H 31 32/* mingw doesn't define the SEEK_* macros in <unistd.h>. */ 33#if !(defined SEEK_CUR && defined SEEK_END && defined SEEK_SET) 34# include <stdio.h> 35#endif 36 37/* mingw fails to declare _exit in <unistd.h>. */ 38#include <stdlib.h> 39 40/* The definition of GL_LINK_WARNING is copied here. */ 41 42 43/* Declare overridden functions. */ 44 45#ifdef __cplusplus 46extern "C" { 47#endif 48 49 50#if @GNULIB_CHOWN@ 51# if @REPLACE_CHOWN@ 52/* Change the owner of FILE to UID (if UID is not -1) and the group of FILE 53 to GID (if GID is not -1). 54 Return 0 if successful, otherwise -1 and errno set. 55 See the POSIX:2001 specification 56 <http://www.opengroup.org/susv3xsh/chown.html>. */ 57# define chown rpl_chown 58extern int chown (const char *file, uid_t uid, gid_t gid); 59# endif 60#elif defined GNULIB_POSIXCHECK 61# undef chown 62# define chown(f,u,g) \ 63 (GL_LINK_WARNING ("chown fails to follow symlinks on some systems and " \ 64 "doesn't treat a uid or gid of -1 on some systems - " \ 65 "use gnulib module chown for portability"), \ 66 chown (f, u, g)) 67#endif 68 69 70#if @GNULIB_DUP2@ 71# if !@HAVE_DUP2@ 72/* Copy the file descriptor OLDFD into file descriptor NEWFD. Do nothing if 73 NEWFD = OLDFD, otherwise close NEWFD first if it is open. 74 Return 0 if successful, otherwise -1 and errno set. 75 See the POSIX:2001 specification 76 <http://www.opengroup.org/susv3xsh/dup2.html>. */ 77extern int dup2 (int oldfd, int newfd); 78# endif 79#elif defined GNULIB_POSIXCHECK 80# undef dup2 81# define dup2(o,n) \ 82 (GL_LINK_WARNING ("dup2 is unportable - " \ 83 "use gnulib module dup2 for portability"), \ 84 dup2 (o, n)) 85#endif 86 87 88#if @GNULIB_FCHDIR@ 89# if @REPLACE_FCHDIR@ 90 91/* Change the process' current working directory to the directory on which 92 the given file descriptor is open. 93 Return 0 if successful, otherwise -1 and errno set. 94 See the POSIX:2001 specification 95 <http://www.opengroup.org/susv3xsh/fchdir.html>. */ 96extern int fchdir (int /*fd*/); 97 98# define close rpl_close 99extern int close (int); 100# define dup rpl_dup 101extern int dup (int); 102# define dup2 rpl_dup2 103extern int dup2 (int, int); 104 105# endif 106#elif defined GNULIB_POSIXCHECK 107# undef fchdir 108# define fchdir(f) \ 109 (GL_LINK_WARNING ("fchdir is unportable - " \ 110 "use gnulib module fchdir for portability"), \ 111 fchdir (f)) 112#endif 113 114 115#if @GNULIB_FTRUNCATE@ 116# if !@HAVE_FTRUNCATE@ 117/* Change the size of the file to which FD is opened to become equal to LENGTH. 118 Return 0 if successful, otherwise -1 and errno set. 119 See the POSIX:2001 specification 120 <http://www.opengroup.org/susv3xsh/ftruncate.html>. */ 121extern int ftruncate (int fd, off_t length); 122# endif 123#elif defined GNULIB_POSIXCHECK 124# undef ftruncate 125# define ftruncate(f,l) \ 126 (GL_LINK_WARNING ("ftruncate is unportable - " \ 127 "use gnulib module ftruncate for portability"), \ 128 ftruncate (f, l)) 129#endif 130 131 132#if @GNULIB_GETCWD@ 133/* Include the headers that might declare getcwd so that they will not 134 cause confusion if included after this file. */ 135# include <stdlib.h> 136# if @REPLACE_GETCWD@ 137/* Get the name of the current working directory, and put it in SIZE bytes 138 of BUF. 139 Return BUF if successful, or NULL if the directory couldn't be determined 140 or SIZE was too small. 141 See the POSIX:2001 specification 142 <http://www.opengroup.org/susv3xsh/getcwd.html>. 143 Additionally, the gnulib module 'getcwd' guarantees the following GNU 144 extension: If BUF is NULL, an array is allocated with 'malloc'; the array 145 is SIZE bytes long, unless SIZE == 0, in which case it is as big as 146 necessary. */ 147# define getcwd rpl_getcwd 148extern char * getcwd (char *buf, size_t size); 149# endif 150#elif defined GNULIB_POSIXCHECK 151# undef getcwd 152# define getcwd(b,s) \ 153 (GL_LINK_WARNING ("getcwd is unportable - " \ 154 "use gnulib module getcwd for portability"), \ 155 getcwd (b, s)) 156#endif 157 158 159#if @GNULIB_GETLOGIN_R@ 160/* Copies the user's login name to NAME. 161 The array pointed to by NAME has room for SIZE bytes. 162 163 Returns 0 if successful. Upon error, an error number is returned, or -1 in 164 the case that the login name cannot be found but no specific error is 165 provided (this case is hopefully rare but is left open by the POSIX spec). 166 167 See <http://www.opengroup.org/susv3xsh/getlogin.html>. 168 */ 169# if !@HAVE_DECL_GETLOGIN_R@ 170# include <stddef.h> 171extern int getlogin_r (char *name, size_t size); 172# endif 173#elif defined GNULIB_POSIXCHECK 174# undef getlogin_r 175# define getlogin_r(n,s) \ 176 (GL_LINK_WARNING ("getlogin_r is unportable - " \ 177 "use gnulib module getlogin_r for portability"), \ 178 getlogin_r (n, s)) 179#endif 180 181 182#if @GNULIB_LSEEK@ 183# if @REPLACE_LSEEK@ 184/* Set the offset of FD relative to SEEK_SET, SEEK_CUR, or SEEK_END. 185 Return the new offset if successful, otherwise -1 and errno set. 186 See the POSIX:2001 specification 187 <http://www.opengroup.org/susv3xsh/lseek.html>. */ 188# define lseek rpl_lseek 189 extern off_t lseek (int fd, off_t offset, int whence); 190# endif 191#elif defined GNULIB_POSIXCHECK 192# undef lseek 193# define lseek(f,o,w) \ 194 (GL_LINK_WARNING ("lseek does not fail with ESPIPE on pipes on some " \ 195 "systems - use gnulib module lseek for portability"), \ 196 lseek (f, o, w)) 197#endif 198 199 200#if @GNULIB_READLINK@ 201/* Read the contents of the symbolic link FILE and place the first BUFSIZE 202 bytes of it into BUF. Return the number of bytes placed into BUF if 203 successful, otherwise -1 and errno set. 204 See the POSIX:2001 specification 205 <http://www.opengroup.org/susv3xsh/readlink.html>. */ 206# if !@HAVE_READLINK@ 207# include <stddef.h> 208extern int readlink (const char *file, char *buf, size_t bufsize); 209# endif 210#elif defined GNULIB_POSIXCHECK 211# undef readlink 212# define readlink(f,b,s) \ 213 (GL_LINK_WARNING ("readlink is unportable - " \ 214 "use gnulib module readlink for portability"), \ 215 readlink (f, b, s)) 216#endif 217 218 219#if @GNULIB_SLEEP@ 220/* Pause the execution of the current thread for N seconds. 221 Returns the number of seconds left to sleep. 222 See the POSIX:2001 specification 223 <http://www.opengroup.org/susv3xsh/sleep.html>. */ 224# if !@HAVE_SLEEP@ 225extern unsigned int sleep (unsigned int n); 226# endif 227#elif defined GNULIB_POSIXCHECK 228# undef sleep 229# define sleep(n) \ 230 (GL_LINK_WARNING ("sleep is unportable - " \ 231 "use gnulib module sleep for portability"), \ 232 sleep (n)) 233#endif 234 235 236#ifdef __cplusplus 237} 238#endif 239 240 241#endif /* _GL_UNISTD_H */ 242#endif /* _GL_UNISTD_H */ 243