nutcracker 0.2.4.12 → 0.3.0.12

data/ext/nutcracker/configure

@@ -1,8 +1,8 @@
 #! /bin/sh
 # Guess values for system-dependent variables and create Makefiles.
-# Generated by GNU Autoconf 2.68 for nutcracker 0.2.4.
+# Generated by GNU Autoconf 2.68 for nutcracker 0.3.0.
 #
-# Report bugs to <manj@twitter.com>.
+# Report bugs to <manj@cs.stanford.edu>.
 #
 #
 # Copyright (C) 1992, 1993, 1994, 1995, 1996, 1998, 1999, 2000, 2001,
@@ -246,7 +246,7 @@ fi
     $as_echo "$0: In particular, zsh $ZSH_VERSION has bugs and should"
     $as_echo "$0: be upgraded to zsh 4.3.4 or later."
   else
-    $as_echo "$0: Please tell bug-autoconf@gnu.org and manj@twitter.com about your
+    $as_echo "$0: Please tell bug-autoconf@gnu.org and manj@cs.stanford.edu about your
 $0: system, including any error possibly output before this
 $0: message. Then install a modern shell, or manually run
 $0: the script under such a shell if you do have one."
@@ -569,9 +569,9 @@ MAKEFLAGS=
 # Identity of this package.
 PACKAGE_NAME='nutcracker'
 PACKAGE_TARNAME='nutcracker'
-PACKAGE_VERSION='0.2.4'
-PACKAGE_STRING='nutcracker 0.2.4'
-PACKAGE_BUGREPORT='manj@twitter.com'
+PACKAGE_VERSION='0.3.0'
+PACKAGE_STRING='nutcracker 0.3.0'
+PACKAGE_BUGREPORT='manj@cs.stanford.edu'
 PACKAGE_URL=''
 
 ac_unique_file="src/nc.c"
@@ -616,6 +616,12 @@ ac_subst_vars='am__EXEEXT_FALSE
 am__EXEEXT_TRUE
 LTLIBOBJS
 subdirs
+OS_SOLARIS_FALSE
+OS_SOLARIS_TRUE
+OS_BSD_FALSE
+OS_BSD_TRUE
+OS_LINUX_FALSE
+OS_LINUX_TRUE
 LIBOBJS
 CXXCPP
 OTOOL64
@@ -1301,7 +1307,7 @@ if test "$ac_init_help" = "long"; then
   # Omit some internal or obsolete options to make the list less imposing.
   # This message is too long to be a string in the A/UX 3.1 sh.
   cat <<_ACEOF
-\`configure' configures nutcracker 0.2.4 to adapt to many kinds of systems.
+\`configure' configures nutcracker 0.3.0 to adapt to many kinds of systems.
 
 Usage: $0 [OPTION]... [VAR=VALUE]...
 
@@ -1371,7 +1377,7 @@ fi
 
 if test -n "$ac_init_help"; then
   case $ac_init_help in
-     short | recursive ) echo "Configuration of nutcracker 0.2.4:";;
+     short | recursive ) echo "Configuration of nutcracker 0.3.0:";;
    esac
   cat <<\_ACEOF
 
@@ -1417,7 +1423,7 @@ Some influential environment variables:
 Use these variables to override the choices made by `configure' or to help
 it to find libraries and programs with nonstandard names/locations.
 
-Report bugs to <manj@twitter.com>.
+Report bugs to <manj@cs.stanford.edu>.
 _ACEOF
 ac_status=$?
 fi
@@ -1480,7 +1486,7 @@ fi
 test -n "$ac_init_help" && exit $ac_status
 if $ac_init_version; then
   cat <<\_ACEOF
-nutcracker configure 0.2.4
+nutcracker configure 0.3.0
 generated by GNU Autoconf 2.68
 
 Copyright (C) 2010 Free Software Foundation, Inc.
@@ -2127,9 +2133,9 @@ $as_echo "$as_me: WARNING: $2: see the Autoconf documentation" >&2;}
 $as_echo "$as_me: WARNING: $2:     section \"Present But Cannot Be Compiled\"" >&2;}
     { $as_echo "$as_me:${as_lineno-$LINENO}: WARNING: $2: proceeding with the compiler's result" >&5
 $as_echo "$as_me: WARNING: $2: proceeding with the compiler's result" >&2;}
-( $as_echo "## ------------------------------- ##
-## Report this to manj@twitter.com ##
-## ------------------------------- ##"
+( $as_echo "## ----------------------------------- ##
+## Report this to manj@cs.stanford.edu ##
+## ----------------------------------- ##"
      ) | sed "s/^/$as_me: WARNING:     /" >&2
     ;;
 esac
@@ -2151,7 +2157,7 @@ cat >config.log <<_ACEOF
 This file contains any messages produced by compilers while
 running configure, to aid debugging if configure makes a mistake.
 
-It was created by nutcracker $as_me 0.2.4, which was
+It was created by nutcracker $as_me 0.3.0, which was
 generated by GNU Autoconf 2.68.  Invocation command line was
 
   $ $0 $@
@@ -2972,7 +2978,7 @@ fi
 
 # Define the identity of the package.
  PACKAGE='nutcracker'
- VERSION='0.2.4'
+ VERSION='0.3.0'
 
 
 cat >>confdefs.h <<_ACEOF
@@ -3018,13 +3024,13 @@ am__tar='$${TAR-tar} chof - "$$tardir"' am__untar='$${TAR-tar} xf -'
 $as_echo "#define NC_VERSION_MAJOR 0" >>confdefs.h
 
 
-$as_echo "#define NC_VERSION_MINOR 2" >>confdefs.h
+$as_echo "#define NC_VERSION_MINOR 3" >>confdefs.h
 
 
-$as_echo "#define NC_VERSION_PATCH 4" >>confdefs.h
+$as_echo "#define NC_VERSION_PATCH 0" >>confdefs.h
 
 
-$as_echo "#define NC_VERSION_STRING \"0.2.4\"" >>confdefs.h
+$as_echo "#define NC_VERSION_STRING \"0.3.0\"" >>confdefs.h
 
 
 # Checks for language
@@ -16191,6 +16197,20 @@ fi
 
 done
 
+for ac_header in execinfo.h
+do :
+  ac_fn_c_check_header_mongrel "$LINENO" "execinfo.h" "ac_cv_header_execinfo_h" "$ac_includes_default"
+if test "x$ac_cv_header_execinfo_h" = xyes; then :
+  cat >>confdefs.h <<_ACEOF
+#define HAVE_EXECINFO_H 1
+_ACEOF
+
+$as_echo "#define HAVE_BACKTRACE 1" >>confdefs.h
+
+fi
+
+done
+
 for ac_header in sys/epoll.h
 do :
   ac_fn_c_check_header_mongrel "$LINENO" "sys/epoll.h" "ac_cv_header_sys_epoll_h" "$ac_includes_default"
@@ -16199,8 +16219,18 @@ if test "x$ac_cv_header_sys_epoll_h" = xyes; then :
 #define HAVE_SYS_EPOLL_H 1
 _ACEOF
 
-else
-  as_fn_error $? "required sys/epoll.h header file is missing" "$LINENO" 5
+fi
+
+done
+
+for ac_header in sys/event.h
+do :
+  ac_fn_c_check_header_mongrel "$LINENO" "sys/event.h" "ac_cv_header_sys_event_h" "$ac_includes_default"
+if test "x$ac_cv_header_sys_event_h" = xyes; then :
+  cat >>confdefs.h <<_ACEOF
+#define HAVE_SYS_EVENT_H 1
+_ACEOF
+
 fi
 
 done
@@ -16739,13 +16769,141 @@ fi
 $as_echo "$ac_cv_epoll_works" >&6; }
 if test "x$ac_cv_epoll_works" = "xyes"; then :
 
+$as_echo "#define HAVE_EPOLL 1" >>confdefs.h
+
+fi
+
+{ $as_echo "$as_me:${as_lineno-$LINENO}: checking if kqueue works" >&5
+$as_echo_n "checking if kqueue works... " >&6; }
+if ${ac_cv_kqueue_works+:} false; then :
+  $as_echo_n "(cached) " >&6
+else
+  if test "$cross_compiling" = yes; then :
+  { { $as_echo "$as_me:${as_lineno-$LINENO}: error: in \`$ac_pwd':" >&5
+$as_echo "$as_me: error: in \`$ac_pwd':" >&2;}
+as_fn_error $? "cannot run test program while cross compiling
+See \`config.log' for more details" "$LINENO" 5; }
+else
+  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+
+#include <stdio.h>
+#include <stdlib.h>
+#include <sys/types.h>
+#include <sys/event.h>
+#include <sys/time.h>
+int
+main(int argc, char **argv)
+{
+    int fd;
+
+    fd = kqueue();
+    if (fd < 0) {
+        perror("kqueue:");
+        exit(1);
+    }
+    exit(0);
+}
+
+_ACEOF
+if ac_fn_c_try_run "$LINENO"; then :
+  ac_cv_kqueue_works=yes
+else
+  ac_cv_kqueue_works=no
+fi
+rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
+  conftest.$ac_objext conftest.beam conftest.$ac_ext
+fi
+
+fi
+{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_kqueue_works" >&5
+$as_echo "$ac_cv_kqueue_works" >&6; }
+if test "x$ac_cv_kqueue_works" = "xyes"; then :
+
+$as_echo "#define HAVE_KQUEUE 1" >>confdefs.h
+
+fi
+
+{ $as_echo "$as_me:${as_lineno-$LINENO}: checking if event ports works" >&5
+$as_echo_n "checking if event ports works... " >&6; }
+if ${ac_cv_evports_works+:} false; then :
+  $as_echo_n "(cached) " >&6
 else
+  if test "$cross_compiling" = yes; then :
   { { $as_echo "$as_me:${as_lineno-$LINENO}: error: in \`$ac_pwd':" >&5
 $as_echo "$as_me: error: in \`$ac_pwd':" >&2;}
-as_fn_error $? "Linux epoll(7) API is missing
+as_fn_error $? "cannot run test program while cross compiling
 See \`config.log' for more details" "$LINENO" 5; }
+else
+  cat confdefs.h - <<_ACEOF >conftest.$ac_ext
+/* end confdefs.h.  */
+
+#include <stdio.h>
+#include <stdlib.h>
+#include <port.h>
+int
+main(int argc, char **argv)
+{
+    int fd;
+
+    fd = port_create();
+    if (fd < 0) {
+        perror("port_create:");
+        exit(1);
+    }
+    exit(0);
+}
+
+_ACEOF
+if ac_fn_c_try_run "$LINENO"; then :
+  ac_cv_evports_works=yes
+else
+  ac_cv_evports_works=no
+fi
+rm -f core *.core core.conftest.* gmon.out bb.out conftest$ac_exeext \
+  conftest.$ac_objext conftest.beam conftest.$ac_ext
+fi
+
+fi
+{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $ac_cv_evports_works" >&5
+$as_echo "$ac_cv_evports_works" >&6; }
+if test "x$ac_cv_evports_works" = "xyes"; then :
+
+$as_echo "#define HAVE_EVENT_PORTS 1" >>confdefs.h
+
+fi
+
+if test "x$ac_cv_epoll_works" = "xno" &&
+       test "x$ac_cv_kqueue_works" = "xno" &&
+       test "x$ac_cv_evports_works" = "xno"; then :
+  as_fn_error $? "either epoll or kqueue or event ports support is required" "$LINENO" 5
+fi
+
+ if test "x$ac_cv_epoll_works" = "xyes"; then
+  OS_LINUX_TRUE=
+  OS_LINUX_FALSE='#'
+else
+  OS_LINUX_TRUE='#'
+  OS_LINUX_FALSE=
 fi
 
+ if test "x$ac_cv_kqueue_works" = "xyes"; then
+  OS_BSD_TRUE=
+  OS_BSD_FALSE='#'
+else
+  OS_BSD_TRUE='#'
+  OS_BSD_FALSE=
+fi
+
+ if test "x$ac_cv_evports_works" = "xyes"; then
+  OS_SOLARIS_TRUE=
+  OS_SOLARIS_FALSE='#'
+else
+  OS_SOLARIS_TRUE='#'
+  OS_SOLARIS_FALSE=
+fi
+
+
 # Package options
 { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether to enable debug logs and asserts" >&5
 $as_echo_n "checking whether to enable debug logs and asserts... " >&6; }
@@ -16817,7 +16975,7 @@ subdirs="$subdirs contrib/yaml-0.1.4"
 
 
 # Define Makefiles
-ac_config_files="$ac_config_files Makefile contrib/Makefile src/Makefile src/hashkit/Makefile src/proto/Makefile"
+ac_config_files="$ac_config_files Makefile contrib/Makefile src/Makefile src/hashkit/Makefile src/proto/Makefile src/event/Makefile"
 
 
 # Generate the "configure" script
@@ -16950,6 +17108,18 @@ if test -z "${am__fastdepCXX_TRUE}" && test -z "${am__fastdepCXX_FALSE}"; then
   as_fn_error $? "conditional \"am__fastdepCXX\" was never defined.
 Usually this means the macro was only invoked conditionally." "$LINENO" 5
 fi
+if test -z "${OS_LINUX_TRUE}" && test -z "${OS_LINUX_FALSE}"; then
+  as_fn_error $? "conditional \"OS_LINUX\" was never defined.
+Usually this means the macro was only invoked conditionally." "$LINENO" 5
+fi
+if test -z "${OS_BSD_TRUE}" && test -z "${OS_BSD_FALSE}"; then
+  as_fn_error $? "conditional \"OS_BSD\" was never defined.
+Usually this means the macro was only invoked conditionally." "$LINENO" 5
+fi
+if test -z "${OS_SOLARIS_TRUE}" && test -z "${OS_SOLARIS_FALSE}"; then
+  as_fn_error $? "conditional \"OS_SOLARIS\" was never defined.
+Usually this means the macro was only invoked conditionally." "$LINENO" 5
+fi
 tar xvfz contrib/yaml-0.1.4.tar.gz -C contrib
 
 : "${CONFIG_STATUS=./config.status}"
@@ -17360,7 +17530,7 @@ cat >>$CONFIG_STATUS <<\_ACEOF || ac_write_fail=1
 # report actual input values of CONFIG_FILES etc. instead of their
 # values after options handling.
 ac_log="
-This file was extended by nutcracker $as_me 0.2.4, which was
+This file was extended by nutcracker $as_me 0.3.0, which was
 generated by GNU Autoconf 2.68.  Invocation command line was
 
   CONFIG_FILES    = $CONFIG_FILES
@@ -17420,13 +17590,13 @@ $config_headers
 Configuration commands:
 $config_commands
 
-Report bugs to <manj@twitter.com>."
+Report bugs to <manj@cs.stanford.edu>."
 
 _ACEOF
 cat >>$CONFIG_STATUS <<_ACEOF || ac_write_fail=1
 ac_cs_config="`$as_echo "$ac_configure_args" | sed 's/^ //; s/[\\""\`\$]/\\\\&/g'`"
 ac_cs_version="\\
-nutcracker config.status 0.2.4
+nutcracker config.status 0.3.0
 configured by $0, generated by GNU Autoconf 2.68,
   with options \\"\$ac_cs_config\\"
 
@@ -17938,6 +18108,7 @@ do
     "src/Makefile") CONFIG_FILES="$CONFIG_FILES src/Makefile" ;;
     "src/hashkit/Makefile") CONFIG_FILES="$CONFIG_FILES src/hashkit/Makefile" ;;
     "src/proto/Makefile") CONFIG_FILES="$CONFIG_FILES src/proto/Makefile" ;;
+    "src/event/Makefile") CONFIG_FILES="$CONFIG_FILES src/event/Makefile" ;;
 
   *) as_fn_error $? "invalid argument: \`$ac_config_target'" "$LINENO" 5;;
   esac

data/ext/nutcracker/configure.ac

@@ -1,8 +1,8 @@
 # Define the package version numbers and the bug reporting address
 m4_define([NC_MAJOR], 0)
-m4_define([NC_MINOR], 2)
-m4_define([NC_PATCH], 4)
-m4_define([NC_BUGS], [manj@twitter.com])
+m4_define([NC_MINOR], 3)
+m4_define([NC_PATCH], 0)
+m4_define([NC_BUGS], [manj@cs.stanford.edu])
 
 # Initialize autoconf
 AC_PREREQ([2.64])
@@ -67,7 +67,10 @@ AC_CHECK_HEADERS([fcntl.h float.h limits.h stddef.h stdlib.h string.h unistd.h])
 AC_CHECK_HEADERS([inttypes.h stdint.h])
 AC_CHECK_HEADERS([sys/ioctl.h sys/time.h sys/uio.h])
 AC_CHECK_HEADERS([sys/socket.h sys/un.h netinet/in.h arpa/inet.h netdb.h])
-AC_CHECK_HEADERS([sys/epoll.h], [], [AC_MSG_ERROR([required sys/epoll.h header file is missing])])
+AC_CHECK_HEADERS([execinfo.h],
+  [AC_DEFINE(HAVE_BACKTRACE, [1], [Define to 1 if backtrace is supported])], [])
+AC_CHECK_HEADERS([sys/epoll.h], [], [])
+AC_CHECK_HEADERS([sys/event.h], [], [])
 
 # Checks for libraries
 AC_CHECK_LIB([m], [pow])
@@ -100,7 +103,61 @@ main(int argc, char **argv)
     exit(0);
 }
   ], [ac_cv_epoll_works=yes], [ac_cv_epoll_works=no]))
-AS_IF([test "x$ac_cv_epoll_works" = "xyes"], [], [AC_MSG_FAILURE([Linux epoll(7) API is missing])])
+AS_IF([test "x$ac_cv_epoll_works" = "xyes"],
+  [AC_DEFINE([HAVE_EPOLL], [1], [Define to 1 if epoll is supported])], [])
+
+AC_CACHE_CHECK([if kqueue works], [ac_cv_kqueue_works],
+  AC_TRY_RUN([
+#include <stdio.h>
+#include <stdlib.h>
+#include <sys/types.h>
+#include <sys/event.h>
+#include <sys/time.h>
+int
+main(int argc, char **argv)
+{
+    int fd;
+
+    fd = kqueue();
+    if (fd < 0) {
+        perror("kqueue:");
+        exit(1);
+    }
+    exit(0);
+}
+  ], [ac_cv_kqueue_works=yes], [ac_cv_kqueue_works=no]))
+AS_IF([test "x$ac_cv_kqueue_works" = "xyes"],
+  [AC_DEFINE([HAVE_KQUEUE], [1], [Define to 1 if kqueue is supported])], [])
+
+AC_CACHE_CHECK([if event ports works], [ac_cv_evports_works],
+  AC_TRY_RUN([
+#include <stdio.h>
+#include <stdlib.h>
+#include <port.h>
+int
+main(int argc, char **argv)
+{
+    int fd;
+
+    fd = port_create();
+    if (fd < 0) {
+        perror("port_create:");
+        exit(1);
+    }
+    exit(0);
+}
+  ], [ac_cv_evports_works=yes], [ac_cv_evports_works=no]))
+AS_IF([test "x$ac_cv_evports_works" = "xyes"],
+  [AC_DEFINE([HAVE_EVENT_PORTS], [1], [Define to 1 if event ports is supported])], [])
+
+AS_IF([test "x$ac_cv_epoll_works" = "xno" &&
+       test "x$ac_cv_kqueue_works" = "xno" &&
+       test "x$ac_cv_evports_works" = "xno"],
+  [AC_MSG_ERROR([either epoll or kqueue or event ports support is required])], [])
+
+AM_CONDITIONAL([OS_LINUX], [test "x$ac_cv_epoll_works" = "xyes"])
+AM_CONDITIONAL([OS_BSD], [test "x$ac_cv_kqueue_works" = "xyes"])
+AM_CONDITIONAL([OS_SOLARIS], [test "x$ac_cv_evports_works" = "xyes"])
 
 # Package options
 AC_MSG_CHECKING([whether to enable debug logs and asserts])
@@ -149,7 +206,8 @@ AC_CONFIG_FILES([Makefile
                  contrib/Makefile
                  src/Makefile
                  src/hashkit/Makefile
-                 src/proto/Makefile])
+                 src/proto/Makefile
+                 src/event/Makefile])
 
 # Generate the "configure" script
 AC_OUTPUT

data/ext/nutcracker/extconf.rb

@@ -1,5 +1,5 @@
 
-        raise "no support for #{RUBY_PLATFORM}" if RUBY_PLATFORM =~ /darwin|mswin|mingw/
+        #raise "no support for #{RUBY_PLATFORM}" if RUBY_PLATFORM =~ /darwin|mswin|mingw/
         system "./configure --prefix=#{File.expand_path('..',__FILE__)}"
         system 'make'
       

data/ext/nutcracker/man/nutcracker.8

@@ -0,0 +1,76 @@
+.TH NUTCRACKER 8 "June 13, 2013"
+.SH NAME
+nutcracker \- Fast, light-weight proxy for memcached and Redis
+.SH SYNOPSIS
+.B nutcracker
+.RI [ options ]
+.SH DESCRIPTION
+\fBnutcracker\fP, also known as \fBtwemproxy\fP (pronounced "two-em-proxy"), is
+a fast and lightweight proxy for the memcached and Redis protocols.
+.PP
+It was primarily built to reduce the connection count on backend caching
+servers, but it has a number of features, such as:
+.IP \[bu]
+Maintains persistent server connections to backend servers.
+.IP \[bu]
+Enables pipelining of requests and responses.
+.IP \[bu]
+Supports multiple server pools simultaneously.
+.IP \[bu]
+Shard data automatically across multiple servers.
+.IP \[bu]
+Supports multiple hashing modes including consistent hashing and
+distribution.
+.IP \[bu]
+High-availability by disabling nodes on failures.
+.IP \[bu]
+Observability through stats exposed on stats monitoring port.
+.SH OPTIONS
+.TP
+.BR \-h ", " \-\-help
+Show usage information and exit.
+.TP
+.BR \-V ", " \-\-version
+Show version and exit.
+.TP
+.BR \-t ", " \-\-test-conf
+Test configuration for syntax errors and exit.
+.TP
+.BR \-D ", " \-\-describe-stats
+Print stats description and exit.
+.TP
+.BR \-v ", " \-\-verbosity=\fIN\fP
+Set logging level to \fIN\fP. (default: 5, min: 0, max: 11)
+.TP
+.BR \-o ", " \-\-output=\fIfilename\fP
+Set logging file to \fIfilename\fP.
+.TP
+.BR \-c ", " \-\-conf-file=\fIfilename\fP
+Set configuration file to \fIfilename\fP.
+.TP
+.BR \-s ", " \-\-stats-port=\fIport\fP
+Set stats monitoring port to \fIport\fP.
+(default: 22222)
+.TP
+.BR \-a ", " \-\-stats-addr=\fIaddress\fP
+Set stats monitoring IP to \fIaddress\fP.
+(default: 0.0.0.0)
+.TP
+.BR \-i ", " \-\-stats-interval=\fIinterval\fP
+Set stats aggregation interval in msec to \fIinterval\fP.
+(default: 30000 msec)
+.TP
+.BR \-m ", " \-\-mbuf-size=\fIsize\fP
+Set size of mbuf chunk in bytes to \fIsize\fP. (default: 16384 bytes)
+.TP
+.BR \-d ", " \-\-daemonize
+Run as a daemon.
+.TP
+.BR \-p ", " \-\-pid-file=\fIfilename\fP
+Set pid file to \fIfilename\fP.
+.SH SEE ALSO
+.BR memcached (8),
+.BR redis-server (1)
+.br
+.SH AUTHOR
+nutcracker was written by Twitter, Inc.

data/ext/nutcracker/notes/debug.txt

@@ -1,22 +1,6 @@
 - strace
   strace -o strace.txt -ttT -s 1024 -p `pgrep nutcracker`
 
-- epoll
-
-  EPOLLIN     = 0x001,
-  EPOLLPRI    = 0x002,
-  EPOLLOUT    = 0x004,
-  EPOLLERR    = 0x008,
-  EPOLLHUP    = 0x010,
-  EPOLLRDNORM = 0x040,
-  EPOLLRDBAND = 0x080,
-  EPOLLWRNORM = 0x100,
-  EPOLLWRBAND = 0x200,
-  EPOLLMSG    = 0x400,
-  EPOLLRDHUP  = 0x2000,
-  EPOLLONESHOT = (1 << 30),
-  EPOLLET = (1 << 31)
-
 - libyaml (yaml-0.1.4)
 
   - yaml tokens:
@@ -94,3 +78,119 @@
   http://www.cs.utah.edu/dept/old/texinfo/glibc-manual-0.02/library_2.html
   /usr/include/asm-generic/errno-base.h
   /usr/include/asm-generic/errno.h
+
+- epoll (linux)
+
+  union epoll_data {
+      void *ptr;
+      int fd;
+      uint32_t u32;
+      uint64_t u64;
+  };
+
+  struct epoll_event {
+      uint32_t          events;  /* epoll events */
+      struct epoll_data data;    /* user data variable */
+  };
+
+  /* events */
+  EPOLLIN       = 0x001,
+  EPOLLPRI      = 0x002,
+  EPOLLOUT      = 0x004,
+  EPOLLERR      = 0x008,
+  EPOLLHUP      = 0x010,
+  EPOLLRDNORM   = 0x040,
+  EPOLLRDBAND   = 0x080,
+  EPOLLWRNORM   = 0x100,
+  EPOLLWRBAND   = 0x200,
+  EPOLLMSG      = 0x400,
+  EPOLLRDHUP    = 0x2000,
+  EPOLLONESHOT  = (1 << 30),
+  EPOLLET       = (1 << 31)
+
+  /* opcodes */
+  EPOLL_CTL_ADD = 1 /* add a file decriptor to the interface */
+  EPOLL_CTL_DEL = 2 /* remove a file decriptor from the interface */
+  EPOLL_CTL_MOD = 3 /* change file decriptor epoll_event structure */
+
+- kqueue (bsd)
+
+  struct kevent {
+      uintptr_t   ident;    /* identifier for this event */
+      int16_t     filter;   /* filter for event */
+      uint16_t    flags;    /* general flags */
+      uint32_t    fflags;   /* filter-specific flags */
+      intptr_t    data;     /* filter-specific data */
+      void        *udata;   /* opaque user data identifier */
+  };
+
+  /* flags / events */
+  EV_ADD        = 0x0001    /* action - add event to kq (implies enable) */
+  EV_DELETE     = 0x0002    /* action - delete event from kq */
+  EV_ENABLE     = 0x0004    /* action - enable event */
+  EV_DISABLE    = 0x0008    /* action - disable event (not reported) */
+  EV_RECEIPT    = 0x0040    /* action - force EV_ERROR on success, data == 0 */
+
+  EV_ONESHOT    = 0x0010    /* flags - only report one occurrence */
+  EV_CLEAR      = 0x0020    /* flags - clear event state after reporting */
+  EV_DISPATCH   = 0x0080    /* flags - disable event after reporting */
+  EV_SYSFLAGS   = 0xF000    /* flags - reserved by system */
+  EV_FLAG0      = 0x1000    /* flags - filter-specific flag */
+  EV_FLAG1      = 0x2000    /* flags - filter-specific flag */
+
+  EV_EOF        = 0x8000    /* returned values - EOF detected */
+  EV_ERROR      = 0x4000    /* returned values - error, data contains errno */
+
+  /* filters */
+  EVFILT_READ       (-1)    /* readable */
+  EVFILT_WRITE      (-2)    /* writable */
+  EVFILT_AIO        (-3)    /* attached to aio requests */
+  EVFILT_VNODE      (-4)    /* attached to vnodes */
+  EVFILT_PROC       (-5)    /* attached to struct proc */
+  EVFILT_SIGNAL     (-6)    /* attached to struct proc */
+  EVFILT_TIMER      (-7)    /* timers */
+  EVFILT_MACHPORT   (-8)    /* mach portsets */
+  EVFILT_FS         (-9)    /* filesystem events */
+  EVFILT_USER       (-10)   /* user events */
+  EVFILT_VM         (-12)   /* virtual memory events */
+
+  EV_CLEAR behaves like EPOLLET because it resets the event after it is
+  returned; without this flag, the event would be repeatedly returned.
+
+- poll (unix)
+
+  POLLIN       0x001    /* there is data to read */
+  POLLPRI      0x002    /* there is urgent data to read */
+  POLLOUT      0x004    /* writing now will not block */
+
+  POLLRDNORM   0x040    /* normal data may be read */
+  POLLRDBAND   0x080    /* priority data may be read */
+  POLLWRNORM   0x100    /* writing now will not block */
+  POLLWRBAND   0x200    /* priority data may be written */
+
+  POLLMSG      0x400
+  POLLREMOVE  0x1000
+  POLLRDHUP   0x2000
+
+  POLLERR	   0x008    /* error condition */
+  POLLHUP      0x010    /* hung up */
+  POLLNVAL     0x020    /* invalid polling request */
+
+- event ports (solaris)
+
+  typedef struct port_event {
+      int         portev_events;  /* event data is source specific */
+      ushort_t    portev_source;  /* event source */
+      ushort_t    portev_pad;     /* port internal use */
+      uintptr_t   portev_object;  /* source specific object */
+      void        *portev_user;   /* user cookie */
+  } port_event_t;
+
+  /* port sources */
+  PORT_SOURCE_AIO     1
+  PORT_SOURCE_TIMER   2
+  PORT_SOURCE_USER    3
+  PORT_SOURCE_FD      4
+  PORT_SOURCE_ALERT   5
+  PORT_SOURCE_MQ      6
+  PORT_SOURCE_FILE    7