191df013fSAsim Jamshed<!-- Creator : groff version 1.22.2 --> 291df013fSAsim Jamshed<!-- CreationDate: Thu Feb 2 23:56:35 2017 --> 391df013fSAsim Jamshed<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 491df013fSAsim Jamshed"http://www.w3.org/TR/html4/loose.dtd"> 591df013fSAsim Jamshed<html> 691df013fSAsim Jamshed<head> 791df013fSAsim Jamshed<meta name="generator" content="groff -Thtml, see www.gnu.org"> 891df013fSAsim Jamshed<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII"> 991df013fSAsim Jamshed<meta name="Content-Style" content="text/css"> 1091df013fSAsim Jamshed<style type="text/css"> 1191df013fSAsim Jamshed p { margin-top: 0; margin-bottom: 0; vertical-align: top } 1291df013fSAsim Jamshed pre { margin-top: 0; margin-bottom: 0; vertical-align: top } 1391df013fSAsim Jamshed table { margin-top: 0; margin-bottom: 0; vertical-align: top } 1491df013fSAsim Jamshed h1 { text-align: center } 1591df013fSAsim Jamshed</style> 1691df013fSAsim Jamshed<title>mtcp_setsockopt</title> 17*e5df9dc1SAsim Jamshed<link rel="stylesheet" href="./common.css"> 1891df013fSAsim Jamshed</head> 1991df013fSAsim Jamshed<body> 20*e5df9dc1SAsim Jamshed<div class="main"> 2191df013fSAsim Jamshed<h1 align="center">mtcp_setsockopt</h1> 22*e5df9dc1SAsim Jamshed<!-- 2391df013fSAsim Jamshed<a href="#NAME">NAME</a><br> 2491df013fSAsim Jamshed<a href="#SYNOPSIS">SYNOPSIS</a><br> 2591df013fSAsim Jamshed<a href="#DESCRIPTION">DESCRIPTION</a><br> 2691df013fSAsim Jamshed<a href="#RETURN VALUE">RETURN VALUE</a><br> 2791df013fSAsim Jamshed<a href="#ERRORS">ERRORS</a><br> 2891df013fSAsim Jamshed<a href="#AUTHORS">AUTHORS</a><br> 2991df013fSAsim Jamshed<a href="#SEE ALSO">SEE ALSO</a><br> 3091df013fSAsim Jamshed<a href="#COLOPHON">COLOPHON</a><br> 3191df013fSAsim Jamshed<hr> 32*e5df9dc1SAsim Jamshed--> 3391df013fSAsim Jamshed 3491df013fSAsim Jamshed<h2>NAME 3591df013fSAsim Jamshed<a name="NAME"></a> 3691df013fSAsim Jamshed</h2> 3791df013fSAsim Jamshed 3891df013fSAsim Jamshed 3991df013fSAsim Jamshed 4091df013fSAsim Jamshed<p style="margin-left:11%; margin-top: 1em">mtcp_setsockopt 4191df013fSAsim Jamshed− set options on mTCP/mOS sockets</p> 4291df013fSAsim Jamshed 4391df013fSAsim Jamshed<h2>SYNOPSIS 4491df013fSAsim Jamshed<a name="SYNOPSIS"></a> 4591df013fSAsim Jamshed</h2> 4691df013fSAsim Jamshed 4791df013fSAsim Jamshed 4891df013fSAsim Jamshed<p style="margin-left:11%; margin-top: 1em"><b>#include 4991df013fSAsim Jamshed<mtcp_api.h></b></p> 5091df013fSAsim Jamshed 5191df013fSAsim Jamshed<p style="margin-left:11%; margin-top: 1em"><b>int 5291df013fSAsim Jamshedmtcp_setsockopt(mctx_t</b> <i>mctx</i><b>, int</b> 5391df013fSAsim Jamshed<i>sockid</i><b>, int</b> <i>level</i><b>, int</b> 5491df013fSAsim Jamshed<i>optname</i><b>, const void *</b><i>optval</i><b>, 5591df013fSAsim Jamshedsocklen_t</b> <i>optlen</i><b>);</b></p> 5691df013fSAsim Jamshed 5791df013fSAsim Jamshed<h2>DESCRIPTION 5891df013fSAsim Jamshed<a name="DESCRIPTION"></a> 5991df013fSAsim Jamshed</h2> 6091df013fSAsim Jamshed 6191df013fSAsim Jamshed 6291df013fSAsim Jamshed 6391df013fSAsim Jamshed<p style="margin-left:11%; margin-top: 1em"><b>mtcp_setsockopt</b>() 6491df013fSAsim Jamshedmanipulate options for the socket referred to by the 6591df013fSAsim Jamshed<i>sockid</i> descriptor. These options may exist at 6691df013fSAsim Jamshedmultiple protocol levels. When manipulating socket options, 6791df013fSAsim Jamshedthe level at which the options resides and the name of the 6891df013fSAsim Jamshedoption must be specified. A user can use 6991df013fSAsim Jamshed<b>SOL_MONSOCKET</b> <i>level</i> to adjust options for 7091df013fSAsim Jamshedmonitoring sockets.</p> 7191df013fSAsim Jamshed 7291df013fSAsim Jamshed<p style="margin-left:11%; margin-top: 1em">The arguments 7391df013fSAsim Jamshed<i>optval</i> and <i>optlen</i> are used to set options 7491df013fSAsim Jamshedvalues for mtcp_setsockopt().</p> 7591df013fSAsim Jamshed 7691df013fSAsim Jamshed<p style="margin-left:11%; margin-top: 1em">SOL_MONSOCKET 7791df013fSAsim Jamshedsocket <i>level</i> can be used by <b>mtcp_setsockopt()</b> 7891df013fSAsim Jamshedto set a number of attributes pertaining to the socket.</p> 7991df013fSAsim Jamshed 8091df013fSAsim Jamshed<table width="100%" border="0" rules="none" frame="void" 8191df013fSAsim Jamshed cellspacing="0" cellpadding="0"> 8291df013fSAsim Jamshed<tr valign="top" align="left"> 8391df013fSAsim Jamshed<td width="11%"></td> 8491df013fSAsim Jamshed<td width="15%"> 8591df013fSAsim Jamshed 8691df013fSAsim Jamshed 8791df013fSAsim Jamshed<p style="margin-top: 1em">MOS_CLIBUF</p></td> 8891df013fSAsim Jamshed<td width="23%"></td> 8991df013fSAsim Jamshed<td width="51%"> 9091df013fSAsim Jamshed 9191df013fSAsim Jamshed 9291df013fSAsim Jamshed<p style="margin-top: 1em">Dynamically adjust the size of 9391df013fSAsim Jamshedthe TCP receive ring buffer of the emulated client stack. 9491df013fSAsim JamshedThe <i>optval</i> contains the size of the buffer that needs 9591df013fSAsim Jamshedto be set as int, while <i>optlen</i> is equal to 9691df013fSAsim Jamshedsizeof(int).</p> </td></tr> 9791df013fSAsim Jamshed<tr valign="top" align="left"> 9891df013fSAsim Jamshed<td width="11%"></td> 9991df013fSAsim Jamshed<td width="15%"> 10091df013fSAsim Jamshed 10191df013fSAsim Jamshed 10291df013fSAsim Jamshed<p>MOS_SVRBUF</p></td> 10391df013fSAsim Jamshed<td width="23%"></td> 10491df013fSAsim Jamshed<td width="51%"> 10591df013fSAsim Jamshed 10691df013fSAsim Jamshed 10791df013fSAsim Jamshed<p>Dynamically adjust the size of the TCP receive ring 10891df013fSAsim Jamshedbuffer of the emulated client stack. The <i>optval</i> 10991df013fSAsim Jamshedcontains the size of the buffer that needs to be set as int, 11091df013fSAsim Jamshedwhile <i>optlen</i> is equal to sizeof(int).</p></td></tr> 111*e5df9dc1SAsim Jamshed<tr valign="top" align="left"> 112*e5df9dc1SAsim Jamshed<td width="11%"></td> 113*e5df9dc1SAsim Jamshed<td width="21%"> 114*e5df9dc1SAsim Jamshed 115*e5df9dc1SAsim Jamshed 116*e5df9dc1SAsim Jamshed<p>MOS_CLIOVERLAP</p></td> 117*e5df9dc1SAsim Jamshed<td width="17%"></td> 118*e5df9dc1SAsim Jamshed<td width="51%"> 119*e5df9dc1SAsim Jamshed 120*e5df9dc1SAsim Jamshed 121*e5df9dc1SAsim Jamshed<p>Dynamically determine the policy on content overlap 122*e5df9dc1SAsim Jamshed(e.g., overwriting with the retransmitted payload or not) 123*e5df9dc1SAsim Jamshedfor the client-side buffer. The <i>optval</i> can be either 124*e5df9dc1SAsim JamshedMOS_OVERLAP_POLICY_FIRST (to take the first data and never 125*e5df9dc1SAsim Jamshedoverwrite the buffer) or MOS_OVERLAP_POLICY_LAST (to always 126*e5df9dc1SAsim Jamshedupdate the buffer with the last data), and <i>optlen</i> is 127*e5df9dc1SAsim Jamshedequal to sizeof(int).</p></td></tr> 128*e5df9dc1SAsim Jamshed<tr valign="top" align="left"> 129*e5df9dc1SAsim Jamshed<td width="11%"></td> 130*e5df9dc1SAsim Jamshed<td width="21%"> 131*e5df9dc1SAsim Jamshed 132*e5df9dc1SAsim Jamshed 133*e5df9dc1SAsim Jamshed<p>MOS_SVROVERLAP</p></td> 134*e5df9dc1SAsim Jamshed<td width="17%"></td> 135*e5df9dc1SAsim Jamshed<td width="51%"> 136*e5df9dc1SAsim Jamshed 137*e5df9dc1SAsim Jamshed 138*e5df9dc1SAsim Jamshed<p>Dynamically determine the policy on content overlap 139*e5df9dc1SAsim Jamshed(e.g., overwriting with the retransmitted payload or not) 140*e5df9dc1SAsim Jamshedfor the server-side buffer. The <i>optval</i> can be either 141*e5df9dc1SAsim JamshedMOS_OVERLAP_POLICY_FIRST (to take the first data and never 142*e5df9dc1SAsim Jamshedoverwrite the buffer) or MOS_OVERLAP_POLICY_LAST (to always 143*e5df9dc1SAsim Jamshedupdate the buffer with the last data), and <i>optlen</i> is 144*e5df9dc1SAsim Jamshedequal to sizeof(int).</p></td></tr> 145*e5df9dc1SAsim Jamshed<tr valign="top" align="left"> 146*e5df9dc1SAsim Jamshed<td width="11%"></td> 147*e5df9dc1SAsim Jamshed<td width="21%"> 148*e5df9dc1SAsim Jamshed 149*e5df9dc1SAsim Jamshed 150*e5df9dc1SAsim Jamshed<p>MOS_STOP_MON</p></td> 151*e5df9dc1SAsim Jamshed<td width="17%"></td> 152*e5df9dc1SAsim Jamshed<td width="51%"> 153*e5df9dc1SAsim Jamshed 154*e5df9dc1SAsim Jamshed 155*e5df9dc1SAsim Jamshed<p>Dynamically stop monitoring a flow for the specific 156*e5df9dc1SAsim Jamshedside. This option can be used only with a 157*e5df9dc1SAsim JamshedMOS_SOCK_MONITOR_ACTIVE socket, which is given as a 158*e5df9dc1SAsim Jamshedparameter in callback functions for every flow. The 159*e5df9dc1SAsim Jamshed<i>optval</i> contains a side variable (MOS_SIDE_CLI, 160*e5df9dc1SAsim JamshedMOS_SIDE_SVR, or MOS_SIDE_BOTH), while <i>optlen</i> is 161*e5df9dc1SAsim Jamshedequal to sizeof(int).</p></td></tr> 16291df013fSAsim Jamshed</table> 16391df013fSAsim Jamshed 16491df013fSAsim Jamshed<h2>RETURN VALUE 16591df013fSAsim Jamshed<a name="RETURN VALUE"></a> 16691df013fSAsim Jamshed</h2> 16791df013fSAsim Jamshed 16891df013fSAsim Jamshed 16991df013fSAsim Jamshed<p style="margin-left:11%; margin-top: 1em">Returns 0 on 17091df013fSAsim Jamshedsuccess; -1 on failure. In case of failure, <i>errno</i> is 17191df013fSAsim Jamshedset appropriately.</p> 17291df013fSAsim Jamshed 17391df013fSAsim Jamshed<h2>ERRORS 17491df013fSAsim Jamshed<a name="ERRORS"></a> 17591df013fSAsim Jamshed</h2> 17691df013fSAsim Jamshed 17791df013fSAsim Jamshed 17891df013fSAsim Jamshed<table width="100%" border="0" rules="none" frame="void" 17991df013fSAsim Jamshed cellspacing="0" cellpadding="0"> 18091df013fSAsim Jamshed<tr valign="top" align="left"> 18191df013fSAsim Jamshed<td width="11%"></td> 18291df013fSAsim Jamshed<td width="12%"> 18391df013fSAsim Jamshed 18491df013fSAsim Jamshed 18591df013fSAsim Jamshed<p style="margin-top: 1em"><b>EACCES</b></p></td> 18691df013fSAsim Jamshed<td width="3%"></td> 18791df013fSAsim Jamshed<td width="74%"> 18891df013fSAsim Jamshed 18991df013fSAsim Jamshed 19091df013fSAsim Jamshed<p style="margin-top: 1em"><i>mctx</i> is not valid.</p></td></tr> 19191df013fSAsim Jamshed<tr valign="top" align="left"> 19291df013fSAsim Jamshed<td width="11%"></td> 19391df013fSAsim Jamshed<td width="12%"> 19491df013fSAsim Jamshed 19591df013fSAsim Jamshed 19691df013fSAsim Jamshed<p><b>EBADF</b></p></td> 19791df013fSAsim Jamshed<td width="3%"></td> 19891df013fSAsim Jamshed<td width="74%"> 19991df013fSAsim Jamshed 20091df013fSAsim Jamshed 20191df013fSAsim Jamshed<p><i>sockid</i> is not a valid socket descriptor.</p></td></tr> 20291df013fSAsim Jamshed<tr valign="top" align="left"> 20391df013fSAsim Jamshed<td width="11%"></td> 20491df013fSAsim Jamshed<td width="12%"> 20591df013fSAsim Jamshed 20691df013fSAsim Jamshed 20791df013fSAsim Jamshed<p><b>ENOTSOCK</b></p></td> 20891df013fSAsim Jamshed<td width="3%"></td> 20991df013fSAsim Jamshed<td width="74%"> 21091df013fSAsim Jamshed 21191df013fSAsim Jamshed 21291df013fSAsim Jamshed<p>The socket referred to by <i>sockid</i> is not 21391df013fSAsim Jamshedvalid.</p> </td></tr> 21491df013fSAsim Jamshed<tr valign="top" align="left"> 21591df013fSAsim Jamshed<td width="11%"></td> 21691df013fSAsim Jamshed<td width="12%"> 21791df013fSAsim Jamshed 21891df013fSAsim Jamshed 21991df013fSAsim Jamshed<p><b>ENOSYS</b></p></td> 22091df013fSAsim Jamshed<td width="3%"></td> 22191df013fSAsim Jamshed<td width="74%"> 22291df013fSAsim Jamshed 22391df013fSAsim Jamshed 22491df013fSAsim Jamshed<p>Either the <i>level</i> or the <i>optname</i> is not 22591df013fSAsim Jamshedimplemented.</p> </td></tr> 22691df013fSAsim Jamshed<tr valign="top" align="left"> 22791df013fSAsim Jamshed<td width="11%"></td> 22891df013fSAsim Jamshed<td width="12%"> 22991df013fSAsim Jamshed 23091df013fSAsim Jamshed 23191df013fSAsim Jamshed<p><b>EPERM</b></p></td> 23291df013fSAsim Jamshed<td width="3%"></td> 23391df013fSAsim Jamshed<td width="74%"> 23491df013fSAsim Jamshed 23591df013fSAsim Jamshed 23691df013fSAsim Jamshed<p>Permission to access a socket option is denied.</p></td></tr> 23791df013fSAsim Jamshed</table> 23891df013fSAsim Jamshed 23991df013fSAsim Jamshed<h2>AUTHORS 24091df013fSAsim Jamshed<a name="AUTHORS"></a> 24191df013fSAsim Jamshed</h2> 24291df013fSAsim Jamshed 24391df013fSAsim Jamshed 24491df013fSAsim Jamshed<p style="margin-left:22%; margin-top: 1em">mOS development 24591df013fSAsim Jamshedteam <[email protected]></p> 24691df013fSAsim Jamshed 24791df013fSAsim Jamshed<h2>SEE ALSO 24891df013fSAsim Jamshed<a name="SEE ALSO"></a> 24991df013fSAsim Jamshed</h2> 25091df013fSAsim Jamshed 25191df013fSAsim Jamshed 25291df013fSAsim Jamshed 25391df013fSAsim Jamshed<p style="margin-left:11%; margin-top: 1em"><b>mtcp_socket</b>(), 25491df013fSAsim Jamshed<b>mtcp_getsockopt</b>()</p> 25591df013fSAsim Jamshed 25691df013fSAsim Jamshed<h2>COLOPHON 25791df013fSAsim Jamshed<a name="COLOPHON"></a> 25891df013fSAsim Jamshed</h2> 25991df013fSAsim Jamshed 26091df013fSAsim Jamshed 26191df013fSAsim Jamshed<p style="margin-left:11%; margin-top: 1em">This page is 26291df013fSAsim Jamshedpart of mOS release 0.3 <i>docs</i> section. A description 26391df013fSAsim Jamshedof the project, and information about reporting bugs, can be 26491df013fSAsim Jamshedfound at http://mos.kaist.edu/.</p> 265*e5df9dc1SAsim Jamshed<!-- <hr>--> 266*e5df9dc1SAsim Jamshed<br> 267*e5df9dc1SAsim Jamshed<div class="footer"> 268*e5df9dc1SAsim Jamshed <img src="back-arrow.jpg" width="2%" height="2%"><a href="http://mos.kaist.edu/index_man.html">Back to Index</a> 269*e5df9dc1SAsim Jamshed</div> 270*e5df9dc1SAsim Jamshed</div> 27191df013fSAsim Jamshed</body> 27291df013fSAsim Jamshed</html> 273
