/**************************************************************************** * include/unistd.h * * Copyright (C) 2007-2009, 2013-2014, 2016-2018 Gregory Nutt. All rights * reserved. * Author: Gregory Nutt * * 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. * 3. Neither the name NuttX nor the names of its contributors may be * used to endorse or promote products derived from this software * without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "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 * COPYRIGHT OWNER 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. * ****************************************************************************/ #ifndef __INCLUDE_UNISTD_H #define __INCLUDE_UNISTD_H /**************************************************************************** * Included Files ****************************************************************************/ #include #include /**************************************************************************** * Pre-processor Definitions ****************************************************************************/ /* The number of functions that may be registered to be called * at program exit. */ #define ATEXIT_MAX 1 /* Values for seeking */ #define SEEK_SET 0 /* From the start of the file */ #define SEEK_CUR 1 /* From the current file offset */ #define SEEK_END 2 /* From the end of the file */ /* Bit values for the second argument to access */ #define F_OK 0 /* Test existence */ #define X_OK 1 /* Test execute permission */ #define W_OK 2 /* Test write permission */ #define R_OK 4 /* Test read permission */ /* POSIX feature set macros */ #define POSIX_VERSION #undef _POSIX_SAVED_IDS #undef _POSIX_JOB_CONTROL #define _POSIX_REALTIME_SIGNALS 1 #define _POSIX_MESSAGE_PASSING 1 #undef _POSIX_MAPPED_FILES #undef _POSIX_SHARED_MEMORY_OBJECTS #define _POSIX_PRIORITY_SCHEDULING 1 #define _POSIX_TIMERS 1 #undef _POSIX_MEMLOCK #undef _POSIX_MEMLOCK_RANGE #undef _POSIX_FSYNC #define _POSIX_SYNCHRONIZED_IO 1 #ifdef CONFIG_FS_AIO # define _POSIX_ASYNCHRONOUS_IO 1 #else # undef _POSIX_ASYNCHRONOUS_IO #endif #undef _POSIX_PRIORITIZED_IO #ifdef CONFIG_SCHED_SPORADIC # define _POSIX_SPORADIC_SERVER 1 # define _POSIX_THREAD_SPORADIC_SERVER 1 #else # undef _POSIX_SPORADIC_SERVER # undef _POSIX_THREAD_SPORADIC_SERVER #endif /* Execution time constants (not supported) */ #undef _POSIX_CHOWN_RESTRICTED #undef _POSIX_NO_TRUNC #undef _POSIX_VDISABLE #define _POSIX_SYNC_IO 1 #undef _POSIX_ASYNC_IO #undef _POSIX_PRIO_IO /* Constants used with POSIX sysconf(). sysconf() will return -2 and set * errno to ENOSYS for most of these. */ #define _SC_2_C_BIND 0x0001 #define _SC_2_C_DEV 0x0002 #define _SC_2_CHAR_TERM 0x0003 #define _SC_2_FORT_DEV 0x0004 #define _SC_2_FORT_RUN 0x0005 #define _SC_2_LOCALEDEF 0x0006 #define _SC_2_PBS 0x0007 #define _SC_2_PBS_ACCOUNTING 0x0008 #define _SC_2_PBS_CHECKPOINT 0x0009 #define _SC_2_PBS_LOCATE 0x000a #define _SC_2_PBS_MESSAGE 0x000b #define _SC_2_PBS_TRACK 0x000c #define _SC_2_SW_DEV 0x000d #define _SC_2_UPE 0x000e #define _SC_2_VERSION 0x000f #define _SC_ADVISORY_INFO 0x0010 #define _SC_AIO_LISTIO_MAX 0x0011 #define _SC_AIO_MAX 0x0012 #define _SC_AIO_PRIO_DELTA_MAX 0x0013 #define _SC_ARG_MAX 0x0014 #define _SC_ASYNCHRONOUS_IO 0x0015 #define _SC_ATEXIT_MAX 0x0016 #define _SC_BARRIERS 0x0017 #define _SC_BC_BASE_MAX 0x0018 #define _SC_BC_DIM_MAX 0x0019 #define _SC_BC_SCALE_MAX 0x001a #define _SC_BC_STRING_MAX 0x001b #define _SC_CHILD_MAX 0x001c #define _SC_CLK_TCK 0x001d #define _SC_CLOCK_SELECTION 0x001e #define _SC_COLL_WEIGHTS_MAX 0x001f #define _SC_CPUTIME 0x0020 #define _SC_DELAYTIMER_MAX 0x0021 #define _SC_EXPR_NEST_MAX 0x0022 #define _SC_FSYNC 0x0023 #define _SC_GETGR_R_SIZE_MAX 0x0024 #define _SC_GETPW_R_SIZE_MAX 0x0025 #define _SC_HOST_NAME_MAX 0x0026 #define _SC_IOV_MAX 0x0027 #define _SC_IPV6 0x0028 #define _SC_JOB_CONTROL 0x0029 #define _SC_LINE_MAX 0x002a #define _SC_LOGIN_NAME_MAX 0x002b #define _SC_MAPPED_FILES 0x002c #define _SC_MEMLOCK 0x002d #define _SC_MEMLOCK_RANGE 0x002e #define _SC_MEMORY_PROTECTION 0x002f #define _SC_MESSAGE_PASSING 0x0030 #define _SC_MONOTONIC_CLOCK 0x0031 #define _SC_MQ_OPEN_MAX 0x0032 #define _SC_MQ_PRIO_MAX 0x0033 #define _SC_NGROUPS_MAX 0x0034 #define _SC_OPEN_MAX 0x0035 #define _SC_PAGE_SIZE 0x0036 #define _SC_PAGESIZE _SC_PAGE_SIZE #define _SC_PRIORITIZED_IO 0x0037 #define _SC_PRIORITY_SCHEDULING 0x0038 #define _SC_RAW_SOCKETS 0x0039 #define _SC_RE_DUP_MAX 0x003a #define _SC_READER_WRITER_LOCKS 0x003b #define _SC_REALTIME_SIGNALS 0x003c #define _SC_REGEXP 0x003d #define _SC_RTSIG_MAX 0x003e #define _SC_SAVED_IDS 0x003f #define _SC_SEM_NSEMS_MAX 0x0040 #define _SC_SEM_VALUE_MAX 0x0041 #define _SC_SEMAPHORES 0x0042 #define _SC_SHARED_MEMORY_OBJECTS 0x0043 #define _SC_SHELL 0x0044 #define _SC_SIGQUEUE_MAX 0x0045 #define _SC_SPAWN 0x0046 #define _SC_SPIN_LOCKS 0x0047 #define _SC_SPORADIC_SERVER 0x0048 #define _SC_SS_REPL_MAX 0x0049 #define _SC_STREAM_MAX 0x004a #define _SC_SYMLOOP_MAX 0x004b #define _SC_SYNCHRONIZED_IO 0x004c #define _SC_THREAD_ATTR_STACKADDR 0x004d #define _SC_THREAD_ATTR_STACKSIZE 0x004e #define _SC_THREAD_CPUTIME 0x004f #define _SC_THREAD_DESTRUCTOR_ITERATIONS 0x0050 #define _SC_THREAD_KEYS_MAX 0x0051 #define _SC_THREAD_PRIO_INHERIT 0x0052 #define _SC_THREAD_PRIO_PROTECT 0x0053 #define _SC_THREAD_PRIORITY_SCHEDULING 0x0054 #define _SC_THREAD_PROCESS_SHARED 0x0055 #define _SC_THREAD_SAFE_FUNCTIONS 0x0056 #define _SC_THREAD_SPORADIC_SERVER 0x0057 #define _SC_THREAD_STACK_MIN 0x0058 #define _SC_THREAD_THREADS_MAX 0x0059 #define _SC_THREADS 0x005a #define _SC_TIMEOUTS 0x005b #define _SC_TIMER_MAX 0x005c #define _SC_TIMERS 0x005d #define _SC_TRACE 0x005e #define _SC_TRACE_EVENT_FILTER 0x005f #define _SC_TRACE_EVENT_NAME_MAX 0x0060 #define _SC_TRACE_INHERIT 0x0061 #define _SC_TRACE_LOG 0x0062 #define _SC_TRACE_NAME_MAX 0x0063 #define _SC_TRACE_SYS_MAX 0x0064 #define _SC_TRACE_USER_EVENT_MAX 0x0065 #define _SC_TTY_NAME_MAX 0x0066 #define _SC_TYPED_MEMORY_OBJECTS 0x0067 #define _SC_TZNAME_MAX 0x0068 #define _SC_V6_ILP32_OFF32 0x0069 #define _SC_V6_ILP32_OFFBIG 0x006a #define _SC_V6_LP64_OFF64 0x006b #define _SC_V6_LPBIG_OFFBIG 0x006c #define _SC_VERSION 0x006d #define _SC_XBS5_ILP32_OFF32 0x006e /* (LEGACY) */ #define _SC_XBS5_ILP32_OFFBIG 0x006f /* (LEGACY) */ #define _SC_XBS5_LP64_OFF64 0x0070 /* (LEGACY) */ #define _SC_XBS5_LPBIG_OFFBIG 0x0071 /* (LEGACY) */ #define _SC_XOPEN_CRYPT 0x0072 #define _SC_XOPEN_ENH_I18N 0x0073 #define _SC_XOPEN_LEGACY 0x0074 #define _SC_XOPEN_REALTIME 0x0075 #define _SC_XOPEN_REALTIME_THREADS 0x0076 #define _SC_XOPEN_SHM 0x0077 #define _SC_XOPEN_STREAMS 0x0078 #define _SC_XOPEN_UNIX 0x0079 #define _SC_XOPEN_VERSION 0x007a /* The following symbolic constants must be defined for file streams: */ #define STDERR_FILENO 2 /* File number of stderr */ #define STDIN_FILENO 0 /* File number of stdin */ #define STDOUT_FILENO 1 /* File number of stdout */ #define HOST_NAME_MAX 32 /* Helpers and legacy compatibility definitions */ #define fdatasync(f) fsync(f) #define getdtablesize(f) ((int)sysconf(_SC_OPEN_MAX)) /**************************************************************************** * Public Data ****************************************************************************/ #undef EXTERN #if defined(__cplusplus) #define EXTERN extern "C" extern "C" { #else #define EXTERN extern #endif /* Used by getopt (obviously NOT thread safe!). These variables cannot be * accessed directly by an external NXFLAT module. In that case, accessor * functions must be used. */ #ifndef __NXFLAT__ EXTERN FAR char *optarg; /* Optional argument following option */ EXTERN int optind; /* Index into argv */ EXTERN int optopt; /* Unrecognized option character */ #else # define optarg (*(getoptargp())) # define optind (*(getoptindp())) # define optopt (*(getoptoptp())) #endif /**************************************************************************** * Public Function Prototypes ****************************************************************************/ /* Task Control Interfaces */ pid_t vfork(void); pid_t getpid(void); void _exit(int status) noreturn_function; unsigned int sleep(unsigned int seconds); int usleep(useconds_t usec); int pause(void); int daemon(int nochdir, int noclose); /* File descriptor operations */ int close(int fd); int dup(int fd); int dup2(int fd1, int fd2); int fsync(int fd); off_t lseek(int fd, off_t offset, int whence); ssize_t read(int fd, FAR void *buf, size_t nbytes); ssize_t write(int fd, FAR const void *buf, size_t nbytes); ssize_t pread(int fd, FAR void *buf, size_t nbytes, off_t offset); ssize_t pwrite(int fd, FAR const void *buf, size_t nbytes, off_t offset); int ftruncate(int fd, off_t length); /* Check if a file descriptor corresponds to a terminal I/O file */ int isatty(int fd); /* Memory management */ #if defined(CONFIG_ARCH_ADDRENV) && defined(CONFIG_MM_PGALLOC) && \ defined(CONFIG_ARCH_USE_MMU) FAR void *sbrk(intptr_t incr); #endif /* Special devices */ int pipe(int fd[2]); /* Working directory operations */ int chdir(FAR const char *path); FAR char *getcwd(FAR char *buf, size_t size); /* File path operations */ int access(FAR const char *path, int amode); int rmdir(FAR const char *pathname); int unlink(FAR const char *pathname); int truncate(FAR const char *path, off_t length); #ifdef CONFIG_PSEUDOFS_SOFTLINKS int link(FAR const char *path1, FAR const char *path2); ssize_t readlink(FAR const char *path, FAR char *buf, size_t bufsize); #endif /* Execution of programs from files */ #ifdef CONFIG_LIBC_EXECFUNCS int execl(FAR const char *path, ...); int execv(FAR const char *path, FAR char *const argv[]); #endif /* Byte operations */ void swab(FAR const void *src, FAR void *dest, ssize_t nbytes); /* getopt and friends */ int getopt(int argc, FAR char *const argv[], FAR const char *optstring); /* Accessor functions intended for use only by external NXFLAT * modules. The global variables optarg, optind, and optopt cannot * be referenced directly from external modules. */ FAR char **getoptargp(void); /* Optional argument following option */ FAR int *getoptindp(void); /* Index into argv */ FAR int *getoptoptp(void); /* Unrecognized option character */ int gethostname(FAR char *name, size_t size); int sethostname(FAR const char *name, size_t size); /* Get configurable system variables */ long sysconf(int name); #undef EXTERN #if defined(__cplusplus) } #endif #endif /* __INCLUDE_UNISTD_H */