1/* 2 * Copyright (c) 2000-2001,2003-2004,2011,2014 Apple Inc. All Rights Reserved. 3 * 4 * @APPLE_LICENSE_HEADER_START@ 5 * 6 * This file contains Original Code and/or Modifications of Original Code 7 * as defined in and that are subject to the Apple Public Source License 8 * Version 2.0 (the 'License'). You may not use this file except in 9 * compliance with the License. Please obtain a copy of the License at 10 * http://www.opensource.apple.com/apsl/ and read it before using this 11 * file. 12 * 13 * The Original Code and all software distributed under the License are 14 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER 15 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES, 16 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, 17 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. 18 * Please see the License for the specific language governing rights and 19 * limitations under the License. 20 * 21 * @APPLE_LICENSE_HEADER_END@ 22 */ 23 24 25// 26// fdmover - send/receive file descriptors over a UNIX domain socket connection 27// 28// An FdMover object is a very specialized Socket: 29// It must be bound to a UNIX domain address 30// 31#ifndef _H_FDMOVER 32#define _H_FDMOVER 33 34#include "ip++.h" 35#include <vector> 36 37using namespace UnixPlusPlus; 38 39 40namespace Security { 41namespace IPPlusPlus { 42 43 44// an ordered list of file descriptors 45typedef std::vector<FileDesc> FdVector; 46 47 48// 49// An FdMover - a specialized Socket for transferring file descriptors 50// across UNIX domain sockets. 51// 52class FdMover : public Socket { 53private: 54 class Element : public cmsghdr { 55 public: 56 void *operator new (size_t base, size_t more); 57 void operator delete (void *addr, size_t size); 58 59 Element() { } 60 Element(int level, int type); 61 62 template <class T> T &payload() { return *reinterpret_cast<T *>(CMSG_DATA(this)); } 63 size_t payloadSize() const { return cmsg_len - ((caddr_t)CMSG_DATA(this) - (caddr_t)this); } 64 }; 65 66 class Message : public msghdr { 67 public: 68 Message(const void *data, size_t length); 69 void set(Element *elem); 70 Element *element() const { return (Element *)msg_control; } 71 Element *next(Element *elem) const { return (Element *)CMSG_NXTHDR(this, elem); } 72 73 public: 74 IOVec iovec; 75 }; 76 77public: 78 FdMover() { } 79 FdMover(Socket s) : Socket(s) { } 80 81 size_t send(const void *data, size_t length, const FdVector &fds); 82 size_t receive(void *data, size_t length, FdVector &fds); 83 84private: 85 86}; 87 88 89} // end namespace IPPlusPlus 90} // end namespace Security 91 92 93#endif //_H_FDMOVER 94