libssh2_channel_receive_window_adjust man page

libssh2_channel_receive_window_adjust — adjust the channel window


#include <libssh2.h>

unsigned long libssh2_channel_receive_window_adjust(LIBSSH2_CHANNEL * channel,
unsigned long adjustment,
unsigned char force);


This function is deprecated in 1.1. Use libssh2_channel_receive_window_adjust2(3)!

Adjust the receive window for a channel by adjustment bytes. If the amount to be adjusted is less than LIBSSH2_CHANNEL_MINADJUST and force is 0 the adjustment amount will be queued for a later packet.

Return Value

Returns the new size of the receive window (as understood by remote end). Note that the window value sent over the wire is strictly 32bit, but this API is made to return a 'long' which may not be 32 bit on all platforms.


In 1.0 and earlier, this function returns LIBSSH2_ERROR_EAGAIN for non-blocking channels where it would otherwise block. However, that is a negative number and this function only returns an unsigned value and this then leads to a very strange value being returned.

See Also


Referenced By

libssh2_channel_window_read_ex(3), libssh2_channel_window_write_ex(3).

15 Mar 2009 libssh2 0.15 libssh2 manual