1*e5df9dc1SAsim Jamshed<!-- Creator : groff version 1.22.3 --> 2*e5df9dc1SAsim Jamshed<!-- CreationDate: Sat Aug 26 16:40:01 2017 --> 3*e5df9dc1SAsim Jamshed<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 4*e5df9dc1SAsim Jamshed"http://www.w3.org/TR/html4/loose.dtd"> 5*e5df9dc1SAsim Jamshed<html> 6*e5df9dc1SAsim Jamshed<head> 7*e5df9dc1SAsim Jamshed<meta name="generator" content="groff -Thtml, see www.gnu.org"> 8*e5df9dc1SAsim Jamshed<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII"> 9*e5df9dc1SAsim Jamshed<meta name="Content-Style" content="text/css"> 10*e5df9dc1SAsim Jamshed<style type="text/css"> 11*e5df9dc1SAsim Jamshed p { margin-top: 0; margin-bottom: 0; vertical-align: top } 12*e5df9dc1SAsim Jamshed pre { margin-top: 0; margin-bottom: 0; vertical-align: top } 13*e5df9dc1SAsim Jamshed table { margin-top: 0; margin-bottom: 0; vertical-align: top } 14*e5df9dc1SAsim Jamshed h1 { text-align: center } 15*e5df9dc1SAsim Jamshed</style> 16*e5df9dc1SAsim Jamshed<title>mtcp_sendpkt</title> 17*e5df9dc1SAsim Jamshed<link rel="stylesheet" href="./common.css"> 18*e5df9dc1SAsim Jamshed</head> 19*e5df9dc1SAsim Jamshed<body> 20*e5df9dc1SAsim Jamshed<div class="main"> 21*e5df9dc1SAsim Jamshed<h1 align="center">mtcp_sendpkt</h1> 22*e5df9dc1SAsim Jamshed<!-- 23*e5df9dc1SAsim Jamshed<a href="#NAME">NAME</a><br> 24*e5df9dc1SAsim Jamshed<a href="#SYNOPSIS">SYNOPSIS</a><br> 25*e5df9dc1SAsim Jamshed<a href="#DESCRIPTION">DESCRIPTION</a><br> 26*e5df9dc1SAsim Jamshed<a href="#RETURN VALUE">RETURN VALUE</a><br> 27*e5df9dc1SAsim Jamshed<a href="#ERRORS">ERRORS</a><br> 28*e5df9dc1SAsim Jamshed<a href="#AUTHORS">AUTHORS</a><br> 29*e5df9dc1SAsim Jamshed<a href="#SEE ALSO">SEE ALSO</a><br> 30*e5df9dc1SAsim Jamshed<a href="#COLOPHON">COLOPHON</a><br> 31*e5df9dc1SAsim Jamshed 32*e5df9dc1SAsim Jamshed<hr> 33*e5df9dc1SAsim Jamshed--> 34*e5df9dc1SAsim Jamshed 35*e5df9dc1SAsim Jamshed<h2>NAME 36*e5df9dc1SAsim Jamshed<a name="NAME"></a> 37*e5df9dc1SAsim Jamshed</h2> 38*e5df9dc1SAsim Jamshed 39*e5df9dc1SAsim Jamshed 40*e5df9dc1SAsim Jamshed<p style="margin-left:11%; margin-top: 1em">mtcp_sendpkt 41*e5df9dc1SAsim Jamshed− Sends a self-constructed TCP packet to network</p> 42*e5df9dc1SAsim Jamshed 43*e5df9dc1SAsim Jamshed<h2>SYNOPSIS 44*e5df9dc1SAsim Jamshed<a name="SYNOPSIS"></a> 45*e5df9dc1SAsim Jamshed</h2> 46*e5df9dc1SAsim Jamshed 47*e5df9dc1SAsim Jamshed 48*e5df9dc1SAsim Jamshed<p style="margin-left:11%; margin-top: 1em"><b>#include 49*e5df9dc1SAsim Jamshed<mos_api.h></b></p> 50*e5df9dc1SAsim Jamshed 51*e5df9dc1SAsim Jamshed<p style="margin-left:11%; margin-top: 1em"><b>int 52*e5df9dc1SAsim Jamshedmtcp_sendpkt(mctx_t</b> <i>mctx</i><b>, int</b> 53*e5df9dc1SAsim Jamshed<i>sockid</i><b>, struct pkt_info 54*e5df9dc1SAsim Jamshed*</b><i>pinfo</i><b>);</b></p> 55*e5df9dc1SAsim Jamshed 56*e5df9dc1SAsim Jamshed<h2>DESCRIPTION 57*e5df9dc1SAsim Jamshed<a name="DESCRIPTION"></a> 58*e5df9dc1SAsim Jamshed</h2> 59*e5df9dc1SAsim Jamshed 60*e5df9dc1SAsim Jamshed 61*e5df9dc1SAsim Jamshed 62*e5df9dc1SAsim Jamshed<p style="margin-left:11%; margin-top: 1em"><b>mtcp_sendpkt</b>() 63*e5df9dc1SAsim Jamshedsends a self-constructed TCP packet for a given flow to 64*e5df9dc1SAsim Jamshednetwork. The user can select the socket descriptor using 65*e5df9dc1SAsim Jamshed<i>sockid</i> and the <i>pinfo</i> points to an instance of 66*e5df9dc1SAsim Jamshed<b>struct</b> pkt_info that is allocated and filled by the 67*e5df9dc1SAsim Jamsheduser via mtcp_getlastpkt() function. 68*e5df9dc1SAsim JamshedIt is the user's responsibility to allocate the <i>pkt_info </i> 69*e5df9dc1SAsim Jamshedstructure before the function call, and free the 70*e5df9dc1SAsim Jamshed<i>pkt_info</i> after the function call. The structure is 71*e5df9dc1SAsim Jamsheddefined as:</p> 72*e5df9dc1SAsim Jamshed 73*e5df9dc1SAsim Jamshed<p style="margin-left:11%; margin-top: 1em">struct pkt_info 74*e5df9dc1SAsim Jamshed{</p> 75*e5df9dc1SAsim Jamshed 76*e5df9dc1SAsim Jamshed<table width="100%" border="0" rules="none" frame="void" 77*e5df9dc1SAsim Jamshed cellspacing="0" cellpadding="0"> 78*e5df9dc1SAsim Jamshed<tr valign="top" align="left"> 79*e5df9dc1SAsim Jamshed<td width="8%"></td> 80*e5df9dc1SAsim Jamshed<td width="7%"></td> 81*e5df9dc1SAsim Jamshed<td width="85%"> 82*e5df9dc1SAsim Jamshed 83*e5df9dc1SAsim Jamshed 84*e5df9dc1SAsim Jamshed<p>// pkt recving time</p></td></tr> 85*e5df9dc1SAsim Jamshed<tr valign="top" align="left"> 86*e5df9dc1SAsim Jamshed<td width="8%"></td> 87*e5df9dc1SAsim Jamshed<td width="7%"></td> 88*e5df9dc1SAsim Jamshed<td width="85%"> 89*e5df9dc1SAsim Jamshed 90*e5df9dc1SAsim Jamshed 91*e5df9dc1SAsim Jamshed<p>uint32_t cur_ts;</p></td></tr> 92*e5df9dc1SAsim Jamshed<tr valign="top" align="left"> 93*e5df9dc1SAsim Jamshed<td width="8%"></td> 94*e5df9dc1SAsim Jamshed<td width="7%"></td> 95*e5df9dc1SAsim Jamshed<td width="85%"> 96*e5df9dc1SAsim Jamshed 97*e5df9dc1SAsim Jamshed 98*e5df9dc1SAsim Jamshed<p>// ETH</p></td></tr> 99*e5df9dc1SAsim Jamshed<tr valign="top" align="left"> 100*e5df9dc1SAsim Jamshed<td width="8%"></td> 101*e5df9dc1SAsim Jamshed<td width="7%"></td> 102*e5df9dc1SAsim Jamshed<td width="85%"> 103*e5df9dc1SAsim Jamshed 104*e5df9dc1SAsim Jamshed 105*e5df9dc1SAsim Jamshed<p>uint16_t eth_len;</p></td></tr> 106*e5df9dc1SAsim Jamshed<tr valign="top" align="left"> 107*e5df9dc1SAsim Jamshed<td width="8%"></td> 108*e5df9dc1SAsim Jamshed<td width="7%"></td> 109*e5df9dc1SAsim Jamshed<td width="85%"> 110*e5df9dc1SAsim Jamshed 111*e5df9dc1SAsim Jamshed 112*e5df9dc1SAsim Jamshed<p>// IP</p></td></tr> 113*e5df9dc1SAsim Jamshed<tr valign="top" align="left"> 114*e5df9dc1SAsim Jamshed<td width="8%"></td> 115*e5df9dc1SAsim Jamshed<td width="7%"></td> 116*e5df9dc1SAsim Jamshed<td width="85%"> 117*e5df9dc1SAsim Jamshed 118*e5df9dc1SAsim Jamshed 119*e5df9dc1SAsim Jamshed<p>uint16_t ip_len;</p></td></tr> 120*e5df9dc1SAsim Jamshed<tr valign="top" align="left"> 121*e5df9dc1SAsim Jamshed<td width="8%"></td> 122*e5df9dc1SAsim Jamshed<td width="7%"></td> 123*e5df9dc1SAsim Jamshed<td width="85%"> 124*e5df9dc1SAsim Jamshed 125*e5df9dc1SAsim Jamshed 126*e5df9dc1SAsim Jamshed<p>//TCP</p></td></tr> 127*e5df9dc1SAsim Jamshed<tr valign="top" align="left"> 128*e5df9dc1SAsim Jamshed<td width="8%"></td> 129*e5df9dc1SAsim Jamshed<td width="7%"></td> 130*e5df9dc1SAsim Jamshed<td width="85%"> 131*e5df9dc1SAsim Jamshed 132*e5df9dc1SAsim Jamshed 133*e5df9dc1SAsim Jamshed<p>uint64_t offset; // TCP recv buffer offset</p></td></tr> 134*e5df9dc1SAsim Jamshed<tr valign="top" align="left"> 135*e5df9dc1SAsim Jamshed<td width="8%"></td> 136*e5df9dc1SAsim Jamshed<td width="7%"></td> 137*e5df9dc1SAsim Jamshed<td width="85%"> 138*e5df9dc1SAsim Jamshed 139*e5df9dc1SAsim Jamshed 140*e5df9dc1SAsim Jamshed<p>uint16_t payloadlen;</p></td></tr> 141*e5df9dc1SAsim Jamshed<tr valign="top" align="left"> 142*e5df9dc1SAsim Jamshed<td width="8%"></td> 143*e5df9dc1SAsim Jamshed<td width="7%"></td> 144*e5df9dc1SAsim Jamshed<td width="85%"> 145*e5df9dc1SAsim Jamshed 146*e5df9dc1SAsim Jamshed 147*e5df9dc1SAsim Jamshed<p>uint32_t seq;</p></td></tr> 148*e5df9dc1SAsim Jamshed<tr valign="top" align="left"> 149*e5df9dc1SAsim Jamshed<td width="8%"></td> 150*e5df9dc1SAsim Jamshed<td width="7%"></td> 151*e5df9dc1SAsim Jamshed<td width="85%"> 152*e5df9dc1SAsim Jamshed 153*e5df9dc1SAsim Jamshed 154*e5df9dc1SAsim Jamshed<p>uint32_t ack_seq;</p></td></tr> 155*e5df9dc1SAsim Jamshed<tr valign="top" align="left"> 156*e5df9dc1SAsim Jamshed<td width="8%"></td> 157*e5df9dc1SAsim Jamshed<td width="7%"></td> 158*e5df9dc1SAsim Jamshed<td width="85%"> 159*e5df9dc1SAsim Jamshed 160*e5df9dc1SAsim Jamshed 161*e5df9dc1SAsim Jamshed<p>uint16_t window;</p></td></tr> 162*e5df9dc1SAsim Jamshed<tr valign="top" align="left"> 163*e5df9dc1SAsim Jamshed<td width="8%"></td> 164*e5df9dc1SAsim Jamshed<td width="7%"></td> 165*e5df9dc1SAsim Jamshed<td width="85%"> 166*e5df9dc1SAsim Jamshed 167*e5df9dc1SAsim Jamshed 168*e5df9dc1SAsim Jamshed<p>struct ethhdr *ethh;</p></td></tr> 169*e5df9dc1SAsim Jamshed<tr valign="top" align="left"> 170*e5df9dc1SAsim Jamshed<td width="8%"></td> 171*e5df9dc1SAsim Jamshed<td width="7%"></td> 172*e5df9dc1SAsim Jamshed<td width="85%"> 173*e5df9dc1SAsim Jamshed 174*e5df9dc1SAsim Jamshed 175*e5df9dc1SAsim Jamshed<p>struct iphdr *iph;</p></td></tr> 176*e5df9dc1SAsim Jamshed<tr valign="top" align="left"> 177*e5df9dc1SAsim Jamshed<td width="8%"></td> 178*e5df9dc1SAsim Jamshed<td width="7%"></td> 179*e5df9dc1SAsim Jamshed<td width="85%"> 180*e5df9dc1SAsim Jamshed 181*e5df9dc1SAsim Jamshed 182*e5df9dc1SAsim Jamshed<p>struct tcphdr *tcph;</p></td></tr> 183*e5df9dc1SAsim Jamshed<tr valign="top" align="left"> 184*e5df9dc1SAsim Jamshed<td width="8%"></td> 185*e5df9dc1SAsim Jamshed<td width="7%"></td> 186*e5df9dc1SAsim Jamshed<td width="85%"> 187*e5df9dc1SAsim Jamshed 188*e5df9dc1SAsim Jamshed 189*e5df9dc1SAsim Jamshed<p>uint8_t *payload;</p></td></tr> 190*e5df9dc1SAsim Jamshed</table> 191*e5df9dc1SAsim Jamshed 192*e5df9dc1SAsim Jamshed<p style="margin-left:11%;">}</p> 193*e5df9dc1SAsim Jamshed 194*e5df9dc1SAsim Jamshed<p style="margin-left:11%; margin-top: 1em">A successful 195*e5df9dc1SAsim Jamshedcall to <b>mtcp_sendpkt()</b> constructs a TCP packet based 196*e5df9dc1SAsim Jamshedon the given packet information <i>pinfo</i> and send the 197*e5df9dc1SAsim Jamshedpacket to the network.</p> 198*e5df9dc1SAsim Jamshed 199*e5df9dc1SAsim Jamshed<p style="margin-left:11%; margin-top: 1em">An 200*e5df9dc1SAsim Jamshed<b>mtcp_sendpkt</b>() call takes an additional argument 201*e5df9dc1SAsim Jamshednamed <i>mctx</i> that represents the per-core mTCP context 202*e5df9dc1SAsim Jamshedin an application (see <b>mtcp_create_context()</b> for 203*e5df9dc1SAsim Jamsheddetails).</p> 204*e5df9dc1SAsim Jamshed 205*e5df9dc1SAsim Jamshed<h2>RETURN VALUE 206*e5df9dc1SAsim Jamshed<a name="RETURN VALUE"></a> 207*e5df9dc1SAsim Jamshed</h2> 208*e5df9dc1SAsim Jamshed 209*e5df9dc1SAsim Jamshed 210*e5df9dc1SAsim Jamshed<p style="margin-left:11%; margin-top: 1em">Returns 0 on 211*e5df9dc1SAsim Jamshedsuccess; -1 on failure. In case of failure, <i>errno</i> is 212*e5df9dc1SAsim Jamshedset appropriately.</p> 213*e5df9dc1SAsim Jamshed 214*e5df9dc1SAsim Jamshed<h2>ERRORS 215*e5df9dc1SAsim Jamshed<a name="ERRORS"></a> 216*e5df9dc1SAsim Jamshed</h2> 217*e5df9dc1SAsim Jamshed 218*e5df9dc1SAsim Jamshed 219*e5df9dc1SAsim Jamshed<table width="100%" border="0" rules="none" frame="void" 220*e5df9dc1SAsim Jamshed cellspacing="0" cellpadding="0"> 221*e5df9dc1SAsim Jamshed<tr valign="top" align="left"> 222*e5df9dc1SAsim Jamshed<td width="11%"></td> 223*e5df9dc1SAsim Jamshed<td width="11%"> 224*e5df9dc1SAsim Jamshed 225*e5df9dc1SAsim Jamshed 226*e5df9dc1SAsim Jamshed<p style="margin-top: 1em"><b>EACCES</b></p></td> 227*e5df9dc1SAsim Jamshed<td width="12%"></td> 228*e5df9dc1SAsim Jamshed<td width="66%"> 229*e5df9dc1SAsim Jamshed 230*e5df9dc1SAsim Jamshed 231*e5df9dc1SAsim Jamshed<p style="margin-top: 1em"><i>mctx</i> is invalid, or 232*e5df9dc1SAsim Jamshed<i>pinfo</i> is NULL.</p></td></tr> 233*e5df9dc1SAsim Jamshed<tr valign="top" align="left"> 234*e5df9dc1SAsim Jamshed<td width="11%"></td> 235*e5df9dc1SAsim Jamshed<td width="11%"> 236*e5df9dc1SAsim Jamshed 237*e5df9dc1SAsim Jamshed 238*e5df9dc1SAsim Jamshed<p><b>ENODATA</b></p></td> 239*e5df9dc1SAsim Jamshed<td width="12%"></td> 240*e5df9dc1SAsim Jamshed<td width="66%"> 241*e5df9dc1SAsim Jamshed 242*e5df9dc1SAsim Jamshed 243*e5df9dc1SAsim Jamshed<p>The packet information does not contain a valid IP 244*e5df9dc1SAsim Jamshedheader or TCP header information. This normally does not 245*e5df9dc1SAsim Jamshedoccur when we put the result of the <b>mtcp_sendpkt()</b> 246*e5df9dc1SAsim Jamshedfunction. Therefore, it means that the user modified the 247*e5df9dc1SAsim Jamshedpacket information inappropriately.</p></td></tr> 248*e5df9dc1SAsim Jamshed</table> 249*e5df9dc1SAsim Jamshed 250*e5df9dc1SAsim Jamshed<h2>AUTHORS 251*e5df9dc1SAsim Jamshed<a name="AUTHORS"></a> 252*e5df9dc1SAsim Jamshed</h2> 253*e5df9dc1SAsim Jamshed 254*e5df9dc1SAsim Jamshed 255*e5df9dc1SAsim Jamshed<p style="margin-left:11%; margin-top: 1em">mOS development 256*e5df9dc1SAsim Jamshedteam <[email protected]></p> 257*e5df9dc1SAsim Jamshed 258*e5df9dc1SAsim Jamshed<h2>SEE ALSO 259*e5df9dc1SAsim Jamshed<a name="SEE ALSO"></a> 260*e5df9dc1SAsim Jamshed</h2> 261*e5df9dc1SAsim Jamshed 262*e5df9dc1SAsim Jamshed 263*e5df9dc1SAsim Jamshed 264*e5df9dc1SAsim Jamshed<p style="margin-left:11%; margin-top: 1em"><b>mtcp_create_context</b>(), 265*e5df9dc1SAsim Jamshed<b>mtcp_setlastpkt</b>(), <b>mtcp_socket</b>(),</p> 266*e5df9dc1SAsim Jamshed 267*e5df9dc1SAsim Jamshed<h2>COLOPHON 268*e5df9dc1SAsim Jamshed<a name="COLOPHON"></a> 269*e5df9dc1SAsim Jamshed</h2> 270*e5df9dc1SAsim Jamshed 271*e5df9dc1SAsim Jamshed 272*e5df9dc1SAsim Jamshed<p style="margin-left:11%; margin-top: 1em">This page is 273*e5df9dc1SAsim Jamshedpart of mOS release 0.3 <i>docs</i> section. A description 274*e5df9dc1SAsim Jamshedof the project, and information about reporting bugs, can be 275*e5df9dc1SAsim Jamshedfound at http://mos.kaist.edu/.</p> 276*e5df9dc1SAsim Jamshed<hr> 277*e5df9dc1SAsim Jamshed<div class="footer"> 278*e5df9dc1SAsim Jamshed <img src="back-arrow.jpg" width="2%" height="2%"><a href="http://mos.kaist.edu/index_man.html">Back to Index</a> 279*e5df9dc1SAsim Jamshed</div> 280*e5df9dc1SAsim Jamshed</div> 281*e5df9dc1SAsim Jamshed</body> 282*e5df9dc1SAsim Jamshed</html> 283
