1*91df013fSAsim Jamshed<!-- Creator : groff version 1.22.2 --> 2*91df013fSAsim Jamshed<!-- CreationDate: Thu Feb 2 23:56:35 2017 --> 3*91df013fSAsim Jamshed<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 4*91df013fSAsim Jamshed"http://www.w3.org/TR/html4/loose.dtd"> 5*91df013fSAsim Jamshed<html> 6*91df013fSAsim Jamshed<head> 7*91df013fSAsim Jamshed<meta name="generator" content="groff -Thtml, see www.gnu.org"> 8*91df013fSAsim Jamshed<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII"> 9*91df013fSAsim Jamshed<meta name="Content-Style" content="text/css"> 10*91df013fSAsim Jamshed<style type="text/css"> 11*91df013fSAsim Jamshed p { margin-top: 0; margin-bottom: 0; vertical-align: top } 12*91df013fSAsim Jamshed pre { margin-top: 0; margin-bottom: 0; vertical-align: top } 13*91df013fSAsim Jamshed table { margin-top: 0; margin-bottom: 0; vertical-align: top } 14*91df013fSAsim Jamshed h1 { text-align: center } 15*91df013fSAsim Jamshed</style> 16*91df013fSAsim Jamshed<title>mtcp_setsockopt</title> 17*91df013fSAsim Jamshed 18*91df013fSAsim Jamshed</head> 19*91df013fSAsim Jamshed<body> 20*91df013fSAsim Jamshed 21*91df013fSAsim Jamshed<h1 align="center">mtcp_setsockopt</h1> 22*91df013fSAsim Jamshed 23*91df013fSAsim Jamshed<a href="#NAME">NAME</a><br> 24*91df013fSAsim Jamshed<a href="#SYNOPSIS">SYNOPSIS</a><br> 25*91df013fSAsim Jamshed<a href="#DESCRIPTION">DESCRIPTION</a><br> 26*91df013fSAsim Jamshed<a href="#RETURN VALUE">RETURN VALUE</a><br> 27*91df013fSAsim Jamshed<a href="#ERRORS">ERRORS</a><br> 28*91df013fSAsim Jamshed<a href="#AUTHORS">AUTHORS</a><br> 29*91df013fSAsim Jamshed<a href="#SEE ALSO">SEE ALSO</a><br> 30*91df013fSAsim Jamshed<a href="#COLOPHON">COLOPHON</a><br> 31*91df013fSAsim Jamshed 32*91df013fSAsim Jamshed<hr> 33*91df013fSAsim Jamshed 34*91df013fSAsim Jamshed 35*91df013fSAsim Jamshed<h2>NAME 36*91df013fSAsim Jamshed<a name="NAME"></a> 37*91df013fSAsim Jamshed</h2> 38*91df013fSAsim Jamshed 39*91df013fSAsim Jamshed 40*91df013fSAsim Jamshed 41*91df013fSAsim Jamshed<p style="margin-left:11%; margin-top: 1em">mtcp_setsockopt 42*91df013fSAsim Jamshed− set options on mTCP/mOS sockets</p> 43*91df013fSAsim Jamshed 44*91df013fSAsim Jamshed<h2>SYNOPSIS 45*91df013fSAsim Jamshed<a name="SYNOPSIS"></a> 46*91df013fSAsim Jamshed</h2> 47*91df013fSAsim Jamshed 48*91df013fSAsim Jamshed 49*91df013fSAsim Jamshed<p style="margin-left:11%; margin-top: 1em"><b>#include 50*91df013fSAsim Jamshed<mtcp_api.h></b></p> 51*91df013fSAsim Jamshed 52*91df013fSAsim Jamshed<p style="margin-left:11%; margin-top: 1em"><b>int 53*91df013fSAsim Jamshedmtcp_setsockopt(mctx_t</b> <i>mctx</i><b>, int</b> 54*91df013fSAsim Jamshed<i>sockid</i><b>, int</b> <i>level</i><b>, int</b> 55*91df013fSAsim Jamshed<i>optname</i><b>, const void *</b><i>optval</i><b>, 56*91df013fSAsim Jamshedsocklen_t</b> <i>optlen</i><b>);</b></p> 57*91df013fSAsim Jamshed 58*91df013fSAsim Jamshed<h2>DESCRIPTION 59*91df013fSAsim Jamshed<a name="DESCRIPTION"></a> 60*91df013fSAsim Jamshed</h2> 61*91df013fSAsim Jamshed 62*91df013fSAsim Jamshed 63*91df013fSAsim Jamshed 64*91df013fSAsim Jamshed<p style="margin-left:11%; margin-top: 1em"><b>mtcp_setsockopt</b>() 65*91df013fSAsim Jamshedmanipulate options for the socket referred to by the 66*91df013fSAsim Jamshed<i>sockid</i> descriptor. These options may exist at 67*91df013fSAsim Jamshedmultiple protocol levels. When manipulating socket options, 68*91df013fSAsim Jamshedthe level at which the options resides and the name of the 69*91df013fSAsim Jamshedoption must be specified. A user can use 70*91df013fSAsim Jamshed<b>SOL_MONSOCKET</b> <i>level</i> to adjust options for 71*91df013fSAsim Jamshedmonitoring sockets.</p> 72*91df013fSAsim Jamshed 73*91df013fSAsim Jamshed<p style="margin-left:11%; margin-top: 1em">The arguments 74*91df013fSAsim Jamshed<i>optval</i> and <i>optlen</i> are used to set options 75*91df013fSAsim Jamshedvalues for mtcp_setsockopt().</p> 76*91df013fSAsim Jamshed 77*91df013fSAsim Jamshed<p style="margin-left:11%; margin-top: 1em">SOL_MONSOCKET 78*91df013fSAsim Jamshedsocket <i>level</i> can be used by <b>mtcp_setsockopt()</b> 79*91df013fSAsim Jamshedto set a number of attributes pertaining to the socket.</p> 80*91df013fSAsim Jamshed 81*91df013fSAsim Jamshed<table width="100%" border="0" rules="none" frame="void" 82*91df013fSAsim Jamshed cellspacing="0" cellpadding="0"> 83*91df013fSAsim Jamshed<tr valign="top" align="left"> 84*91df013fSAsim Jamshed<td width="11%"></td> 85*91df013fSAsim Jamshed<td width="15%"> 86*91df013fSAsim Jamshed 87*91df013fSAsim Jamshed 88*91df013fSAsim Jamshed<p style="margin-top: 1em">MOS_CLIBUF</p></td> 89*91df013fSAsim Jamshed<td width="23%"></td> 90*91df013fSAsim Jamshed<td width="51%"> 91*91df013fSAsim Jamshed 92*91df013fSAsim Jamshed 93*91df013fSAsim Jamshed<p style="margin-top: 1em">Dynamically adjust the size of 94*91df013fSAsim Jamshedthe TCP receive ring buffer of the emulated client stack. 95*91df013fSAsim JamshedThe <i>optval</i> contains the size of the buffer that needs 96*91df013fSAsim Jamshedto be set as int, while <i>optlen</i> is equal to 97*91df013fSAsim Jamshedsizeof(int).</p> </td></tr> 98*91df013fSAsim Jamshed<tr valign="top" align="left"> 99*91df013fSAsim Jamshed<td width="11%"></td> 100*91df013fSAsim Jamshed<td width="15%"> 101*91df013fSAsim Jamshed 102*91df013fSAsim Jamshed 103*91df013fSAsim Jamshed<p>MOS_SVRBUF</p></td> 104*91df013fSAsim Jamshed<td width="23%"></td> 105*91df013fSAsim Jamshed<td width="51%"> 106*91df013fSAsim Jamshed 107*91df013fSAsim Jamshed 108*91df013fSAsim Jamshed<p>Dynamically adjust the size of the TCP receive ring 109*91df013fSAsim Jamshedbuffer of the emulated client stack. The <i>optval</i> 110*91df013fSAsim Jamshedcontains the size of the buffer that needs to be set as int, 111*91df013fSAsim Jamshedwhile <i>optlen</i> is equal to sizeof(int).</p></td></tr> 112*91df013fSAsim Jamshed</table> 113*91df013fSAsim Jamshed 114*91df013fSAsim Jamshed<h2>RETURN VALUE 115*91df013fSAsim Jamshed<a name="RETURN VALUE"></a> 116*91df013fSAsim Jamshed</h2> 117*91df013fSAsim Jamshed 118*91df013fSAsim Jamshed 119*91df013fSAsim Jamshed<p style="margin-left:11%; margin-top: 1em">Returns 0 on 120*91df013fSAsim Jamshedsuccess; -1 on failure. In case of failure, <i>errno</i> is 121*91df013fSAsim Jamshedset appropriately.</p> 122*91df013fSAsim Jamshed 123*91df013fSAsim Jamshed<h2>ERRORS 124*91df013fSAsim Jamshed<a name="ERRORS"></a> 125*91df013fSAsim Jamshed</h2> 126*91df013fSAsim Jamshed 127*91df013fSAsim Jamshed 128*91df013fSAsim Jamshed<table width="100%" border="0" rules="none" frame="void" 129*91df013fSAsim Jamshed cellspacing="0" cellpadding="0"> 130*91df013fSAsim Jamshed<tr valign="top" align="left"> 131*91df013fSAsim Jamshed<td width="11%"></td> 132*91df013fSAsim Jamshed<td width="12%"> 133*91df013fSAsim Jamshed 134*91df013fSAsim Jamshed 135*91df013fSAsim Jamshed<p style="margin-top: 1em"><b>EACCES</b></p></td> 136*91df013fSAsim Jamshed<td width="3%"></td> 137*91df013fSAsim Jamshed<td width="74%"> 138*91df013fSAsim Jamshed 139*91df013fSAsim Jamshed 140*91df013fSAsim Jamshed<p style="margin-top: 1em"><i>mctx</i> is not valid.</p></td></tr> 141*91df013fSAsim Jamshed<tr valign="top" align="left"> 142*91df013fSAsim Jamshed<td width="11%"></td> 143*91df013fSAsim Jamshed<td width="12%"> 144*91df013fSAsim Jamshed 145*91df013fSAsim Jamshed 146*91df013fSAsim Jamshed<p><b>EBADF</b></p></td> 147*91df013fSAsim Jamshed<td width="3%"></td> 148*91df013fSAsim Jamshed<td width="74%"> 149*91df013fSAsim Jamshed 150*91df013fSAsim Jamshed 151*91df013fSAsim Jamshed<p><i>sockid</i> is not a valid socket descriptor.</p></td></tr> 152*91df013fSAsim Jamshed<tr valign="top" align="left"> 153*91df013fSAsim Jamshed<td width="11%"></td> 154*91df013fSAsim Jamshed<td width="12%"> 155*91df013fSAsim Jamshed 156*91df013fSAsim Jamshed 157*91df013fSAsim Jamshed<p><b>ENOTSOCK</b></p></td> 158*91df013fSAsim Jamshed<td width="3%"></td> 159*91df013fSAsim Jamshed<td width="74%"> 160*91df013fSAsim Jamshed 161*91df013fSAsim Jamshed 162*91df013fSAsim Jamshed<p>The socket referred to by <i>sockid</i> is not 163*91df013fSAsim Jamshedvalid.</p> </td></tr> 164*91df013fSAsim Jamshed<tr valign="top" align="left"> 165*91df013fSAsim Jamshed<td width="11%"></td> 166*91df013fSAsim Jamshed<td width="12%"> 167*91df013fSAsim Jamshed 168*91df013fSAsim Jamshed 169*91df013fSAsim Jamshed<p><b>ENOSYS</b></p></td> 170*91df013fSAsim Jamshed<td width="3%"></td> 171*91df013fSAsim Jamshed<td width="74%"> 172*91df013fSAsim Jamshed 173*91df013fSAsim Jamshed 174*91df013fSAsim Jamshed<p>Either the <i>level</i> or the <i>optname</i> is not 175*91df013fSAsim Jamshedimplemented.</p> </td></tr> 176*91df013fSAsim Jamshed<tr valign="top" align="left"> 177*91df013fSAsim Jamshed<td width="11%"></td> 178*91df013fSAsim Jamshed<td width="12%"> 179*91df013fSAsim Jamshed 180*91df013fSAsim Jamshed 181*91df013fSAsim Jamshed<p><b>EPERM</b></p></td> 182*91df013fSAsim Jamshed<td width="3%"></td> 183*91df013fSAsim Jamshed<td width="74%"> 184*91df013fSAsim Jamshed 185*91df013fSAsim Jamshed 186*91df013fSAsim Jamshed<p>Permission to access a socket option is denied.</p></td></tr> 187*91df013fSAsim Jamshed</table> 188*91df013fSAsim Jamshed 189*91df013fSAsim Jamshed<h2>AUTHORS 190*91df013fSAsim Jamshed<a name="AUTHORS"></a> 191*91df013fSAsim Jamshed</h2> 192*91df013fSAsim Jamshed 193*91df013fSAsim Jamshed 194*91df013fSAsim Jamshed<p style="margin-left:22%; margin-top: 1em">mOS development 195*91df013fSAsim Jamshedteam <[email protected]></p> 196*91df013fSAsim Jamshed 197*91df013fSAsim Jamshed<h2>SEE ALSO 198*91df013fSAsim Jamshed<a name="SEE ALSO"></a> 199*91df013fSAsim Jamshed</h2> 200*91df013fSAsim Jamshed 201*91df013fSAsim Jamshed 202*91df013fSAsim Jamshed 203*91df013fSAsim Jamshed<p style="margin-left:11%; margin-top: 1em"><b>mtcp_socket</b>(), 204*91df013fSAsim Jamshed<b>mtcp_getsockopt</b>()</p> 205*91df013fSAsim Jamshed 206*91df013fSAsim Jamshed<h2>COLOPHON 207*91df013fSAsim Jamshed<a name="COLOPHON"></a> 208*91df013fSAsim Jamshed</h2> 209*91df013fSAsim Jamshed 210*91df013fSAsim Jamshed 211*91df013fSAsim Jamshed<p style="margin-left:11%; margin-top: 1em">This page is 212*91df013fSAsim Jamshedpart of mOS release 0.3 <i>docs</i> section. A description 213*91df013fSAsim Jamshedof the project, and information about reporting bugs, can be 214*91df013fSAsim Jamshedfound at http://mos.kaist.edu/.</p> 215*91df013fSAsim Jamshed<hr> 216*91df013fSAsim Jamshed</body> 217*91df013fSAsim Jamshed</html> 218