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"
10 #include <sys/socket.h>
12 #include <sys/types.h>
15 #if defined(OS_OPENBSD)
19 #if !defined(OS_NACL_NONSFI)
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"
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 //------------------------------------------------------------------------------
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
97 static PipeMap
* GetInstance() {
98 return Singleton
<PipeMap
>::get();
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
);
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_
);
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
;
138 typedef std::map
<std::string
, int> ChannelToFDMap
;
141 friend struct DefaultSingletonTraits
<PipeMap
>;
142 #if defined(OS_ANDROID)
143 friend void ::IPC::Channel::NotifyProcessForkedForTesting();
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
;
164 return errno
== EAGAIN
;
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();
178 //------------------------------------------------------------------------------
180 #if defined(OS_LINUX)
181 int ChannelPosix::global_pid_
= 0;
184 ChannelPosix::ChannelPosix(const IPC::ChannelHandle
& channel_handle
,
185 Mode mode
, Listener
* listener
)
186 : ChannelReader(listener
),
188 peer_pid_(base::kNullProcessId
),
189 is_blocked_on_write_(false),
190 waiting_connect_(true),
191 message_send_bytes_written_(0),
192 pipe_name_(channel_handle
.name
),
194 must_unlink_(false) {
195 if (!CreatePipe(channel_handle
)) {
196 // The pipe may have been closed already.
197 const char *modestr
= (mode_
& MODE_SERVER_FLAG
) ? "server" : "client";
198 LOG(WARNING
) << "Unable to create pipe named \"" << channel_handle
.name
199 << "\" in " << modestr
<< " mode";
203 ChannelPosix::~ChannelPosix() {
208 bool SocketPair(int* fd1
, int* fd2
) {
210 if (socketpair(AF_UNIX
, SOCK_STREAM
, 0, pipe_fds
) != 0) {
211 PLOG(ERROR
) << "socketpair()";
215 // Set both ends to be non-blocking.
216 if (fcntl(pipe_fds
[0], F_SETFL
, O_NONBLOCK
) == -1 ||
217 fcntl(pipe_fds
[1], F_SETFL
, O_NONBLOCK
) == -1) {
218 PLOG(ERROR
) << "fcntl(O_NONBLOCK)";
219 if (IGNORE_EINTR(close(pipe_fds
[0])) < 0)
220 PLOG(ERROR
) << "close";
221 if (IGNORE_EINTR(close(pipe_fds
[1])) < 0)
222 PLOG(ERROR
) << "close";
232 bool ChannelPosix::CreatePipe(
233 const IPC::ChannelHandle
& channel_handle
) {
234 DCHECK(!server_listen_pipe_
.is_valid() && !pipe_
.is_valid());
236 // Four possible cases:
237 // 1) It's a channel wrapping a pipe that is given to us.
238 // 2) It's for a named channel, so we create it.
239 // 3) It's for a client that we implement ourself. This is used
240 // in single-process unittesting.
241 // 4) It's the initial IPC channel:
242 // 4a) Client side: Pull the pipe out of the GlobalDescriptors set.
243 // 4b) Server side: create the pipe.
245 base::ScopedFD local_pipe
;
246 if (channel_handle
.socket
.fd
!= -1) {
247 // Case 1 from comment above.
248 local_pipe
.reset(channel_handle
.socket
.fd
);
249 } else if (mode_
& MODE_NAMED_FLAG
) {
250 #if defined(OS_NACL_NONSFI)
252 << "IPC channels in nacl_helper_nonsfi should not be in NAMED mode.";
254 // Case 2 from comment above.
255 int local_pipe_fd
= -1;
257 if (mode_
& MODE_SERVER_FLAG
) {
258 if (!CreateServerUnixDomainSocket(base::FilePath(pipe_name_
),
264 } else if (mode_
& MODE_CLIENT_FLAG
) {
265 if (!CreateClientUnixDomainSocket(base::FilePath(pipe_name_
),
270 LOG(ERROR
) << "Bad mode: " << mode_
;
274 local_pipe
.reset(local_pipe_fd
);
275 #endif // !defined(OS_NACL_NONSFI)
277 local_pipe
.reset(PipeMap::GetInstance()->Lookup(pipe_name_
));
278 if (mode_
& MODE_CLIENT_FLAG
) {
279 if (local_pipe
.is_valid()) {
280 // Case 3 from comment above.
281 // We only allow one connection.
282 local_pipe
.reset(HANDLE_EINTR(dup(local_pipe
.release())));
283 PipeMap::GetInstance()->Remove(pipe_name_
);
285 // Case 4a from comment above.
286 // Guard against inappropriate reuse of the initial IPC channel. If
287 // an IPC channel closes and someone attempts to reuse it by name, the
288 // initial channel must not be recycled here. http://crbug.com/26754.
289 static bool used_initial_channel
= false;
290 if (used_initial_channel
) {
291 LOG(FATAL
) << "Denying attempt to reuse initial IPC channel for "
295 used_initial_channel
= true;
298 base::GlobalDescriptors::GetInstance()->Get(kPrimaryIPCChannel
));
300 } else if (mode_
& MODE_SERVER_FLAG
) {
301 // Case 4b from comment above.
302 if (local_pipe
.is_valid()) {
303 LOG(ERROR
) << "Server already exists for " << pipe_name_
;
304 // This is a client side pipe registered by other server and
305 // shouldn't be closed.
306 ignore_result(local_pipe
.release());
309 base::AutoLock
lock(client_pipe_lock_
);
310 int local_pipe_fd
= -1, client_pipe_fd
= -1;
311 if (!SocketPair(&local_pipe_fd
, &client_pipe_fd
))
313 local_pipe
.reset(local_pipe_fd
);
314 client_pipe_
.reset(client_pipe_fd
);
315 PipeMap::GetInstance()->Insert(pipe_name_
, client_pipe_fd
);
317 LOG(ERROR
) << "Bad mode: " << mode_
;
322 if ((mode_
& MODE_SERVER_FLAG
) && (mode_
& MODE_NAMED_FLAG
)) {
323 #if defined(OS_NACL_NONSFI)
324 LOG(FATAL
) << "IPC channels in nacl_helper_nonsfi "
325 << "should not be in NAMED or SERVER mode.";
327 server_listen_pipe_
.reset(local_pipe
.release());
330 pipe_
.reset(local_pipe
.release());
335 bool ChannelPosix::Connect() {
336 if (!server_listen_pipe_
.is_valid() && !pipe_
.is_valid()) {
337 DLOG(WARNING
) << "Channel creation failed: " << pipe_name_
;
341 bool did_connect
= true;
342 if (server_listen_pipe_
.is_valid()) {
343 #if defined(OS_NACL_NONSFI)
344 LOG(FATAL
) << "IPC channels in nacl_helper_nonsfi "
345 << "should always be in client mode.";
347 // Watch the pipe for connections, and turn any connections into
349 base::MessageLoopForIO::current()->WatchFileDescriptor(
350 server_listen_pipe_
.get(),
352 base::MessageLoopForIO::WATCH_READ
,
353 &server_listen_connection_watcher_
,
357 did_connect
= AcceptConnection();
362 void ChannelPosix::CloseFileDescriptors(Message
* msg
) {
363 #if defined(OS_MACOSX)
364 // There is a bug on OSX which makes it dangerous to close
365 // a file descriptor while it is in transit. So instead we
366 // store the file descriptor in a set and send a message to
367 // the recipient, which is queued AFTER the message that
368 // sent the FD. The recipient will reply to the message,
369 // letting us know that it is now safe to close the file
370 // descriptor. For more information, see:
371 // http://crbug.com/298276
372 std::vector
<int> to_close
;
373 msg
->attachment_set()->ReleaseFDsToClose(&to_close
);
374 for (size_t i
= 0; i
< to_close
.size(); i
++) {
375 fds_to_close_
.insert(to_close
[i
]);
376 QueueCloseFDMessage(to_close
[i
], 2);
379 msg
->attachment_set()->CommitAll();
383 bool ChannelPosix::ProcessOutgoingMessages() {
384 DCHECK(!waiting_connect_
); // Why are we trying to send messages if there's
386 if (output_queue_
.empty())
389 if (!pipe_
.is_valid())
392 // Write out all the messages we can till the write blocks or there are no
393 // more outgoing messages.
394 while (!output_queue_
.empty()) {
395 Message
* msg
= output_queue_
.front();
397 size_t amt_to_write
= msg
->size() - message_send_bytes_written_
;
398 DCHECK_NE(0U, amt_to_write
);
399 const char* out_bytes
= reinterpret_cast<const char*>(msg
->data()) +
400 message_send_bytes_written_
;
402 struct msghdr msgh
= {0};
403 struct iovec iov
= {const_cast<char*>(out_bytes
), amt_to_write
};
406 char buf
[CMSG_SPACE(sizeof(int) *
407 MessageAttachmentSet::kMaxDescriptorsPerMessage
)];
409 ssize_t bytes_written
= 1;
412 if (message_send_bytes_written_
== 0 && !msg
->attachment_set()->empty()) {
413 // This is the first chunk of a message which has descriptors to send
414 struct cmsghdr
*cmsg
;
415 const unsigned num_fds
= msg
->attachment_set()->size();
417 DCHECK(num_fds
<= MessageAttachmentSet::kMaxDescriptorsPerMessage
);
418 if (msg
->attachment_set()->ContainsDirectoryDescriptor()) {
419 LOG(FATAL
) << "Panic: attempting to transport directory descriptor over"
420 " IPC. Aborting to maintain sandbox isolation.";
421 // If you have hit this then something tried to send a file descriptor
422 // to a directory over an IPC channel. Since IPC channels span
423 // sandboxes this is very bad: the receiving process can use openat
424 // with ".." elements in the path in order to reach the real
428 msgh
.msg_control
= buf
;
429 msgh
.msg_controllen
= CMSG_SPACE(sizeof(int) * num_fds
);
430 cmsg
= CMSG_FIRSTHDR(&msgh
);
431 cmsg
->cmsg_level
= SOL_SOCKET
;
432 cmsg
->cmsg_type
= SCM_RIGHTS
;
433 cmsg
->cmsg_len
= CMSG_LEN(sizeof(int) * num_fds
);
434 msg
->attachment_set()->PeekDescriptors(
435 reinterpret_cast<int*>(CMSG_DATA(cmsg
)));
436 msgh
.msg_controllen
= cmsg
->cmsg_len
;
438 // DCHECK_LE above already checks that
439 // num_fds < kMaxDescriptorsPerMessage so no danger of overflow.
440 msg
->header()->num_fds
= static_cast<uint16
>(num_fds
);
443 if (bytes_written
== 1) {
444 fd_written
= pipe_
.get();
445 bytes_written
= HANDLE_EINTR(sendmsg(pipe_
.get(), &msgh
, MSG_DONTWAIT
));
447 if (bytes_written
> 0)
448 CloseFileDescriptors(msg
);
450 if (bytes_written
< 0 && !SocketWriteErrorIsRecoverable()) {
451 // We can't close the pipe here, because calling OnChannelError
452 // may destroy this object, and that would be bad if we are
453 // called from Send(). Instead, we return false and hope the
454 // caller will close the pipe. If they do not, the pipe will
455 // still be closed next time OnFileCanReadWithoutBlocking is
457 #if defined(OS_MACOSX)
458 // On OSX writing to a pipe with no listener returns EPERM.
459 if (errno
== EPERM
) {
463 if (errno
== EPIPE
) {
466 PLOG(ERROR
) << "pipe error on "
468 << " Currently writing message of size: "
473 if (static_cast<size_t>(bytes_written
) != amt_to_write
) {
474 if (bytes_written
> 0) {
475 // If write() fails with EAGAIN then bytes_written will be -1.
476 message_send_bytes_written_
+= bytes_written
;
479 // Tell libevent to call us back once things are unblocked.
480 is_blocked_on_write_
= true;
481 base::MessageLoopForIO::current()->WatchFileDescriptor(
484 base::MessageLoopForIO::WATCH_WRITE
,
489 message_send_bytes_written_
= 0;
492 DVLOG(2) << "sent message @" << msg
<< " on channel @" << this
493 << " with type " << msg
->type() << " on fd " << pipe_
.get();
494 delete output_queue_
.front();
501 bool ChannelPosix::Send(Message
* message
) {
502 DCHECK(!message
->HasMojoHandles());
503 DVLOG(2) << "sending message @" << message
<< " on channel @" << this
504 << " with type " << message
->type()
505 << " (" << output_queue_
.size() << " in queue)";
507 #ifdef IPC_MESSAGE_LOG_ENABLED
508 Logging::GetInstance()->OnSendMessage(message
, "");
509 #endif // IPC_MESSAGE_LOG_ENABLED
511 message
->TraceMessageBegin();
512 output_queue_
.push(message
);
513 if (!is_blocked_on_write_
&& !waiting_connect_
) {
514 return ProcessOutgoingMessages();
520 int ChannelPosix::GetClientFileDescriptor() const {
521 base::AutoLock
lock(client_pipe_lock_
);
522 return client_pipe_
.get();
525 base::ScopedFD
ChannelPosix::TakeClientFileDescriptor() {
526 base::AutoLock
lock(client_pipe_lock_
);
527 if (!client_pipe_
.is_valid())
528 return base::ScopedFD();
529 PipeMap::GetInstance()->Remove(pipe_name_
);
530 return client_pipe_
.Pass();
533 void ChannelPosix::CloseClientFileDescriptor() {
534 base::AutoLock
lock(client_pipe_lock_
);
535 if (!client_pipe_
.is_valid())
537 PipeMap::GetInstance()->Remove(pipe_name_
);
538 client_pipe_
.reset();
541 bool ChannelPosix::AcceptsConnections() const {
542 return server_listen_pipe_
.is_valid();
545 bool ChannelPosix::HasAcceptedConnection() const {
546 return AcceptsConnections() && pipe_
.is_valid();
549 #if !defined(OS_NACL_NONSFI)
550 // GetPeerEuid is not supported in nacl_helper_nonsfi.
551 bool ChannelPosix::GetPeerEuid(uid_t
* peer_euid
) const {
552 DCHECK(!(mode_
& MODE_SERVER
) || HasAcceptedConnection());
553 return IPC::GetPeerEuid(pipe_
.get(), peer_euid
);
557 void ChannelPosix::ResetToAcceptingConnectionState() {
558 // Unregister libevent for the unix domain socket and close it.
559 read_watcher_
.StopWatchingFileDescriptor();
560 write_watcher_
.StopWatchingFileDescriptor();
563 while (!output_queue_
.empty()) {
564 Message
* m
= output_queue_
.front();
569 // Close any outstanding, received file descriptors.
572 #if defined(OS_MACOSX)
573 // Clear any outstanding, sent file descriptors.
574 for (std::set
<int>::iterator i
= fds_to_close_
.begin();
575 i
!= fds_to_close_
.end();
577 if (IGNORE_EINTR(close(*i
)) < 0)
578 PLOG(ERROR
) << "close";
580 fds_to_close_
.clear();
585 bool ChannelPosix::IsNamedServerInitialized(
586 const std::string
& channel_id
) {
587 return base::PathExists(base::FilePath(channel_id
));
590 #if defined(OS_LINUX)
592 void ChannelPosix::SetGlobalPid(int pid
) {
597 // Called by libevent when we can read from the pipe without blocking.
598 void ChannelPosix::OnFileCanReadWithoutBlocking(int fd
) {
599 if (fd
== server_listen_pipe_
.get()) {
600 #if defined(OS_NACL_NONSFI)
602 << "IPC channels in nacl_helper_nonsfi should not be SERVER mode.";
605 if (!ServerAcceptConnection(server_listen_pipe_
.get(), &new_pipe
) ||
608 listener()->OnChannelListenError();
611 if (pipe_
.is_valid()) {
612 // We already have a connection. We only handle one at a time.
613 // close our new descriptor.
614 if (HANDLE_EINTR(shutdown(new_pipe
, SHUT_RDWR
)) < 0)
615 DPLOG(ERROR
) << "shutdown " << pipe_name_
;
616 if (IGNORE_EINTR(close(new_pipe
)) < 0)
617 DPLOG(ERROR
) << "close " << pipe_name_
;
618 listener()->OnChannelDenied();
621 pipe_
.reset(new_pipe
);
623 if ((mode_
& MODE_OPEN_ACCESS_FLAG
) == 0) {
624 // Verify that the IPC channel peer is running as the same user.
626 if (!GetPeerEuid(&client_euid
)) {
627 DLOG(ERROR
) << "Unable to query client euid";
628 ResetToAcceptingConnectionState();
631 if (client_euid
!= geteuid()) {
632 DLOG(WARNING
) << "Client euid is not authorised";
633 ResetToAcceptingConnectionState();
638 if (!AcceptConnection()) {
639 NOTREACHED() << "AcceptConnection should not fail on server";
641 waiting_connect_
= false;
643 } else if (fd
== pipe_
) {
644 if (waiting_connect_
&& (mode_
& MODE_SERVER_FLAG
)) {
645 waiting_connect_
= false;
647 if (!ProcessIncomingMessages()) {
648 // ClosePipeOnError may delete this object, so we mustn't call
649 // ProcessOutgoingMessages.
654 NOTREACHED() << "Unknown pipe " << fd
;
657 // If we're a server and handshaking, then we want to make sure that we
658 // only send our handshake message after we've processed the client's.
659 // This gives us a chance to kill the client if the incoming handshake
660 // is invalid. This also flushes any closefd messages.
661 if (!is_blocked_on_write_
) {
662 if (!ProcessOutgoingMessages()) {
668 // Called by libevent when we can write to the pipe without blocking.
669 void ChannelPosix::OnFileCanWriteWithoutBlocking(int fd
) {
670 DCHECK_EQ(pipe_
.get(), fd
);
671 is_blocked_on_write_
= false;
672 if (!ProcessOutgoingMessages()) {
677 bool ChannelPosix::AcceptConnection() {
678 base::MessageLoopForIO::current()->WatchFileDescriptor(
681 base::MessageLoopForIO::WATCH_READ
,
686 if (mode_
& MODE_CLIENT_FLAG
) {
687 // If we are a client we want to send a hello message out immediately.
688 // In server mode we will send a hello message when we receive one from a
690 waiting_connect_
= false;
691 return ProcessOutgoingMessages();
692 } else if (mode_
& MODE_SERVER_FLAG
) {
693 waiting_connect_
= true;
701 void ChannelPosix::ClosePipeOnError() {
702 if (HasAcceptedConnection()) {
703 ResetToAcceptingConnectionState();
704 listener()->OnChannelError();
707 if (AcceptsConnections()) {
708 listener()->OnChannelListenError();
710 listener()->OnChannelError();
715 int ChannelPosix::GetHelloMessageProcId() const {
716 #if defined(OS_NACL_NONSFI)
717 // In nacl_helper_nonsfi, getpid() invoked by GetCurrentProcId() is not
718 // allowed and would cause a SIGSYS crash because of the seccomp sandbox.
721 int pid
= base::GetCurrentProcId();
722 #if defined(OS_LINUX)
723 // Our process may be in a sandbox with a separate PID namespace.
727 #endif // defined(OS_LINUX)
729 #endif // defined(OS_NACL_NONSFI)
732 void ChannelPosix::QueueHelloMessage() {
733 // Create the Hello message
734 scoped_ptr
<Message
> msg(new Message(MSG_ROUTING_NONE
,
736 IPC::Message::PRIORITY_NORMAL
));
737 if (!msg
->WriteInt(GetHelloMessageProcId())) {
738 NOTREACHED() << "Unable to pickle hello message proc id";
740 output_queue_
.push(msg
.release());
743 ChannelPosix::ReadState
ChannelPosix::ReadData(
747 if (!pipe_
.is_valid())
750 struct msghdr msg
= {0};
752 struct iovec iov
= {buffer
, static_cast<size_t>(buffer_len
)};
756 char input_cmsg_buf
[kMaxReadFDBuffer
];
757 msg
.msg_control
= input_cmsg_buf
;
759 // recvmsg() returns 0 if the connection has closed or EAGAIN if no data
760 // is waiting on the pipe.
761 msg
.msg_controllen
= sizeof(input_cmsg_buf
);
762 *bytes_read
= HANDLE_EINTR(recvmsg(pipe_
.get(), &msg
, MSG_DONTWAIT
));
764 if (*bytes_read
< 0) {
765 if (errno
== EAGAIN
) {
767 #if defined(OS_MACOSX)
768 } else if (errno
== EPERM
) {
769 // On OSX, reading from a pipe with no listener returns EPERM
770 // treat this as a special case to prevent spurious error messages
774 } else if (errno
== ECONNRESET
|| errno
== EPIPE
) {
777 PLOG(ERROR
) << "pipe error (" << pipe_
.get() << ")";
780 } else if (*bytes_read
== 0) {
781 // The pipe has closed...
786 CloseClientFileDescriptor();
788 // Read any file descriptors from the message.
789 if (!ExtractFileDescriptorsFromMsghdr(&msg
))
791 return READ_SUCCEEDED
;
794 // On Posix, we need to fix up the file descriptors before the input message
797 // This will read from the input_fds_ (READWRITE mode only) and read more
798 // handles from the FD pipe if necessary.
799 bool ChannelPosix::WillDispatchInputMessage(Message
* msg
) {
800 uint16 header_fds
= msg
->header()->num_fds
;
802 return true; // Nothing to do.
804 // The message has file descriptors.
805 const char* error
= NULL
;
806 if (header_fds
> input_fds_
.size()) {
807 // The message has been completely received, but we didn't get
808 // enough file descriptors.
809 error
= "Message needs unreceived descriptors";
812 if (header_fds
> MessageAttachmentSet::kMaxDescriptorsPerMessage
)
813 error
= "Message requires an excessive number of descriptors";
816 LOG(WARNING
) << error
817 << " channel:" << this
818 << " message-type:" << msg
->type()
819 << " header()->num_fds:" << header_fds
;
820 // Abort the connection.
825 // The shenaniganery below with &foo.front() requires input_fds_ to have
826 // contiguous underlying storage (such as a simple array or a std::vector).
827 // This is why the header warns not to make input_fds_ a deque<>.
828 msg
->attachment_set()->AddDescriptorsToOwn(&input_fds_
.front(), header_fds
);
829 input_fds_
.erase(input_fds_
.begin(), input_fds_
.begin() + header_fds
);
833 bool ChannelPosix::DidEmptyInputBuffers() {
834 // When the input data buffer is empty, the fds should be too. If this is
835 // not the case, we probably have a rogue renderer which is trying to fill
836 // our descriptor table.
837 return input_fds_
.empty();
840 bool ChannelPosix::ExtractFileDescriptorsFromMsghdr(msghdr
* msg
) {
841 // Check that there are any control messages. On OSX, CMSG_FIRSTHDR will
842 // return an invalid non-NULL pointer in the case that controllen == 0.
843 if (msg
->msg_controllen
== 0)
846 for (cmsghdr
* cmsg
= CMSG_FIRSTHDR(msg
);
848 cmsg
= CMSG_NXTHDR(msg
, cmsg
)) {
849 if (cmsg
->cmsg_level
== SOL_SOCKET
&& cmsg
->cmsg_type
== SCM_RIGHTS
) {
850 unsigned payload_len
= cmsg
->cmsg_len
- CMSG_LEN(0);
851 DCHECK_EQ(0U, payload_len
% sizeof(int));
852 const int* file_descriptors
= reinterpret_cast<int*>(CMSG_DATA(cmsg
));
853 unsigned num_file_descriptors
= payload_len
/ 4;
854 input_fds_
.insert(input_fds_
.end(),
856 file_descriptors
+ num_file_descriptors
);
858 // Check this after adding the FDs so we don't leak them.
859 if (msg
->msg_flags
& MSG_CTRUNC
) {
868 // No file descriptors found, but that's OK.
872 void ChannelPosix::ClearInputFDs() {
873 for (size_t i
= 0; i
< input_fds_
.size(); ++i
) {
874 if (IGNORE_EINTR(close(input_fds_
[i
])) < 0)
875 PLOG(ERROR
) << "close ";
880 void ChannelPosix::QueueCloseFDMessage(int fd
, int hops
) {
884 // Create the message
885 scoped_ptr
<Message
> msg(new Message(MSG_ROUTING_NONE
,
886 CLOSE_FD_MESSAGE_TYPE
,
887 IPC::Message::PRIORITY_NORMAL
));
888 if (!msg
->WriteInt(hops
- 1) || !msg
->WriteInt(fd
)) {
889 NOTREACHED() << "Unable to pickle close fd.";
891 // Send(msg.release());
892 output_queue_
.push(msg
.release());
902 void ChannelPosix::HandleInternalMessage(const Message
& msg
) {
903 // The Hello message contains only the process id.
904 base::PickleIterator
iter(msg
);
906 switch (msg
.type()) {
911 case Channel::HELLO_MESSAGE_TYPE
:
913 if (!iter
.ReadInt(&pid
))
917 listener()->OnChannelConnected(pid
);
920 #if defined(OS_MACOSX)
921 case Channel::CLOSE_FD_MESSAGE_TYPE
:
923 if (!iter
.ReadInt(&hops
))
925 if (!iter
.ReadInt(&fd
))
928 if (fds_to_close_
.erase(fd
) > 0) {
929 if (IGNORE_EINTR(close(fd
)) < 0)
930 PLOG(ERROR
) << "close";
935 QueueCloseFDMessage(fd
, hops
);
942 void ChannelPosix::Close() {
943 // Close can be called multiple time, so we need to make sure we're
946 ResetToAcceptingConnectionState();
949 unlink(pipe_name_
.c_str());
950 must_unlink_
= false;
953 if (server_listen_pipe_
.is_valid()) {
954 #if defined(OS_NACL_NONSFI)
956 << "IPC channels in nacl_helper_nonsfi should not be SERVER mode.";
958 server_listen_pipe_
.reset();
959 // Unregister libevent for the listening socket and close it.
960 server_listen_connection_watcher_
.StopWatchingFileDescriptor();
964 CloseClientFileDescriptor();
967 base::ProcessId
ChannelPosix::GetPeerPID() const {
971 base::ProcessId
ChannelPosix::GetSelfPID() const {
972 return GetHelloMessageProcId();
975 void ChannelPosix::ResetSafely(base::ScopedFD
* fd
) {
982 // The CL [1] tightened the error check for closing FDs, but it turned
983 // out that there are existing cases that hit the newly added check.
984 // ResetSafely() is the workaround for that crash, turning it from
985 // from PCHECK() to DPCHECK() so that it doesn't crash in production.
986 // [1] https://crrev.com/ce44fef5fd60dd2be5c587d4b084bdcd36adcee4
987 int fd_to_close
= fd
->release();
988 if (-1 != fd_to_close
) {
989 int rv
= IGNORE_EINTR(close(fd_to_close
));
994 //------------------------------------------------------------------------------
998 scoped_ptr
<Channel
> Channel::Create(
999 const IPC::ChannelHandle
&channel_handle
, Mode mode
, Listener
* listener
) {
1000 return make_scoped_ptr(new ChannelPosix(channel_handle
, mode
, listener
));
1004 std::string
Channel::GenerateVerifiedChannelID(const std::string
& prefix
) {
1005 // A random name is sufficient validation on posix systems, so we don't need
1006 // an additional shared secret.
1008 std::string id
= prefix
;
1012 return id
.append(GenerateUniqueRandomChannelID());
1015 bool Channel::IsNamedServerInitialized(
1016 const std::string
& channel_id
) {
1017 return ChannelPosix::IsNamedServerInitialized(channel_id
);
1020 #if defined(OS_LINUX)
1022 void Channel::SetGlobalPid(int pid
) {
1023 ChannelPosix::SetGlobalPid(pid
);