Cross-platform asynchronous I/O
Go to file
Bert Belder e43e5b3d95 2013.05.30, Version 0.11.4 (Unstable)
Changes since version 0.11.3:

* windows: make uv_spawn not fail when the libuv embedding application
  is run under external job control (Bert Belder)

* darwin: assume CFRunLoopStop() isn't thread-safe, fixing a race
  condition when stopping the 'stdin select hack' thread (Fedor Indutny)

* win: fix UV_EALREADY not being reported correctly to the libuv user in
  some cases (Bert Belder)

* darwin: make the uv__cf_loop_runner and uv__cf_loop_cb functions
  static (Ben Noordhuis)

* darwin: task_info() cannot fail (Ben Noordhuis)

* unix: add error mapping for ENETDOWN (Ben Noordhuis)

* unix: implicitly signal write errors to the libuv user (Ben Noordhuis)

* unix: fix assertion error on signal pipe overflow (Bert Belder)

* unix: turn off POLLOUT after stream connect (Ben Noordhuis)

* unix: fix stream refcounting buglet (Ben Noordhuis)

* unix: remove assert statements that are no longer correct (Ben
  Noordhuis)

* unix: appease warning about non-standard `inline` (Sean Silva)

* unix: add uv__is_closing() macro (Ben Noordhuis)

* unix: stop stream POLLOUT watcher on write error (Ben Noordhuis)

* include: document uv_update_time() and uv_now() (Ben Noordhuis)

* linux: fix cpu model parsing on newer arm kernels (Ben Noordhuis)

* linux: fix a memory leak in uv_cpu_info() error path (Ben Noordhuis)

* linux: don't ignore out-of-memory errors in uv_cpu_info() (Ben
  Noordhuis)

* unix, windows: move uv_now() to uv-common.c (Ben Noordhuis)

* test: fix a compilation problem in test-osx-select.c that was caused
  by the use of c-style comments (Bert Belder)

* darwin: use uv_fs_sendfile() use the sendfile api correctly (Wynn
  Wilkes)

* windows: call idle handles on every loop iteration, something the unix
  implementation already did (Bert Belder)

* test: update the idle-starvation test to verify that idle handles are
  called in every loop iteration (Bert Belder)

* unix, windows: ensure that uv_run() in RUN_ONCE mode calls timers that
  expire after blocking (Ben Noordhuis)
2013-05-30 01:00:55 +02:00
include Merge remote-tracking branch 'origin/v0.10' 2013-05-29 23:32:07 +02:00
src 2013.05.30, Version 0.11.4 (Unstable) 2013-05-30 01:00:55 +02:00
test unix, windows: run expired timers in run-once mode 2013-05-30 00:33:23 +02:00
.gitignore gitigore: ignore auto-generated uv-dtrace.h header 2013-04-10 14:23:55 +02:00
.mailmap 2013.04.12, Version 0.10.4 (Stable) 2013-04-11 09:00:06 -07:00
AUTHORS 2013.05.30, Version 0.11.4 (Unstable) 2013-05-30 01:00:55 +02:00
build.mk Merge remote-tracking branch 'origin/v0.10' 2013-05-12 16:53:38 +02:00
ChangeLog 2013.05.30, Version 0.11.4 (Unstable) 2013-05-30 01:00:55 +02:00
checksparse.sh linux: move files out of src/unix/linux 2013-01-29 17:07:41 +01:00
common.gypi sunos: re-export entire library when static 2013-04-10 14:10:05 +02:00
config-mingw.mk Prepare for making releases, add uv_version/uv_version_string API 2013-03-25 15:35:00 +01:00
config-unix.mk Merge branch 'v0.10' 2013-05-14 17:03:24 -07:00
gyp_uv build: fix host/target arch detection 2013-01-13 00:51:53 +01:00
LICENSE unix, windows: remove ngx-queue.h 2013-03-27 00:09:36 +01:00
Makefile build: add distclean target to out-of-tree builds 2013-02-27 22:09:11 +01:00
README.md doc: add link to Visual Studio Express in README 2013-04-08 00:05:02 +02:00
uv.gyp Merge remote-tracking branch 'origin/v0.10' 2013-05-12 14:53:19 +02:00
vcbuild.bat build: add support for Visual Studio 2012 2013-04-10 16:13:32 +02:00

libuv

libuv is a new platform layer for Node. Its purpose is to abstract IOCP on Windows and epoll/kqueue/event ports/etc. on Unix systems. We intend to eventually contain all platform differences in this library.

http://nodejs.org/

Features

  • Non-blocking TCP sockets

  • Non-blocking named pipes

  • UDP

  • Timers

  • Child process spawning

  • Asynchronous DNS via uv_getaddrinfo.

  • Asynchronous file system APIs uv_fs_*

  • High resolution time uv_hrtime

  • Current executable path look up uv_exepath

  • Thread pool scheduling uv_queue_work

  • ANSI escape code controlled TTY uv_tty_t

  • File system events Currently supports inotify, ReadDirectoryChangesW and kqueue. Event ports in the near future. uv_fs_event_t

  • IPC and socket sharing between processes uv_write2

Community

Documentation

Build Instructions

For GCC (including MinGW) there are two methods building: via normal makefiles or via GYP. GYP is a meta-build system which can generate MSVS, Makefile, and XCode backends. It is best used for integration into other projects. The old system is using plain GNU Makefiles.

To build via Makefile simply execute:

make

MinGW users should run this instead:

make PLATFORM=mingw

Out-of-tree builds are supported:

make builddir_name=/path/to/builddir

To build with Visual Studio run the vcbuild.bat file which will checkout the GYP code into build/gyp and generate the uv.sln and related files.

Windows users can also build from cmd-line using msbuild. This is done by running vcbuild.bat from Visual Studio command prompt.

To have GYP generate build script for another system, make sure that you have Python 2.6 or 2.7 installed, then checkout GYP into the project tree manually:

mkdir -p build
svn co http://gyp.googlecode.com/svn/trunk build/gyp

Or:

mkdir -p build
git clone https://git.chromium.org/external/gyp.git build/gyp

Unix users run

./gyp_uv -f make
make -C out

Macintosh users run

./gyp_uv -f xcode
xcodebuild -project uv.xcodeproj -configuration Release -target All

Note for UNIX users: compile your project with -D_LARGEFILE_SOURCE and -D_FILE_OFFSET_BITS=64. GYP builds take care of that automatically.

Note for Linux users: compile your project with -D_GNU_SOURCE when you include uv.h. GYP builds take care of that automatically. If you use autotools, add a AC_GNU_SOURCE declaration to your configure.ac.

Supported Platforms

Microsoft Windows operating systems since Windows XP SP2. It can be built with either Visual Studio or MinGW. Consider using Visual Studio Express 2010 or later if you do not have a full Visual Studio license.

Linux 2.6 using the GCC toolchain.

MacOS using the GCC or XCode toolchain.

Solaris 121 and later using GCC toolchain.