NetworkSocketAPI
Dependents: HelloWizFi250Interface
Fork of NetworkSocketAPI by
TCPServer.h@96:656011e49d9f, 2016-04-19 (annotated)
- Committer:
- Christopher Haster
- Date:
- Tue Apr 19 18:24:34 2016 -0500
- Revision:
- 96:656011e49d9f
- Parent:
- 92:dd5f19874adf
- Child:
- 98:0f614f1d0398
Added better support for SocketAddress/string addresses/ports
Who changed what in which revision?
User | Revision | Line number | New contents of line |
---|---|---|---|
Christopher Haster |
89:b1d417383c0d | 1 | /* Socket |
Christopher Haster |
89:b1d417383c0d | 2 | * Copyright (c) 2015 ARM Limited |
Christopher Haster |
89:b1d417383c0d | 3 | * |
Christopher Haster |
89:b1d417383c0d | 4 | * Licensed under the Apache License, Version 2.0 (the "License"); |
Christopher Haster |
89:b1d417383c0d | 5 | * you may not use this file except in compliance with the License. |
Christopher Haster |
89:b1d417383c0d | 6 | * You may obtain a copy of the License at |
Christopher Haster |
89:b1d417383c0d | 7 | * |
Christopher Haster |
89:b1d417383c0d | 8 | * http://www.apache.org/licenses/LICENSE-2.0 |
Christopher Haster |
89:b1d417383c0d | 9 | * |
Christopher Haster |
89:b1d417383c0d | 10 | * Unless required by applicable law or agreed to in writing, software |
Christopher Haster |
89:b1d417383c0d | 11 | * distributed under the License is distributed on an "AS IS" BASIS, |
Christopher Haster |
89:b1d417383c0d | 12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
Christopher Haster |
89:b1d417383c0d | 13 | * See the License for the specific language governing permissions and |
Christopher Haster |
89:b1d417383c0d | 14 | * limitations under the License. |
Christopher Haster |
89:b1d417383c0d | 15 | */ |
Christopher Haster |
89:b1d417383c0d | 16 | |
Christopher Haster |
89:b1d417383c0d | 17 | #ifndef TCPSERVER_H |
Christopher Haster |
89:b1d417383c0d | 18 | #define TCPSERVER_H |
Christopher Haster |
89:b1d417383c0d | 19 | |
Christopher Haster |
89:b1d417383c0d | 20 | #include "Socket.h" |
Christopher Haster |
89:b1d417383c0d | 21 | #include "TCPSocket.h" |
Christopher Haster |
89:b1d417383c0d | 22 | #include "NetworkInterface.h" |
Christopher Haster |
89:b1d417383c0d | 23 | |
Christopher Haster |
89:b1d417383c0d | 24 | /** TCP Server. |
Christopher Haster |
89:b1d417383c0d | 25 | */ |
Christopher Haster |
89:b1d417383c0d | 26 | class TCPServer : public Socket { |
Christopher Haster |
89:b1d417383c0d | 27 | public: |
Christopher Haster |
89:b1d417383c0d | 28 | /** TCP Server lifetime |
Christopher Haster |
89:b1d417383c0d | 29 | */ |
Christopher Haster |
90:0a988e4abb72 | 30 | TCPServer(); |
Christopher Haster |
89:b1d417383c0d | 31 | TCPServer(NetworkInterface *iface); |
Christopher Haster |
89:b1d417383c0d | 32 | virtual ~TCPServer(); |
Christopher Haster |
90:0a988e4abb72 | 33 | |
Christopher Haster |
90:0a988e4abb72 | 34 | /** Open the socket |
Christopher Haster |
90:0a988e4abb72 | 35 | * @param iface Interface to open socket on |
Christopher Haster |
90:0a988e4abb72 | 36 | */ |
Christopher Haster |
90:0a988e4abb72 | 37 | virtual int open(NetworkInterface *iface); |
Christopher Haster |
89:b1d417383c0d | 38 | |
Christopher Haster |
96:656011e49d9f | 39 | /** Bind a TCP Server to a specific port |
Christopher Haster |
96:656011e49d9f | 40 | * @param port The port to listen for incoming connections on |
Christopher Haster |
96:656011e49d9f | 41 | * @return 0 on success, negative on failure. |
Christopher Haster |
89:b1d417383c0d | 42 | */ |
Christopher Haster |
89:b1d417383c0d | 43 | int bind(uint16_t port); |
Christopher Haster |
96:656011e49d9f | 44 | |
Christopher Haster |
96:656011e49d9f | 45 | /** Bind a TCP Server to a local address |
Christopher Haster |
96:656011e49d9f | 46 | * @param address The null-terminated address to listen for incoming connections on |
Christopher Haster |
96:656011e49d9f | 47 | * @param port The port to listen for incoming connections on |
Christopher Haster |
96:656011e49d9f | 48 | * @return 0 on success, negative on failure. |
Christopher Haster |
96:656011e49d9f | 49 | */ |
Christopher Haster |
96:656011e49d9f | 50 | int bind(const char *address, uint16_t port); |
Christopher Haster |
96:656011e49d9f | 51 | |
Christopher Haster |
96:656011e49d9f | 52 | /** Bind a TCP Server to a local address |
Christopher Haster |
96:656011e49d9f | 53 | * @param address The SocketAddress to listen for incoming connections on |
Christopher Haster |
96:656011e49d9f | 54 | * @return 0 on success, negative on failure. |
Christopher Haster |
96:656011e49d9f | 55 | */ |
Christopher Haster |
96:656011e49d9f | 56 | int bind(const SocketAddress &address); |
Christopher Haster |
89:b1d417383c0d | 57 | |
Christopher Haster |
89:b1d417383c0d | 58 | /** Start listening for incoming connections |
Christopher Haster |
89:b1d417383c0d | 59 | * @param backlog Number of pending connections that can be queued up at any |
Christopher Haster |
89:b1d417383c0d | 60 | * one time [Default: 1] |
Christopher Haster |
89:b1d417383c0d | 61 | * @return 0 on success, negative on failure |
Christopher Haster |
89:b1d417383c0d | 62 | */ |
Christopher Haster |
89:b1d417383c0d | 63 | int listen(int backlog=1); |
Christopher Haster |
89:b1d417383c0d | 64 | |
Christopher Haster |
89:b1d417383c0d | 65 | /** Accept a new connection. |
Christopher Haster |
89:b1d417383c0d | 66 | * @param socket A TCPSocket instance that will handle the incoming connection. |
Christopher Haster |
89:b1d417383c0d | 67 | * @return 0 on success, negative on failure. |
Christopher Haster |
89:b1d417383c0d | 68 | */ |
Christopher Haster |
89:b1d417383c0d | 69 | int accept(TCPSocket *connection); |
Christopher Haster |
89:b1d417383c0d | 70 | }; |
Christopher Haster |
89:b1d417383c0d | 71 | |
Christopher Haster |
89:b1d417383c0d | 72 | #endif |