Skip to content
This repository

Cross-platform asychronous I/O

branch: master

common: pass const sockaddr ptr to uv_ip*_name

uv_ip4_name and uv_ip6_name do not modify passed sockaddr pointer,
so there is no need to keep this parameter non-const.
latest commit 20d092edc8
Astellar authored April 17, 2014 saghul committed April 18, 2014
Octocat-spinner-32 include common: pass const sockaddr ptr to uv_ip*_name April 18, 2014
Octocat-spinner-32 m4 build: fix building with old versions of autoconf April 10, 2014
Octocat-spinner-32 samples gyp: qualify `library` variable February 05, 2014
Octocat-spinner-32 src common: pass const sockaddr ptr to uv_ip*_name April 18, 2014
Octocat-spinner-32 test test: fix compilation warnings with VC++ April 17, 2014
Octocat-spinner-32 .gitignore gitignore: root test ignores at /test February 03, 2014
Octocat-spinner-32 .mailmap Merge branch 'v0.10' April 07, 2014
Octocat-spinner-32 AUTHORS authors: fix name April 17, 2014
Octocat-spinner-32 doc: add guidelines for contributing December 01, 2013
Octocat-spinner-32 ChangeLog Now working on v0.11.25 April 14, 2014
Octocat-spinner-32 LICENSE android: add support of ifaddrs in android March 16, 2014
Octocat-spinner-32 unix, windows: do not set SO_REUSEADDR by default on udp April 02, 2014
Octocat-spinner-32 Makefile.mingw build: allow CC to be overridden on Makefile.mingw March 07, 2014
Octocat-spinner-32 doc: small fixes to comments and syntax February 23, 2014
Octocat-spinner-32 android-configure build: update android toolchain February 21, 2014
Octocat-spinner-32 build: fix automake serial-tests check again August 17, 2013
Octocat-spinner-32 pipe: allow queueing pending handles March 04, 2014
Octocat-spinner-32 common.gypi gyp: qualify `library` variable February 05, 2014
Octocat-spinner-32 Now working on v0.11.25 April 14, 2014
Octocat-spinner-32 gyp: qualify `library` variable February 05, 2014
Octocat-spinner-32 build: add required libraries to March 02, 2014
Octocat-spinner-32 uv.gyp inet: allow scopeid in uv_inet_pton April 14, 2014
Octocat-spinner-32 vcbuild.bat build, windows: do not fail on Windows SDK Prompt February 26, 2014


libuv is a multi-platform support library with a focus on asynchronous I/O. It was primarily developed for use by Node.js, but it's also used by Mozilla's Rust language, Luvit, Julia, pyuv, and others.

Feature highlights

  • Full-featured event loop backed by epoll, kqueue, IOCP, event ports.

  • Asynchronous TCP and UDP sockets

  • Asynchronous DNS resolution

  • Asynchronous file and file system operations

  • File system events

  • ANSI escape code controlled TTY

  • IPC with socket sharing, using Unix domain sockets or named pipes (Windows)

  • Child processes

  • Thread pool

  • Signal handling

  • High resolution clock

  • Threading and synchronization primitives



Build Instructions

For GCC there are two methods building: via autotools 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.

To build with autotools:

$ sh
$ ./configure
$ make
$ make check
$ make install


First, Python 2.6 or 2.7 must be installed as it is required by GYP.

Also, the directory for the preferred Python executable must be specified by the PYTHON or Path environment variables.

To build with Visual Studio, launch a git shell (e.g. Cmd or PowerShell) and run vcbuild.bat which will checkout the GYP code into build/gyp and generate uv.sln as well as related project files.

To have GYP generate build script for another system, checkout GYP into the project tree manually:

$ mkdir -p build
$ git clone build/gyp



$ ./ -f make
$ make -C out



$ ./ -f xcode
$ xcodebuild -ARCHS="x86_64" -project uv.xcodeproj \
     -configuration Release -target All

Note to OS X users:

Make sure that you specify the architecture you wish to build for in the "ARCHS" flag. You can specify more than one by delimiting with a space (e.g. "x86_64 i386").



$ source ./android-configure NDK_PATH gyp
$ make -C out

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

Running tests


$ ./ -f make
$ make -C out
$ ./out/Debug/run-tests

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 using the GCC toolchain.

OS X using the GCC or XCode toolchain.

Solaris 121 and later using GCC toolchain.


See the guidelines for contributing.

Something went wrong with that request. Please try again.