blob: a9b7b16a6577db6e99407650b72424fb601ee924 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
|
// Copyright 2020 The Pigweed Authors
//
// Licensed under the Apache License, Version 2.0 (the "License"); you may not
// use this file except in compliance with the License. You may obtain a copy of
// the License at
//
// https://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
// WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
// License for the specific language governing permissions and limitations under
// the License.
#pragma once
#include <cstdint>
#include "pw_result/result.h"
#include "pw_span/span.h"
#include "pw_stream/stream.h"
namespace pw::stream {
class SocketStream : public NonSeekableReaderWriter {
public:
constexpr SocketStream() = default;
// Construct a SocketStream directly from a file descriptor.
explicit SocketStream(int connection_fd) : connection_fd_(connection_fd) {}
// SocketStream objects are moveable but not copyable.
SocketStream& operator=(SocketStream&& other) {
connection_fd_ = other.connection_fd_;
other.connection_fd_ = kInvalidFd;
return *this;
}
SocketStream(SocketStream&& other) noexcept
: connection_fd_(other.connection_fd_) {
other.connection_fd_ = kInvalidFd;
}
SocketStream(const SocketStream&) = delete;
SocketStream& operator=(const SocketStream&) = delete;
~SocketStream() override { Close(); }
// Connect to a local or remote endpoint. Host may be either an IPv4 or IPv6
// address. If host is nullptr then the IPv4 localhost address is used
// instead.
Status Connect(const char* host, uint16_t port);
// Close the socket stream and release all resources
void Close();
// Exposes the file descriptor for the active connection. This is exposed to
// allow configuration and introspection of this socket's current
// configuration using setsockopt() and getsockopt().
//
// Returns -1 if there is no active connection.
int connection_fd() { return connection_fd_; }
private:
friend class ServerSocket;
static constexpr int kInvalidFd = -1;
Status DoWrite(span<const std::byte> data) override;
StatusWithSize DoRead(ByteSpan dest) override;
int connection_fd_ = kInvalidFd;
};
/// `ServerSocket` wraps a POSIX-style server socket, producing a `SocketStream`
/// for each accepted client connection.
///
/// Call `Listen` to create the socket and start listening for connections.
/// Then call `Accept` any number of times to accept client connections.
class ServerSocket {
public:
ServerSocket() = default;
~ServerSocket() { Close(); }
ServerSocket(const ServerSocket& other) = delete;
ServerSocket& operator=(const ServerSocket& other) = delete;
// Listen for connections on the given port.
// If port is 0, a random unused port is chosen and can be retrieved with
// port().
Status Listen(uint16_t port = 0);
// Accept a connection. Blocks until after a client is connected.
// On success, returns a SocketStream connected to the new client.
Result<SocketStream> Accept();
// Close the server socket, preventing further connections.
void Close();
// Returns the port this socket is listening on.
uint16_t port() const { return port_; }
private:
static constexpr int kInvalidFd = -1;
uint16_t port_ = -1;
int socket_fd_ = kInvalidFd;
};
} // namespace pw::stream
|
