436 lines
16 KiB
C
436 lines
16 KiB
C
/****************************************************************************
|
|
* include/unistd.h
|
|
*
|
|
* 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.
|
|
*
|
|
****************************************************************************/
|
|
|
|
#ifndef __INCLUDE_UNISTD_H
|
|
#define __INCLUDE_UNISTD_H
|
|
|
|
/****************************************************************************
|
|
* Included Files
|
|
****************************************************************************/
|
|
|
|
#include <sys/types.h>
|
|
#include <nuttx/compiler.h>
|
|
#include <limits.h>
|
|
|
|
/****************************************************************************
|
|
* Pre-processor Definitions
|
|
****************************************************************************/
|
|
|
|
/* 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
|
|
#ifndef CONFIG_DISABLE_POSIX_TIMERS
|
|
# define _POSIX_TIMERS 1
|
|
#endif
|
|
#if !defined(CONFIG_DISABLE_MQUEUE) && !defined(CONFIG_DISABLE_PTHREAD)
|
|
# define _POSIX_TIMEOUTS 1
|
|
#endif
|
|
#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
|
|
# define _POSIX_SPORADIC_SERVER -1
|
|
# define _POSIX_THREAD_SPORADIC_SERVER -1
|
|
#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 pathconf(). pathconf() will return -1 and set
|
|
* errno to ENOSYS for most of these.
|
|
*/
|
|
|
|
#define _PC_2_SYMLINKS 0x0001
|
|
#define _PC_ALLOC_SIZE_MIN 0x0002
|
|
#define _PC_ASYNC_IO 0x0003
|
|
#define _PC_CHOWN_RESTRICTED 0x0004
|
|
#define _PC_FILESIZEBITS 0x0005
|
|
#define _PC_LINK_MAX 0x0006
|
|
#define _PC_MAX_CANON 0x0007
|
|
#define _PC_MAX_INPUT 0x0008
|
|
#define _PC_NAME_MAX 0x0009
|
|
#define _PC_NO_TRUNC 0x000a
|
|
#define _PC_PATH_MAX 0x000b
|
|
#define _PC_PIPE_BUF 0x000c
|
|
#define _PC_PRIO_IO 0x000d
|
|
#define _PC_REC_INCR_XFER_SIZE 0x000e
|
|
#define _PC_REC_MIN_XFER_SIZE 0x000f
|
|
#define _PC_REC_XFER_ALIGN 0x0010
|
|
#define _PC_SYMLINK_MAX 0x0011
|
|
#define _PC_SYNC_IO 0x0012
|
|
#define _PC_VDISABLE 0x0013
|
|
|
|
/* Constants used with POSIX sysconf(). sysconf() will return -1 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
|
|
|
|
#define _SC_PHYS_PAGES 0x007b
|
|
#define _SC_AVPHYS_PAGES 0x007c
|
|
|
|
#define _SC_NPROCESSORS_CONF 0x007d
|
|
#define _SC_NPROCESSORS_ONLN 0x007e
|
|
|
|
/* 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 */
|
|
|
|
/* Helpers and legacy compatibility definitions */
|
|
|
|
#define link(p1, p2) symlink((p1), (p2))
|
|
#define fdatasync(f) fsync(f)
|
|
#define getdtablesize(f) ((int)sysconf(_SC_OPEN_MAX))
|
|
#define getpagesize(f) ((int)sysconf(_SC_PAGESIZE))
|
|
|
|
/* Accessor functions associated with getopt(). */
|
|
|
|
#define optarg (*(getoptargp()))
|
|
#define opterr (*(getopterrp()))
|
|
#define optind (*(getoptindp()))
|
|
#define optopt (*(getoptoptp()))
|
|
|
|
#if defined(CONFIG_FS_LARGEFILE) && defined(CONFIG_HAVE_LONG_LONG)
|
|
# define lseek64 lseek
|
|
# define pread64 pread
|
|
# define pwrite64 pwrite
|
|
# define truncate64 truncate
|
|
# define ftruncate64 ftruncate
|
|
# define lockf64 lockf
|
|
#endif
|
|
|
|
/* NOTE: NuttX provides only one implementation: If
|
|
* CONFIG_LIBC_ENVPATH is defined, then only execvp/execlp/execvpe behavior
|
|
* is supported; otherwise, only execv/execl/execve behavior is supported.
|
|
*/
|
|
|
|
#ifdef CONFIG_LIBC_EXECFUNCS
|
|
# define execvp execv
|
|
# define execlp execl
|
|
# define execvpe execve
|
|
#endif
|
|
|
|
/****************************************************************************
|
|
* Public Data
|
|
****************************************************************************/
|
|
|
|
#undef EXTERN
|
|
#if defined(__cplusplus)
|
|
#define EXTERN extern "C"
|
|
extern "C"
|
|
{
|
|
#else
|
|
#define EXTERN extern
|
|
#endif
|
|
|
|
/****************************************************************************
|
|
* Public Function Prototypes
|
|
****************************************************************************/
|
|
|
|
/* Task Control Interfaces */
|
|
|
|
pid_t vfork(void);
|
|
pid_t getpid(void);
|
|
pid_t gettid(void);
|
|
pid_t getppid(void);
|
|
void _exit(int status) noreturn_function;
|
|
unsigned int sleep(unsigned int seconds);
|
|
int usleep(useconds_t usec);
|
|
int pause(void);
|
|
int nice(int inc);
|
|
|
|
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);
|
|
int fchown(int fd, uid_t owner, gid_t group);
|
|
|
|
/* Check if a file descriptor corresponds to a terminal I/O file */
|
|
|
|
int isatty(int fd);
|
|
|
|
FAR char *ttyname(int fd);
|
|
int ttyname_r(int fd, FAR char *buf, size_t buflen);
|
|
|
|
/* 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]);
|
|
int pipe2(int pipefd[2], int flags);
|
|
|
|
/* Schedule an alarm */
|
|
|
|
unsigned int alarm(unsigned int seconds);
|
|
|
|
/* Working directory operations */
|
|
|
|
int chdir(FAR const char *path);
|
|
int fchdir(int fd);
|
|
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);
|
|
int symlink(FAR const char *path1, FAR const char *path2);
|
|
ssize_t readlink(FAR const char *path, FAR char *buf, size_t bufsize);
|
|
int chown(FAR const char *path, uid_t owner, gid_t group);
|
|
int lchown(FAR const char *path, uid_t owner, gid_t group);
|
|
|
|
/* Execution of programs from files */
|
|
|
|
#ifdef CONFIG_LIBC_EXECFUNCS
|
|
int execl(FAR const char *path, FAR const char *arg0, ...);
|
|
int execle(FAR const char *path, FAR const char *arg0, ...);
|
|
int execv(FAR const char *path, FAR char * const argv[]);
|
|
int execve(FAR const char *path, FAR char *const argv[],
|
|
FAR char *const envp[]);
|
|
#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 associated with getopt(). */
|
|
|
|
FAR char **getoptargp(void); /* Optional argument following option */
|
|
FAR int *getopterrp(void); /* Print error message */
|
|
FAR int *getoptindp(void); /* Index into argv */
|
|
FAR int *getoptoptp(void); /* Unrecognized option character */
|
|
|
|
int gethostname(FAR char *name, size_t namelen);
|
|
int sethostname(FAR const char *name, size_t namelen);
|
|
|
|
/* Get configurable system variables */
|
|
|
|
long sysconf(int name);
|
|
long fpathconf(int fildes, int name);
|
|
long pathconf(FAR const char *path, int name);
|
|
|
|
/* User and group identity management */
|
|
|
|
int setuid(uid_t uid);
|
|
uid_t getuid(void);
|
|
int setgid(gid_t gid);
|
|
gid_t getgid(void);
|
|
|
|
int seteuid(uid_t uid);
|
|
uid_t geteuid(void);
|
|
int setegid(gid_t gid);
|
|
gid_t getegid(void);
|
|
|
|
int setreuid(uid_t ruid, uid_t euid);
|
|
int setregid(gid_t rgid, gid_t egid);
|
|
|
|
int getentropy(FAR void *buffer, size_t length);
|
|
|
|
#undef EXTERN
|
|
#if defined(__cplusplus)
|
|
}
|
|
#endif
|
|
|
|
#endif /* __INCLUDE_UNISTD_H */
|