Sharvil Nanavati | c2031c4 | 2014-07-25 15:50:17 -0700 | [diff] [blame] | 1 | /****************************************************************************** |
| 2 | * |
| 3 | * Copyright (C) 2014 Google, Inc. |
| 4 | * |
| 5 | * Licensed under the Apache License, Version 2.0 (the "License"); |
| 6 | * you may not use this file except in compliance with the License. |
| 7 | * You may obtain a copy of the License at: |
| 8 | * |
| 9 | * http://www.apache.org/licenses/LICENSE-2.0 |
| 10 | * |
| 11 | * Unless required by applicable law or agreed to in writing, software |
| 12 | * distributed under the License is distributed on an "AS IS" BASIS, |
| 13 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| 14 | * See the License for the specific language governing permissions and |
| 15 | * limitations under the License. |
| 16 | * |
| 17 | ******************************************************************************/ |
| 18 | |
| 19 | #pragma once |
| 20 | |
Sharvil Nanavati | 98bf85f | 2014-08-27 19:05:40 -0700 | [diff] [blame] | 21 | #include <stdbool.h> |
Sharvil Nanavati | c2031c4 | 2014-07-25 15:50:17 -0700 | [diff] [blame] | 22 | #include <stddef.h> |
| 23 | #include <stdint.h> |
Sharvil Nanavati | 98bf85f | 2014-08-27 19:05:40 -0700 | [diff] [blame] | 24 | #include <sys/types.h> |
Sharvil Nanavati | c2031c4 | 2014-07-25 15:50:17 -0700 | [diff] [blame] | 25 | |
Jakub Pawlowski | 713993d | 2016-04-21 13:16:45 -0700 | [diff] [blame] | 26 | #ifdef __cplusplus |
| 27 | extern "C" { |
| 28 | #endif |
| 29 | |
Sharvil Nanavati | c2031c4 | 2014-07-25 15:50:17 -0700 | [diff] [blame] | 30 | typedef struct reactor_t reactor_t; |
| 31 | typedef struct socket_t socket_t; |
| 32 | typedef uint16_t port_t; |
| 33 | |
Myles Watson | b55040c | 2016-10-19 13:15:34 -0700 | [diff] [blame] | 34 | typedef void (*socket_cb)(socket_t* socket, void* context); |
Sharvil Nanavati | c2031c4 | 2014-07-25 15:50:17 -0700 | [diff] [blame] | 35 | |
Myles Watson | b55040c | 2016-10-19 13:15:34 -0700 | [diff] [blame] | 36 | // Returns a new socket object. The socket is in an idle, disconnected state |
| 37 | // when |
Sharvil Nanavati | c2031c4 | 2014-07-25 15:50:17 -0700 | [diff] [blame] | 38 | // it is returned by this function. The returned object must be freed by calling |
| 39 | // |socket_free|. Returns NULL on failure. |
Myles Watson | b55040c | 2016-10-19 13:15:34 -0700 | [diff] [blame] | 40 | socket_t* socket_new(void); |
Sharvil Nanavati | c2031c4 | 2014-07-25 15:50:17 -0700 | [diff] [blame] | 41 | |
Sharvil Nanavati | ad3067b | 2014-08-21 18:13:46 -0700 | [diff] [blame] | 42 | // Returns a new socket object backed by |fd|. The socket object is in whichever |
Myles Watson | b55040c | 2016-10-19 13:15:34 -0700 | [diff] [blame] | 43 | // state |fd| is in when it was passed to this function. The returned object |
| 44 | // must |
Sharvil Nanavati | ad3067b | 2014-08-21 18:13:46 -0700 | [diff] [blame] | 45 | // be freed by calling |socket_free|. Returns NULL on failure. If this function |
Myles Watson | b55040c | 2016-10-19 13:15:34 -0700 | [diff] [blame] | 46 | // is successful, ownership of |fd| is transferred and the caller must not close |
| 47 | // it. |
| 48 | socket_t* socket_new_from_fd(int fd); |
Sharvil Nanavati | ad3067b | 2014-08-21 18:13:46 -0700 | [diff] [blame] | 49 | |
Myles Watson | b55040c | 2016-10-19 13:15:34 -0700 | [diff] [blame] | 50 | // Frees a socket object created by |socket_new| or |socket_accept|. |socket| |
| 51 | // may |
Sharvil Nanavati | c2031c4 | 2014-07-25 15:50:17 -0700 | [diff] [blame] | 52 | // be NULL. If the socket was connected, it will be disconnected. |
Myles Watson | b55040c | 2016-10-19 13:15:34 -0700 | [diff] [blame] | 53 | void socket_free(socket_t* socket); |
Sharvil Nanavati | c2031c4 | 2014-07-25 15:50:17 -0700 | [diff] [blame] | 54 | |
| 55 | // Puts |socket| in listening mode for incoming TCP connections on the specified |
Pavlin Radoslavov | d2199cb | 2015-08-17 18:54:22 -0700 | [diff] [blame] | 56 | // |port| and the loopback IPv4 address. Returns true on success, false on |
| 57 | // failure (e.g. |port| is bound by another socket). |socket| may not be NULL. |
Myles Watson | b55040c | 2016-10-19 13:15:34 -0700 | [diff] [blame] | 58 | bool socket_listen(const socket_t* socket, port_t port); |
Sharvil Nanavati | c2031c4 | 2014-07-25 15:50:17 -0700 | [diff] [blame] | 59 | |
Myles Watson | b55040c | 2016-10-19 13:15:34 -0700 | [diff] [blame] | 60 | // Blocks on a listening socket, |socket|, until a client connects to it. |
| 61 | // Returns |
Sharvil Nanavati | c2031c4 | 2014-07-25 15:50:17 -0700 | [diff] [blame] | 62 | // a connected socket on success, NULL on failure. The returned object must be |
| 63 | // freed by calling |socket_free|. |socket| may not be NULL. |
Myles Watson | b55040c | 2016-10-19 13:15:34 -0700 | [diff] [blame] | 64 | socket_t* socket_accept(const socket_t* socket); |
Sharvil Nanavati | c2031c4 | 2014-07-25 15:50:17 -0700 | [diff] [blame] | 65 | |
| 66 | // Reads up to |count| bytes from |socket| into |buf|. This function will not |
| 67 | // block. This function returns a positive integer representing the number |
| 68 | // of bytes copied into |buf| on success, 0 if the socket has disconnected, |
| 69 | // and -1 on error. This function may return a value less than |count| if not |
Pavlin Radoslavov | d6121a3 | 2016-05-12 11:36:44 -0700 | [diff] [blame] | 70 | // enough data is currently available. If this function returns -1, errno will |
| 71 | // also be set (see recv(2) for possible errno values). However, if the reading |
| 72 | // system call was interrupted with errno of EINTR, the read operation is |
| 73 | // restarted internally without propagating EINTR back to the caller. If there |
| 74 | // were no bytes available to be read, this function returns -1 and sets errno |
| 75 | // to EWOULDBLOCK. Neither |socket| nor |buf| may be NULL. |
Myles Watson | b55040c | 2016-10-19 13:15:34 -0700 | [diff] [blame] | 76 | ssize_t socket_read(const socket_t* socket, void* buf, size_t count); |
Sharvil Nanavati | c2031c4 | 2014-07-25 15:50:17 -0700 | [diff] [blame] | 77 | |
| 78 | // Writes up to |count| bytes from |buf| into |socket|. This function will not |
| 79 | // block. Returns a positive integer representing the number of bytes written |
Pavlin Radoslavov | d6121a3 | 2016-05-12 11:36:44 -0700 | [diff] [blame] | 80 | // to |socket| on success, 0 if the socket has disconnected, and -1 on error. |
| 81 | // This function may return a value less than |count| if writing more bytes |
| 82 | // would result in blocking. If this function returns -1, errno will also be |
| 83 | // set (see send(2) for possible errno values). However, if the writing system |
| 84 | // call was interrupted with errno of EINTR, the write operation is restarted |
| 85 | // internally without propagating EINTR back to the caller. If no bytes could |
| 86 | // be written without blocking, this function will return -1 and set errno to |
| 87 | // EWOULDBLOCK. Neither |socket| nor |buf| may be NULL. |
Myles Watson | b55040c | 2016-10-19 13:15:34 -0700 | [diff] [blame] | 88 | ssize_t socket_write(const socket_t* socket, const void* buf, size_t count); |
Sharvil Nanavati | c2031c4 | 2014-07-25 15:50:17 -0700 | [diff] [blame] | 89 | |
Sharvil Nanavati | ad3067b | 2014-08-21 18:13:46 -0700 | [diff] [blame] | 90 | // This function performs the same write operation as |socket_write| and also |
| 91 | // sends the file descriptor |fd| over the socket to a remote process. Ownership |
Myles Watson | b55040c | 2016-10-19 13:15:34 -0700 | [diff] [blame] | 92 | // of |fd| transfers to this function and the descriptor must not be used any |
| 93 | // longer. |
Sharvil Nanavati | ad3067b | 2014-08-21 18:13:46 -0700 | [diff] [blame] | 94 | // If |fd| is INVALID_FD, this function behaves the same as |socket_write|. |
Myles Watson | b55040c | 2016-10-19 13:15:34 -0700 | [diff] [blame] | 95 | ssize_t socket_write_and_transfer_fd(const socket_t* socket, const void* buf, |
| 96 | size_t count, int fd); |
Sharvil Nanavati | ad3067b | 2014-08-21 18:13:46 -0700 | [diff] [blame] | 97 | |
Myles Watson | b55040c | 2016-10-19 13:15:34 -0700 | [diff] [blame] | 98 | // Returns the number of bytes that can be read from |socket| without blocking. |
| 99 | // On error, |
Sharvil Nanavati | 98bf85f | 2014-08-27 19:05:40 -0700 | [diff] [blame] | 100 | // this function returns -1. |socket| may not be NULL. |
| 101 | // |
Myles Watson | b55040c | 2016-10-19 13:15:34 -0700 | [diff] [blame] | 102 | // Note: this function should not be part of the socket interface. It is only |
| 103 | // provided as |
| 104 | // a stop-gap until we can refactor away code that depends on a priori |
| 105 | // knowledge of |
| 106 | // the byte count. Do not use this function unless you need it while |
| 107 | // refactoring |
Sharvil Nanavati | 98bf85f | 2014-08-27 19:05:40 -0700 | [diff] [blame] | 108 | // legacy bluedroid code. |
Myles Watson | b55040c | 2016-10-19 13:15:34 -0700 | [diff] [blame] | 109 | ssize_t socket_bytes_available(const socket_t* socket); |
Sharvil Nanavati | 98bf85f | 2014-08-27 19:05:40 -0700 | [diff] [blame] | 110 | |
Myles Watson | b55040c | 2016-10-19 13:15:34 -0700 | [diff] [blame] | 111 | // Registers |socket| with the |reactor|. When the socket becomes readable, |
| 112 | // |read_cb| |
| 113 | // will be called. When the socket becomes writeable, |write_cb| will be called. |
| 114 | // The |
| 115 | // |context| parameter is passed, untouched, to each of the callback routines. |
| 116 | // Neither |
| 117 | // |socket| nor |reactor| may be NULL. |read_cb|, |write_cb|, and |context| may |
| 118 | // be NULL. |
| 119 | void socket_register(socket_t* socket, reactor_t* reactor, void* context, |
| 120 | socket_cb read_cb, socket_cb write_cb); |
Sharvil Nanavati | c2031c4 | 2014-07-25 15:50:17 -0700 | [diff] [blame] | 121 | |
Myles Watson | b55040c | 2016-10-19 13:15:34 -0700 | [diff] [blame] | 122 | // Unregisters |socket| from whichever reactor it is registered with, if any. |
| 123 | // This |
Sharvil Nanavati | c2031c4 | 2014-07-25 15:50:17 -0700 | [diff] [blame] | 124 | // function is idempotent. |
Myles Watson | b55040c | 2016-10-19 13:15:34 -0700 | [diff] [blame] | 125 | void socket_unregister(socket_t* socket); |
Jakub Pawlowski | 713993d | 2016-04-21 13:16:45 -0700 | [diff] [blame] | 126 | |
| 127 | #ifdef __cplusplus |
| 128 | } |
Marie Janssen | d19e078 | 2016-07-15 12:48:27 -0700 | [diff] [blame] | 129 | #endif |