2011-09-23 20:07:57 +02:00
|
|
|
# libuv
|
|
|
|
|
|
|
|
|
|
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.
|
2011-05-13 04:16:40 +02:00
|
|
|
|
|
|
|
|
http://nodejs.org/
|
|
|
|
|
|
2011-09-23 20:07:57 +02:00
|
|
|
## Features
|
|
|
|
|
|
2011-09-24 05:23:41 +02:00
|
|
|
Implemented:
|
2011-09-23 20:07:57 +02:00
|
|
|
|
2011-09-24 05:23:41 +02:00
|
|
|
* Non-blocking TCP sockets
|
2011-09-23 20:07:57 +02:00
|
|
|
|
2011-09-24 05:23:41 +02:00
|
|
|
* Non-blocking named pipes
|
2011-09-23 20:07:57 +02:00
|
|
|
|
|
|
|
|
* UDP
|
|
|
|
|
|
2011-09-24 05:23:41 +02:00
|
|
|
* Timers
|
|
|
|
|
|
2011-09-23 20:07:57 +02:00
|
|
|
* Child process spawning
|
|
|
|
|
|
2011-09-24 05:23:41 +02:00
|
|
|
* Asynchronous DNS via c-ares or `uv_getaddrinfo`.
|
2011-09-23 20:07:57 +02:00
|
|
|
|
2011-09-24 05:23:41 +02:00
|
|
|
* Asynchronous file system APIs `uv_fs_*`
|
2011-09-23 20:07:57 +02:00
|
|
|
|
2011-09-24 05:23:41 +02:00
|
|
|
* High resolution time `uv_hrtime`
|
2011-09-23 20:07:57 +02:00
|
|
|
|
2011-09-24 05:23:41 +02:00
|
|
|
* Current executable path look up `uv_exepath`
|
2011-09-23 20:07:57 +02:00
|
|
|
|
2011-09-24 05:23:41 +02:00
|
|
|
* Thread pool scheduling `uv_queue_work`
|
2011-09-23 20:07:57 +02:00
|
|
|
|
2011-09-30 20:22:38 +02:00
|
|
|
* ANSI escape code controlled TTY `uv_tty_t`
|
|
|
|
|
|
2011-09-24 05:23:41 +02:00
|
|
|
In-progress:
|
2011-09-23 20:07:57 +02:00
|
|
|
|
2011-09-24 05:23:41 +02:00
|
|
|
* File system events (Currently supports inotify, `ReadDirectoryChangesW`
|
|
|
|
|
and will support kqueue and event ports in the near future.)
|
|
|
|
|
`uv_fs_event_t`
|
2011-09-23 20:07:57 +02:00
|
|
|
|
2011-09-24 05:23:41 +02:00
|
|
|
* Socket sharing between processes `uv_ipc_t`
|
2011-09-23 20:07:57 +02:00
|
|
|
|
|
|
|
|
|
|
|
|
|
## Documentation
|
|
|
|
|
|
|
|
|
|
See `include/uv.h`.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Build Instructions
|
2011-05-13 04:16:40 +02:00
|
|
|
|
2011-08-08 23:14:47 +02:00
|
|
|
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.
|
2011-08-06 12:38:11 +02:00
|
|
|
|
2011-08-08 23:14:47 +02:00
|
|
|
To build via Makefile simply execute:
|
2011-08-06 12:38:11 +02:00
|
|
|
|
|
|
|
|
make
|
|
|
|
|
|
2011-08-30 00:23:13 +02:00
|
|
|
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
|
2011-08-08 23:14:47 +02:00
|
|
|
related files.
|
2011-08-06 12:38:11 +02:00
|
|
|
|
2011-09-24 05:23:41 +02:00
|
|
|
Windows users can also build from cmd-line using msbuild. This is
|
2011-08-30 00:23:13 +02:00
|
|
|
done by running vcbuild.bat from Visual Studio command prompt.
|
|
|
|
|
|
2011-08-08 23:14:47 +02:00
|
|
|
To have GYP generate build script for another system you will need to
|
|
|
|
|
checkout GYP into the project tree manually:
|
2011-08-06 12:38:11 +02:00
|
|
|
|
2011-08-08 23:14:47 +02:00
|
|
|
svn co http://gyp.googlecode.com/svn/trunk build/gyp
|
|
|
|
|
|
2011-08-23 02:34:43 +02:00
|
|
|
Unix users run
|
2011-08-08 23:14:47 +02:00
|
|
|
|
2011-08-23 02:34:43 +02:00
|
|
|
./gyp_uv -f make
|
|
|
|
|
make
|
2011-08-08 23:14:47 +02:00
|
|
|
|
2011-08-23 02:34:43 +02:00
|
|
|
Macintosh users run
|
2011-08-08 23:14:47 +02:00
|
|
|
|
2011-08-23 02:34:43 +02:00
|
|
|
./gyp_uv -f xcode
|
|
|
|
|
xcodebuild -project uv.xcodeproj -configuration Release -target All
|
2011-08-06 12:38:11 +02:00
|
|
|
|
|
|
|
|
|
2011-09-23 20:07:57 +02:00
|
|
|
## Supported Platforms
|
2011-05-13 04:16:40 +02:00
|
|
|
|
2011-08-08 23:14:47 +02:00
|
|
|
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.
|
2011-05-13 04:16:40 +02:00
|
|
|
|
2011-08-08 23:14:47 +02:00
|
|
|
MacOS using the GCC or XCode toolchain.
|
2011-05-13 04:16:40 +02:00
|
|
|
|
|
|
|
|
Solaris 121 and later using GCC toolchain.
|
