Karl Skomski <karl@skomski.com>

Jeremy Whitlock <jwhitlock@apache.org>

Willem Thiart <himself@willemthiart.com>

Ben Trask <bentrask@comcast.net>

Jianghua Yang <jianghua.yjh@alibaba-inc.com>

Colin Snover <github.com@zetafleet.com>

Sakthipriyan Vairamani <thechargingvolcano@gmail.com>

Eli Skeggs <skeggse@gmail.com>

additional guidelines, are enumerated below.

* Code that is specific to unix-y platforms should be placed in `src/unix`, and

declarations go into `src/uv-unix.h`.

declarations go into `include/uv-unix.h`.

* Source code that is Windows-specific goes into `src/win`, and related

publicly exported types, functions and macro declarations should generally

2015.09.12, Version 1.7.4 (Stable), a7ad4f52189d89cfcba35f78bfc5ff3b1f4105c4

Changes since version 1.7.3:

* doc: uv_read_start and uv_read_cb clarifications (Ben Trask)

* freebsd: obtain true uptime through clock_gettime() (Jianghua Yang)

* win, tty: do not convert \r to \r\n (Colin Snover)

* build,gyp: add DragonFly to the list of OSes (Michael Neumann)

* fs: fix bug in sendfile for DragonFly (Michael Neumann)

* doc: add uv_dlsym() return type (Brian White)

* tests: fix fs tests run w/o full getdents support (Jeremy Whitlock)

* doc: fix typo (Devchandra Meetei Leishangthem)

* doc: fix uv-unix.h location (Sakthipriyan Vairamani)

* unix: fix error check when closing process pipe fd (Ben Noordhuis)

* test,freebsd: fix ipc_listen_xx_write tests (Santiago Gimeno)

* win: fix unsavory rwlock fallback implementation (Bert Belder)

* doc: clarify repeat timer behavior (Eli Skeggs)

2015.08.28, Version 1.7.3 (Stable), 93877b11c8b86e0a6befcda83a54555c1e36e4f0

Changes since version 1.7.2:

version: v1.7.3.build{build}

version: v1.7.4.build{build}

install:

- cinst -y nsis

}]

]

}],

['OS in "freebsd linux openbsd solaris android"', {

['OS in "freebsd dragonflybsd linux openbsd solaris android"', {

'cflags': [ '-Wall' ],

'cflags_cc': [ '-fno-rtti', '-fno-exceptions' ],

'target_conditions': [

# OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

AC_PREREQ(2.57)

AC_INIT([libuv], [1.7.3], [https://github.com/libuv/libuv/issues])

AC_INIT([libuv], [1.7.4], [https://github.com/libuv/libuv/issues])

AC_CONFIG_MACRO_DIR([m4])

m4_include([m4/libuv-extra-automake-flags.m4])

m4_include([m4/as_case.m4])

Close the shared library.

.. c:function:: uv_dlsym(uv_lib_t* lib, const char* name, void** ptr)

.. c:function:: int uv_dlsym(uv_lib_t* lib, const char* name, void** ptr)

Retrieves a data pointer from a dynamic library. It is legal for a symbol

to map to NULL. Returns 0 on success and -1 if the symbol was not found.

Public members

^^^^^^^^^^^^^^

.. c:member:: void* uv_request_t.data

.. c:member:: void* uv_req_t.data

Space for user-defined arbitrary data. libuv does not use this field.

Callback called when data was read on a stream.

`nread` is > 0 if there is data available, 0 if libuv is done reading for

now, or < 0 on error.

`nread` is > 0 if there is data available or < 0 on error. When we've

reached EOF, `nread` will be set to ``UV_EOF``. When `nread` < 0,

the `buf` parameter might not point to a valid buffer; in that case

`buf.len` and `buf.base` are both set to 0.

.. note::

`nread` might be 0, which does *not* indicate an error or EOF. This

is equivalent to ``EAGAIN`` or ``EWOULDBLOCK`` under ``read(2)``.

The callee is responsible for stopping closing the stream when an error happens

by calling :c:func:`uv_read_stop` or :c:func:`uv_close`. Trying to read

.. c:function:: int uv_read_start(uv_stream_t* stream, uv_alloc_cb alloc_cb, uv_read_cb read_cb)

Read data from an incoming stream. The callback will be made several

times until there is no more data to read or :c:func:`uv_read_stop` is called.

When we've reached EOF `nread` will be set to ``UV_EOF``.

When `nread` < 0, the `buf` parameter might not point to a valid buffer;

in that case `buf.len` and `buf.base` are both set to 0.

.. note::

`nread` might also be 0, which does *not* indicate an error or EOF, it happens when

libuv requested a buffer through the alloc callback but then decided that it didn't

need that buffer.

Read data from an incoming stream. The :c:type:`uv_read_cb` callback will

be made several times until there is no more data to read or

:c:func:`uv_read_stop` is called.

.. c:function:: int uv_read_stop(uv_stream_t*)

.. c:function:: void uv_timer_set_repeat(uv_timer_t* handle, uint64_t repeat)

Set the repeat value in milliseconds.

Set the repeat interval value in milliseconds. The timer will be scheduled

to run on the given interval, regardless of the callback execution

duration, and will follow normal timer semantics in the case of a

time-slice overrun.

For example, if a 50ms repeating timer first runs for 17ms, it will be

scheduled to run again 33ms later. If other tasks consume more than the

33ms following the first timer callback, then the callback will run as soon

as possible.

.. note::

If the repeat value is set from a timer callback it does not immediately take effect.