Cross-platform asynchronous I/O
Go to file
Ben Noordhuis 3348cd7407 unix: handle EINPROGRESS for unix sockets
Before this commit, it was assumed that connect() on UNIX sockets never
returns EINPROGRESS. It turned out to be a bad assumption: Dave Pacheco
reports sporadic hangups on SmartOS because of that.

It's not clear to me _why_ the Illumos kernel returns that error but
that's inconsequential: whatever the cause, libuv needs to handle it
and now it does.

Fixes joyent/node#4785.
2013-02-21 23:21:29 +01:00
include unix, windows: make uv_timer_get_repeat() const correct 2013-02-20 17:01:00 +01:00
src unix: handle EINPROGRESS for unix sockets 2013-02-21 23:21:29 +01:00
test unix, windows: make uv_now() return uint64_t 2013-02-20 16:58:45 +01:00
.gitignore build: support out of tree builds 2013-01-29 17:07:25 +01:00
.mailmap Update AUTHORS and .mailmap 2011-12-14 14:32:13 +01:00
AUTHORS Update AUTHORS 2012-06-25 03:58:17 +02:00
build.mk build: support out of tree builds 2013-01-29 17:07:25 +01:00
checksparse.sh linux: move files out of src/unix/linux 2013-01-29 17:07:41 +01:00
common.gypi build: compile with -fwrapv in debug mode 2012-10-15 00:52:27 +02:00
config-mingw.mk build: fix up WIN_SRCS 2013-02-02 01:16:37 +01:00
config-unix.mk build: fix shared-after-static build 2013-02-20 19:53:17 +01:00
gyp_uv build: fix host/target arch detection 2013-01-13 00:51:53 +01:00
LICENSE unix: remove libev 2012-11-16 17:33:29 +01:00
Makefile build: support out of tree builds 2013-01-29 17:07:25 +01:00
README.md doc: document _LARGEFILE_SOURCE + _FILE_OFFSET_BITS 2013-02-20 17:11:54 +01:00
uv.gyp linux: move files out of src/unix/linux 2013-01-29 17:07:41 +01:00
vcbuild.bat win: Avoid using subversion to download gyp 2013-02-06 23:03:09 +01: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 OS=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.

Linux 2.6 using the GCC toolchain.

MacOS using the GCC or XCode toolchain.

Solaris 121 and later using GCC toolchain.