luo980/libuv
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Cross-platform asynchronous I/O
1,431 Commits 13 Branches 240 Tags 29 MiB
C 97%
M4 1.2%
CMake 0.9%
Makefile 0.7%
9efa8b3571
Go to file
Ben Noordhuis 9efa8b3571 unix, windows: rework reference counting scheme 
This commit changes how the event loop determines if it needs to stay alive.

Previously, an internal counter was increased whenever a handle got created
and decreased again when the handle was closed.

While conceptually simple, it turned out hard to work with: you often want
to keep the event loop alive only if the handle is actually doing something.
Stopped or inactive handles were a frequent source of hanging event loops.

That's why this commit changes the reference counting scheme to a model where
a handle only references the event loop when it's active. 'Active' means
different things for different handle types, e.g.:

 * timers: ticking
 * sockets: reading, writing or listening
 * processes: always active (for now, subject to change)
 * idle, check, prepare: only active when started

This commit also changes how the uv_ref() and uv_unref() functions work: they
now operate on the level of individual handles, not the whole event loop.

The Windows implementation was done by Bert Belder.
2012-05-17 07:07:53 +02:00
build build: fix gcc 3.x build 2011-10-25 23:52:03 +00:00
include unix, windows: rework reference counting scheme 2012-05-17 07:07:53 +02:00
src unix, windows: rework reference counting scheme 2012-05-17 07:07:53 +02:00
test unix, windows: rework reference counting scheme 2012-05-17 07:07:53 +02:00
.gitignore .gitignore gyp build artifacts 2012-02-23 01:11:17 +01:00
.mailmap Update AUTHORS and .mailmap 2011-12-14 14:32:13 +01:00
.travis.yml test: add .travis.yml for testing on Travis CI 2011-12-12 02:10:43 +01:00
AUTHORS Update AUTHORS 2012-01-31 19:43:13 -08:00
common.gypi Windows: always enable multicore compile 2012-04-29 02:18:17 +02:00
config-mingw.mk build: add missing libs required to compile under MinGW 2012-03-05 16:09:26 +01:00
config-unix.mk unix, windows: rework reference counting scheme 2012-05-17 07:07:53 +02:00
gyp_uv build: print error message when gyp is not installed 2012-04-18 13:19:51 -07:00
LICENSE docs: add c-ares license note 2011-12-22 17:19:22 +01:00
Makefile Dont build tests on 'make all' 2011-10-06 14:53:52 -07:00
README.md doc: add Travis CI build status image 2011-12-12 02:10:43 +01:00
uv.gyp unix, windows: rework reference counting scheme 2012-05-17 07:07:53 +02:00
vcbuild.bat Windows: try to set up vc environment when not running from vs command prompt 2012-01-31 14:28:21 +01:00

README.md

libuv Build Status

libuv is a new platform layer for Node. Its purpose is to abstract IOCP on Windows and libev 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 c-ares or 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

Documentation

See include/uv.h.

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 (more stable) system is using Makefiles.

To build via Makefile simply execute:

make

To build with Visual Studio run the vcbuilds.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 you will need to checkout GYP into the project tree manually:

svn co http://gyp.googlecode.com/svn/trunk build/gyp

Unix users run

./gyp_uv -f make
make

Macintosh users run

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

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.