1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file.
5 #include "net/udp/udp_socket_win.h"
9 #include "base/callback.h"
10 #include "base/logging.h"
11 #include "base/message_loop/message_loop.h"
12 #include "base/metrics/histogram.h"
13 #include "base/metrics/stats_counters.h"
14 #include "base/posix/eintr_wrapper.h"
15 #include "base/rand_util.h"
16 #include "net/base/io_buffer.h"
17 #include "net/base/ip_endpoint.h"
18 #include "net/base/net_errors.h"
19 #include "net/base/net_log.h"
20 #include "net/base/net_util.h"
21 #include "net/base/winsock_init.h"
22 #include "net/base/winsock_util.h"
23 #include "net/socket/socket_descriptor.h"
24 #include "net/udp/udp_net_log_parameters.h"
28 const int kBindRetries = 10;
29 const int kPortStart = 1024;
30 const int kPortEnd = 65535;
36 // This class encapsulates all the state that has to be preserved as long as
37 // there is a network IO operation in progress. If the owner UDPSocketWin
38 // is destroyed while an operation is in progress, the Core is detached and it
39 // lives until the operation completes and the OS doesn't reference any resource
40 // declared on this class anymore.
41 class UDPSocketWin::Core : public base::RefCounted<Core> {
43 explicit Core(UDPSocketWin* socket);
45 // Start watching for the end of a read or write operation.
49 // The UDPSocketWin is going away.
50 void Detach() { socket_ = NULL; }
52 // The separate OVERLAPPED variables for asynchronous operation.
53 OVERLAPPED read_overlapped_;
54 OVERLAPPED write_overlapped_;
56 // The buffers used in Read() and Write().
57 scoped_refptr<IOBuffer> read_iobuffer_;
58 scoped_refptr<IOBuffer> write_iobuffer_;
60 // The address storage passed to WSARecvFrom().
61 SockaddrStorage recv_addr_storage_;
64 friend class base::RefCounted<Core>;
66 class ReadDelegate : public base::win::ObjectWatcher::Delegate {
68 explicit ReadDelegate(Core* core) : core_(core) {}
69 virtual ~ReadDelegate() {}
71 // base::ObjectWatcher::Delegate methods:
72 virtual void OnObjectSignaled(HANDLE object);
78 class WriteDelegate : public base::win::ObjectWatcher::Delegate {
80 explicit WriteDelegate(Core* core) : core_(core) {}
81 virtual ~WriteDelegate() {}
83 // base::ObjectWatcher::Delegate methods:
84 virtual void OnObjectSignaled(HANDLE object);
92 // The socket that created this object.
93 UDPSocketWin* socket_;
95 // |reader_| handles the signals from |read_watcher_|.
97 // |writer_| handles the signals from |write_watcher_|.
98 WriteDelegate writer_;
100 // |read_watcher_| watches for events from Read().
101 base::win::ObjectWatcher read_watcher_;
102 // |write_watcher_| watches for events from Write();
103 base::win::ObjectWatcher write_watcher_;
105 DISALLOW_COPY_AND_ASSIGN(Core);
108 UDPSocketWin::Core::Core(UDPSocketWin* socket)
112 memset(&read_overlapped_, 0, sizeof(read_overlapped_));
113 memset(&write_overlapped_, 0, sizeof(write_overlapped_));
115 read_overlapped_.hEvent = WSACreateEvent();
116 write_overlapped_.hEvent = WSACreateEvent();
119 UDPSocketWin::Core::~Core() {
120 // Make sure the message loop is not watching this object anymore.
121 read_watcher_.StopWatching();
122 write_watcher_.StopWatching();
124 WSACloseEvent(read_overlapped_.hEvent);
125 memset(&read_overlapped_, 0xaf, sizeof(read_overlapped_));
126 WSACloseEvent(write_overlapped_.hEvent);
127 memset(&write_overlapped_, 0xaf, sizeof(write_overlapped_));
130 void UDPSocketWin::Core::WatchForRead() {
131 // We grab an extra reference because there is an IO operation in progress.
132 // Balanced in ReadDelegate::OnObjectSignaled().
134 read_watcher_.StartWatching(read_overlapped_.hEvent, &reader_);
137 void UDPSocketWin::Core::WatchForWrite() {
138 // We grab an extra reference because there is an IO operation in progress.
139 // Balanced in WriteDelegate::OnObjectSignaled().
141 write_watcher_.StartWatching(write_overlapped_.hEvent, &writer_);
144 void UDPSocketWin::Core::ReadDelegate::OnObjectSignaled(HANDLE object) {
145 DCHECK_EQ(object, core_->read_overlapped_.hEvent);
147 core_->socket_->DidCompleteRead();
152 void UDPSocketWin::Core::WriteDelegate::OnObjectSignaled(HANDLE object) {
153 DCHECK_EQ(object, core_->write_overlapped_.hEvent);
155 core_->socket_->DidCompleteWrite();
160 //-----------------------------------------------------------------------------
162 UDPSocketWin::UDPSocketWin(DatagramSocket::BindType bind_type,
163 const RandIntCallback& rand_int_cb,
164 net::NetLog* net_log,
165 const net::NetLog::Source& source)
166 : socket_(INVALID_SOCKET),
168 socket_options_(SOCKET_OPTION_MULTICAST_LOOP),
169 multicast_time_to_live_(1),
170 bind_type_(bind_type),
171 rand_int_cb_(rand_int_cb),
172 recv_from_address_(NULL),
173 net_log_(BoundNetLog::Make(net_log, NetLog::SOURCE_UDP_SOCKET)) {
175 net_log_.BeginEvent(NetLog::TYPE_SOCKET_ALIVE,
176 source.ToEventParametersCallback());
177 if (bind_type == DatagramSocket::RANDOM_BIND)
178 DCHECK(!rand_int_cb.is_null());
181 UDPSocketWin::~UDPSocketWin() {
183 net_log_.EndEvent(NetLog::TYPE_SOCKET_ALIVE);
186 void UDPSocketWin::Close() {
187 DCHECK(CalledOnValidThread());
192 // Zero out any pending read/write callback state.
193 read_callback_.Reset();
194 recv_from_address_ = NULL;
195 write_callback_.Reset();
197 base::TimeTicks start_time = base::TimeTicks::Now();
198 closesocket(socket_);
199 UMA_HISTOGRAM_TIMES("Net.UDPSocketWinClose",
200 base::TimeTicks::Now() - start_time);
201 socket_ = INVALID_SOCKET;
208 int UDPSocketWin::GetPeerAddress(IPEndPoint* address) const {
209 DCHECK(CalledOnValidThread());
212 return ERR_SOCKET_NOT_CONNECTED;
214 // TODO(szym): Simplify. http://crbug.com/126152
215 if (!remote_address_.get()) {
216 SockaddrStorage storage;
217 if (getpeername(socket_, storage.addr, &storage.addr_len))
218 return MapSystemError(WSAGetLastError());
219 scoped_ptr<IPEndPoint> address(new IPEndPoint());
220 if (!address->FromSockAddr(storage.addr, storage.addr_len))
221 return ERR_ADDRESS_INVALID;
222 remote_address_.reset(address.release());
225 *address = *remote_address_;
229 int UDPSocketWin::GetLocalAddress(IPEndPoint* address) const {
230 DCHECK(CalledOnValidThread());
233 return ERR_SOCKET_NOT_CONNECTED;
235 // TODO(szym): Simplify. http://crbug.com/126152
236 if (!local_address_.get()) {
237 SockaddrStorage storage;
238 if (getsockname(socket_, storage.addr, &storage.addr_len))
239 return MapSystemError(WSAGetLastError());
240 scoped_ptr<IPEndPoint> address(new IPEndPoint());
241 if (!address->FromSockAddr(storage.addr, storage.addr_len))
242 return ERR_ADDRESS_INVALID;
243 local_address_.reset(address.release());
244 net_log_.AddEvent(NetLog::TYPE_UDP_LOCAL_ADDRESS,
245 CreateNetLogUDPConnectCallback(local_address_.get()));
248 *address = *local_address_;
252 int UDPSocketWin::Read(IOBuffer* buf,
254 const CompletionCallback& callback) {
255 return RecvFrom(buf, buf_len, NULL, callback);
258 int UDPSocketWin::RecvFrom(IOBuffer* buf,
261 const CompletionCallback& callback) {
262 DCHECK(CalledOnValidThread());
263 DCHECK_NE(INVALID_SOCKET, socket_);
264 DCHECK(read_callback_.is_null());
265 DCHECK(!recv_from_address_);
266 DCHECK(!callback.is_null()); // Synchronous operation not supported.
267 DCHECK_GT(buf_len, 0);
269 int nread = InternalRecvFrom(buf, buf_len, address);
270 if (nread != ERR_IO_PENDING)
273 read_callback_ = callback;
274 recv_from_address_ = address;
275 return ERR_IO_PENDING;
278 int UDPSocketWin::Write(IOBuffer* buf,
280 const CompletionCallback& callback) {
281 return SendToOrWrite(buf, buf_len, NULL, callback);
284 int UDPSocketWin::SendTo(IOBuffer* buf,
286 const IPEndPoint& address,
287 const CompletionCallback& callback) {
288 return SendToOrWrite(buf, buf_len, &address, callback);
291 int UDPSocketWin::SendToOrWrite(IOBuffer* buf,
293 const IPEndPoint* address,
294 const CompletionCallback& callback) {
295 DCHECK(CalledOnValidThread());
296 DCHECK_NE(INVALID_SOCKET, socket_);
297 DCHECK(write_callback_.is_null());
298 DCHECK(!callback.is_null()); // Synchronous operation not supported.
299 DCHECK_GT(buf_len, 0);
300 DCHECK(!send_to_address_.get());
302 int nwrite = InternalSendTo(buf, buf_len, address);
303 if (nwrite != ERR_IO_PENDING)
307 send_to_address_.reset(new IPEndPoint(*address));
308 write_callback_ = callback;
309 return ERR_IO_PENDING;
312 int UDPSocketWin::Connect(const IPEndPoint& address) {
313 net_log_.BeginEvent(NetLog::TYPE_UDP_CONNECT,
314 CreateNetLogUDPConnectCallback(&address));
315 int rv = InternalConnect(address);
318 net_log_.EndEventWithNetErrorCode(NetLog::TYPE_UDP_CONNECT, rv);
322 int UDPSocketWin::InternalConnect(const IPEndPoint& address) {
323 DCHECK(!is_connected());
324 DCHECK(!remote_address_.get());
325 int rv = CreateSocket(address);
329 if (bind_type_ == DatagramSocket::RANDOM_BIND)
330 rv = RandomBind(address);
331 // else connect() does the DatagramSocket::DEFAULT_BIND
338 SockaddrStorage storage;
339 if (!address.ToSockAddr(storage.addr, &storage.addr_len))
340 return ERR_ADDRESS_INVALID;
342 rv = connect(socket_, storage.addr, storage.addr_len);
344 // Close() may change the last error. Map it beforehand.
345 int result = MapSystemError(WSAGetLastError());
350 remote_address_.reset(new IPEndPoint(address));
354 int UDPSocketWin::Bind(const IPEndPoint& address) {
355 DCHECK(!is_connected());
356 int rv = CreateSocket(address);
359 rv = SetSocketOptions();
364 rv = DoBind(address);
369 local_address_.reset();
373 int UDPSocketWin::CreateSocket(const IPEndPoint& address) {
374 addr_family_ = address.GetSockAddrFamily();
375 socket_ = CreatePlatformSocket(addr_family_, SOCK_DGRAM, IPPROTO_UDP);
376 if (socket_ == INVALID_SOCKET)
377 return MapSystemError(WSAGetLastError());
378 core_ = new Core(this);
382 bool UDPSocketWin::SetReceiveBufferSize(int32 size) {
383 DCHECK(CalledOnValidThread());
384 int rv = setsockopt(socket_, SOL_SOCKET, SO_RCVBUF,
385 reinterpret_cast<const char*>(&size), sizeof(size));
386 DCHECK(!rv) << "Could not set socket receive buffer size: " << errno;
390 bool UDPSocketWin::SetSendBufferSize(int32 size) {
391 DCHECK(CalledOnValidThread());
392 int rv = setsockopt(socket_, SOL_SOCKET, SO_SNDBUF,
393 reinterpret_cast<const char*>(&size), sizeof(size));
394 DCHECK(!rv) << "Could not set socket send buffer size: " << errno;
398 void UDPSocketWin::AllowAddressReuse() {
399 DCHECK(CalledOnValidThread());
400 DCHECK(!is_connected());
402 socket_options_ |= SOCKET_OPTION_REUSE_ADDRESS;
405 void UDPSocketWin::AllowBroadcast() {
406 DCHECK(CalledOnValidThread());
407 DCHECK(!is_connected());
409 socket_options_ |= SOCKET_OPTION_BROADCAST;
412 void UDPSocketWin::DoReadCallback(int rv) {
413 DCHECK_NE(rv, ERR_IO_PENDING);
414 DCHECK(!read_callback_.is_null());
416 // since Run may result in Read being called, clear read_callback_ up front.
417 CompletionCallback c = read_callback_;
418 read_callback_.Reset();
422 void UDPSocketWin::DoWriteCallback(int rv) {
423 DCHECK_NE(rv, ERR_IO_PENDING);
424 DCHECK(!write_callback_.is_null());
426 // since Run may result in Write being called, clear write_callback_ up front.
427 CompletionCallback c = write_callback_;
428 write_callback_.Reset();
432 void UDPSocketWin::DidCompleteRead() {
433 DWORD num_bytes, flags;
434 BOOL ok = WSAGetOverlappedResult(socket_, &core_->read_overlapped_,
435 &num_bytes, FALSE, &flags);
436 WSAResetEvent(core_->read_overlapped_.hEvent);
437 int result = ok ? num_bytes : MapSystemError(WSAGetLastError());
439 if (recv_from_address_ && result >= 0) {
440 if (!ReceiveAddressToIPEndpoint(recv_from_address_))
441 result = ERR_ADDRESS_INVALID;
443 LogRead(result, core_->read_iobuffer_->data());
444 core_->read_iobuffer_ = NULL;
445 recv_from_address_ = NULL;
446 DoReadCallback(result);
449 void UDPSocketWin::LogRead(int result, const char* bytes) const {
451 net_log_.AddEventWithNetErrorCode(NetLog::TYPE_UDP_RECEIVE_ERROR, result);
455 if (net_log_.IsLoggingAllEvents()) {
456 // Get address for logging, if |address| is NULL.
458 bool is_address_valid = ReceiveAddressToIPEndpoint(&address);
460 NetLog::TYPE_UDP_BYTES_RECEIVED,
461 CreateNetLogUDPDataTranferCallback(
463 is_address_valid ? &address : NULL));
466 base::StatsCounter read_bytes("udp.read_bytes");
467 read_bytes.Add(result);
470 void UDPSocketWin::DidCompleteWrite() {
471 DWORD num_bytes, flags;
472 BOOL ok = WSAGetOverlappedResult(socket_, &core_->write_overlapped_,
473 &num_bytes, FALSE, &flags);
474 WSAResetEvent(core_->write_overlapped_.hEvent);
475 int result = ok ? num_bytes : MapSystemError(WSAGetLastError());
476 LogWrite(result, core_->write_iobuffer_->data(), send_to_address_.get());
478 send_to_address_.reset();
479 core_->write_iobuffer_ = NULL;
480 DoWriteCallback(result);
483 void UDPSocketWin::LogWrite(int result,
485 const IPEndPoint* address) const {
487 net_log_.AddEventWithNetErrorCode(NetLog::TYPE_UDP_SEND_ERROR, result);
491 if (net_log_.IsLoggingAllEvents()) {
493 NetLog::TYPE_UDP_BYTES_SENT,
494 CreateNetLogUDPDataTranferCallback(result, bytes, address));
497 base::StatsCounter write_bytes("udp.write_bytes");
498 write_bytes.Add(result);
501 int UDPSocketWin::InternalRecvFrom(IOBuffer* buf, int buf_len,
502 IPEndPoint* address) {
503 DCHECK(!core_->read_iobuffer_);
504 SockaddrStorage& storage = core_->recv_addr_storage_;
505 storage.addr_len = sizeof(storage.addr_storage);
508 read_buffer.buf = buf->data();
509 read_buffer.len = buf_len;
513 CHECK_NE(INVALID_SOCKET, socket_);
514 AssertEventNotSignaled(core_->read_overlapped_.hEvent);
515 int rv = WSARecvFrom(socket_, &read_buffer, 1, &num, &flags, storage.addr,
516 &storage.addr_len, &core_->read_overlapped_, NULL);
518 if (ResetEventIfSignaled(core_->read_overlapped_.hEvent)) {
521 if (address && result >= 0) {
522 if (!ReceiveAddressToIPEndpoint(address))
525 LogRead(result, buf->data());
529 int os_error = WSAGetLastError();
530 if (os_error != WSA_IO_PENDING) {
531 int result = MapSystemError(os_error);
532 LogRead(result, NULL);
536 core_->WatchForRead();
537 core_->read_iobuffer_ = buf;
538 return ERR_IO_PENDING;
541 int UDPSocketWin::InternalSendTo(IOBuffer* buf, int buf_len,
542 const IPEndPoint* address) {
543 DCHECK(!core_->write_iobuffer_);
544 SockaddrStorage storage;
545 struct sockaddr* addr = storage.addr;
549 storage.addr_len = 0;
551 if (!address->ToSockAddr(addr, &storage.addr_len)) {
552 int result = ERR_FAILED;
553 LogWrite(result, NULL, NULL);
559 write_buffer.buf = buf->data();
560 write_buffer.len = buf_len;
564 AssertEventNotSignaled(core_->write_overlapped_.hEvent);
565 int rv = WSASendTo(socket_, &write_buffer, 1, &num, flags,
566 addr, storage.addr_len, &core_->write_overlapped_, NULL);
568 if (ResetEventIfSignaled(core_->write_overlapped_.hEvent)) {
570 LogWrite(result, buf->data(), address);
574 int os_error = WSAGetLastError();
575 if (os_error != WSA_IO_PENDING) {
576 int result = MapSystemError(os_error);
577 LogWrite(result, NULL, NULL);
582 core_->WatchForWrite();
583 core_->write_iobuffer_ = buf;
584 return ERR_IO_PENDING;
587 int UDPSocketWin::SetSocketOptions() {
589 if (socket_options_ & SOCKET_OPTION_REUSE_ADDRESS) {
590 int rv = setsockopt(socket_, SOL_SOCKET, SO_REUSEADDR,
591 reinterpret_cast<const char*>(&true_value),
594 return MapSystemError(WSAGetLastError());
596 if (socket_options_ & SOCKET_OPTION_BROADCAST) {
597 int rv = setsockopt(socket_, SOL_SOCKET, SO_BROADCAST,
598 reinterpret_cast<const char*>(&true_value),
601 return MapSystemError(WSAGetLastError());
603 if (!(socket_options_ & SOCKET_OPTION_MULTICAST_LOOP)) {
606 addr_family_ == AF_INET ? IPPROTO_IP : IPPROTO_IPV6;
608 addr_family_ == AF_INET ? IP_MULTICAST_LOOP: IPV6_MULTICAST_LOOP;
609 int rv = setsockopt(socket_, protocol_level, option,
610 reinterpret_cast<const char*>(&loop), sizeof(loop));
612 return MapSystemError(WSAGetLastError());
614 if (multicast_time_to_live_ != 1) {
615 DWORD hops = multicast_time_to_live_;
617 addr_family_ == AF_INET ? IPPROTO_IP : IPPROTO_IPV6;
619 addr_family_ == AF_INET ? IP_MULTICAST_TTL: IPV6_MULTICAST_HOPS;
620 int rv = setsockopt(socket_, protocol_level, option,
621 reinterpret_cast<const char*>(&hops), sizeof(hops));
623 return MapSystemError(WSAGetLastError());
628 int UDPSocketWin::DoBind(const IPEndPoint& address) {
629 SockaddrStorage storage;
630 if (!address.ToSockAddr(storage.addr, &storage.addr_len))
631 return ERR_ADDRESS_INVALID;
632 int rv = bind(socket_, storage.addr, storage.addr_len);
633 return rv < 0 ? MapSystemError(WSAGetLastError()) : rv;
636 int UDPSocketWin::RandomBind(const IPEndPoint& address) {
637 DCHECK(bind_type_ == DatagramSocket::RANDOM_BIND && !rand_int_cb_.is_null());
639 // Construct IPAddressNumber of appropriate size (IPv4 or IPv6) of 0s.
640 IPAddressNumber ip(address.address().size());
642 for (int i = 0; i < kBindRetries; ++i) {
643 int rv = DoBind(IPEndPoint(ip, rand_int_cb_.Run(kPortStart, kPortEnd)));
644 if (rv == OK || rv != ERR_ADDRESS_IN_USE)
647 return DoBind(IPEndPoint(ip, 0));
650 bool UDPSocketWin::ReceiveAddressToIPEndpoint(IPEndPoint* address) const {
651 SockaddrStorage& storage = core_->recv_addr_storage_;
652 return address->FromSockAddr(storage.addr, storage.addr_len);
655 int UDPSocketWin::JoinGroup(
656 const IPAddressNumber& group_address) const {
657 DCHECK(CalledOnValidThread());
659 return ERR_SOCKET_NOT_CONNECTED;
661 switch (group_address.size()) {
662 case kIPv4AddressSize: {
663 if (addr_family_ != AF_INET)
664 return ERR_ADDRESS_INVALID;
666 mreq.imr_interface.s_addr = INADDR_ANY;
667 memcpy(&mreq.imr_multiaddr, &group_address[0], kIPv4AddressSize);
668 int rv = setsockopt(socket_, IPPROTO_IP, IP_ADD_MEMBERSHIP,
669 reinterpret_cast<const char*>(&mreq),
672 return MapSystemError(WSAGetLastError());
675 case kIPv6AddressSize: {
676 if (addr_family_ != AF_INET6)
677 return ERR_ADDRESS_INVALID;
679 mreq.ipv6mr_interface = 0; // 0 indicates default multicast interface.
680 memcpy(&mreq.ipv6mr_multiaddr, &group_address[0], kIPv6AddressSize);
681 int rv = setsockopt(socket_, IPPROTO_IPV6, IPV6_ADD_MEMBERSHIP,
682 reinterpret_cast<const char*>(&mreq),
685 return MapSystemError(WSAGetLastError());
689 NOTREACHED() << "Invalid address family";
690 return ERR_ADDRESS_INVALID;
694 int UDPSocketWin::LeaveGroup(
695 const IPAddressNumber& group_address) const {
696 DCHECK(CalledOnValidThread());
698 return ERR_SOCKET_NOT_CONNECTED;
700 switch (group_address.size()) {
701 case kIPv4AddressSize: {
702 if (addr_family_ != AF_INET)
703 return ERR_ADDRESS_INVALID;
705 mreq.imr_interface.s_addr = INADDR_ANY;
706 memcpy(&mreq.imr_multiaddr, &group_address[0], kIPv4AddressSize);
707 int rv = setsockopt(socket_, IPPROTO_IP, IP_DROP_MEMBERSHIP,
708 reinterpret_cast<const char*>(&mreq),
711 return MapSystemError(WSAGetLastError());
714 case kIPv6AddressSize: {
715 if (addr_family_ != AF_INET6)
716 return ERR_ADDRESS_INVALID;
718 mreq.ipv6mr_interface = 0; // 0 indicates default multicast interface.
719 memcpy(&mreq.ipv6mr_multiaddr, &group_address[0], kIPv6AddressSize);
720 int rv = setsockopt(socket_, IPPROTO_IPV6, IP_DROP_MEMBERSHIP,
721 reinterpret_cast<const char*>(&mreq),
724 return MapSystemError(WSAGetLastError());
728 NOTREACHED() << "Invalid address family";
729 return ERR_ADDRESS_INVALID;
733 int UDPSocketWin::SetMulticastTimeToLive(int time_to_live) {
734 DCHECK(CalledOnValidThread());
736 return ERR_SOCKET_IS_CONNECTED;
738 if (time_to_live < 0 || time_to_live > 255)
739 return ERR_INVALID_ARGUMENT;
740 multicast_time_to_live_ = time_to_live;
744 int UDPSocketWin::SetMulticastLoopbackMode(bool loopback) {
745 DCHECK(CalledOnValidThread());
747 return ERR_SOCKET_IS_CONNECTED;
750 socket_options_ |= SOCKET_OPTION_MULTICAST_LOOP;
752 socket_options_ &= ~SOCKET_OPTION_MULTICAST_LOOP;
756 // TODO(hubbe): Implement differentiated services for windows.
757 // Note: setsockopt(IP_TOS) does not work on windows XP and later.
758 int UDPSocketWin::SetDiffServCodePoint(DiffServCodePoint dscp) {
759 return ERR_NOT_IMPLEMENTED;