Enable icu_use_data_file_flag on Android
[chromium-blink-merge.git] / ipc / ipc_channel_posix.cc
blob2bd0989ddabdc20a113f3750613853018f26b21f
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 "ipc/ipc_channel_posix.h"
7 #include <errno.h>
8 #include <fcntl.h>
9 #include <stddef.h>
10 #include <sys/socket.h>
11 #include <sys/stat.h>
12 #include <sys/types.h>
13 #include <sys/un.h>
14 #include <unistd.h>
16 #if defined(OS_OPENBSD)
17 #include <sys/uio.h>
18 #endif
20 #include <map>
21 #include <string>
23 #include "base/command_line.h"
24 #include "base/file_util.h"
25 #include "base/files/file_path.h"
26 #include "base/location.h"
27 #include "base/logging.h"
28 #include "base/memory/scoped_ptr.h"
29 #include "base/memory/singleton.h"
30 #include "base/posix/eintr_wrapper.h"
31 #include "base/posix/global_descriptors.h"
32 #include "base/process/process_handle.h"
33 #include "base/rand_util.h"
34 #include "base/stl_util.h"
35 #include "base/strings/string_util.h"
36 #include "base/synchronization/lock.h"
37 #include "ipc/file_descriptor_set_posix.h"
38 #include "ipc/ipc_descriptors.h"
39 #include "ipc/ipc_listener.h"
40 #include "ipc/ipc_logging.h"
41 #include "ipc/ipc_message_utils.h"
42 #include "ipc/ipc_switches.h"
43 #include "ipc/unix_domain_socket_util.h"
45 namespace IPC {
47 // IPC channels on Windows use named pipes (CreateNamedPipe()) with
48 // channel ids as the pipe names. Channels on POSIX use sockets as
49 // pipes These don't quite line up.
51 // When creating a child subprocess we use a socket pair and the parent side of
52 // the fork arranges it such that the initial control channel ends up on the
53 // magic file descriptor kPrimaryIPCChannel in the child. Future
54 // connections (file descriptors) can then be passed via that
55 // connection via sendmsg().
57 // A POSIX IPC channel can also be set up as a server for a bound UNIX domain
58 // socket, and will handle multiple connect and disconnect sequences. Currently
59 // it is limited to one connection at a time.
61 //------------------------------------------------------------------------------
62 namespace {
64 // The PipeMap class works around this quirk related to unit tests:
66 // When running as a server, we install the client socket in a
67 // specific file descriptor number (@kPrimaryIPCChannel). However, we
68 // also have to support the case where we are running unittests in the
69 // same process. (We do not support forking without execing.)
71 // Case 1: normal running
72 // The IPC server object will install a mapping in PipeMap from the
73 // name which it was given to the client pipe. When forking the client, the
74 // GetClientFileDescriptorMapping will ensure that the socket is installed in
75 // the magic slot (@kPrimaryIPCChannel). The client will search for the
76 // mapping, but it won't find any since we are in a new process. Thus the
77 // magic fd number is returned. Once the client connects, the server will
78 // close its copy of the client socket and remove the mapping.
80 // Case 2: unittests - client and server in the same process
81 // The IPC server will install a mapping as before. The client will search
82 // for a mapping and find out. It duplicates the file descriptor and
83 // connects. Once the client connects, the server will close the original
84 // copy of the client socket and remove the mapping. Thus, when the client
85 // object closes, it will close the only remaining copy of the client socket
86 // in the fd table and the server will see EOF on its side.
88 // TODO(port): a client process cannot connect to multiple IPC channels with
89 // this scheme.
91 class PipeMap {
92 public:
93 static PipeMap* GetInstance() {
94 return Singleton<PipeMap>::get();
97 ~PipeMap() {
98 // Shouldn't have left over pipes.
99 DCHECK(map_.empty());
102 // Lookup a given channel id. Return -1 if not found.
103 int Lookup(const std::string& channel_id) {
104 base::AutoLock locked(lock_);
106 ChannelToFDMap::const_iterator i = map_.find(channel_id);
107 if (i == map_.end())
108 return -1;
109 return i->second;
112 // Remove the mapping for the given channel id. No error is signaled if the
113 // channel_id doesn't exist
114 void Remove(const std::string& channel_id) {
115 base::AutoLock locked(lock_);
116 map_.erase(channel_id);
119 // Insert a mapping from @channel_id to @fd. It's a fatal error to insert a
120 // mapping if one already exists for the given channel_id
121 void Insert(const std::string& channel_id, int fd) {
122 base::AutoLock locked(lock_);
123 DCHECK_NE(-1, fd);
125 ChannelToFDMap::const_iterator i = map_.find(channel_id);
126 CHECK(i == map_.end()) << "Creating second IPC server (fd " << fd << ") "
127 << "for '" << channel_id << "' while first "
128 << "(fd " << i->second << ") still exists";
129 map_[channel_id] = fd;
132 private:
133 base::Lock lock_;
134 typedef std::map<std::string, int> ChannelToFDMap;
135 ChannelToFDMap map_;
137 friend struct DefaultSingletonTraits<PipeMap>;
140 //------------------------------------------------------------------------------
142 bool SocketWriteErrorIsRecoverable() {
143 #if defined(OS_MACOSX)
144 // On OS X if sendmsg() is trying to send fds between processes and there
145 // isn't enough room in the output buffer to send the fd structure over
146 // atomically then EMSGSIZE is returned.
148 // EMSGSIZE presents a problem since the system APIs can only call us when
149 // there's room in the socket buffer and not when there is "enough" room.
151 // The current behavior is to return to the event loop when EMSGSIZE is
152 // received and hopefull service another FD. This is however still
153 // technically a busy wait since the event loop will call us right back until
154 // the receiver has read enough data to allow passing the FD over atomically.
155 return errno == EAGAIN || errno == EMSGSIZE;
156 #else
157 return errno == EAGAIN;
158 #endif // OS_MACOSX
161 } // namespace
162 //------------------------------------------------------------------------------
164 #if defined(OS_LINUX)
165 int Channel::ChannelImpl::global_pid_ = 0;
166 #endif // OS_LINUX
168 Channel::ChannelImpl::ChannelImpl(const IPC::ChannelHandle& channel_handle,
169 Mode mode, Listener* listener)
170 : ChannelReader(listener),
171 mode_(mode),
172 peer_pid_(base::kNullProcessId),
173 is_blocked_on_write_(false),
174 waiting_connect_(true),
175 message_send_bytes_written_(0),
176 server_listen_pipe_(-1),
177 pipe_(-1),
178 client_pipe_(-1),
179 #if defined(IPC_USES_READWRITE)
180 fd_pipe_(-1),
181 remote_fd_pipe_(-1),
182 #endif // IPC_USES_READWRITE
183 pipe_name_(channel_handle.name),
184 must_unlink_(false) {
185 memset(input_cmsg_buf_, 0, sizeof(input_cmsg_buf_));
186 if (!CreatePipe(channel_handle)) {
187 // The pipe may have been closed already.
188 const char *modestr = (mode_ & MODE_SERVER_FLAG) ? "server" : "client";
189 LOG(WARNING) << "Unable to create pipe named \"" << channel_handle.name
190 << "\" in " << modestr << " mode";
194 Channel::ChannelImpl::~ChannelImpl() {
195 Close();
198 bool SocketPair(int* fd1, int* fd2) {
199 int pipe_fds[2];
200 if (socketpair(AF_UNIX, SOCK_STREAM, 0, pipe_fds) != 0) {
201 PLOG(ERROR) << "socketpair()";
202 return false;
205 // Set both ends to be non-blocking.
206 if (fcntl(pipe_fds[0], F_SETFL, O_NONBLOCK) == -1 ||
207 fcntl(pipe_fds[1], F_SETFL, O_NONBLOCK) == -1) {
208 PLOG(ERROR) << "fcntl(O_NONBLOCK)";
209 if (IGNORE_EINTR(close(pipe_fds[0])) < 0)
210 PLOG(ERROR) << "close";
211 if (IGNORE_EINTR(close(pipe_fds[1])) < 0)
212 PLOG(ERROR) << "close";
213 return false;
216 *fd1 = pipe_fds[0];
217 *fd2 = pipe_fds[1];
219 return true;
222 bool Channel::ChannelImpl::CreatePipe(
223 const IPC::ChannelHandle& channel_handle) {
224 DCHECK(server_listen_pipe_ == -1 && pipe_ == -1);
226 // Four possible cases:
227 // 1) It's a channel wrapping a pipe that is given to us.
228 // 2) It's for a named channel, so we create it.
229 // 3) It's for a client that we implement ourself. This is used
230 // in unittesting.
231 // 4) It's the initial IPC channel:
232 // 4a) Client side: Pull the pipe out of the GlobalDescriptors set.
233 // 4b) Server side: create the pipe.
235 int local_pipe = -1;
236 if (channel_handle.socket.fd != -1) {
237 // Case 1 from comment above.
238 local_pipe = channel_handle.socket.fd;
239 #if defined(IPC_USES_READWRITE)
240 // Test the socket passed into us to make sure it is nonblocking.
241 // We don't want to call read/write on a blocking socket.
242 int value = fcntl(local_pipe, F_GETFL);
243 if (value == -1) {
244 PLOG(ERROR) << "fcntl(F_GETFL) " << pipe_name_;
245 return false;
247 if (!(value & O_NONBLOCK)) {
248 LOG(ERROR) << "Socket " << pipe_name_ << " must be O_NONBLOCK";
249 return false;
251 #endif // IPC_USES_READWRITE
252 } else if (mode_ & MODE_NAMED_FLAG) {
253 // Case 2 from comment above.
254 if (mode_ & MODE_SERVER_FLAG) {
255 if (!CreateServerUnixDomainSocket(base::FilePath(pipe_name_),
256 &local_pipe)) {
257 return false;
259 must_unlink_ = true;
260 } else if (mode_ & MODE_CLIENT_FLAG) {
261 if (!CreateClientUnixDomainSocket(base::FilePath(pipe_name_),
262 &local_pipe)) {
263 return false;
265 } else {
266 LOG(ERROR) << "Bad mode: " << mode_;
267 return false;
269 } else {
270 local_pipe = PipeMap::GetInstance()->Lookup(pipe_name_);
271 if (mode_ & MODE_CLIENT_FLAG) {
272 if (local_pipe != -1) {
273 // Case 3 from comment above.
274 // We only allow one connection.
275 local_pipe = HANDLE_EINTR(dup(local_pipe));
276 PipeMap::GetInstance()->Remove(pipe_name_);
277 } else {
278 // Case 4a from comment above.
279 // Guard against inappropriate reuse of the initial IPC channel. If
280 // an IPC channel closes and someone attempts to reuse it by name, the
281 // initial channel must not be recycled here. http://crbug.com/26754.
282 static bool used_initial_channel = false;
283 if (used_initial_channel) {
284 LOG(FATAL) << "Denying attempt to reuse initial IPC channel for "
285 << pipe_name_;
286 return false;
288 used_initial_channel = true;
290 local_pipe =
291 base::GlobalDescriptors::GetInstance()->Get(kPrimaryIPCChannel);
293 } else if (mode_ & MODE_SERVER_FLAG) {
294 // Case 4b from comment above.
295 if (local_pipe != -1) {
296 LOG(ERROR) << "Server already exists for " << pipe_name_;
297 return false;
299 base::AutoLock lock(client_pipe_lock_);
300 if (!SocketPair(&local_pipe, &client_pipe_))
301 return false;
302 PipeMap::GetInstance()->Insert(pipe_name_, client_pipe_);
303 } else {
304 LOG(ERROR) << "Bad mode: " << mode_;
305 return false;
309 #if defined(IPC_USES_READWRITE)
310 // Create a dedicated socketpair() for exchanging file descriptors.
311 // See comments for IPC_USES_READWRITE for details.
312 if (mode_ & MODE_CLIENT_FLAG) {
313 if (!SocketPair(&fd_pipe_, &remote_fd_pipe_)) {
314 return false;
317 #endif // IPC_USES_READWRITE
319 if ((mode_ & MODE_SERVER_FLAG) && (mode_ & MODE_NAMED_FLAG)) {
320 server_listen_pipe_ = local_pipe;
321 local_pipe = -1;
324 pipe_ = local_pipe;
325 return true;
328 bool Channel::ChannelImpl::Connect() {
329 if (server_listen_pipe_ == -1 && pipe_ == -1) {
330 DLOG(WARNING) << "Channel creation failed: " << pipe_name_;
331 return false;
334 bool did_connect = true;
335 if (server_listen_pipe_ != -1) {
336 // Watch the pipe for connections, and turn any connections into
337 // active sockets.
338 base::MessageLoopForIO::current()->WatchFileDescriptor(
339 server_listen_pipe_,
340 true,
341 base::MessageLoopForIO::WATCH_READ,
342 &server_listen_connection_watcher_,
343 this);
344 } else {
345 did_connect = AcceptConnection();
347 return did_connect;
350 void Channel::ChannelImpl::CloseFileDescriptors(Message* msg) {
351 #if defined(OS_MACOSX)
352 // There is a bug on OSX which makes it dangerous to close
353 // a file descriptor while it is in transit. So instead we
354 // store the file descriptor in a set and send a message to
355 // the recipient, which is queued AFTER the message that
356 // sent the FD. The recipient will reply to the message,
357 // letting us know that it is now safe to close the file
358 // descriptor. For more information, see:
359 // http://crbug.com/298276
360 std::vector<int> to_close;
361 msg->file_descriptor_set()->ReleaseFDsToClose(&to_close);
362 for (size_t i = 0; i < to_close.size(); i++) {
363 fds_to_close_.insert(to_close[i]);
364 QueueCloseFDMessage(to_close[i], 2);
366 #else
367 msg->file_descriptor_set()->CommitAll();
368 #endif
371 bool Channel::ChannelImpl::ProcessOutgoingMessages() {
372 DCHECK(!waiting_connect_); // Why are we trying to send messages if there's
373 // no connection?
374 if (output_queue_.empty())
375 return true;
377 if (pipe_ == -1)
378 return false;
380 // Write out all the messages we can till the write blocks or there are no
381 // more outgoing messages.
382 while (!output_queue_.empty()) {
383 Message* msg = output_queue_.front();
385 size_t amt_to_write = msg->size() - message_send_bytes_written_;
386 DCHECK_NE(0U, amt_to_write);
387 const char* out_bytes = reinterpret_cast<const char*>(msg->data()) +
388 message_send_bytes_written_;
390 struct msghdr msgh = {0};
391 struct iovec iov = {const_cast<char*>(out_bytes), amt_to_write};
392 msgh.msg_iov = &iov;
393 msgh.msg_iovlen = 1;
394 char buf[CMSG_SPACE(
395 sizeof(int) * FileDescriptorSet::kMaxDescriptorsPerMessage)];
397 ssize_t bytes_written = 1;
398 int fd_written = -1;
400 if (message_send_bytes_written_ == 0 &&
401 !msg->file_descriptor_set()->empty()) {
402 // This is the first chunk of a message which has descriptors to send
403 struct cmsghdr *cmsg;
404 const unsigned num_fds = msg->file_descriptor_set()->size();
406 DCHECK(num_fds <= FileDescriptorSet::kMaxDescriptorsPerMessage);
407 if (msg->file_descriptor_set()->ContainsDirectoryDescriptor()) {
408 LOG(FATAL) << "Panic: attempting to transport directory descriptor over"
409 " IPC. Aborting to maintain sandbox isolation.";
410 // If you have hit this then something tried to send a file descriptor
411 // to a directory over an IPC channel. Since IPC channels span
412 // sandboxes this is very bad: the receiving process can use openat
413 // with ".." elements in the path in order to reach the real
414 // filesystem.
417 msgh.msg_control = buf;
418 msgh.msg_controllen = CMSG_SPACE(sizeof(int) * num_fds);
419 cmsg = CMSG_FIRSTHDR(&msgh);
420 cmsg->cmsg_level = SOL_SOCKET;
421 cmsg->cmsg_type = SCM_RIGHTS;
422 cmsg->cmsg_len = CMSG_LEN(sizeof(int) * num_fds);
423 msg->file_descriptor_set()->GetDescriptors(
424 reinterpret_cast<int*>(CMSG_DATA(cmsg)));
425 msgh.msg_controllen = cmsg->cmsg_len;
427 // DCHECK_LE above already checks that
428 // num_fds < kMaxDescriptorsPerMessage so no danger of overflow.
429 msg->header()->num_fds = static_cast<uint16>(num_fds);
431 #if defined(IPC_USES_READWRITE)
432 if (!IsHelloMessage(*msg)) {
433 // Only the Hello message sends the file descriptor with the message.
434 // Subsequently, we can send file descriptors on the dedicated
435 // fd_pipe_ which makes Seccomp sandbox operation more efficient.
436 struct iovec fd_pipe_iov = { const_cast<char *>(""), 1 };
437 msgh.msg_iov = &fd_pipe_iov;
438 fd_written = fd_pipe_;
439 bytes_written = HANDLE_EINTR(sendmsg(fd_pipe_, &msgh, MSG_DONTWAIT));
440 msgh.msg_iov = &iov;
441 msgh.msg_controllen = 0;
442 if (bytes_written > 0) {
443 CloseFileDescriptors(msg);
446 #endif // IPC_USES_READWRITE
449 if (bytes_written == 1) {
450 fd_written = pipe_;
451 #if defined(IPC_USES_READWRITE)
452 if ((mode_ & MODE_CLIENT_FLAG) && IsHelloMessage(*msg)) {
453 DCHECK_EQ(msg->file_descriptor_set()->size(), 1U);
455 if (!msgh.msg_controllen) {
456 bytes_written = HANDLE_EINTR(write(pipe_, out_bytes, amt_to_write));
457 } else
458 #endif // IPC_USES_READWRITE
460 bytes_written = HANDLE_EINTR(sendmsg(pipe_, &msgh, MSG_DONTWAIT));
463 if (bytes_written > 0)
464 CloseFileDescriptors(msg);
466 if (bytes_written < 0 && !SocketWriteErrorIsRecoverable()) {
467 // We can't close the pipe here, because calling OnChannelError
468 // may destroy this object, and that would be bad if we are
469 // called from Send(). Instead, we return false and hope the
470 // caller will close the pipe. If they do not, the pipe will
471 // still be closed next time OnFileCanReadWithoutBlocking is
472 // called.
473 #if defined(OS_MACOSX)
474 // On OSX writing to a pipe with no listener returns EPERM.
475 if (errno == EPERM) {
476 return false;
478 #endif // OS_MACOSX
479 if (errno == EPIPE) {
480 return false;
482 PLOG(ERROR) << "pipe error on "
483 << fd_written
484 << " Currently writing message of size: "
485 << msg->size();
486 return false;
489 if (static_cast<size_t>(bytes_written) != amt_to_write) {
490 if (bytes_written > 0) {
491 // If write() fails with EAGAIN then bytes_written will be -1.
492 message_send_bytes_written_ += bytes_written;
495 // Tell libevent to call us back once things are unblocked.
496 is_blocked_on_write_ = true;
497 base::MessageLoopForIO::current()->WatchFileDescriptor(
498 pipe_,
499 false, // One shot
500 base::MessageLoopForIO::WATCH_WRITE,
501 &write_watcher_,
502 this);
503 return true;
504 } else {
505 message_send_bytes_written_ = 0;
507 // Message sent OK!
508 DVLOG(2) << "sent message @" << msg << " on channel @" << this
509 << " with type " << msg->type() << " on fd " << pipe_;
510 delete output_queue_.front();
511 output_queue_.pop();
514 return true;
517 bool Channel::ChannelImpl::Send(Message* message) {
518 DVLOG(2) << "sending message @" << message << " on channel @" << this
519 << " with type " << message->type()
520 << " (" << output_queue_.size() << " in queue)";
522 #ifdef IPC_MESSAGE_LOG_ENABLED
523 Logging::GetInstance()->OnSendMessage(message, "");
524 #endif // IPC_MESSAGE_LOG_ENABLED
526 message->TraceMessageBegin();
527 output_queue_.push(message);
528 if (!is_blocked_on_write_ && !waiting_connect_) {
529 return ProcessOutgoingMessages();
532 return true;
535 int Channel::ChannelImpl::GetClientFileDescriptor() {
536 base::AutoLock lock(client_pipe_lock_);
537 return client_pipe_;
540 int Channel::ChannelImpl::TakeClientFileDescriptor() {
541 base::AutoLock lock(client_pipe_lock_);
542 int fd = client_pipe_;
543 if (client_pipe_ != -1) {
544 PipeMap::GetInstance()->Remove(pipe_name_);
545 client_pipe_ = -1;
547 return fd;
550 void Channel::ChannelImpl::CloseClientFileDescriptor() {
551 base::AutoLock lock(client_pipe_lock_);
552 if (client_pipe_ != -1) {
553 PipeMap::GetInstance()->Remove(pipe_name_);
554 if (IGNORE_EINTR(close(client_pipe_)) < 0)
555 PLOG(ERROR) << "close " << pipe_name_;
556 client_pipe_ = -1;
560 bool Channel::ChannelImpl::AcceptsConnections() const {
561 return server_listen_pipe_ != -1;
564 bool Channel::ChannelImpl::HasAcceptedConnection() const {
565 return AcceptsConnections() && pipe_ != -1;
568 bool Channel::ChannelImpl::GetPeerEuid(uid_t* peer_euid) const {
569 DCHECK(!(mode_ & MODE_SERVER) || HasAcceptedConnection());
570 return IPC::GetPeerEuid(pipe_, peer_euid);
573 void Channel::ChannelImpl::ResetToAcceptingConnectionState() {
574 // Unregister libevent for the unix domain socket and close it.
575 read_watcher_.StopWatchingFileDescriptor();
576 write_watcher_.StopWatchingFileDescriptor();
577 if (pipe_ != -1) {
578 if (IGNORE_EINTR(close(pipe_)) < 0)
579 PLOG(ERROR) << "close pipe_ " << pipe_name_;
580 pipe_ = -1;
582 #if defined(IPC_USES_READWRITE)
583 if (fd_pipe_ != -1) {
584 if (IGNORE_EINTR(close(fd_pipe_)) < 0)
585 PLOG(ERROR) << "close fd_pipe_ " << pipe_name_;
586 fd_pipe_ = -1;
588 if (remote_fd_pipe_ != -1) {
589 if (IGNORE_EINTR(close(remote_fd_pipe_)) < 0)
590 PLOG(ERROR) << "close remote_fd_pipe_ " << pipe_name_;
591 remote_fd_pipe_ = -1;
593 #endif // IPC_USES_READWRITE
595 while (!output_queue_.empty()) {
596 Message* m = output_queue_.front();
597 output_queue_.pop();
598 delete m;
601 // Close any outstanding, received file descriptors.
602 ClearInputFDs();
604 #if defined(OS_MACOSX)
605 // Clear any outstanding, sent file descriptors.
606 for (std::set<int>::iterator i = fds_to_close_.begin();
607 i != fds_to_close_.end();
608 ++i) {
609 if (IGNORE_EINTR(close(*i)) < 0)
610 PLOG(ERROR) << "close";
612 fds_to_close_.clear();
613 #endif
616 // static
617 bool Channel::ChannelImpl::IsNamedServerInitialized(
618 const std::string& channel_id) {
619 return base::PathExists(base::FilePath(channel_id));
622 #if defined(OS_LINUX)
623 // static
624 void Channel::ChannelImpl::SetGlobalPid(int pid) {
625 global_pid_ = pid;
627 #endif // OS_LINUX
629 // Called by libevent when we can read from the pipe without blocking.
630 void Channel::ChannelImpl::OnFileCanReadWithoutBlocking(int fd) {
631 if (fd == server_listen_pipe_) {
632 int new_pipe = 0;
633 if (!ServerAcceptConnection(server_listen_pipe_, &new_pipe) ||
634 new_pipe < 0) {
635 Close();
636 listener()->OnChannelListenError();
639 if (pipe_ != -1) {
640 // We already have a connection. We only handle one at a time.
641 // close our new descriptor.
642 if (HANDLE_EINTR(shutdown(new_pipe, SHUT_RDWR)) < 0)
643 DPLOG(ERROR) << "shutdown " << pipe_name_;
644 if (IGNORE_EINTR(close(new_pipe)) < 0)
645 DPLOG(ERROR) << "close " << pipe_name_;
646 listener()->OnChannelDenied();
647 return;
649 pipe_ = new_pipe;
651 if ((mode_ & MODE_OPEN_ACCESS_FLAG) == 0) {
652 // Verify that the IPC channel peer is running as the same user.
653 uid_t client_euid;
654 if (!GetPeerEuid(&client_euid)) {
655 DLOG(ERROR) << "Unable to query client euid";
656 ResetToAcceptingConnectionState();
657 return;
659 if (client_euid != geteuid()) {
660 DLOG(WARNING) << "Client euid is not authorised";
661 ResetToAcceptingConnectionState();
662 return;
666 if (!AcceptConnection()) {
667 NOTREACHED() << "AcceptConnection should not fail on server";
669 waiting_connect_ = false;
670 } else if (fd == pipe_) {
671 if (waiting_connect_ && (mode_ & MODE_SERVER_FLAG)) {
672 waiting_connect_ = false;
674 if (!ProcessIncomingMessages()) {
675 // ClosePipeOnError may delete this object, so we mustn't call
676 // ProcessOutgoingMessages.
677 ClosePipeOnError();
678 return;
680 } else {
681 NOTREACHED() << "Unknown pipe " << fd;
684 // If we're a server and handshaking, then we want to make sure that we
685 // only send our handshake message after we've processed the client's.
686 // This gives us a chance to kill the client if the incoming handshake
687 // is invalid. This also flushes any closefd messages.
688 if (!is_blocked_on_write_) {
689 if (!ProcessOutgoingMessages()) {
690 ClosePipeOnError();
695 // Called by libevent when we can write to the pipe without blocking.
696 void Channel::ChannelImpl::OnFileCanWriteWithoutBlocking(int fd) {
697 DCHECK_EQ(pipe_, fd);
698 is_blocked_on_write_ = false;
699 if (!ProcessOutgoingMessages()) {
700 ClosePipeOnError();
704 bool Channel::ChannelImpl::AcceptConnection() {
705 base::MessageLoopForIO::current()->WatchFileDescriptor(
706 pipe_, true, base::MessageLoopForIO::WATCH_READ, &read_watcher_, this);
707 QueueHelloMessage();
709 if (mode_ & MODE_CLIENT_FLAG) {
710 // If we are a client we want to send a hello message out immediately.
711 // In server mode we will send a hello message when we receive one from a
712 // client.
713 waiting_connect_ = false;
714 return ProcessOutgoingMessages();
715 } else if (mode_ & MODE_SERVER_FLAG) {
716 waiting_connect_ = true;
717 return true;
718 } else {
719 NOTREACHED();
720 return false;
724 void Channel::ChannelImpl::ClosePipeOnError() {
725 if (HasAcceptedConnection()) {
726 ResetToAcceptingConnectionState();
727 listener()->OnChannelError();
728 } else {
729 Close();
730 if (AcceptsConnections()) {
731 listener()->OnChannelListenError();
732 } else {
733 listener()->OnChannelError();
738 int Channel::ChannelImpl::GetHelloMessageProcId() {
739 int pid = base::GetCurrentProcId();
740 #if defined(OS_LINUX)
741 // Our process may be in a sandbox with a separate PID namespace.
742 if (global_pid_) {
743 pid = global_pid_;
745 #endif
746 return pid;
749 void Channel::ChannelImpl::QueueHelloMessage() {
750 // Create the Hello message
751 scoped_ptr<Message> msg(new Message(MSG_ROUTING_NONE,
752 HELLO_MESSAGE_TYPE,
753 IPC::Message::PRIORITY_NORMAL));
754 if (!msg->WriteInt(GetHelloMessageProcId())) {
755 NOTREACHED() << "Unable to pickle hello message proc id";
757 #if defined(IPC_USES_READWRITE)
758 scoped_ptr<Message> hello;
759 if (remote_fd_pipe_ != -1) {
760 if (!msg->WriteFileDescriptor(base::FileDescriptor(remote_fd_pipe_,
761 false))) {
762 NOTREACHED() << "Unable to pickle hello message file descriptors";
764 DCHECK_EQ(msg->file_descriptor_set()->size(), 1U);
766 #endif // IPC_USES_READWRITE
767 output_queue_.push(msg.release());
770 Channel::ChannelImpl::ReadState Channel::ChannelImpl::ReadData(
771 char* buffer,
772 int buffer_len,
773 int* bytes_read) {
774 if (pipe_ == -1)
775 return READ_FAILED;
777 struct msghdr msg = {0};
779 struct iovec iov = {buffer, static_cast<size_t>(buffer_len)};
780 msg.msg_iov = &iov;
781 msg.msg_iovlen = 1;
783 msg.msg_control = input_cmsg_buf_;
785 // recvmsg() returns 0 if the connection has closed or EAGAIN if no data
786 // is waiting on the pipe.
787 #if defined(IPC_USES_READWRITE)
788 if (fd_pipe_ >= 0) {
789 *bytes_read = HANDLE_EINTR(read(pipe_, buffer, buffer_len));
790 msg.msg_controllen = 0;
791 } else
792 #endif // IPC_USES_READWRITE
794 msg.msg_controllen = sizeof(input_cmsg_buf_);
795 *bytes_read = HANDLE_EINTR(recvmsg(pipe_, &msg, MSG_DONTWAIT));
797 if (*bytes_read < 0) {
798 if (errno == EAGAIN) {
799 return READ_PENDING;
800 #if defined(OS_MACOSX)
801 } else if (errno == EPERM) {
802 // On OSX, reading from a pipe with no listener returns EPERM
803 // treat this as a special case to prevent spurious error messages
804 // to the console.
805 return READ_FAILED;
806 #endif // OS_MACOSX
807 } else if (errno == ECONNRESET || errno == EPIPE) {
808 return READ_FAILED;
809 } else {
810 PLOG(ERROR) << "pipe error (" << pipe_ << ")";
811 return READ_FAILED;
813 } else if (*bytes_read == 0) {
814 // The pipe has closed...
815 return READ_FAILED;
817 DCHECK(*bytes_read);
819 CloseClientFileDescriptor();
821 // Read any file descriptors from the message.
822 if (!ExtractFileDescriptorsFromMsghdr(&msg))
823 return READ_FAILED;
824 return READ_SUCCEEDED;
827 #if defined(IPC_USES_READWRITE)
828 bool Channel::ChannelImpl::ReadFileDescriptorsFromFDPipe() {
829 char dummy;
830 struct iovec fd_pipe_iov = { &dummy, 1 };
832 struct msghdr msg = { 0 };
833 msg.msg_iov = &fd_pipe_iov;
834 msg.msg_iovlen = 1;
835 msg.msg_control = input_cmsg_buf_;
836 msg.msg_controllen = sizeof(input_cmsg_buf_);
837 ssize_t bytes_received = HANDLE_EINTR(recvmsg(fd_pipe_, &msg, MSG_DONTWAIT));
839 if (bytes_received != 1)
840 return true; // No message waiting.
842 if (!ExtractFileDescriptorsFromMsghdr(&msg))
843 return false;
844 return true;
846 #endif
848 // On Posix, we need to fix up the file descriptors before the input message
849 // is dispatched.
851 // This will read from the input_fds_ (READWRITE mode only) and read more
852 // handles from the FD pipe if necessary.
853 bool Channel::ChannelImpl::WillDispatchInputMessage(Message* msg) {
854 uint16 header_fds = msg->header()->num_fds;
855 if (!header_fds)
856 return true; // Nothing to do.
858 // The message has file descriptors.
859 const char* error = NULL;
860 if (header_fds > input_fds_.size()) {
861 // The message has been completely received, but we didn't get
862 // enough file descriptors.
863 #if defined(IPC_USES_READWRITE)
864 if (!ReadFileDescriptorsFromFDPipe())
865 return false;
866 if (header_fds > input_fds_.size())
867 #endif // IPC_USES_READWRITE
868 error = "Message needs unreceived descriptors";
871 if (header_fds > FileDescriptorSet::kMaxDescriptorsPerMessage)
872 error = "Message requires an excessive number of descriptors";
874 if (error) {
875 LOG(WARNING) << error
876 << " channel:" << this
877 << " message-type:" << msg->type()
878 << " header()->num_fds:" << header_fds;
879 // Abort the connection.
880 ClearInputFDs();
881 return false;
884 // The shenaniganery below with &foo.front() requires input_fds_ to have
885 // contiguous underlying storage (such as a simple array or a std::vector).
886 // This is why the header warns not to make input_fds_ a deque<>.
887 msg->file_descriptor_set()->SetDescriptors(&input_fds_.front(),
888 header_fds);
889 input_fds_.erase(input_fds_.begin(), input_fds_.begin() + header_fds);
890 return true;
893 bool Channel::ChannelImpl::DidEmptyInputBuffers() {
894 // When the input data buffer is empty, the fds should be too. If this is
895 // not the case, we probably have a rogue renderer which is trying to fill
896 // our descriptor table.
897 return input_fds_.empty();
900 bool Channel::ChannelImpl::ExtractFileDescriptorsFromMsghdr(msghdr* msg) {
901 // Check that there are any control messages. On OSX, CMSG_FIRSTHDR will
902 // return an invalid non-NULL pointer in the case that controllen == 0.
903 if (msg->msg_controllen == 0)
904 return true;
906 for (cmsghdr* cmsg = CMSG_FIRSTHDR(msg);
907 cmsg;
908 cmsg = CMSG_NXTHDR(msg, cmsg)) {
909 if (cmsg->cmsg_level == SOL_SOCKET && cmsg->cmsg_type == SCM_RIGHTS) {
910 unsigned payload_len = cmsg->cmsg_len - CMSG_LEN(0);
911 DCHECK_EQ(0U, payload_len % sizeof(int));
912 const int* file_descriptors = reinterpret_cast<int*>(CMSG_DATA(cmsg));
913 unsigned num_file_descriptors = payload_len / 4;
914 input_fds_.insert(input_fds_.end(),
915 file_descriptors,
916 file_descriptors + num_file_descriptors);
918 // Check this after adding the FDs so we don't leak them.
919 if (msg->msg_flags & MSG_CTRUNC) {
920 ClearInputFDs();
921 return false;
924 return true;
928 // No file descriptors found, but that's OK.
929 return true;
932 void Channel::ChannelImpl::ClearInputFDs() {
933 for (size_t i = 0; i < input_fds_.size(); ++i) {
934 if (IGNORE_EINTR(close(input_fds_[i])) < 0)
935 PLOG(ERROR) << "close ";
937 input_fds_.clear();
940 void Channel::ChannelImpl::QueueCloseFDMessage(int fd, int hops) {
941 switch (hops) {
942 case 1:
943 case 2: {
944 // Create the message
945 scoped_ptr<Message> msg(new Message(MSG_ROUTING_NONE,
946 CLOSE_FD_MESSAGE_TYPE,
947 IPC::Message::PRIORITY_NORMAL));
948 if (!msg->WriteInt(hops - 1) || !msg->WriteInt(fd)) {
949 NOTREACHED() << "Unable to pickle close fd.";
951 // Send(msg.release());
952 output_queue_.push(msg.release());
953 break;
956 default:
957 NOTREACHED();
958 break;
962 void Channel::ChannelImpl::HandleInternalMessage(const Message& msg) {
963 // The Hello message contains only the process id.
964 PickleIterator iter(msg);
966 switch (msg.type()) {
967 default:
968 NOTREACHED();
969 break;
971 case Channel::HELLO_MESSAGE_TYPE:
972 int pid;
973 if (!msg.ReadInt(&iter, &pid))
974 NOTREACHED();
976 #if defined(IPC_USES_READWRITE)
977 if (mode_ & MODE_SERVER_FLAG) {
978 // With IPC_USES_READWRITE, the Hello message from the client to the
979 // server also contains the fd_pipe_, which will be used for all
980 // subsequent file descriptor passing.
981 DCHECK_EQ(msg.file_descriptor_set()->size(), 1U);
982 base::FileDescriptor descriptor;
983 if (!msg.ReadFileDescriptor(&iter, &descriptor)) {
984 NOTREACHED();
986 fd_pipe_ = descriptor.fd;
987 CHECK(descriptor.auto_close);
989 #endif // IPC_USES_READWRITE
990 peer_pid_ = pid;
991 listener()->OnChannelConnected(pid);
992 break;
994 #if defined(OS_MACOSX)
995 case Channel::CLOSE_FD_MESSAGE_TYPE:
996 int fd, hops;
997 if (!msg.ReadInt(&iter, &hops))
998 NOTREACHED();
999 if (!msg.ReadInt(&iter, &fd))
1000 NOTREACHED();
1001 if (hops == 0) {
1002 if (fds_to_close_.erase(fd) > 0) {
1003 if (IGNORE_EINTR(close(fd)) < 0)
1004 PLOG(ERROR) << "close";
1005 } else {
1006 NOTREACHED();
1008 } else {
1009 QueueCloseFDMessage(fd, hops);
1011 break;
1012 #endif
1016 void Channel::ChannelImpl::Close() {
1017 // Close can be called multiple time, so we need to make sure we're
1018 // idempotent.
1020 ResetToAcceptingConnectionState();
1022 if (must_unlink_) {
1023 unlink(pipe_name_.c_str());
1024 must_unlink_ = false;
1026 if (server_listen_pipe_ != -1) {
1027 if (IGNORE_EINTR(close(server_listen_pipe_)) < 0)
1028 DPLOG(ERROR) << "close " << server_listen_pipe_;
1029 server_listen_pipe_ = -1;
1030 // Unregister libevent for the listening socket and close it.
1031 server_listen_connection_watcher_.StopWatchingFileDescriptor();
1034 CloseClientFileDescriptor();
1037 //------------------------------------------------------------------------------
1038 // Channel's methods simply call through to ChannelImpl.
1039 Channel::Channel(const IPC::ChannelHandle& channel_handle, Mode mode,
1040 Listener* listener)
1041 : channel_impl_(new ChannelImpl(channel_handle, mode, listener)) {
1044 Channel::~Channel() {
1045 delete channel_impl_;
1048 bool Channel::Connect() {
1049 return channel_impl_->Connect();
1052 void Channel::Close() {
1053 if (channel_impl_)
1054 channel_impl_->Close();
1057 base::ProcessId Channel::peer_pid() const {
1058 return channel_impl_->peer_pid();
1061 bool Channel::Send(Message* message) {
1062 return channel_impl_->Send(message);
1065 int Channel::GetClientFileDescriptor() const {
1066 return channel_impl_->GetClientFileDescriptor();
1069 int Channel::TakeClientFileDescriptor() {
1070 return channel_impl_->TakeClientFileDescriptor();
1073 bool Channel::AcceptsConnections() const {
1074 return channel_impl_->AcceptsConnections();
1077 bool Channel::HasAcceptedConnection() const {
1078 return channel_impl_->HasAcceptedConnection();
1081 bool Channel::GetPeerEuid(uid_t* peer_euid) const {
1082 return channel_impl_->GetPeerEuid(peer_euid);
1085 void Channel::ResetToAcceptingConnectionState() {
1086 channel_impl_->ResetToAcceptingConnectionState();
1089 // static
1090 bool Channel::IsNamedServerInitialized(const std::string& channel_id) {
1091 return ChannelImpl::IsNamedServerInitialized(channel_id);
1094 // static
1095 std::string Channel::GenerateVerifiedChannelID(const std::string& prefix) {
1096 // A random name is sufficient validation on posix systems, so we don't need
1097 // an additional shared secret.
1099 std::string id = prefix;
1100 if (!id.empty())
1101 id.append(".");
1103 return id.append(GenerateUniqueRandomChannelID());
1107 #if defined(OS_LINUX)
1108 // static
1109 void Channel::SetGlobalPid(int pid) {
1110 ChannelImpl::SetGlobalPid(pid);
1112 #endif // OS_LINUX
1114 } // namespace IPC