1 // Copyright (c) 2009 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. 4 5 #ifndef BASE_UNIX_DOMAIN_SOCKET_POSIX_H_ 6 #define BASE_UNIX_DOMAIN_SOCKET_POSIX_H_ 7 8 #include <stdint.h> 9 #include <sys/types.h> 10 #include <vector> 11 12 class Pickle; 13 14 namespace base { 15 16 // Use sendmsg to write the given msg and include a vector 17 // of file descriptors. Returns true iff successful. 18 bool SendMsg(int fd, const void* msg, size_t length, 19 std::vector<int>& fds); 20 // Use recvmsg to read a message and an array of file descriptors. Returns 21 // -1 on failure. Note: will read, at most, 16 descriptors. 22 ssize_t RecvMsg(int fd, void* msg, size_t length, std::vector<int>* fds); 23 // Perform a sendmsg/recvmsg pair. 24 // 1. This process creates a UNIX DGRAM socketpair. 25 // 2. This proces writes a request to |fd| with an SCM_RIGHTS control message 26 // containing on end of the fresh socket pair. 27 // 3. This process blocks reading from the other end of the fresh socketpair. 28 // 4. The target process receives the request, processes it and writes the 29 // reply to the end of the socketpair contained in the request. 30 // 5. This process wakes up and continues. 31 // 32 // fd: descriptor to send the request on 33 // reply: buffer for the reply 34 // reply_len: size of |reply| 35 // result_fd: (may be NULL) the file descriptor returned in the reply (if any) 36 // request: the bytes to send in the request 37 ssize_t SendRecvMsg(int fd, uint8_t* reply, unsigned reply_len, int* result_fd, 38 const Pickle& request); 39 40 } // namespace base 41 42 #endif // BASE_UNIX_DOMAIN_SOCKET_POSIX_H_ 43