1 /* 2 * Copyright (C) 2001-2004 Peter J Jones (pjones@pmade.org) 3 * All Rights Reserved 4 * 5 * Redistribution and use in source and binary forms, with or without 6 * modification, are permitted provided that the following conditions 7 * are met: 8 * 9 * 1. Redistributions of source code must retain the above copyright 10 * notice, this list of conditions and the following disclaimer. 11 * 2. Redistributions in binary form must reproduce the above copyright 12 * notice, this list of conditions and the following disclaimer in 13 * the documentation and/or other materials provided with the 14 * distribution. 15 * 3. Neither the name of the Author nor the names of its contributors 16 * may be used to endorse or promote products derived from this software 17 * without specific prior written permission. 18 * 19 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' 20 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 21 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A 22 * PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR 23 * OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 24 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 25 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF 26 * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED 27 * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 28 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT 29 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 30 * SUCH DAMAGE. 31 */ 32 33 /** @file 34 * This file contains the definition of the Netxx::call_recvfrom function. 35 **/ 36 37 #ifndef _netxx_recvfrom_h_ 38 #define _netxx_recvfrom_h_ 39 40 // local includes 41 #include "types.h" 42 #include "peer.h" 43 #include "socket.h" 44 45 // standard includes 46 #include <utility> 47 48 namespace Netxx { 49 50 //#################################################################### 51 /** 52 * Wrapper around the recvfrom(2) system call. 53 * 54 * @param socket The server socket 55 * @param buffer Where to place the new datagram 56 * @param length The size of the datagram buffer 57 * @return A std::pair<bytes received, peer address> 58 * @author Peter Jones 59 **/ 60 //#################################################################### 61 std::pair<signed_size_type, Peer> call_recvfrom (Socket &socket, void *buffer, size_type length); 62 63 } // end Netxx namespace 64 #endif 65