mbed official / mbed

The official Mbed 2 C/C++ SDK provides the software platform and libraries to build your applications.

Dependents:   hello SerialTestv11 SerialTestv12 Sierpinski ... more

mbed 2

This is the mbed 2 library. If you'd like to learn about Mbed OS please see the mbed-os docs.

platform/mbed_retarget.h@169:a7c7b631e539, 2018-06-22 (annotated)

Committer:
Anna Bridge
Date:
Fri Jun 22 15:38:59 2018 +0100
Revision:
169:a7c7b631e539
Parent:
165:d1b4690b3f8b
Child:
170:e95d10626187
mbed library. Release version 162

Who changed what in which revision?

UserRevisionLine numberNew contents of line
AnnaBridge 156:ff21514d8981 1 /*
AnnaBridge 156:ff21514d8981 2 * mbed Microcontroller Library
AnnaBridge 156:ff21514d8981 3 * Copyright (c) 2006-2016 ARM Limited
AnnaBridge 156:ff21514d8981 4 *
AnnaBridge 156:ff21514d8981 5 * Licensed under the Apache License, Version 2.0 (the "License");
AnnaBridge 156:ff21514d8981 6 * you may not use this file except in compliance with the License.
AnnaBridge 156:ff21514d8981 7 * You may obtain a copy of the License at
AnnaBridge 156:ff21514d8981 8 *
AnnaBridge 156:ff21514d8981 9 * http://www.apache.org/licenses/LICENSE-2.0
AnnaBridge 156:ff21514d8981 10 *
AnnaBridge 156:ff21514d8981 11 * Unless required by applicable law or agreed to in writing, software
AnnaBridge 156:ff21514d8981 12 * distributed under the License is distributed on an "AS IS" BASIS,
AnnaBridge 156:ff21514d8981 13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
AnnaBridge 156:ff21514d8981 14 * See the License for the specific language governing permissions and
AnnaBridge 156:ff21514d8981 15 * limitations under the License.
AnnaBridge 156:ff21514d8981 16 *
AnnaBridge 156:ff21514d8981 17 */
AnnaBridge 156:ff21514d8981 18
AnnaBridge 156:ff21514d8981 19 #ifndef RETARGET_H
AnnaBridge 156:ff21514d8981 20 #define RETARGET_H
AnnaBridge 156:ff21514d8981 21
AnnaBridge 156:ff21514d8981 22 #if __cplusplus
AnnaBridge 156:ff21514d8981 23 #include <cstdio>
AnnaBridge 165:d1b4690b3f8b 24 #else
AnnaBridge 165:d1b4690b3f8b 25 #include <stdio.h>
AnnaBridge 156:ff21514d8981 26 #endif //__cplusplus
AnnaBridge 156:ff21514d8981 27 #include <stdint.h>
AnnaBridge 156:ff21514d8981 28 #include <stddef.h>
AnnaBridge 156:ff21514d8981 29
Anna Bridge 169:a7c7b631e539 30 /* Include logic for errno so we can get errno defined but not bring in error_t,
Anna Bridge 169:a7c7b631e539 31 * including errno here prevents an include later, which would redefine our
Anna Bridge 169:a7c7b631e539 32 * error codes
Anna Bridge 169:a7c7b631e539 33 */
Anna Bridge 169:a7c7b631e539 34 #ifndef __error_t_defined
Anna Bridge 169:a7c7b631e539 35 #define __error_t_defined 1
Anna Bridge 169:a7c7b631e539 36 #include <errno.h>
Anna Bridge 169:a7c7b631e539 37 #undef __error_t_defined
Anna Bridge 169:a7c7b631e539 38 #else
Anna Bridge 169:a7c7b631e539 39 #include <errno.h>
Anna Bridge 169:a7c7b631e539 40 #endif
Anna Bridge 169:a7c7b631e539 41
AnnaBridge 156:ff21514d8981 42 /* We can get the following standard types from sys/types for gcc, but we
AnnaBridge 156:ff21514d8981 43 * need to define the types ourselves for the other compilers that normally
AnnaBridge 156:ff21514d8981 44 * target embedded systems */
AnnaBridge 156:ff21514d8981 45 typedef signed int ssize_t; ///< Signed size type, usually encodes negative errors
AnnaBridge 156:ff21514d8981 46 typedef signed long off_t; ///< Offset in a data stream
AnnaBridge 165:d1b4690b3f8b 47 typedef unsigned int nfds_t; ///< Number of file descriptors
AnnaBridge 165:d1b4690b3f8b 48 typedef unsigned long long fsblkcnt_t; ///< Count of file system blocks
Anna Bridge 160:5571c4ff569f 49 #if defined(__ARMCC_VERSION) || !defined(__GNUC__)
AnnaBridge 156:ff21514d8981 50 typedef unsigned int mode_t; ///< Mode for opening files
AnnaBridge 156:ff21514d8981 51 typedef unsigned int dev_t; ///< Device ID type
AnnaBridge 156:ff21514d8981 52 typedef unsigned long ino_t; ///< File serial number
AnnaBridge 156:ff21514d8981 53 typedef unsigned int nlink_t; ///< Number of links to a file
AnnaBridge 156:ff21514d8981 54 typedef unsigned int uid_t; ///< User ID
AnnaBridge 156:ff21514d8981 55 typedef unsigned int gid_t; ///< Group ID
Anna Bridge 160:5571c4ff569f 56 #endif
AnnaBridge 156:ff21514d8981 57
Anna Bridge 169:a7c7b631e539 58 /* Flags for open() and fcntl(GETFL/SETFL)
Anna Bridge 169:a7c7b631e539 59 * At present, fcntl only supports reading and writing O_NONBLOCK
Anna Bridge 169:a7c7b631e539 60 */
Anna Bridge 169:a7c7b631e539 61 #define O_RDONLY 0 ///< Open for reading
Anna Bridge 169:a7c7b631e539 62 #define O_WRONLY 1 ///< Open for writing
Anna Bridge 169:a7c7b631e539 63 #define O_RDWR 2 ///< Open for reading and writing
Anna Bridge 169:a7c7b631e539 64 #define O_NONBLOCK 0x0004 ///< Non-blocking mode
Anna Bridge 169:a7c7b631e539 65 #define O_APPEND 0x0008 ///< Set file offset to end of file prior to each write
Anna Bridge 169:a7c7b631e539 66 #define O_CREAT 0x0200 ///< Create file if it does not exist
Anna Bridge 169:a7c7b631e539 67 #define O_TRUNC 0x0400 ///< Truncate file to zero length
Anna Bridge 169:a7c7b631e539 68 #define O_EXCL 0x0800 ///< Fail if file exists
Anna Bridge 169:a7c7b631e539 69 #define O_BINARY 0x8000 ///< Open file in binary mode
Anna Bridge 169:a7c7b631e539 70
Anna Bridge 169:a7c7b631e539 71 #define O_ACCMODE (O_RDONLY|O_WRONLY|O_RDWR)
AnnaBridge 156:ff21514d8981 72
AnnaBridge 156:ff21514d8981 73 #define NAME_MAX 255 ///< Maximum size of a name in a file path
AnnaBridge 156:ff21514d8981 74
AnnaBridge 165:d1b4690b3f8b 75 #define STDIN_FILENO 0
AnnaBridge 165:d1b4690b3f8b 76 #define STDOUT_FILENO 1
AnnaBridge 165:d1b4690b3f8b 77 #define STDERR_FILENO 2
AnnaBridge 165:d1b4690b3f8b 78
AnnaBridge 156:ff21514d8981 79 #include <time.h>
AnnaBridge 156:ff21514d8981 80
AnnaBridge 158:1c57384330a6 81 /** \addtogroup platform */
AnnaBridge 158:1c57384330a6 82 /** @{*/
AnnaBridge 158:1c57384330a6 83 /**
AnnaBridge 158:1c57384330a6 84 * \defgroup platform_retarget Retarget functions
AnnaBridge 158:1c57384330a6 85 * @{
AnnaBridge 158:1c57384330a6 86 */
AnnaBridge 156:ff21514d8981 87
AnnaBridge 156:ff21514d8981 88 /* DIR declarations must also be here */
AnnaBridge 156:ff21514d8981 89 #if __cplusplus
AnnaBridge 156:ff21514d8981 90 namespace mbed {
AnnaBridge 165:d1b4690b3f8b 91
AnnaBridge 156:ff21514d8981 92 class FileHandle;
AnnaBridge 156:ff21514d8981 93 class DirHandle;
AnnaBridge 165:d1b4690b3f8b 94
AnnaBridge 165:d1b4690b3f8b 95 /** Targets may implement this to change stdin, stdout, stderr.
AnnaBridge 165:d1b4690b3f8b 96 *
AnnaBridge 165:d1b4690b3f8b 97 * If the application hasn't provided mbed_override_console, this is called
AnnaBridge 165:d1b4690b3f8b 98 * to give the target a chance to specify a FileHandle for the console.
AnnaBridge 165:d1b4690b3f8b 99 *
AnnaBridge 165:d1b4690b3f8b 100 * If this is not provided or returns NULL, the console will be:
AnnaBridge 165:d1b4690b3f8b 101 * - UARTSerial if configuration option "platform.stdio-buffered-serial" is
AnnaBridge 165:d1b4690b3f8b 102 * true and the target has DEVICE_SERIAL;
AnnaBridge 165:d1b4690b3f8b 103 * - Raw HAL serial via serial_getc and serial_putc if
AnnaBridge 165:d1b4690b3f8b 104 * "platform.stdio-buffered-serial" is false and the target has DEVICE_SERIAL;
AnnaBridge 165:d1b4690b3f8b 105 * - stdout/stderr will be a sink and stdin will input a stream of 0s if the
AnnaBridge 165:d1b4690b3f8b 106 * target does not have DEVICE_SERIAL.
AnnaBridge 165:d1b4690b3f8b 107 *
AnnaBridge 165:d1b4690b3f8b 108 * @param fd file descriptor - STDIN_FILENO, STDOUT_FILENO or STDERR_FILENO
AnnaBridge 165:d1b4690b3f8b 109 * @return pointer to FileHandle to override normal stream otherwise NULL
AnnaBridge 165:d1b4690b3f8b 110 */
AnnaBridge 165:d1b4690b3f8b 111 FileHandle* mbed_target_override_console(int fd);
AnnaBridge 165:d1b4690b3f8b 112
AnnaBridge 165:d1b4690b3f8b 113 /** Applications may implement this to change stdin, stdout, stderr.
AnnaBridge 165:d1b4690b3f8b 114 *
AnnaBridge 165:d1b4690b3f8b 115 * This hook gives the application a chance to specify a custom FileHandle
AnnaBridge 165:d1b4690b3f8b 116 * for the console.
AnnaBridge 165:d1b4690b3f8b 117 *
AnnaBridge 165:d1b4690b3f8b 118 * If this is not provided or returns NULL, the console will be specified
AnnaBridge 165:d1b4690b3f8b 119 * by mbed_target_override_console, else will default to serial - see
AnnaBridge 165:d1b4690b3f8b 120 * mbed_target_override_console for more details.
AnnaBridge 165:d1b4690b3f8b 121 *
AnnaBridge 165:d1b4690b3f8b 122 * Example:
AnnaBridge 165:d1b4690b3f8b 123 * @code
AnnaBridge 165:d1b4690b3f8b 124 * FileHandle* mbed::mbed_override_console(int) {
AnnaBridge 165:d1b4690b3f8b 125 * static UARTSerial my_serial(D0, D1);
AnnaBridge 165:d1b4690b3f8b 126 * return &my_serial;
AnnaBridge 165:d1b4690b3f8b 127 * }
AnnaBridge 165:d1b4690b3f8b 128 * @endcode
AnnaBridge 165:d1b4690b3f8b 129
AnnaBridge 165:d1b4690b3f8b 130 * @param fd file descriptor - STDIN_FILENO, STDOUT_FILENO or STDERR_FILENO
AnnaBridge 165:d1b4690b3f8b 131 * @return pointer to FileHandle to override normal stream otherwise NULL
AnnaBridge 165:d1b4690b3f8b 132 */
AnnaBridge 165:d1b4690b3f8b 133 FileHandle* mbed_override_console(int fd);
AnnaBridge 158:1c57384330a6 134
AnnaBridge 156:ff21514d8981 135 }
AnnaBridge 165:d1b4690b3f8b 136
AnnaBridge 156:ff21514d8981 137 typedef mbed::DirHandle DIR;
AnnaBridge 156:ff21514d8981 138 #else
AnnaBridge 156:ff21514d8981 139 typedef struct Dir DIR;
AnnaBridge 156:ff21514d8981 140 #endif
AnnaBridge 156:ff21514d8981 141
AnnaBridge 156:ff21514d8981 142 /* The intent of this section is to unify the errno error values to match
AnnaBridge 156:ff21514d8981 143 * the POSIX definitions for the GCC_ARM, ARMCC and IAR compilers. This is
AnnaBridge 156:ff21514d8981 144 * necessary because the ARMCC/IAR errno.h, or sys/stat.h are missing some
AnnaBridge 156:ff21514d8981 145 * symbol definitions used by the POSIX filesystem API to return errno codes.
AnnaBridge 156:ff21514d8981 146 * Note also that ARMCC errno.h defines some symbol values differently from
AnnaBridge 156:ff21514d8981 147 * the GCC_ARM/IAR/standard POSIX definitions. The definitions guard against
AnnaBridge 156:ff21514d8981 148 * this and future changes by changing the symbol definition as shown below.
AnnaBridge 156:ff21514d8981 149 */
AnnaBridge 156:ff21514d8981 150 #undef EPERM
AnnaBridge 156:ff21514d8981 151 #define EPERM 1 /* Operation not permitted */
AnnaBridge 156:ff21514d8981 152 #undef ENOENT
AnnaBridge 156:ff21514d8981 153 #define ENOENT 2 /* No such file or directory */
AnnaBridge 156:ff21514d8981 154 #undef ESRCH
AnnaBridge 156:ff21514d8981 155 #define ESRCH 3 /* No such process */
AnnaBridge 156:ff21514d8981 156 #undef EINTR
AnnaBridge 156:ff21514d8981 157 #define EINTR 4 /* Interrupted system call */
AnnaBridge 156:ff21514d8981 158 #undef EIO
AnnaBridge 156:ff21514d8981 159 #define EIO 5 /* I/O error */
AnnaBridge 156:ff21514d8981 160 #undef ENXIO
AnnaBridge 156:ff21514d8981 161 #define ENXIO 6 /* No such device or address */
AnnaBridge 156:ff21514d8981 162 #undef E2BIG
AnnaBridge 156:ff21514d8981 163 #define E2BIG 7 /* Argument list too long */
AnnaBridge 156:ff21514d8981 164 #undef ENOEXEC
AnnaBridge 156:ff21514d8981 165 #define ENOEXEC 8 /* Exec format error */
AnnaBridge 156:ff21514d8981 166 #undef EBADF
AnnaBridge 156:ff21514d8981 167 #define EBADF 9 /* Bad file number */
AnnaBridge 156:ff21514d8981 168 #undef ECHILD
AnnaBridge 156:ff21514d8981 169 #define ECHILD 10 /* No child processes */
AnnaBridge 156:ff21514d8981 170 #undef EAGAIN
AnnaBridge 156:ff21514d8981 171 #define EAGAIN 11 /* Try again */
AnnaBridge 156:ff21514d8981 172 #undef ENOMEM
AnnaBridge 156:ff21514d8981 173 #define ENOMEM 12 /* Out of memory */
AnnaBridge 156:ff21514d8981 174 #undef EACCES
AnnaBridge 156:ff21514d8981 175 #define EACCES 13 /* Permission denied */
AnnaBridge 156:ff21514d8981 176 #undef EFAULT
AnnaBridge 156:ff21514d8981 177 #define EFAULT 14 /* Bad address */
AnnaBridge 156:ff21514d8981 178 #undef ENOTBLK
AnnaBridge 156:ff21514d8981 179 #define ENOTBLK 15 /* Block device required */
AnnaBridge 156:ff21514d8981 180 #undef EBUSY
AnnaBridge 156:ff21514d8981 181 #define EBUSY 16 /* Device or resource busy */
AnnaBridge 156:ff21514d8981 182 #undef EEXIST
AnnaBridge 156:ff21514d8981 183 #define EEXIST 17 /* File exists */
AnnaBridge 156:ff21514d8981 184 #undef EXDEV
AnnaBridge 156:ff21514d8981 185 #define EXDEV 18 /* Cross-device link */
AnnaBridge 156:ff21514d8981 186 #undef ENODEV
AnnaBridge 156:ff21514d8981 187 #define ENODEV 19 /* No such device */
AnnaBridge 156:ff21514d8981 188 #undef ENOTDIR
AnnaBridge 156:ff21514d8981 189 #define ENOTDIR 20 /* Not a directory */
AnnaBridge 156:ff21514d8981 190 #undef EISDIR
AnnaBridge 156:ff21514d8981 191 #define EISDIR 21 /* Is a directory */
AnnaBridge 156:ff21514d8981 192 #undef EINVAL
AnnaBridge 156:ff21514d8981 193 #define EINVAL 22 /* Invalid argument */
AnnaBridge 156:ff21514d8981 194 #undef ENFILE
AnnaBridge 156:ff21514d8981 195 #define ENFILE 23 /* File table overflow */
AnnaBridge 156:ff21514d8981 196 #undef EMFILE
AnnaBridge 156:ff21514d8981 197 #define EMFILE 24 /* Too many open files */
AnnaBridge 156:ff21514d8981 198 #undef ENOTTY
AnnaBridge 156:ff21514d8981 199 #define ENOTTY 25 /* Not a typewriter */
AnnaBridge 156:ff21514d8981 200 #undef ETXTBSY
AnnaBridge 156:ff21514d8981 201 #define ETXTBSY 26 /* Text file busy */
AnnaBridge 156:ff21514d8981 202 #undef EFBIG
AnnaBridge 156:ff21514d8981 203 #define EFBIG 27 /* File too large */
AnnaBridge 156:ff21514d8981 204 #undef ENOSPC
AnnaBridge 156:ff21514d8981 205 #define ENOSPC 28 /* No space left on device */
AnnaBridge 156:ff21514d8981 206 #undef ESPIPE
AnnaBridge 156:ff21514d8981 207 #define ESPIPE 29 /* Illegal seek */
AnnaBridge 156:ff21514d8981 208 #undef EROFS
AnnaBridge 156:ff21514d8981 209 #define EROFS 30 /* Read-only file system */
AnnaBridge 156:ff21514d8981 210 #undef EMLINK
AnnaBridge 156:ff21514d8981 211 #define EMLINK 31 /* Too many links */
AnnaBridge 156:ff21514d8981 212 #undef EPIPE
AnnaBridge 156:ff21514d8981 213 #define EPIPE 32 /* Broken pipe */
AnnaBridge 156:ff21514d8981 214 #undef EDOM
AnnaBridge 156:ff21514d8981 215 #define EDOM 33 /* Math argument out of domain of func */
AnnaBridge 156:ff21514d8981 216 #undef ERANGE
AnnaBridge 156:ff21514d8981 217 #define ERANGE 34 /* Math result not representable */
AnnaBridge 156:ff21514d8981 218 #undef EDEADLK
AnnaBridge 156:ff21514d8981 219 #define EDEADLK 35 /* Resource deadlock would occur */
AnnaBridge 156:ff21514d8981 220 #undef ENAMETOOLONG
AnnaBridge 156:ff21514d8981 221 #define ENAMETOOLONG 36 /* File name too long */
AnnaBridge 156:ff21514d8981 222 #undef ENOLCK
AnnaBridge 156:ff21514d8981 223 #define ENOLCK 37 /* No record locks available */
AnnaBridge 156:ff21514d8981 224 #undef ENOSYS
AnnaBridge 156:ff21514d8981 225 #define ENOSYS 38 /* Function not implemented */
AnnaBridge 156:ff21514d8981 226 #undef ENOTEMPTY
AnnaBridge 156:ff21514d8981 227 #define ENOTEMPTY 39 /* Directory not empty */
AnnaBridge 156:ff21514d8981 228 #undef ELOOP
AnnaBridge 156:ff21514d8981 229 #define ELOOP 40 /* Too many symbolic links encountered */
AnnaBridge 156:ff21514d8981 230 #undef EWOULDBLOCK
AnnaBridge 156:ff21514d8981 231 #define EWOULDBLOCK EAGAIN /* Operation would block */
AnnaBridge 156:ff21514d8981 232 #undef ENOMSG
AnnaBridge 156:ff21514d8981 233 #define ENOMSG 42 /* No message of desired type */
AnnaBridge 156:ff21514d8981 234 #undef EIDRM
AnnaBridge 156:ff21514d8981 235 #define EIDRM 43 /* Identifier removed */
AnnaBridge 156:ff21514d8981 236 #undef ECHRNG
AnnaBridge 156:ff21514d8981 237 #define ECHRNG 44 /* Channel number out of range */
AnnaBridge 156:ff21514d8981 238 #undef EL2NSYNC
AnnaBridge 156:ff21514d8981 239 #define EL2NSYNC 45 /* Level 2 not synchronized */
AnnaBridge 156:ff21514d8981 240 #undef EL3HLT
AnnaBridge 156:ff21514d8981 241 #define EL3HLT 46 /* Level 3 halted */
AnnaBridge 156:ff21514d8981 242 #undef EL3RST
AnnaBridge 156:ff21514d8981 243 #define EL3RST 47 /* Level 3 reset */
AnnaBridge 156:ff21514d8981 244 #undef ELNRNG
AnnaBridge 156:ff21514d8981 245 #define ELNRNG 48 /* Link number out of range */
AnnaBridge 156:ff21514d8981 246 #undef EUNATCH
AnnaBridge 156:ff21514d8981 247 #define EUNATCH 49 /* Protocol driver not attached */
AnnaBridge 156:ff21514d8981 248 #undef ENOCSI
AnnaBridge 156:ff21514d8981 249 #define ENOCSI 50 /* No CSI structure available */
AnnaBridge 156:ff21514d8981 250 #undef EL2HLT
AnnaBridge 156:ff21514d8981 251 #define EL2HLT 51 /* Level 2 halted */
AnnaBridge 156:ff21514d8981 252 #undef EBADE
AnnaBridge 156:ff21514d8981 253 #define EBADE 52 /* Invalid exchange */
AnnaBridge 156:ff21514d8981 254 #undef EBADR
AnnaBridge 156:ff21514d8981 255 #define EBADR 53 /* Invalid request descriptor */
AnnaBridge 156:ff21514d8981 256 #undef EXFULL
AnnaBridge 156:ff21514d8981 257 #define EXFULL 54 /* Exchange full */
AnnaBridge 156:ff21514d8981 258 #undef ENOANO
AnnaBridge 156:ff21514d8981 259 #define ENOANO 55 /* No anode */
AnnaBridge 156:ff21514d8981 260 #undef EBADRQC
AnnaBridge 156:ff21514d8981 261 #define EBADRQC 56 /* Invalid request code */
AnnaBridge 156:ff21514d8981 262 #undef EBADSLT
AnnaBridge 156:ff21514d8981 263 #define EBADSLT 57 /* Invalid slot */
AnnaBridge 156:ff21514d8981 264 #undef EDEADLOCK
AnnaBridge 156:ff21514d8981 265 #define EDEADLOCK EDEADLK /* Resource deadlock would occur */
AnnaBridge 156:ff21514d8981 266 #undef EBFONT
AnnaBridge 156:ff21514d8981 267 #define EBFONT 59 /* Bad font file format */
AnnaBridge 156:ff21514d8981 268 #undef ENOSTR
AnnaBridge 156:ff21514d8981 269 #define ENOSTR 60 /* Device not a stream */
AnnaBridge 156:ff21514d8981 270 #undef ENODATA
AnnaBridge 156:ff21514d8981 271 #define ENODATA 61 /* No data available */
AnnaBridge 156:ff21514d8981 272 #undef ETIME
AnnaBridge 156:ff21514d8981 273 #define ETIME 62 /* Timer expired */
AnnaBridge 156:ff21514d8981 274 #undef ENOSR
AnnaBridge 156:ff21514d8981 275 #define ENOSR 63 /* Out of streams resources */
AnnaBridge 156:ff21514d8981 276 #undef ENONET
AnnaBridge 156:ff21514d8981 277 #define ENONET 64 /* Machine is not on the network */
AnnaBridge 156:ff21514d8981 278 #undef ENOPKG
AnnaBridge 156:ff21514d8981 279 #define ENOPKG 65 /* Package not installed */
AnnaBridge 156:ff21514d8981 280 #undef EREMOTE
AnnaBridge 156:ff21514d8981 281 #define EREMOTE 66 /* Object is remote */
AnnaBridge 156:ff21514d8981 282 #undef ENOLINK
AnnaBridge 156:ff21514d8981 283 #define ENOLINK 67 /* Link has been severed */
AnnaBridge 156:ff21514d8981 284 #undef EADV
AnnaBridge 156:ff21514d8981 285 #define EADV 68 /* Advertise error */
AnnaBridge 156:ff21514d8981 286 #undef ESRMNT
AnnaBridge 156:ff21514d8981 287 #define ESRMNT 69 /* Srmount error */
AnnaBridge 156:ff21514d8981 288 #undef ECOMM
AnnaBridge 156:ff21514d8981 289 #define ECOMM 70 /* Communication error on send */
AnnaBridge 156:ff21514d8981 290 #undef EPROTO
AnnaBridge 156:ff21514d8981 291 #define EPROTO 71 /* Protocol error */
AnnaBridge 156:ff21514d8981 292 #undef EMULTIHOP
AnnaBridge 156:ff21514d8981 293 #define EMULTIHOP 72 /* Multihop attempted */
AnnaBridge 156:ff21514d8981 294 #undef EDOTDOT
AnnaBridge 156:ff21514d8981 295 #define EDOTDOT 73 /* RFS specific error */
AnnaBridge 156:ff21514d8981 296 #undef EBADMSG
AnnaBridge 156:ff21514d8981 297 #define EBADMSG 74 /* Not a data message */
AnnaBridge 156:ff21514d8981 298 #undef EOVERFLOW
AnnaBridge 156:ff21514d8981 299 #define EOVERFLOW 75 /* Value too large for defined data type */
AnnaBridge 156:ff21514d8981 300 #undef ENOTUNIQ
AnnaBridge 156:ff21514d8981 301 #define ENOTUNIQ 76 /* Name not unique on network */
AnnaBridge 156:ff21514d8981 302 #undef EBADFD
AnnaBridge 156:ff21514d8981 303 #define EBADFD 77 /* File descriptor in bad state */
AnnaBridge 156:ff21514d8981 304 #undef EREMCHG
AnnaBridge 156:ff21514d8981 305 #define EREMCHG 78 /* Remote address changed */
AnnaBridge 156:ff21514d8981 306 #undef ELIBACC
AnnaBridge 156:ff21514d8981 307 #define ELIBACC 79 /* Can not access a needed shared library */
AnnaBridge 156:ff21514d8981 308 #undef ELIBBAD
AnnaBridge 156:ff21514d8981 309 #define ELIBBAD 80 /* Accessing a corrupted shared library */
AnnaBridge 156:ff21514d8981 310 #undef ELIBSCN
AnnaBridge 156:ff21514d8981 311 #define ELIBSCN 81 /* .lib section in a.out corrupted */
AnnaBridge 156:ff21514d8981 312 #undef ELIBMAX
AnnaBridge 156:ff21514d8981 313 #define ELIBMAX 82 /* Attempting to link in too many shared libraries */
AnnaBridge 156:ff21514d8981 314 #undef ELIBEXEC
AnnaBridge 156:ff21514d8981 315 #define ELIBEXEC 83 /* Cannot exec a shared library directly */
AnnaBridge 156:ff21514d8981 316 #undef EILSEQ
AnnaBridge 156:ff21514d8981 317 #define EILSEQ 84 /* Illegal byte sequence */
AnnaBridge 156:ff21514d8981 318 #undef ERESTART
AnnaBridge 156:ff21514d8981 319 #define ERESTART 85 /* Interrupted system call should be restarted */
AnnaBridge 156:ff21514d8981 320 #undef ESTRPIPE
AnnaBridge 156:ff21514d8981 321 #define ESTRPIPE 86 /* Streams pipe error */
AnnaBridge 156:ff21514d8981 322 #undef EUSERS
AnnaBridge 156:ff21514d8981 323 #define EUSERS 87 /* Too many users */
AnnaBridge 156:ff21514d8981 324 #undef ENOTSOCK
AnnaBridge 156:ff21514d8981 325 #define ENOTSOCK 88 /* Socket operation on non-socket */
AnnaBridge 156:ff21514d8981 326 #undef EDESTADDRREQ
AnnaBridge 156:ff21514d8981 327 #define EDESTADDRREQ 89 /* Destination address required */
AnnaBridge 156:ff21514d8981 328 #undef EMSGSIZE
AnnaBridge 156:ff21514d8981 329 #define EMSGSIZE 90 /* Message too long */
AnnaBridge 156:ff21514d8981 330 #undef EPROTOTYPE
AnnaBridge 156:ff21514d8981 331 #define EPROTOTYPE 91 /* Protocol wrong type for socket */
AnnaBridge 156:ff21514d8981 332 #undef ENOPROTOOPT
AnnaBridge 156:ff21514d8981 333 #define ENOPROTOOPT 92 /* Protocol not available */
AnnaBridge 156:ff21514d8981 334 #undef EPROTONOSUPPORT
AnnaBridge 156:ff21514d8981 335 #define EPROTONOSUPPORT 93 /* Protocol not supported */
AnnaBridge 156:ff21514d8981 336 #undef ESOCKTNOSUPPORT
AnnaBridge 156:ff21514d8981 337 #define ESOCKTNOSUPPORT 94 /* Socket type not supported */
AnnaBridge 156:ff21514d8981 338 #undef EOPNOTSUPP
AnnaBridge 156:ff21514d8981 339 #define EOPNOTSUPP 95 /* Operation not supported on transport endpoint */
AnnaBridge 156:ff21514d8981 340 #undef EPFNOSUPPORT
AnnaBridge 156:ff21514d8981 341 #define EPFNOSUPPORT 96 /* Protocol family not supported */
AnnaBridge 156:ff21514d8981 342 #undef EAFNOSUPPORT
AnnaBridge 156:ff21514d8981 343 #define EAFNOSUPPORT 97 /* Address family not supported by protocol */
AnnaBridge 156:ff21514d8981 344 #undef EADDRINUSE
AnnaBridge 156:ff21514d8981 345 #define EADDRINUSE 98 /* Address already in use */
AnnaBridge 156:ff21514d8981 346 #undef EADDRNOTAVAIL
AnnaBridge 156:ff21514d8981 347 #define EADDRNOTAVAIL 99 /* Cannot assign requested address */
AnnaBridge 156:ff21514d8981 348 #undef ENETDOWN
AnnaBridge 156:ff21514d8981 349 #define ENETDOWN 100 /* Network is down */
AnnaBridge 156:ff21514d8981 350 #undef ENETUNREACH
AnnaBridge 156:ff21514d8981 351 #define ENETUNREACH 101 /* Network is unreachable */
AnnaBridge 156:ff21514d8981 352 #undef ENETRESET
AnnaBridge 156:ff21514d8981 353 #define ENETRESET 102 /* Network dropped connection because of reset */
AnnaBridge 156:ff21514d8981 354 #undef ECONNABORTED
AnnaBridge 156:ff21514d8981 355 #define ECONNABORTED 103 /* Software caused connection abort */
AnnaBridge 156:ff21514d8981 356 #undef ECONNRESET
AnnaBridge 156:ff21514d8981 357 #define ECONNRESET 104 /* Connection reset by peer */
AnnaBridge 156:ff21514d8981 358 #undef ENOBUFS
AnnaBridge 156:ff21514d8981 359 #define ENOBUFS 105 /* No buffer space available */
AnnaBridge 156:ff21514d8981 360 #undef EISCONN
AnnaBridge 156:ff21514d8981 361 #define EISCONN 106 /* Transport endpoint is already connected */
AnnaBridge 156:ff21514d8981 362 #undef ENOTCONN
AnnaBridge 156:ff21514d8981 363 #define ENOTCONN 107 /* Transport endpoint is not connected */
AnnaBridge 156:ff21514d8981 364 #undef ESHUTDOWN
AnnaBridge 156:ff21514d8981 365 #define ESHUTDOWN 108 /* Cannot send after transport endpoint shutdown */
AnnaBridge 156:ff21514d8981 366 #undef ETOOMANYREFS
AnnaBridge 156:ff21514d8981 367 #define ETOOMANYREFS 109 /* Too many references: cannot splice */
AnnaBridge 156:ff21514d8981 368 #undef ETIMEDOUT
AnnaBridge 156:ff21514d8981 369 #define ETIMEDOUT 110 /* Connection timed out */
AnnaBridge 156:ff21514d8981 370 #undef ECONNREFUSED
AnnaBridge 156:ff21514d8981 371 #define ECONNREFUSED 111 /* Connection refused */
AnnaBridge 156:ff21514d8981 372 #undef EHOSTDOWN
AnnaBridge 156:ff21514d8981 373 #define EHOSTDOWN 112 /* Host is down */
AnnaBridge 156:ff21514d8981 374 #undef EHOSTUNREACH
AnnaBridge 156:ff21514d8981 375 #define EHOSTUNREACH 113 /* No route to host */
AnnaBridge 156:ff21514d8981 376 #undef EALREADY
AnnaBridge 156:ff21514d8981 377 #define EALREADY 114 /* Operation already in progress */
AnnaBridge 156:ff21514d8981 378 #undef EINPROGRESS
AnnaBridge 156:ff21514d8981 379 #define EINPROGRESS 115 /* Operation now in progress */
AnnaBridge 156:ff21514d8981 380 #undef ESTALE
AnnaBridge 156:ff21514d8981 381 #define ESTALE 116 /* Stale NFS file handle */
AnnaBridge 156:ff21514d8981 382 #undef EUCLEAN
AnnaBridge 156:ff21514d8981 383 #define EUCLEAN 117 /* Structure needs cleaning */
AnnaBridge 156:ff21514d8981 384 #undef ENOTNAM
AnnaBridge 156:ff21514d8981 385 #define ENOTNAM 118 /* Not a XENIX named type file */
AnnaBridge 156:ff21514d8981 386 #undef ENAVAIL
AnnaBridge 156:ff21514d8981 387 #define ENAVAIL 119 /* No XENIX semaphores available */
AnnaBridge 156:ff21514d8981 388 #undef EISNAM
AnnaBridge 156:ff21514d8981 389 #define EISNAM 120 /* Is a named type file */
AnnaBridge 156:ff21514d8981 390 #undef EREMOTEIO
AnnaBridge 156:ff21514d8981 391 #define EREMOTEIO 121 /* Remote I/O error */
AnnaBridge 156:ff21514d8981 392 #undef EDQUOT
AnnaBridge 156:ff21514d8981 393 #define EDQUOT 122 /* Quota exceeded */
AnnaBridge 156:ff21514d8981 394 #undef ENOMEDIUM
AnnaBridge 156:ff21514d8981 395 #define ENOMEDIUM 123 /* No medium found */
AnnaBridge 156:ff21514d8981 396 #undef EMEDIUMTYPE
AnnaBridge 156:ff21514d8981 397 #define EMEDIUMTYPE 124 /* Wrong medium type */
AnnaBridge 156:ff21514d8981 398 #undef ECANCELED
AnnaBridge 156:ff21514d8981 399 #define ECANCELED 125 /* Operation Canceled */
AnnaBridge 156:ff21514d8981 400 #undef ENOKEY
AnnaBridge 156:ff21514d8981 401 #define ENOKEY 126 /* Required key not available */
AnnaBridge 156:ff21514d8981 402 #undef EKEYEXPIRED
AnnaBridge 156:ff21514d8981 403 #define EKEYEXPIRED 127 /* Key has expired */
AnnaBridge 156:ff21514d8981 404 #undef EKEYREVOKED
AnnaBridge 156:ff21514d8981 405 #define EKEYREVOKED 128 /* Key has been revoked */
AnnaBridge 156:ff21514d8981 406 #undef EKEYREJECTED
AnnaBridge 156:ff21514d8981 407 #define EKEYREJECTED 129 /* Key was rejected by service */
AnnaBridge 156:ff21514d8981 408 #undef EOWNERDEAD
AnnaBridge 156:ff21514d8981 409 #define EOWNERDEAD 130 /* Owner died */
AnnaBridge 156:ff21514d8981 410 #undef ENOTRECOVERABLE
AnnaBridge 156:ff21514d8981 411 #define ENOTRECOVERABLE 131 /* State not recoverable */
AnnaBridge 156:ff21514d8981 412
AnnaBridge 156:ff21514d8981 413 /* Missing stat.h defines.
AnnaBridge 156:ff21514d8981 414 * The following are sys/stat.h definitions not currently present in the ARMCC
AnnaBridge 156:ff21514d8981 415 * errno.h. Note, ARMCC errno.h defines some symbol values differing from
AnnaBridge 156:ff21514d8981 416 * GCC_ARM/IAR/standard POSIX definitions. Guard against this and future
AnnaBridge 156:ff21514d8981 417 * changes by changing the symbol definition for filesystem use.
AnnaBridge 156:ff21514d8981 418 */
AnnaBridge 156:ff21514d8981 419 #define _IFMT 0170000 //< type of file
AnnaBridge 156:ff21514d8981 420 #define _IFSOCK 0140000 //< socket
AnnaBridge 156:ff21514d8981 421 #define _IFLNK 0120000 //< symbolic link
AnnaBridge 156:ff21514d8981 422 #define _IFREG 0100000 //< regular
AnnaBridge 156:ff21514d8981 423 #define _IFBLK 0060000 //< block special
AnnaBridge 156:ff21514d8981 424 #define _IFDIR 0040000 //< directory
AnnaBridge 156:ff21514d8981 425 #define _IFCHR 0020000 //< character special
AnnaBridge 156:ff21514d8981 426 #define _IFIFO 0010000 //< fifo special
AnnaBridge 156:ff21514d8981 427
AnnaBridge 156:ff21514d8981 428 #define S_IFMT _IFMT //< type of file
AnnaBridge 156:ff21514d8981 429 #define S_IFSOCK _IFSOCK //< socket
AnnaBridge 156:ff21514d8981 430 #define S_IFLNK _IFLNK //< symbolic link
AnnaBridge 156:ff21514d8981 431 #define S_IFREG _IFREG //< regular
AnnaBridge 156:ff21514d8981 432 #define S_IFBLK _IFBLK //< block special
AnnaBridge 156:ff21514d8981 433 #define S_IFDIR _IFDIR //< directory
AnnaBridge 156:ff21514d8981 434 #define S_IFCHR _IFCHR //< character special
AnnaBridge 156:ff21514d8981 435 #define S_IFIFO _IFIFO //< fifo special
AnnaBridge 156:ff21514d8981 436
AnnaBridge 156:ff21514d8981 437 #define S_IRWXU (S_IRUSR | S_IWUSR | S_IXUSR)
AnnaBridge 156:ff21514d8981 438 #define S_IRUSR 0000400 ///< read permission, owner
AnnaBridge 156:ff21514d8981 439 #define S_IWUSR 0000200 ///< write permission, owner
AnnaBridge 156:ff21514d8981 440 #define S_IXUSR 0000100 ///< execute/search permission, owner
AnnaBridge 156:ff21514d8981 441 #define S_IRWXG (S_IRGRP | S_IWGRP | S_IXGRP)
AnnaBridge 156:ff21514d8981 442 #define S_IRGRP 0000040 ///< read permission, group
AnnaBridge 165:d1b4690b3f8b 443 #define S_IWGRP 0000020 ///< write permission, group
AnnaBridge 156:ff21514d8981 444 #define S_IXGRP 0000010 ///< execute/search permission, group
AnnaBridge 156:ff21514d8981 445 #define S_IRWXO (S_IROTH | S_IWOTH | S_IXOTH)
AnnaBridge 156:ff21514d8981 446 #define S_IROTH 0000004 ///< read permission, other
AnnaBridge 156:ff21514d8981 447 #define S_IWOTH 0000002 ///< write permission, other
AnnaBridge 156:ff21514d8981 448 #define S_IXOTH 0000001 ///< execute/search permission, other
AnnaBridge 156:ff21514d8981 449
AnnaBridge 156:ff21514d8981 450 /* Refer to sys/stat standard
AnnaBridge 156:ff21514d8981 451 * Note: Not all fields may be supported by the underlying filesystem
AnnaBridge 156:ff21514d8981 452 */
AnnaBridge 156:ff21514d8981 453 struct stat {
AnnaBridge 156:ff21514d8981 454 dev_t st_dev; ///< Device ID containing file
AnnaBridge 156:ff21514d8981 455 ino_t st_ino; ///< File serial number
AnnaBridge 156:ff21514d8981 456 mode_t st_mode; ///< Mode of file
AnnaBridge 156:ff21514d8981 457 nlink_t st_nlink; ///< Number of links to file
AnnaBridge 156:ff21514d8981 458
AnnaBridge 156:ff21514d8981 459 uid_t st_uid; ///< User ID
AnnaBridge 156:ff21514d8981 460 gid_t st_gid; ///< Group ID
AnnaBridge 156:ff21514d8981 461
AnnaBridge 156:ff21514d8981 462 off_t st_size; ///< Size of file in bytes
AnnaBridge 156:ff21514d8981 463
AnnaBridge 156:ff21514d8981 464 time_t st_atime; ///< Time of last access
AnnaBridge 156:ff21514d8981 465 time_t st_mtime; ///< Time of last data modification
AnnaBridge 156:ff21514d8981 466 time_t st_ctime; ///< Time of last status change
AnnaBridge 156:ff21514d8981 467 };
AnnaBridge 156:ff21514d8981 468
AnnaBridge 165:d1b4690b3f8b 469 struct statvfs {
AnnaBridge 165:d1b4690b3f8b 470 unsigned long f_bsize; ///< Filesystem block size
AnnaBridge 165:d1b4690b3f8b 471 unsigned long f_frsize; ///< Fragment size (block size)
AnnaBridge 165:d1b4690b3f8b 472
AnnaBridge 165:d1b4690b3f8b 473 fsblkcnt_t f_blocks; ///< Number of blocks
AnnaBridge 165:d1b4690b3f8b 474 fsblkcnt_t f_bfree; ///< Number of free blocks
AnnaBridge 165:d1b4690b3f8b 475 fsblkcnt_t f_bavail; ///< Number of free blocks for unprivileged users
AnnaBridge 165:d1b4690b3f8b 476
AnnaBridge 165:d1b4690b3f8b 477 unsigned long f_fsid; ///< Filesystem ID
AnnaBridge 165:d1b4690b3f8b 478
AnnaBridge 165:d1b4690b3f8b 479 unsigned long f_namemax; ///< Maximum filename length
Anna Bridge 160:5571c4ff569f 480 };
AnnaBridge 156:ff21514d8981 481
AnnaBridge 165:d1b4690b3f8b 482 /* The following are dirent.h definitions are declared here to guarantee
AnnaBridge 156:ff21514d8981 483 * consistency where structure may be different with different toolchains
AnnaBridge 156:ff21514d8981 484 */
AnnaBridge 156:ff21514d8981 485 struct dirent {
AnnaBridge 156:ff21514d8981 486 char d_name[NAME_MAX+1]; ///< Name of file
AnnaBridge 156:ff21514d8981 487 uint8_t d_type; ///< Type of file
AnnaBridge 156:ff21514d8981 488 };
AnnaBridge 156:ff21514d8981 489
AnnaBridge 156:ff21514d8981 490 enum {
AnnaBridge 156:ff21514d8981 491 DT_UNKNOWN, ///< The file type could not be determined.
AnnaBridge 156:ff21514d8981 492 DT_FIFO, ///< This is a named pipe (FIFO).
AnnaBridge 156:ff21514d8981 493 DT_CHR, ///< This is a character device.
AnnaBridge 156:ff21514d8981 494 DT_DIR, ///< This is a directory.
AnnaBridge 156:ff21514d8981 495 DT_BLK, ///< This is a block device.
AnnaBridge 156:ff21514d8981 496 DT_REG, ///< This is a regular file.
AnnaBridge 156:ff21514d8981 497 DT_LNK, ///< This is a symbolic link.
AnnaBridge 156:ff21514d8981 498 DT_SOCK, ///< This is a UNIX domain socket.
AnnaBridge 156:ff21514d8981 499 };
AnnaBridge 156:ff21514d8981 500
Anna Bridge 169:a7c7b631e539 501 /* fcntl.h defines */
Anna Bridge 169:a7c7b631e539 502 #define F_GETFL 3
Anna Bridge 169:a7c7b631e539 503 #define F_SETFL 4
Anna Bridge 169:a7c7b631e539 504
AnnaBridge 165:d1b4690b3f8b 505 struct pollfd {
AnnaBridge 165:d1b4690b3f8b 506 int fd;
AnnaBridge 165:d1b4690b3f8b 507 short events;
AnnaBridge 165:d1b4690b3f8b 508 short revents;
AnnaBridge 165:d1b4690b3f8b 509 };
AnnaBridge 165:d1b4690b3f8b 510
AnnaBridge 165:d1b4690b3f8b 511 /* POSIX-compatible I/O functions */
AnnaBridge 165:d1b4690b3f8b 512 #if __cplusplus
AnnaBridge 165:d1b4690b3f8b 513 extern "C" {
AnnaBridge 165:d1b4690b3f8b 514 #endif
AnnaBridge 165:d1b4690b3f8b 515 int open(const char *path, int oflag, ...);
AnnaBridge 165:d1b4690b3f8b 516 #ifndef __IAR_SYSTEMS_ICC__ /* IAR provides fdopen itself */
AnnaBridge 165:d1b4690b3f8b 517 #if __cplusplus
AnnaBridge 165:d1b4690b3f8b 518 std::FILE* fdopen(int fildes, const char *mode);
AnnaBridge 165:d1b4690b3f8b 519 #else
AnnaBridge 165:d1b4690b3f8b 520 FILE* fdopen(int fildes, const char *mode);
AnnaBridge 165:d1b4690b3f8b 521 #endif
AnnaBridge 165:d1b4690b3f8b 522 #endif
AnnaBridge 165:d1b4690b3f8b 523 ssize_t write(int fildes, const void *buf, size_t nbyte);
AnnaBridge 165:d1b4690b3f8b 524 ssize_t read(int fildes, void *buf, size_t nbyte);
AnnaBridge 165:d1b4690b3f8b 525 off_t lseek(int fildes, off_t offset, int whence);
AnnaBridge 165:d1b4690b3f8b 526 int isatty(int fildes);
AnnaBridge 165:d1b4690b3f8b 527 int fsync(int fildes);
Anna Bridge 169:a7c7b631e539 528 int fstat(int fildes, struct stat *st);
Anna Bridge 169:a7c7b631e539 529 int fcntl(int fildes, int cmd, ...);
AnnaBridge 165:d1b4690b3f8b 530 int poll(struct pollfd fds[], nfds_t nfds, int timeout);
AnnaBridge 165:d1b4690b3f8b 531 int close(int fildes);
AnnaBridge 165:d1b4690b3f8b 532 int stat(const char *path, struct stat *st);
AnnaBridge 165:d1b4690b3f8b 533 int statvfs(const char *path, struct statvfs *buf);
AnnaBridge 165:d1b4690b3f8b 534 DIR *opendir(const char*);
AnnaBridge 165:d1b4690b3f8b 535 struct dirent *readdir(DIR *);
AnnaBridge 165:d1b4690b3f8b 536 int closedir(DIR*);
AnnaBridge 165:d1b4690b3f8b 537 void rewinddir(DIR*);
AnnaBridge 165:d1b4690b3f8b 538 long telldir(DIR*);
AnnaBridge 165:d1b4690b3f8b 539 void seekdir(DIR*, long);
AnnaBridge 165:d1b4690b3f8b 540 int mkdir(const char *name, mode_t n);
AnnaBridge 165:d1b4690b3f8b 541 #if __cplusplus
AnnaBridge 165:d1b4690b3f8b 542 }; // extern "C"
AnnaBridge 165:d1b4690b3f8b 543
AnnaBridge 165:d1b4690b3f8b 544 namespace mbed {
AnnaBridge 165:d1b4690b3f8b 545
AnnaBridge 165:d1b4690b3f8b 546 /** This call is an analogue to POSIX fdopen().
AnnaBridge 165:d1b4690b3f8b 547 *
AnnaBridge 165:d1b4690b3f8b 548 * It associates a C stream to an already-opened FileHandle, to allow you to
AnnaBridge 165:d1b4690b3f8b 549 * use C printf/scanf/fwrite etc. The provided FileHandle must remain open -
AnnaBridge 165:d1b4690b3f8b 550 * it will be closed by the C library when fclose(FILE) is called.
AnnaBridge 165:d1b4690b3f8b 551 *
AnnaBridge 165:d1b4690b3f8b 552 * The net effect is fdopen(bind_to_fd(fh), mode), with error handling.
AnnaBridge 165:d1b4690b3f8b 553 *
AnnaBridge 165:d1b4690b3f8b 554 * @param fh a pointer to an opened FileHandle
AnnaBridge 165:d1b4690b3f8b 555 * @param mode operation upon the file descriptor, e.g., "w+"
AnnaBridge 165:d1b4690b3f8b 556 *
AnnaBridge 165:d1b4690b3f8b 557 * @returns a pointer to FILE
AnnaBridge 165:d1b4690b3f8b 558 */
AnnaBridge 165:d1b4690b3f8b 559 std::FILE* fdopen(mbed::FileHandle *fh, const char *mode);
AnnaBridge 165:d1b4690b3f8b 560
AnnaBridge 165:d1b4690b3f8b 561 /** Bind an mbed FileHandle to a POSIX file descriptor
AnnaBridge 165:d1b4690b3f8b 562 *
AnnaBridge 165:d1b4690b3f8b 563 * This is similar to fdopen, but only operating at the POSIX layer - it
AnnaBridge 165:d1b4690b3f8b 564 * associates a POSIX integer file descriptor with a FileHandle, to allow you
AnnaBridge 165:d1b4690b3f8b 565 * to use POSIX read/write calls etc. The provided FileHandle must remain open -
AnnaBridge 165:d1b4690b3f8b 566 * it will be closed when close(int) is called.
AnnaBridge 165:d1b4690b3f8b 567 *
AnnaBridge 165:d1b4690b3f8b 568 * @param fh a pointer to an opened FileHandle
AnnaBridge 165:d1b4690b3f8b 569 *
AnnaBridge 165:d1b4690b3f8b 570 * @return an integer file descriptor, or negative if no descriptors available
AnnaBridge 165:d1b4690b3f8b 571 */
AnnaBridge 165:d1b4690b3f8b 572 int bind_to_fd(mbed::FileHandle *fh);
AnnaBridge 165:d1b4690b3f8b 573
AnnaBridge 165:d1b4690b3f8b 574 } // namespace mbed
AnnaBridge 165:d1b4690b3f8b 575
AnnaBridge 165:d1b4690b3f8b 576 #endif // __cplusplus
AnnaBridge 165:d1b4690b3f8b 577
AnnaBridge 158:1c57384330a6 578 /**@}*/
AnnaBridge 158:1c57384330a6 579
AnnaBridge 158:1c57384330a6 580 /**@}*/
AnnaBridge 158:1c57384330a6 581
AnnaBridge 156:ff21514d8981 582 #endif /* RETARGET_H */