setTCPNoDelay             package:gtools             R Documentation

_M_o_d_i_f_y _t_h_e _T_C_P__N_O_D_E_L_A_Y ('_d_e-_N_a_g_l_e') _f_l_a_g _f_o_r _s_o_c_k_e_t _o_b_j_e_c_t_s

_D_e_s_c_r_i_p_t_i_o_n:

     Modify the TCP_NODELAY (`de-Nagele') flag for socket objects

_U_s_a_g_e:

     setTCPNoDelay(socket, value=TRUE)

_A_r_g_u_m_e_n_t_s:

  socket: A socket connection object

   value: Logical indicating whether to set ('TRUE') or unset ('FALSE')
          the flag

_D_e_t_a_i_l_s:

     By default, TCP connections wait a small fixed interval before
     actually sending data, in order to permit small packets to be
     combined.  This algorithm is named after its inventor, John Nagle,
     and is often referred to as 'Nagling'.

     While this reduces network resource utilization in these
     situations, it imposes a delay on all outgoing message data, which
     can cause problems in client/server situations.

     This function allows this feature to be disabled (de-Nagling,
     'value=TRUE') or enabled (Nagling, 'value=FALSE') for the
     specified socket.

_V_a_l_u_e:

     The character string "SUCCESS" will be returned invisible if the
     operation was succesful.  On failure, an error will be generated.

_A_u_t_h_o_r(_s):

     Gregory R. Warnes gregory.r.warnes@pfizer.com

_R_e_f_e_r_e_n_c_e_s:

     "Nagle's algorithm" at WhatIS.com <URL: 
     http://searchnetworking.techtarget.com/sDefinition/0,,sid7_gci7543
     47,00.html>

     Nagle, John. "Congestion Control in IP/TCP Internetworks", IETF
     Request for Comments 896, January 1984. <URL:
     http://www.ietf.org/rfc/rfc0896.txt?number=896>

_S_e_e _A_l_s_o:

     'make.socket', 'socketConnection'

_E_x_a_m_p_l_e_s:

     ## Not run: 
        s <- make.socket(host='www.r-project.org', port=80)
        setTCPNoDelay(s, value=TRUE)
     ## End(Not run)

