hunspell: Cleanup to fix the header include guards under google/ directory.
[chromium-blink-merge.git] / ipc / ipc_channel_posix.cc
blob4a3eb9d59dbaf853394e04393d93883e8e745190
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 <unistd.h>
15 #if defined(OS_OPENBSD)
16 #include <sys/uio.h>
17 #endif
19 #if !defined(OS_NACL_NONSFI)
20 #include <sys/un.h>
21 #endif
23 #include <map>
24 #include <string>
26 #include "base/command_line.h"
27 #include "base/files/file_path.h"
28 #include "base/files/file_util.h"
29 #include "base/location.h"
30 #include "base/logging.h"
31 #include "base/memory/scoped_ptr.h"
32 #include "base/memory/singleton.h"
33 #include "base/posix/eintr_wrapper.h"
34 #include "base/posix/global_descriptors.h"
35 #include "base/process/process_handle.h"
36 #include "base/rand_util.h"
37 #include "base/stl_util.h"
38 #include "base/strings/string_util.h"
39 #include "base/synchronization/lock.h"
40 #include "ipc/ipc_descriptors.h"
41 #include "ipc/ipc_listener.h"
42 #include "ipc/ipc_logging.h"
43 #include "ipc/ipc_message_attachment_set.h"
44 #include "ipc/ipc_message_utils.h"
45 #include "ipc/ipc_platform_file_attachment_posix.h"
46 #include "ipc/ipc_switches.h"
47 #include "ipc/unix_domain_socket_util.h"
49 namespace IPC {
51 // IPC channels on Windows use named pipes (CreateNamedPipe()) with
52 // channel ids as the pipe names. Channels on POSIX use sockets as
53 // pipes These don't quite line up.
55 // When creating a child subprocess we use a socket pair and the parent side of
56 // the fork arranges it such that the initial control channel ends up on the
57 // magic file descriptor kPrimaryIPCChannel in the child. Future
58 // connections (file descriptors) can then be passed via that
59 // connection via sendmsg().
61 // A POSIX IPC channel can also be set up as a server for a bound UNIX domain
62 // socket, and will handle multiple connect and disconnect sequences. Currently
63 // it is limited to one connection at a time.
65 //------------------------------------------------------------------------------
66 namespace {
68 // The PipeMap class works around this quirk related to unit tests:
70 // When running as a server, we install the client socket in a
71 // specific file descriptor number (@kPrimaryIPCChannel). However, we
72 // also have to support the case where we are running unittests in the
73 // same process. (We do not support forking without execing.)
75 // Case 1: normal running
76 // The IPC server object will install a mapping in PipeMap from the
77 // name which it was given to the client pipe. When forking the client, the
78 // GetClientFileDescriptorMapping will ensure that the socket is installed in
79 // the magic slot (@kPrimaryIPCChannel). The client will search for the
80 // mapping, but it won't find any since we are in a new process. Thus the
81 // magic fd number is returned. Once the client connects, the server will
82 // close its copy of the client socket and remove the mapping.
84 // Case 2: unittests - client and server in the same process
85 // The IPC server will install a mapping as before. The client will search
86 // for a mapping and find out. It duplicates the file descriptor and
87 // connects. Once the client connects, the server will close the original
88 // copy of the client socket and remove the mapping. Thus, when the client
89 // object closes, it will close the only remaining copy of the client socket
90 // in the fd table and the server will see EOF on its side.
92 // TODO(port): a client process cannot connect to multiple IPC channels with
93 // this scheme.
95 class PipeMap {
96 public:
97 static PipeMap* GetInstance() {
98 return Singleton<PipeMap>::get();
101 ~PipeMap() {
102 // Shouldn't have left over pipes.
103 DCHECK(map_.empty());
106 // Lookup a given channel id. Return -1 if not found.
107 int Lookup(const std::string& channel_id) {
108 base::AutoLock locked(lock_);
110 ChannelToFDMap::const_iterator i = map_.find(channel_id);
111 if (i == map_.end())
112 return -1;
113 return i->second;
116 // Remove the mapping for the given channel id. No error is signaled if the
117 // channel_id doesn't exist
118 void Remove(const std::string& channel_id) {
119 base::AutoLock locked(lock_);
120 map_.erase(channel_id);
123 // Insert a mapping from @channel_id to @fd. It's a fatal error to insert a
124 // mapping if one already exists for the given channel_id
125 void Insert(const std::string& channel_id, int fd) {
126 base::AutoLock locked(lock_);
127 DCHECK_NE(-1, fd);
129 ChannelToFDMap::const_iterator i = map_.find(channel_id);
130 CHECK(i == map_.end()) << "Creating second IPC server (fd " << fd << ") "
131 << "for '" << channel_id << "' while first "
132 << "(fd " << i->second << ") still exists";
133 map_[channel_id] = fd;
136 private:
137 base::Lock lock_;
138 typedef std::map<std::string, int> ChannelToFDMap;
139 ChannelToFDMap map_;
141 friend struct DefaultSingletonTraits<PipeMap>;
142 #if defined(OS_ANDROID)
143 friend void ::IPC::Channel::NotifyProcessForkedForTesting();
144 #endif
147 //------------------------------------------------------------------------------
149 bool SocketWriteErrorIsRecoverable() {
150 #if defined(OS_MACOSX)
151 // On OS X if sendmsg() is trying to send fds between processes and there
152 // isn't enough room in the output buffer to send the fd structure over
153 // atomically then EMSGSIZE is returned.
155 // EMSGSIZE presents a problem since the system APIs can only call us when
156 // there's room in the socket buffer and not when there is "enough" room.
158 // The current behavior is to return to the event loop when EMSGSIZE is
159 // received and hopefull service another FD. This is however still
160 // technically a busy wait since the event loop will call us right back until
161 // the receiver has read enough data to allow passing the FD over atomically.
162 return errno == EAGAIN || errno == EMSGSIZE;
163 #else
164 return errno == EAGAIN;
165 #endif // OS_MACOSX
168 } // namespace
170 #if defined(OS_ANDROID)
171 // When we fork for simple tests on Android, we can't 'exec', so we need to
172 // reset these entries manually to get the expected testing behavior.
173 void Channel::NotifyProcessForkedForTesting() {
174 PipeMap::GetInstance()->map_.clear();
176 #endif
178 //------------------------------------------------------------------------------
180 #if defined(OS_LINUX)
181 int ChannelPosix::global_pid_ = 0;
182 #endif // OS_LINUX
184 ChannelPosix::ChannelPosix(const IPC::ChannelHandle& channel_handle,
185 Mode mode,
186 Listener* listener,
187 AttachmentBroker* broker)
188 : ChannelReader(listener),
189 mode_(mode),
190 peer_pid_(base::kNullProcessId),
191 is_blocked_on_write_(false),
192 waiting_connect_(true),
193 message_send_bytes_written_(0),
194 pipe_name_(channel_handle.name),
195 in_dtor_(false),
196 must_unlink_(false),
197 broker_(broker) {
198 if (!CreatePipe(channel_handle)) {
199 // The pipe may have been closed already.
200 const char *modestr = (mode_ & MODE_SERVER_FLAG) ? "server" : "client";
201 LOG(WARNING) << "Unable to create pipe named \"" << channel_handle.name
202 << "\" in " << modestr << " mode";
206 ChannelPosix::~ChannelPosix() {
207 in_dtor_ = true;
208 Close();
211 bool SocketPair(int* fd1, int* fd2) {
212 int pipe_fds[2];
213 if (socketpair(AF_UNIX, SOCK_STREAM, 0, pipe_fds) != 0) {
214 PLOG(ERROR) << "socketpair()";
215 return false;
218 // Set both ends to be non-blocking.
219 if (fcntl(pipe_fds[0], F_SETFL, O_NONBLOCK) == -1 ||
220 fcntl(pipe_fds[1], F_SETFL, O_NONBLOCK) == -1) {
221 PLOG(ERROR) << "fcntl(O_NONBLOCK)";
222 if (IGNORE_EINTR(close(pipe_fds[0])) < 0)
223 PLOG(ERROR) << "close";
224 if (IGNORE_EINTR(close(pipe_fds[1])) < 0)
225 PLOG(ERROR) << "close";
226 return false;
229 *fd1 = pipe_fds[0];
230 *fd2 = pipe_fds[1];
232 return true;
235 bool ChannelPosix::CreatePipe(
236 const IPC::ChannelHandle& channel_handle) {
237 DCHECK(!server_listen_pipe_.is_valid() && !pipe_.is_valid());
239 // Four possible cases:
240 // 1) It's a channel wrapping a pipe that is given to us.
241 // 2) It's for a named channel, so we create it.
242 // 3) It's for a client that we implement ourself. This is used
243 // in single-process unittesting.
244 // 4) It's the initial IPC channel:
245 // 4a) Client side: Pull the pipe out of the GlobalDescriptors set.
246 // 4b) Server side: create the pipe.
248 base::ScopedFD local_pipe;
249 if (channel_handle.socket.fd != -1) {
250 // Case 1 from comment above.
251 local_pipe.reset(channel_handle.socket.fd);
252 } else if (mode_ & MODE_NAMED_FLAG) {
253 #if defined(OS_NACL_NONSFI)
254 LOG(FATAL)
255 << "IPC channels in nacl_helper_nonsfi should not be in NAMED mode.";
256 #else
257 // Case 2 from comment above.
258 int local_pipe_fd = -1;
260 if (mode_ & MODE_SERVER_FLAG) {
261 if (!CreateServerUnixDomainSocket(base::FilePath(pipe_name_),
262 &local_pipe_fd)) {
263 return false;
266 must_unlink_ = true;
267 } else if (mode_ & MODE_CLIENT_FLAG) {
268 if (!CreateClientUnixDomainSocket(base::FilePath(pipe_name_),
269 &local_pipe_fd)) {
270 return false;
272 } else {
273 LOG(ERROR) << "Bad mode: " << mode_;
274 return false;
277 local_pipe.reset(local_pipe_fd);
278 #endif // !defined(OS_NACL_NONSFI)
279 } else {
280 local_pipe.reset(PipeMap::GetInstance()->Lookup(pipe_name_));
281 if (mode_ & MODE_CLIENT_FLAG) {
282 if (local_pipe.is_valid()) {
283 // Case 3 from comment above.
284 // We only allow one connection.
285 local_pipe.reset(HANDLE_EINTR(dup(local_pipe.release())));
286 PipeMap::GetInstance()->Remove(pipe_name_);
287 } else {
288 // Case 4a from comment above.
289 // Guard against inappropriate reuse of the initial IPC channel. If
290 // an IPC channel closes and someone attempts to reuse it by name, the
291 // initial channel must not be recycled here. http://crbug.com/26754.
292 static bool used_initial_channel = false;
293 if (used_initial_channel) {
294 LOG(FATAL) << "Denying attempt to reuse initial IPC channel for "
295 << pipe_name_;
296 return false;
298 used_initial_channel = true;
300 local_pipe.reset(
301 base::GlobalDescriptors::GetInstance()->Get(kPrimaryIPCChannel));
303 } else if (mode_ & MODE_SERVER_FLAG) {
304 // Case 4b from comment above.
305 if (local_pipe.is_valid()) {
306 LOG(ERROR) << "Server already exists for " << pipe_name_;
307 // This is a client side pipe registered by other server and
308 // shouldn't be closed.
309 ignore_result(local_pipe.release());
310 return false;
312 base::AutoLock lock(client_pipe_lock_);
313 int local_pipe_fd = -1, client_pipe_fd = -1;
314 if (!SocketPair(&local_pipe_fd, &client_pipe_fd))
315 return false;
316 local_pipe.reset(local_pipe_fd);
317 client_pipe_.reset(client_pipe_fd);
318 PipeMap::GetInstance()->Insert(pipe_name_, client_pipe_fd);
319 } else {
320 LOG(ERROR) << "Bad mode: " << mode_;
321 return false;
325 if ((mode_ & MODE_SERVER_FLAG) && (mode_ & MODE_NAMED_FLAG)) {
326 #if defined(OS_NACL_NONSFI)
327 LOG(FATAL) << "IPC channels in nacl_helper_nonsfi "
328 << "should not be in NAMED or SERVER mode.";
329 #else
330 server_listen_pipe_.reset(local_pipe.release());
331 #endif
332 } else {
333 pipe_.reset(local_pipe.release());
335 return true;
338 bool ChannelPosix::Connect() {
339 if (!server_listen_pipe_.is_valid() && !pipe_.is_valid()) {
340 DLOG(WARNING) << "Channel creation failed: " << pipe_name_;
341 return false;
344 bool did_connect = true;
345 if (server_listen_pipe_.is_valid()) {
346 #if defined(OS_NACL_NONSFI)
347 LOG(FATAL) << "IPC channels in nacl_helper_nonsfi "
348 << "should always be in client mode.";
349 #else
350 // Watch the pipe for connections, and turn any connections into
351 // active sockets.
352 base::MessageLoopForIO::current()->WatchFileDescriptor(
353 server_listen_pipe_.get(),
354 true,
355 base::MessageLoopForIO::WATCH_READ,
356 &server_listen_connection_watcher_,
357 this);
358 #endif
359 } else {
360 did_connect = AcceptConnection();
362 return did_connect;
365 void ChannelPosix::CloseFileDescriptors(Message* msg) {
366 #if defined(OS_MACOSX)
367 // There is a bug on OSX which makes it dangerous to close
368 // a file descriptor while it is in transit. So instead we
369 // store the file descriptor in a set and send a message to
370 // the recipient, which is queued AFTER the message that
371 // sent the FD. The recipient will reply to the message,
372 // letting us know that it is now safe to close the file
373 // descriptor. For more information, see:
374 // http://crbug.com/298276
375 std::vector<int> to_close;
376 msg->attachment_set()->ReleaseFDsToClose(&to_close);
377 for (size_t i = 0; i < to_close.size(); i++) {
378 fds_to_close_.insert(to_close[i]);
379 QueueCloseFDMessage(to_close[i], 2);
381 #else
382 msg->attachment_set()->CommitAll();
383 #endif
386 bool ChannelPosix::ProcessOutgoingMessages() {
387 DCHECK(!waiting_connect_); // Why are we trying to send messages if there's
388 // no connection?
389 if (output_queue_.empty())
390 return true;
392 if (!pipe_.is_valid())
393 return false;
395 // Write out all the messages we can till the write blocks or there are no
396 // more outgoing messages.
397 while (!output_queue_.empty()) {
398 Message* msg = output_queue_.front();
400 size_t amt_to_write = msg->size() - message_send_bytes_written_;
401 DCHECK_NE(0U, amt_to_write);
402 const char* out_bytes = reinterpret_cast<const char*>(msg->data()) +
403 message_send_bytes_written_;
405 struct msghdr msgh = {0};
406 struct iovec iov = {const_cast<char*>(out_bytes), amt_to_write};
407 msgh.msg_iov = &iov;
408 msgh.msg_iovlen = 1;
409 char buf[CMSG_SPACE(sizeof(int) *
410 MessageAttachmentSet::kMaxDescriptorsPerMessage)];
412 ssize_t bytes_written = 1;
413 int fd_written = -1;
415 if (message_send_bytes_written_ == 0 && !msg->attachment_set()->empty()) {
416 // This is the first chunk of a message which has descriptors to send
417 struct cmsghdr *cmsg;
418 const unsigned num_fds = msg->attachment_set()->size();
420 DCHECK(num_fds <= MessageAttachmentSet::kMaxDescriptorsPerMessage);
421 if (msg->attachment_set()->ContainsDirectoryDescriptor()) {
422 LOG(FATAL) << "Panic: attempting to transport directory descriptor over"
423 " IPC. Aborting to maintain sandbox isolation.";
424 // If you have hit this then something tried to send a file descriptor
425 // to a directory over an IPC channel. Since IPC channels span
426 // sandboxes this is very bad: the receiving process can use openat
427 // with ".." elements in the path in order to reach the real
428 // filesystem.
431 msgh.msg_control = buf;
432 msgh.msg_controllen = CMSG_SPACE(sizeof(int) * num_fds);
433 cmsg = CMSG_FIRSTHDR(&msgh);
434 cmsg->cmsg_level = SOL_SOCKET;
435 cmsg->cmsg_type = SCM_RIGHTS;
436 cmsg->cmsg_len = CMSG_LEN(sizeof(int) * num_fds);
437 msg->attachment_set()->PeekDescriptors(
438 reinterpret_cast<int*>(CMSG_DATA(cmsg)));
439 msgh.msg_controllen = cmsg->cmsg_len;
441 // DCHECK_LE above already checks that
442 // num_fds < kMaxDescriptorsPerMessage so no danger of overflow.
443 msg->header()->num_fds = static_cast<uint16>(num_fds);
446 if (bytes_written == 1) {
447 fd_written = pipe_.get();
448 bytes_written = HANDLE_EINTR(sendmsg(pipe_.get(), &msgh, MSG_DONTWAIT));
450 if (bytes_written > 0)
451 CloseFileDescriptors(msg);
453 if (bytes_written < 0 && !SocketWriteErrorIsRecoverable()) {
454 // We can't close the pipe here, because calling OnChannelError
455 // may destroy this object, and that would be bad if we are
456 // called from Send(). Instead, we return false and hope the
457 // caller will close the pipe. If they do not, the pipe will
458 // still be closed next time OnFileCanReadWithoutBlocking is
459 // called.
460 #if defined(OS_MACOSX)
461 // On OSX writing to a pipe with no listener returns EPERM.
462 if (errno == EPERM) {
463 return false;
465 #endif // OS_MACOSX
466 if (errno == EPIPE) {
467 return false;
469 PLOG(ERROR) << "pipe error on "
470 << fd_written
471 << " Currently writing message of size: "
472 << msg->size();
473 return false;
476 if (static_cast<size_t>(bytes_written) != amt_to_write) {
477 if (bytes_written > 0) {
478 // If write() fails with EAGAIN then bytes_written will be -1.
479 message_send_bytes_written_ += bytes_written;
482 // Tell libevent to call us back once things are unblocked.
483 is_blocked_on_write_ = true;
484 base::MessageLoopForIO::current()->WatchFileDescriptor(
485 pipe_.get(),
486 false, // One shot
487 base::MessageLoopForIO::WATCH_WRITE,
488 &write_watcher_,
489 this);
490 return true;
491 } else {
492 message_send_bytes_written_ = 0;
494 // Message sent OK!
495 DVLOG(2) << "sent message @" << msg << " on channel @" << this
496 << " with type " << msg->type() << " on fd " << pipe_.get();
497 delete output_queue_.front();
498 output_queue_.pop();
501 return true;
504 bool ChannelPosix::Send(Message* message) {
505 DCHECK(!message->HasMojoHandles());
506 DVLOG(2) << "sending message @" << message << " on channel @" << this
507 << " with type " << message->type()
508 << " (" << output_queue_.size() << " in queue)";
510 #ifdef IPC_MESSAGE_LOG_ENABLED
511 Logging::GetInstance()->OnSendMessage(message, "");
512 #endif // IPC_MESSAGE_LOG_ENABLED
514 message->TraceMessageBegin();
515 output_queue_.push(message);
516 if (!is_blocked_on_write_ && !waiting_connect_) {
517 return ProcessOutgoingMessages();
520 return true;
523 AttachmentBroker* ChannelPosix::GetAttachmentBroker() {
524 return broker_;
527 int ChannelPosix::GetClientFileDescriptor() const {
528 base::AutoLock lock(client_pipe_lock_);
529 return client_pipe_.get();
532 base::ScopedFD ChannelPosix::TakeClientFileDescriptor() {
533 base::AutoLock lock(client_pipe_lock_);
534 if (!client_pipe_.is_valid())
535 return base::ScopedFD();
536 PipeMap::GetInstance()->Remove(pipe_name_);
537 return client_pipe_.Pass();
540 void ChannelPosix::CloseClientFileDescriptor() {
541 base::AutoLock lock(client_pipe_lock_);
542 if (!client_pipe_.is_valid())
543 return;
544 PipeMap::GetInstance()->Remove(pipe_name_);
545 client_pipe_.reset();
548 bool ChannelPosix::AcceptsConnections() const {
549 return server_listen_pipe_.is_valid();
552 bool ChannelPosix::HasAcceptedConnection() const {
553 return AcceptsConnections() && pipe_.is_valid();
556 #if !defined(OS_NACL_NONSFI)
557 // GetPeerEuid is not supported in nacl_helper_nonsfi.
558 bool ChannelPosix::GetPeerEuid(uid_t* peer_euid) const {
559 DCHECK(!(mode_ & MODE_SERVER) || HasAcceptedConnection());
560 return IPC::GetPeerEuid(pipe_.get(), peer_euid);
562 #endif
564 void ChannelPosix::ResetToAcceptingConnectionState() {
565 // Unregister libevent for the unix domain socket and close it.
566 read_watcher_.StopWatchingFileDescriptor();
567 write_watcher_.StopWatchingFileDescriptor();
568 ResetSafely(&pipe_);
570 while (!output_queue_.empty()) {
571 Message* m = output_queue_.front();
572 output_queue_.pop();
573 CloseFileDescriptors(m);
574 delete m;
577 // Close any outstanding, received file descriptors.
578 ClearInputFDs();
580 #if defined(OS_MACOSX)
581 // Clear any outstanding, sent file descriptors.
582 for (std::set<int>::iterator i = fds_to_close_.begin();
583 i != fds_to_close_.end();
584 ++i) {
585 if (IGNORE_EINTR(close(*i)) < 0)
586 PLOG(ERROR) << "close";
588 fds_to_close_.clear();
589 #endif
592 // static
593 bool ChannelPosix::IsNamedServerInitialized(
594 const std::string& channel_id) {
595 return base::PathExists(base::FilePath(channel_id));
598 #if defined(OS_LINUX)
599 // static
600 void ChannelPosix::SetGlobalPid(int pid) {
601 global_pid_ = pid;
603 #endif // OS_LINUX
605 // Called by libevent when we can read from the pipe without blocking.
606 void ChannelPosix::OnFileCanReadWithoutBlocking(int fd) {
607 if (fd == server_listen_pipe_.get()) {
608 #if defined(OS_NACL_NONSFI)
609 LOG(FATAL)
610 << "IPC channels in nacl_helper_nonsfi should not be SERVER mode.";
611 #else
612 int new_pipe = 0;
613 if (!ServerAcceptConnection(server_listen_pipe_.get(), &new_pipe) ||
614 new_pipe < 0) {
615 Close();
616 listener()->OnChannelListenError();
619 if (pipe_.is_valid()) {
620 // We already have a connection. We only handle one at a time.
621 // close our new descriptor.
622 if (HANDLE_EINTR(shutdown(new_pipe, SHUT_RDWR)) < 0)
623 DPLOG(ERROR) << "shutdown " << pipe_name_;
624 if (IGNORE_EINTR(close(new_pipe)) < 0)
625 DPLOG(ERROR) << "close " << pipe_name_;
626 listener()->OnChannelDenied();
627 return;
629 pipe_.reset(new_pipe);
631 if ((mode_ & MODE_OPEN_ACCESS_FLAG) == 0) {
632 // Verify that the IPC channel peer is running as the same user.
633 uid_t client_euid;
634 if (!GetPeerEuid(&client_euid)) {
635 DLOG(ERROR) << "Unable to query client euid";
636 ResetToAcceptingConnectionState();
637 return;
639 if (client_euid != geteuid()) {
640 DLOG(WARNING) << "Client euid is not authorised";
641 ResetToAcceptingConnectionState();
642 return;
646 if (!AcceptConnection()) {
647 NOTREACHED() << "AcceptConnection should not fail on server";
649 waiting_connect_ = false;
650 #endif
651 } else if (fd == pipe_) {
652 if (waiting_connect_ && (mode_ & MODE_SERVER_FLAG)) {
653 waiting_connect_ = false;
655 if (ProcessIncomingMessages() == DISPATCH_ERROR) {
656 // ClosePipeOnError may delete this object, so we mustn't call
657 // ProcessOutgoingMessages.
658 ClosePipeOnError();
659 return;
661 } else {
662 NOTREACHED() << "Unknown pipe " << fd;
665 // If we're a server and handshaking, then we want to make sure that we
666 // only send our handshake message after we've processed the client's.
667 // This gives us a chance to kill the client if the incoming handshake
668 // is invalid. This also flushes any closefd messages.
669 if (!is_blocked_on_write_) {
670 if (!ProcessOutgoingMessages()) {
671 ClosePipeOnError();
676 // Called by libevent when we can write to the pipe without blocking.
677 void ChannelPosix::OnFileCanWriteWithoutBlocking(int fd) {
678 DCHECK_EQ(pipe_.get(), fd);
679 is_blocked_on_write_ = false;
680 if (!ProcessOutgoingMessages()) {
681 ClosePipeOnError();
685 bool ChannelPosix::AcceptConnection() {
686 base::MessageLoopForIO::current()->WatchFileDescriptor(
687 pipe_.get(),
688 true,
689 base::MessageLoopForIO::WATCH_READ,
690 &read_watcher_,
691 this);
692 QueueHelloMessage();
694 if (mode_ & MODE_CLIENT_FLAG) {
695 // If we are a client we want to send a hello message out immediately.
696 // In server mode we will send a hello message when we receive one from a
697 // client.
698 waiting_connect_ = false;
699 return ProcessOutgoingMessages();
700 } else if (mode_ & MODE_SERVER_FLAG) {
701 waiting_connect_ = true;
702 return true;
703 } else {
704 NOTREACHED();
705 return false;
709 void ChannelPosix::ClosePipeOnError() {
710 if (HasAcceptedConnection()) {
711 ResetToAcceptingConnectionState();
712 listener()->OnChannelError();
713 } else {
714 Close();
715 if (AcceptsConnections()) {
716 listener()->OnChannelListenError();
717 } else {
718 listener()->OnChannelError();
723 int ChannelPosix::GetHelloMessageProcId() const {
724 #if defined(OS_NACL_NONSFI)
725 // In nacl_helper_nonsfi, getpid() invoked by GetCurrentProcId() is not
726 // allowed and would cause a SIGSYS crash because of the seccomp sandbox.
727 return -1;
728 #else
729 int pid = base::GetCurrentProcId();
730 #if defined(OS_LINUX)
731 // Our process may be in a sandbox with a separate PID namespace.
732 if (global_pid_) {
733 pid = global_pid_;
735 #endif // defined(OS_LINUX)
736 return pid;
737 #endif // defined(OS_NACL_NONSFI)
740 void ChannelPosix::QueueHelloMessage() {
741 // Create the Hello message
742 scoped_ptr<Message> msg(new Message(MSG_ROUTING_NONE,
743 HELLO_MESSAGE_TYPE,
744 IPC::Message::PRIORITY_NORMAL));
745 if (!msg->WriteInt(GetHelloMessageProcId())) {
746 NOTREACHED() << "Unable to pickle hello message proc id";
748 output_queue_.push(msg.release());
751 ChannelPosix::ReadState ChannelPosix::ReadData(
752 char* buffer,
753 int buffer_len,
754 int* bytes_read) {
755 if (!pipe_.is_valid())
756 return READ_FAILED;
758 struct msghdr msg = {0};
760 struct iovec iov = {buffer, static_cast<size_t>(buffer_len)};
761 msg.msg_iov = &iov;
762 msg.msg_iovlen = 1;
764 char input_cmsg_buf[kMaxReadFDBuffer];
765 msg.msg_control = input_cmsg_buf;
767 // recvmsg() returns 0 if the connection has closed or EAGAIN if no data
768 // is waiting on the pipe.
769 msg.msg_controllen = sizeof(input_cmsg_buf);
770 *bytes_read = HANDLE_EINTR(recvmsg(pipe_.get(), &msg, MSG_DONTWAIT));
772 if (*bytes_read < 0) {
773 if (errno == EAGAIN) {
774 return READ_PENDING;
775 #if defined(OS_MACOSX)
776 } else if (errno == EPERM) {
777 // On OSX, reading from a pipe with no listener returns EPERM
778 // treat this as a special case to prevent spurious error messages
779 // to the console.
780 return READ_FAILED;
781 #endif // OS_MACOSX
782 } else if (errno == ECONNRESET || errno == EPIPE) {
783 return READ_FAILED;
784 } else {
785 PLOG(ERROR) << "pipe error (" << pipe_.get() << ")";
786 return READ_FAILED;
788 } else if (*bytes_read == 0) {
789 // The pipe has closed...
790 return READ_FAILED;
792 DCHECK(*bytes_read);
794 CloseClientFileDescriptor();
796 // Read any file descriptors from the message.
797 if (!ExtractFileDescriptorsFromMsghdr(&msg))
798 return READ_FAILED;
799 return READ_SUCCEEDED;
802 bool ChannelPosix::ShouldDispatchInputMessage(Message* msg) {
803 return true;
806 // On Posix, we need to fix up the file descriptors before the input message
807 // is dispatched.
809 // This will read from the input_fds_ (READWRITE mode only) and read more
810 // handles from the FD pipe if necessary.
811 bool ChannelPosix::GetNonBrokeredAttachments(Message* msg) {
812 uint16 header_fds = msg->header()->num_fds;
813 if (!header_fds)
814 return true; // Nothing to do.
816 // The message has file descriptors.
817 const char* error = NULL;
818 if (header_fds > input_fds_.size()) {
819 // The message has been completely received, but we didn't get
820 // enough file descriptors.
821 error = "Message needs unreceived descriptors";
824 if (header_fds > MessageAttachmentSet::kMaxDescriptorsPerMessage)
825 error = "Message requires an excessive number of descriptors";
827 if (error) {
828 LOG(WARNING) << error
829 << " channel:" << this
830 << " message-type:" << msg->type()
831 << " header()->num_fds:" << header_fds;
832 // Abort the connection.
833 ClearInputFDs();
834 return false;
837 // The shenaniganery below with &foo.front() requires input_fds_ to have
838 // contiguous underlying storage (such as a simple array or a std::vector).
839 // This is why the header warns not to make input_fds_ a deque<>.
840 msg->attachment_set()->AddDescriptorsToOwn(&input_fds_.front(), header_fds);
841 input_fds_.erase(input_fds_.begin(), input_fds_.begin() + header_fds);
842 return true;
845 bool ChannelPosix::DidEmptyInputBuffers() {
846 // When the input data buffer is empty, the fds should be too. If this is
847 // not the case, we probably have a rogue renderer which is trying to fill
848 // our descriptor table.
849 return input_fds_.empty();
852 bool ChannelPosix::ExtractFileDescriptorsFromMsghdr(msghdr* msg) {
853 // Check that there are any control messages. On OSX, CMSG_FIRSTHDR will
854 // return an invalid non-NULL pointer in the case that controllen == 0.
855 if (msg->msg_controllen == 0)
856 return true;
858 for (cmsghdr* cmsg = CMSG_FIRSTHDR(msg);
859 cmsg;
860 cmsg = CMSG_NXTHDR(msg, cmsg)) {
861 if (cmsg->cmsg_level == SOL_SOCKET && cmsg->cmsg_type == SCM_RIGHTS) {
862 unsigned payload_len = cmsg->cmsg_len - CMSG_LEN(0);
863 DCHECK_EQ(0U, payload_len % sizeof(int));
864 const int* file_descriptors = reinterpret_cast<int*>(CMSG_DATA(cmsg));
865 unsigned num_file_descriptors = payload_len / 4;
866 input_fds_.insert(input_fds_.end(),
867 file_descriptors,
868 file_descriptors + num_file_descriptors);
870 // Check this after adding the FDs so we don't leak them.
871 if (msg->msg_flags & MSG_CTRUNC) {
872 ClearInputFDs();
873 return false;
876 return true;
880 // No file descriptors found, but that's OK.
881 return true;
884 void ChannelPosix::ClearInputFDs() {
885 for (size_t i = 0; i < input_fds_.size(); ++i) {
886 if (IGNORE_EINTR(close(input_fds_[i])) < 0)
887 PLOG(ERROR) << "close ";
889 input_fds_.clear();
892 void ChannelPosix::QueueCloseFDMessage(int fd, int hops) {
893 switch (hops) {
894 case 1:
895 case 2: {
896 // Create the message
897 scoped_ptr<Message> msg(new Message(MSG_ROUTING_NONE,
898 CLOSE_FD_MESSAGE_TYPE,
899 IPC::Message::PRIORITY_NORMAL));
900 if (!msg->WriteInt(hops - 1) || !msg->WriteInt(fd)) {
901 NOTREACHED() << "Unable to pickle close fd.";
903 // Send(msg.release());
904 output_queue_.push(msg.release());
905 break;
908 default:
909 NOTREACHED();
910 break;
914 void ChannelPosix::HandleInternalMessage(const Message& msg) {
915 // The Hello message contains only the process id.
916 base::PickleIterator iter(msg);
918 switch (msg.type()) {
919 default:
920 NOTREACHED();
921 break;
923 case Channel::HELLO_MESSAGE_TYPE:
924 int pid;
925 if (!iter.ReadInt(&pid))
926 NOTREACHED();
928 peer_pid_ = pid;
929 listener()->OnChannelConnected(pid);
930 break;
932 #if defined(OS_MACOSX)
933 case Channel::CLOSE_FD_MESSAGE_TYPE:
934 int fd, hops;
935 if (!iter.ReadInt(&hops))
936 NOTREACHED();
937 if (!iter.ReadInt(&fd))
938 NOTREACHED();
939 if (hops == 0) {
940 if (fds_to_close_.erase(fd) > 0) {
941 if (IGNORE_EINTR(close(fd)) < 0)
942 PLOG(ERROR) << "close";
943 } else {
944 NOTREACHED();
946 } else {
947 QueueCloseFDMessage(fd, hops);
949 break;
950 #endif
954 base::ProcessId ChannelPosix::GetSenderPID() {
955 return GetPeerPID();
958 bool ChannelPosix::IsAttachmentBrokerEndpoint() {
959 return is_attachment_broker_endpoint();
962 void ChannelPosix::Close() {
963 // Close can be called multiple time, so we need to make sure we're
964 // idempotent.
966 ResetToAcceptingConnectionState();
968 if (must_unlink_) {
969 unlink(pipe_name_.c_str());
970 must_unlink_ = false;
973 if (server_listen_pipe_.is_valid()) {
974 #if defined(OS_NACL_NONSFI)
975 LOG(FATAL)
976 << "IPC channels in nacl_helper_nonsfi should not be SERVER mode.";
977 #else
978 server_listen_pipe_.reset();
979 // Unregister libevent for the listening socket and close it.
980 server_listen_connection_watcher_.StopWatchingFileDescriptor();
981 #endif
984 CloseClientFileDescriptor();
987 base::ProcessId ChannelPosix::GetPeerPID() const {
988 return peer_pid_;
991 base::ProcessId ChannelPosix::GetSelfPID() const {
992 return GetHelloMessageProcId();
995 void ChannelPosix::ResetSafely(base::ScopedFD* fd) {
996 if (!in_dtor_) {
997 fd->reset();
998 return;
1001 // crbug.com/449233
1002 // The CL [1] tightened the error check for closing FDs, but it turned
1003 // out that there are existing cases that hit the newly added check.
1004 // ResetSafely() is the workaround for that crash, turning it from
1005 // from PCHECK() to DPCHECK() so that it doesn't crash in production.
1006 // [1] https://crrev.com/ce44fef5fd60dd2be5c587d4b084bdcd36adcee4
1007 int fd_to_close = fd->release();
1008 if (-1 != fd_to_close) {
1009 int rv = IGNORE_EINTR(close(fd_to_close));
1010 DPCHECK(0 == rv);
1014 //------------------------------------------------------------------------------
1015 // Channel's methods
1017 // static
1018 scoped_ptr<Channel> Channel::Create(const IPC::ChannelHandle& channel_handle,
1019 Mode mode,
1020 Listener* listener,
1021 AttachmentBroker* broker) {
1022 return make_scoped_ptr(
1023 new ChannelPosix(channel_handle, mode, listener, broker));
1026 // static
1027 std::string Channel::GenerateVerifiedChannelID(const std::string& prefix) {
1028 // A random name is sufficient validation on posix systems, so we don't need
1029 // an additional shared secret.
1031 std::string id = prefix;
1032 if (!id.empty())
1033 id.append(".");
1035 return id.append(GenerateUniqueRandomChannelID());
1038 bool Channel::IsNamedServerInitialized(
1039 const std::string& channel_id) {
1040 return ChannelPosix::IsNamedServerInitialized(channel_id);
1043 #if defined(OS_LINUX)
1044 // static
1045 void Channel::SetGlobalPid(int pid) {
1046 ChannelPosix::SetGlobalPid(pid);
1048 #endif // OS_LINUX
1050 } // namespace IPC