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@172:65be27845400, 2019-02-20 (annotated)

Committer:
AnnaBridge
Date:
Wed Feb 20 20:53:29 2019 +0000
Revision:
172:65be27845400
Parent:
170:e95d10626187 
mbed library release version 165

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