nutcracker 0.2.3

Sign up to get free protection for your applications and to get access to all the features.
Files changed (149) hide show
  1. data/README.md +22 -0
  2. data/Rakefile +55 -0
  3. data/bin/nutcracker +2 -0
  4. data/ext/nutcracker/ChangeLog +66 -0
  5. data/ext/nutcracker/LICENSE +177 -0
  6. data/ext/nutcracker/Makefile.am +7 -0
  7. data/ext/nutcracker/Makefile.in +726 -0
  8. data/ext/nutcracker/NOTICE +124 -0
  9. data/ext/nutcracker/README.md +240 -0
  10. data/ext/nutcracker/aclocal.m4 +956 -0
  11. data/ext/nutcracker/conf/nutcracker.leaf.yml +10 -0
  12. data/ext/nutcracker/conf/nutcracker.root.yml +8 -0
  13. data/ext/nutcracker/conf/nutcracker.yml +67 -0
  14. data/ext/nutcracker/config.h.in +316 -0
  15. data/ext/nutcracker/config/config.guess +1561 -0
  16. data/ext/nutcracker/config/config.sub +1686 -0
  17. data/ext/nutcracker/config/depcomp +630 -0
  18. data/ext/nutcracker/config/install-sh +520 -0
  19. data/ext/nutcracker/config/ltmain.sh +8413 -0
  20. data/ext/nutcracker/config/missing +376 -0
  21. data/ext/nutcracker/configure +18862 -0
  22. data/ext/nutcracker/configure.ac +155 -0
  23. data/ext/nutcracker/contrib/Makefile.am +3 -0
  24. data/ext/nutcracker/contrib/Makefile.in +560 -0
  25. data/ext/nutcracker/contrib/yaml-0.1.4.tar.gz +0 -0
  26. data/ext/nutcracker/contrib/yaml-0.1.4/LICENSE +19 -0
  27. data/ext/nutcracker/contrib/yaml-0.1.4/Makefile.am +20 -0
  28. data/ext/nutcracker/contrib/yaml-0.1.4/Makefile.in +736 -0
  29. data/ext/nutcracker/contrib/yaml-0.1.4/README +27 -0
  30. data/ext/nutcracker/contrib/yaml-0.1.4/aclocal.m4 +956 -0
  31. data/ext/nutcracker/contrib/yaml-0.1.4/config.h.in +80 -0
  32. data/ext/nutcracker/contrib/yaml-0.1.4/config/config.guess +1561 -0
  33. data/ext/nutcracker/contrib/yaml-0.1.4/config/config.sub +1686 -0
  34. data/ext/nutcracker/contrib/yaml-0.1.4/config/depcomp +630 -0
  35. data/ext/nutcracker/contrib/yaml-0.1.4/config/install-sh +520 -0
  36. data/ext/nutcracker/contrib/yaml-0.1.4/config/ltmain.sh +8406 -0
  37. data/ext/nutcracker/contrib/yaml-0.1.4/config/missing +376 -0
  38. data/ext/nutcracker/contrib/yaml-0.1.4/configure +13085 -0
  39. data/ext/nutcracker/contrib/yaml-0.1.4/configure.ac +75 -0
  40. data/ext/nutcracker/contrib/yaml-0.1.4/doc/doxygen.cfg +222 -0
  41. data/ext/nutcracker/contrib/yaml-0.1.4/include/yaml.h +1971 -0
  42. data/ext/nutcracker/contrib/yaml-0.1.4/m4/libtool.m4 +7357 -0
  43. data/ext/nutcracker/contrib/yaml-0.1.4/m4/ltoptions.m4 +368 -0
  44. data/ext/nutcracker/contrib/yaml-0.1.4/m4/ltsugar.m4 +123 -0
  45. data/ext/nutcracker/contrib/yaml-0.1.4/m4/ltversion.m4 +23 -0
  46. data/ext/nutcracker/contrib/yaml-0.1.4/m4/lt~obsolete.m4 +92 -0
  47. data/ext/nutcracker/contrib/yaml-0.1.4/src/Makefile.am +4 -0
  48. data/ext/nutcracker/contrib/yaml-0.1.4/src/Makefile.in +484 -0
  49. data/ext/nutcracker/contrib/yaml-0.1.4/src/api.c +1392 -0
  50. data/ext/nutcracker/contrib/yaml-0.1.4/src/dumper.c +394 -0
  51. data/ext/nutcracker/contrib/yaml-0.1.4/src/emitter.c +2329 -0
  52. data/ext/nutcracker/contrib/yaml-0.1.4/src/loader.c +432 -0
  53. data/ext/nutcracker/contrib/yaml-0.1.4/src/parser.c +1374 -0
  54. data/ext/nutcracker/contrib/yaml-0.1.4/src/reader.c +465 -0
  55. data/ext/nutcracker/contrib/yaml-0.1.4/src/scanner.c +3570 -0
  56. data/ext/nutcracker/contrib/yaml-0.1.4/src/writer.c +141 -0
  57. data/ext/nutcracker/contrib/yaml-0.1.4/src/yaml_private.h +640 -0
  58. data/ext/nutcracker/contrib/yaml-0.1.4/tests/Makefile.am +8 -0
  59. data/ext/nutcracker/contrib/yaml-0.1.4/tests/Makefile.in +675 -0
  60. data/ext/nutcracker/contrib/yaml-0.1.4/tests/example-deconstructor-alt.c +800 -0
  61. data/ext/nutcracker/contrib/yaml-0.1.4/tests/example-deconstructor.c +1130 -0
  62. data/ext/nutcracker/contrib/yaml-0.1.4/tests/example-reformatter-alt.c +217 -0
  63. data/ext/nutcracker/contrib/yaml-0.1.4/tests/example-reformatter.c +202 -0
  64. data/ext/nutcracker/contrib/yaml-0.1.4/tests/run-dumper.c +311 -0
  65. data/ext/nutcracker/contrib/yaml-0.1.4/tests/run-emitter.c +327 -0
  66. data/ext/nutcracker/contrib/yaml-0.1.4/tests/run-loader.c +63 -0
  67. data/ext/nutcracker/contrib/yaml-0.1.4/tests/run-parser.c +63 -0
  68. data/ext/nutcracker/contrib/yaml-0.1.4/tests/run-scanner.c +63 -0
  69. data/ext/nutcracker/contrib/yaml-0.1.4/tests/test-reader.c +354 -0
  70. data/ext/nutcracker/contrib/yaml-0.1.4/tests/test-version.c +29 -0
  71. data/ext/nutcracker/extconf.rb +5 -0
  72. data/ext/nutcracker/m4/libtool.m4 +7376 -0
  73. data/ext/nutcracker/m4/ltoptions.m4 +368 -0
  74. data/ext/nutcracker/m4/ltsugar.m4 +123 -0
  75. data/ext/nutcracker/m4/ltversion.m4 +23 -0
  76. data/ext/nutcracker/m4/lt~obsolete.m4 +92 -0
  77. data/ext/nutcracker/notes/c-styleguide.txt +425 -0
  78. data/ext/nutcracker/notes/debug.txt +96 -0
  79. data/ext/nutcracker/notes/memcache.txt +123 -0
  80. data/ext/nutcracker/notes/recommendation.md +118 -0
  81. data/ext/nutcracker/notes/redis.md +415 -0
  82. data/ext/nutcracker/notes/socket.txt +131 -0
  83. data/ext/nutcracker/scripts/multi_get.sh +26 -0
  84. data/ext/nutcracker/scripts/nutcracker.init +73 -0
  85. data/ext/nutcracker/scripts/nutcracker.spec +52 -0
  86. data/ext/nutcracker/scripts/pipelined_read.sh +23 -0
  87. data/ext/nutcracker/scripts/pipelined_write.sh +29 -0
  88. data/ext/nutcracker/scripts/populate_memcached.sh +24 -0
  89. data/ext/nutcracker/scripts/redis-check.py +23 -0
  90. data/ext/nutcracker/scripts/redis-check.sh +564 -0
  91. data/ext/nutcracker/src/Makefile.am +46 -0
  92. data/ext/nutcracker/src/Makefile.in +726 -0
  93. data/ext/nutcracker/src/hashkit/Makefile.am +22 -0
  94. data/ext/nutcracker/src/hashkit/Makefile.in +501 -0
  95. data/ext/nutcracker/src/hashkit/nc_crc32.c +105 -0
  96. data/ext/nutcracker/src/hashkit/nc_fnv.c +82 -0
  97. data/ext/nutcracker/src/hashkit/nc_hashkit.h +74 -0
  98. data/ext/nutcracker/src/hashkit/nc_hsieh.c +93 -0
  99. data/ext/nutcracker/src/hashkit/nc_jenkins.c +230 -0
  100. data/ext/nutcracker/src/hashkit/nc_ketama.c +240 -0
  101. data/ext/nutcracker/src/hashkit/nc_md5.c +379 -0
  102. data/ext/nutcracker/src/hashkit/nc_modula.c +144 -0
  103. data/ext/nutcracker/src/hashkit/nc_murmur.c +99 -0
  104. data/ext/nutcracker/src/hashkit/nc_one_at_a_time.c +51 -0
  105. data/ext/nutcracker/src/hashkit/nc_random.c +146 -0
  106. data/ext/nutcracker/src/nc.c +573 -0
  107. data/ext/nutcracker/src/nc_array.c +204 -0
  108. data/ext/nutcracker/src/nc_array.h +73 -0
  109. data/ext/nutcracker/src/nc_client.c +189 -0
  110. data/ext/nutcracker/src/nc_client.h +28 -0
  111. data/ext/nutcracker/src/nc_conf.c +1766 -0
  112. data/ext/nutcracker/src/nc_conf.h +134 -0
  113. data/ext/nutcracker/src/nc_connection.c +392 -0
  114. data/ext/nutcracker/src/nc_connection.h +99 -0
  115. data/ext/nutcracker/src/nc_core.c +334 -0
  116. data/ext/nutcracker/src/nc_core.h +131 -0
  117. data/ext/nutcracker/src/nc_event.c +214 -0
  118. data/ext/nutcracker/src/nc_event.h +39 -0
  119. data/ext/nutcracker/src/nc_log.c +254 -0
  120. data/ext/nutcracker/src/nc_log.h +120 -0
  121. data/ext/nutcracker/src/nc_mbuf.c +285 -0
  122. data/ext/nutcracker/src/nc_mbuf.h +67 -0
  123. data/ext/nutcracker/src/nc_message.c +828 -0
  124. data/ext/nutcracker/src/nc_message.h +253 -0
  125. data/ext/nutcracker/src/nc_proxy.c +359 -0
  126. data/ext/nutcracker/src/nc_proxy.h +34 -0
  127. data/ext/nutcracker/src/nc_queue.h +788 -0
  128. data/ext/nutcracker/src/nc_rbtree.c +348 -0
  129. data/ext/nutcracker/src/nc_rbtree.h +47 -0
  130. data/ext/nutcracker/src/nc_request.c +588 -0
  131. data/ext/nutcracker/src/nc_response.c +332 -0
  132. data/ext/nutcracker/src/nc_server.c +841 -0
  133. data/ext/nutcracker/src/nc_server.h +143 -0
  134. data/ext/nutcracker/src/nc_signal.c +131 -0
  135. data/ext/nutcracker/src/nc_signal.h +34 -0
  136. data/ext/nutcracker/src/nc_stats.c +1188 -0
  137. data/ext/nutcracker/src/nc_stats.h +206 -0
  138. data/ext/nutcracker/src/nc_string.c +109 -0
  139. data/ext/nutcracker/src/nc_string.h +112 -0
  140. data/ext/nutcracker/src/nc_util.c +619 -0
  141. data/ext/nutcracker/src/nc_util.h +214 -0
  142. data/ext/nutcracker/src/proto/Makefile.am +14 -0
  143. data/ext/nutcracker/src/proto/Makefile.in +482 -0
  144. data/ext/nutcracker/src/proto/nc_memcache.c +1306 -0
  145. data/ext/nutcracker/src/proto/nc_proto.h +155 -0
  146. data/ext/nutcracker/src/proto/nc_redis.c +2102 -0
  147. data/lib/nutcracker.rb +7 -0
  148. data/lib/nutcracker/version.rb +3 -0
  149. metadata +194 -0
@@ -0,0 +1,124 @@
1
+ twemproxy is a fast and lightweight proxy for memcached protocol
2
+ Copyright (C) 2012 Twitter, Inc.
3
+
4
+ Portions of twemproxy were inspired from nginx: http://nginx.org/
5
+
6
+ The implementation of generic array (nc_array.[ch]) and red black tree
7
+ (nc_rbtree.[ch]) also comes from nginx-0.8.55.
8
+
9
+ /*
10
+ * Copyright (C) 2002-2010 Igor Sysoev
11
+ *
12
+ * Redistribution and use in source and binary forms, with or without
13
+ * modification, are permitted provided that the following conditions
14
+ * are met:
15
+ * 1. Redistributions of source code must retain the above copyright
16
+ * notice, this list of conditions and the following disclaimer.
17
+ * 2. Redistributions in binary form must reproduce the above copyright
18
+ * notice, this list of conditions and the following disclaimer in the
19
+ * documentation and/or other materials provided with the distribution.
20
+ *
21
+ * THIS SOFTWARE IS PROVIDED BY AUTHOR AND CONTRIBUTORS ``AS IS'' AND
22
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24
+ * ARE DISCLAIMED. IN NO EVENT SHALL AUTHOR OR CONTRIBUTORS BE LIABLE
25
+ * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
26
+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
27
+ * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
28
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
29
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
30
+ * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
31
+ * SUCH DAMAGE.
32
+ */
33
+
34
+ The generic queue implementation comes from BSD <sys/queue.h>
35
+
36
+ /*
37
+ * Copyright (c) 1991, 1993
38
+ * The Regents of the University of California. All rights reserved.
39
+ *
40
+ * Redistribution and use in source and binary forms, with or without
41
+ * modification, are permitted provided that the following conditions
42
+ * are met:
43
+ * 1. Redistributions of source code must retain the above copyright
44
+ * notice, this list of conditions and the following disclaimer.
45
+ * 2. Redistributions in binary form must reproduce the above copyright
46
+ * notice, this list of conditions and the following disclaimer in the
47
+ * documentation and/or other materials provided with the distribution.
48
+ * 3. All advertising materials mentioning features or use of this software
49
+ * must display the following acknowledgement:
50
+ * This product includes software developed by the University of
51
+ * California, Berkeley and its contributors.
52
+ * 4. Neither the name of the University nor the names of its contributors
53
+ * may be used to endorse or promote products derived from this software
54
+ * without specific prior written permission.
55
+ *
56
+ * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
57
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
58
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
59
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
60
+ * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
61
+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
62
+ * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
63
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
64
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
65
+ * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
66
+ * SUCH DAMAGE.
67
+ */
68
+
69
+ The implementation of consistent hashing and individual hash algorithms were
70
+ borrowed from libmemcached.
71
+
72
+ Copyright (c) 2011, Data Differential (http://datadifferential.com/)
73
+ Copyright (c) 2007-2010, TangentOrg (Brian Aker)
74
+ All rights reserved.
75
+
76
+ Redistribution and use in source and binary forms, with or without
77
+ modification, are permitted provided that the following conditions are
78
+ met:
79
+
80
+ * Redistributions of source code must retain the above copyright
81
+ notice, this list of conditions and the following disclaimer.
82
+
83
+ * Redistributions in binary form must reproduce the above
84
+ copyright notice, this list of conditions and the following disclaimer
85
+ in the documentation and/or other materials provided with the
86
+ distribution.
87
+
88
+ * Neither the name of TangentOrg nor the names of its
89
+ contributors may be used to endorse or promote products derived from
90
+ this software without specific prior written permission.
91
+
92
+ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
93
+ "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
94
+ LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
95
+ A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
96
+ OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
97
+ SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
98
+ LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
99
+ DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
100
+ THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
101
+ (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
102
+ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
103
+
104
+ The source also includes libyaml (yaml-0.1.4) in contrib/ directory
105
+
106
+ Copyright (c) 2006 Kirill Simonov
107
+
108
+ Permission is hereby granted, free of charge, to any person obtaining a copy of
109
+ this software and associated documentation files (the "Software"), to deal in
110
+ the Software without restriction, including without limitation the rights to
111
+ use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
112
+ of the Software, and to permit persons to whom the Software is furnished to do
113
+ so, subject to the following conditions:
114
+
115
+ The above copyright notice and this permission notice shall be included in all
116
+ copies or substantial portions of the Software.
117
+
118
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
119
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
120
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
121
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
122
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
123
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
124
+ SOFTWARE.
@@ -0,0 +1,240 @@
1
+ # twemproxy (nutcracker) [![Build Status](https://secure.travis-ci.org/twitter/twemproxy.png)](http://travis-ci.org/twitter/twemproxy)
2
+
3
+ **twemproxy** (pronounced "two-em-proxy"), aka **nutcracker** is a fast and lightweight proxy for [memcached](http://www.memcached.org/) and [redis](http://redis.io/) protocol. It was primarily built to reduce the connection count on the backend caching servers.
4
+
5
+ ## Build
6
+
7
+ To build nutcracker from [distribution tarball](http://code.google.com/p/twemproxy/downloads/list):
8
+
9
+ $ ./configure
10
+ $ make
11
+ $ sudo make install
12
+
13
+ To build nutcracker from [distribution tarball](http://code.google.com/p/twemproxy/downloads/list) in _debug mode_:
14
+
15
+ $ CFLAGS="-ggdb3 -O0" ./configure --enable-debug=full
16
+ $ make
17
+ $ sudo make install
18
+
19
+ To build nutcracker from source with _debug logs enabled_ and _assertions disabled_:
20
+
21
+ $ git clone git@github.com:twitter/twemproxy.git
22
+ $ cd twemproxy
23
+ $ autoreconf -fvi
24
+ $ ./configure --enable-debug=log
25
+ $ make
26
+ $ src/nutcracker -h
27
+
28
+ ## Features
29
+
30
+ + Fast.
31
+ + Lightweight.
32
+ + Maintains persistent server connections.
33
+ + Keeps connection count on the backend caching servers low.
34
+ + Enables pipelining of requests and responses.
35
+ + Supports proxying to multiple servers.
36
+ + Supports multiple server pools simultaneously.
37
+ + Shard data automatically across multiple servers.
38
+ + Implements the complete [memcached ascii](https://github.com/twitter/twemproxy/blob/master/notes/memcache.txt) and [redis](https://github.com/twitter/twemproxy/blob/master/notes/redis.md) protocol.
39
+ + Easy configuration of server pools through a YAML file.
40
+ + Supports multiple hashing modes including consistent hashing and distribution.
41
+ + Can be configured to disable nodes on failures.
42
+ + Observability through stats exposed on stats monitoring port.
43
+
44
+ ## Help
45
+
46
+ Usage: nutcracker [-?hVdDt] [-v verbosity level] [-o output file]
47
+ [-c conf file] [-s stats port] [-a stats addr]
48
+ [-i stats interval] [-p pid file] [-m mbuf size]
49
+
50
+ Options:
51
+ -h, --help : this help
52
+ -V, --version : show version and exit
53
+ -t, --test-conf : test configuration for syntax errors and exit
54
+ -d, --daemonize : run as a daemon
55
+ -D, --describe-stats : print stats description and exit
56
+ -v, --verbosity=N : set logging level (default: 5, min: 0, max: 11)
57
+ -o, --output=S : set logging file (default: stderr)
58
+ -c, --conf-file=S : set configuration file (default: conf/nutcracker.yml)
59
+ -s, --stats-port=N : set stats monitoring port (default: 22222)
60
+ -a, --stats-addr=S : set stats monitoring ip (default: 0.0.0.0)
61
+ -i, --stats-interval=N : set stats aggregation interval in msec (default: 30000 msec)
62
+ -p, --pid-file=S : set pid file (default: off)
63
+ -m, --mbuf-size=N : set size of mbuf chunk in bytes (default: 16384 bytes)
64
+
65
+ ## Zero Copy
66
+
67
+ In nutcracker, all the memory for incoming requests and outgoing responses is allocated in mbuf. Mbuf enables zero-copy because the same buffer on which a request was received from the client is used for forwarding it to the server. Similarly the same mbuf on which a response was received from the server is used for forwarding it to the client.
68
+
69
+ Furthermore, memory for mbufs is managed using a reuse pool. This means that once mbuf is allocated, it is not deallocated, but just put back into the reuse pool. By default each mbuf chunk is set to 16K bytes in size. There is a trade-off between the mbuf size and number of concurrent connections nutcracker can support. A large mbuf size reduces the number of read syscalls made by nutcracker when reading requests or responses. However, with large mbuf size, every active connection would use up 16K bytes of buffer which might be an issue when nutcracker is handling large number of concurrent connections from clients. When nutcracker is meant to handle a large number of concurrent client connections, you should set chunk size to a small value like 512 bytes using the -m or --mbuf-size=N argument.
70
+
71
+ ## Configuration
72
+
73
+ nutcracker can be configured through a YAML file specified by the -c or --conf-file command-line argument on process start. The configuration file is used to specify the server pools and the servers within each pool that nutcracker manages. The configuration files parses and understands the following keys:
74
+
75
+ + **listen**: The listening address and port (name:port or ip:port) for this server pool.
76
+ + **hash**: The name of the hash function. Possible values are:
77
+ + one_at_a_time
78
+ + md5
79
+ + crc32
80
+ + fnv1_64
81
+ + fnv1a_64
82
+ + fnv1_32
83
+ + fnv1a_32
84
+ + hsieh
85
+ + murmur
86
+ + jenkins
87
+ + **hash_tag**: A two character string that specifies the part of the key used for hashing. Eg "{}" or "$$". [Hash tag](https://github.com/twitter/twemproxy/blob/master/notes/recommendation.md#hash-tags) enable mapping different keys to the same server as long as the part of the key within the tag is the same.
88
+ + **distribution**: The key distribution mode. Possible values are:
89
+ + ketama
90
+ + modula
91
+ + random
92
+ + **timeout**: The timeout value in msec that we wait for to establish a connection to the server or receive a response from a server. By default, we wait indefinitely.
93
+ + **backlog**: The TCP backlog argument. Defaults to 512.
94
+ + **preconnect**: A boolean value that controls if nutcracker should preconnect to all the servers in this pool on process start. Defaults to false.
95
+ + **redis**: A boolean value that controls if a server pool speaks redis or memcached protocol. Defaults to false.
96
+ + **server_connections**: The maximum number of connections that can be opened to each server. By default, we open at most 1 server connection.
97
+ + **auto_eject_hosts**: A boolean value that controls if server should be ejected temporarily when it fails consecutively server_failure_limit times. Defaults to false.
98
+ + **server_retry_timeout**: The timeout value in msec to wait for before retrying on a temporarily ejected server, when auto_eject_host is set to true. Defaults to 30000 msec.
99
+ + **server_failure_limit**: The number of conseutive failures on a server that would leads to it being temporarily ejected when auto_eject_host is set to true. Defaults to 2.
100
+ + **servers**: A list of server address, port and weight (name:port:weight or ip:port:weight) for this server pool.
101
+
102
+
103
+ For example, the configuration file in [conf/nutcracker.yml](https://github.com/twitter/twemproxy/blob/master/conf/nutcracker.yml), also shown below, configures 5 server pools with names - _alpha_, _beta_, _gamma_, _delta_ and omega. Clients that intend to send requests to one of the 10 servers in pool delta connect to port 22124 on 127.0.0.1. Clients that intend to send request to one of 2 servers in pool omega connect to unix path /tmp/gamma. Requests sent to pool alpha and omega have no timeout and might require timeout functionality to be implemented on the client side. On the other hand, requests sent to pool beta, gamma and delta timeout after 400 msec, 400 msec and 100 msec respectively when no response is received from the server. Of the 5 server pools, only pools alpha, gamma and deleta are configured to use server ejection and hence are resilient to server failures. All the 5 server pools use ketama consistent hashing for key distribution with the key hasher for pools alpha, beta, gamma and delta set to fnv1a_64 while that for pool omega set to hsieh. Also only pool beta uses [nodes names](https://github.com/twitter/twemproxy/blob/master/notes/recommendation.md#node-names-for-consistent-hashing) for consistent hashing, while pool alpha, gamma, delta and omega use 'host:port:weight' for consistent hashing. Finally, only pool alpha and beta can speak redis protocol, while pool gamma, deta and omega speak memcached protocol.
104
+
105
+ alpha:
106
+ listen: 127.0.0.1:22121
107
+ hash: fnv1a_64
108
+ distribution: ketama
109
+ auto_eject_hosts: true
110
+ redis: true
111
+ server_retry_timeout: 2000
112
+ server_failure_limit: 1
113
+ servers:
114
+ - 127.0.0.1:6379:1
115
+
116
+ beta:
117
+ listen: 127.0.0.1:22122
118
+ hash: fnv1a_64
119
+ hash_tag: "{}"
120
+ distribution: ketama
121
+ auto_eject_hosts: false
122
+ timeout: 400
123
+ redis: true
124
+ servers:
125
+ - 127.0.0.1:6380:1 server1
126
+ - 127.0.0.1:6381:1 server2
127
+ - 127.0.0.1:6382:1 server3
128
+ - 127.0.0.1:6383:1 server4
129
+
130
+ gamma:
131
+ listen: 127.0.0.1:22123
132
+ hash: fnv1a_64
133
+ distribution: ketama
134
+ timeout: 400
135
+ backlog: 1024
136
+ preconnect: true
137
+ auto_eject_hosts: true
138
+ server_retry_timeout: 2000
139
+ server_failure_limit: 3
140
+ servers:
141
+ - 127.0.0.1:11212:1
142
+ - 127.0.0.1:11213:1
143
+
144
+ delta:
145
+ listen: 127.0.0.1:22124
146
+ hash: fnv1a_64
147
+ distribution: ketama
148
+ timeout: 100
149
+ auto_eject_hosts: true
150
+ server_retry_timeout: 2000
151
+ server_failure_limit: 1
152
+ servers:
153
+ - 127.0.0.1:11214:1
154
+ - 127.0.0.1:11215:1
155
+ - 127.0.0.1:11216:1
156
+ - 127.0.0.1:11217:1
157
+ - 127.0.0.1:11218:1
158
+ - 127.0.0.1:11219:1
159
+ - 127.0.0.1:11220:1
160
+ - 127.0.0.1:11221:1
161
+ - 127.0.0.1:11222:1
162
+ - 127.0.0.1:11223:1
163
+
164
+ omega:
165
+ listen: /tmp/gamma
166
+ hash: hsieh
167
+ distribution: ketama
168
+ auto_eject_hosts: false
169
+ servers:
170
+ - 127.0.0.1:11214:100000
171
+ - 127.0.0.1:11215:1
172
+
173
+ Finally, to make writing syntactically correct configuration file easier, nutcracker provides a command-line argument -t or --test-conf that can be used to test the YAML configuration file for any syntax error.
174
+
175
+ ## Observability
176
+
177
+ Observability in nutcracker is through logs and stats.
178
+
179
+ Nutcracker exposes stats at the granularity of server pool and servers per pool through the stats monitoring port. The stats are essentially JSON formatted key-value pairs, with the keys corresponding to counter names. By default stats are exposed on port 22222 and aggregated every 30 seconds. Both these values can be configured on program start using the -c or --conf-file and -i or --stats-interval command-line arguments respectively. You can print the description of all stats exported by nutcracker using the -D or --describe-stats command-line argument.
180
+
181
+ $ nutcracker --describe-stats
182
+
183
+ pool stats:
184
+ client_eof "# eof on client connections"
185
+ client_err "# errors on client connections"
186
+ client_connections "# active client connections"
187
+ server_ejects "# times backend server was ejected"
188
+ forward_error "# times we encountered a forwarding error"
189
+ fragments "# fragments created from a multi-vector request"
190
+
191
+ server stats:
192
+ server_eof "# eof on server connections"
193
+ server_err "# errors on server connections"
194
+ server_timedout "# timeouts on server connections"
195
+ server_connections "# active server connections"
196
+ requests "# requests"
197
+ request_bytes "total request bytes"
198
+ responses "# respones"
199
+ response_bytes "total response bytes"
200
+ in_queue "# requests in incoming queue"
201
+ in_queue_bytes "current request bytes in incoming queue"
202
+ out_queue "# requests in outgoing queue"
203
+ out_queue_bytes "current request bytes in outgoing queue"
204
+
205
+ Logging in nutcracker is only available when nutcracker is built with logging enabled. By default logs are written to stderr. Nutcracker can also be configured to write logs to a specific file through the -o or --output command-line argument. On a running nutcracker, we can turn log levels up and down by sending it SIGTTIN and SIGTTOU signals respectively and reopen log files by sending it SIGHUP signal.
206
+
207
+ ## Pipelining
208
+
209
+
210
+ Nutcracker enables proxying multiple client connections onto one or few server connections. This architectural setup makes it ideal for pipelining requests and responses and hence saving on the round trip time.
211
+
212
+ For example, if nutcracker is proxing three client connections onto a single server and we get requests - 'get key\r\n', 'set key 0 0 3\r\nval\r\n' and 'delete key\r\n' on these three connections respectively, nutcracker would try to batch these requests and send them as a single message onto the server connection as 'get key\r\nset key 0 0 3\r\nval\r\ndelete key\r\n'.
213
+
214
+ Pipelining is the reason why nutcracker ends up doing better in terms of throughput even though it introduces an extra hop between the client and server.
215
+
216
+ ## Deployment
217
+
218
+ If you are deploying nutcracker in production, you might consider reading through the [recommendation document](https://github.com/twitter/twemproxy/blob/master/notes/recommendation.md) to understand the parameters you could tune in nutcracker to run it efficiently in the production environment.
219
+
220
+ ## Users
221
+ + [Pinterest](http://pinterest.com/)
222
+ + [Tumblr](https://www.tumblr.com/)
223
+ + [Twitter](https://twitter.com/)
224
+ + [Vine](http://vine.co/)
225
+
226
+ ## Issues and Support
227
+
228
+ Have a bug or a question? Please create an issue here on GitHub!
229
+
230
+ https://github.com/twitter/twemproxy/issues
231
+
232
+ ## Contributors
233
+
234
+ * Manju Rajashekhar ([@manju](https://twitter.com/manju))
235
+
236
+ ## License
237
+
238
+ Copyright 2012 Twitter, Inc.
239
+
240
+ Licensed under the Apache License, Version 2.0: http://www.apache.org/licenses/LICENSE-2.0
@@ -0,0 +1,956 @@
1
+ # generated automatically by aclocal 1.11 -*- Autoconf -*-
2
+
3
+ # Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004,
4
+ # 2005, 2006, 2007, 2008, 2009 Free Software Foundation, Inc.
5
+ # This file is free software; the Free Software Foundation
6
+ # gives unlimited permission to copy and/or distribute it,
7
+ # with or without modifications, as long as this notice is preserved.
8
+
9
+ # This program is distributed in the hope that it will be useful,
10
+ # but WITHOUT ANY WARRANTY, to the extent permitted by law; without
11
+ # even the implied warranty of MERCHANTABILITY or FITNESS FOR A
12
+ # PARTICULAR PURPOSE.
13
+
14
+ m4_ifndef([AC_AUTOCONF_VERSION],
15
+ [m4_copy([m4_PACKAGE_VERSION], [AC_AUTOCONF_VERSION])])dnl
16
+ m4_if(m4_defn([AC_AUTOCONF_VERSION]), [2.64],,
17
+ [m4_warning([this file was generated for autoconf 2.64.
18
+ You have another version of autoconf. It may work, but is not guaranteed to.
19
+ If you have problems, you may need to regenerate the build system entirely.
20
+ To do so, use the procedure documented by the package, typically `autoreconf'.])])
21
+
22
+ # Copyright (C) 2002, 2003, 2005, 2006, 2007, 2008 Free Software Foundation, Inc.
23
+ #
24
+ # This file is free software; the Free Software Foundation
25
+ # gives unlimited permission to copy and/or distribute it,
26
+ # with or without modifications, as long as this notice is preserved.
27
+
28
+ # AM_AUTOMAKE_VERSION(VERSION)
29
+ # ----------------------------
30
+ # Automake X.Y traces this macro to ensure aclocal.m4 has been
31
+ # generated from the m4 files accompanying Automake X.Y.
32
+ # (This private macro should not be called outside this file.)
33
+ AC_DEFUN([AM_AUTOMAKE_VERSION],
34
+ [am__api_version='1.11'
35
+ dnl Some users find AM_AUTOMAKE_VERSION and mistake it for a way to
36
+ dnl require some minimum version. Point them to the right macro.
37
+ m4_if([$1], [1.11], [],
38
+ [AC_FATAL([Do not call $0, use AM_INIT_AUTOMAKE([$1]).])])dnl
39
+ ])
40
+
41
+ # _AM_AUTOCONF_VERSION(VERSION)
42
+ # -----------------------------
43
+ # aclocal traces this macro to find the Autoconf version.
44
+ # This is a private macro too. Using m4_define simplifies
45
+ # the logic in aclocal, which can simply ignore this definition.
46
+ m4_define([_AM_AUTOCONF_VERSION], [])
47
+
48
+ # AM_SET_CURRENT_AUTOMAKE_VERSION
49
+ # -------------------------------
50
+ # Call AM_AUTOMAKE_VERSION and AM_AUTOMAKE_VERSION so they can be traced.
51
+ # This function is AC_REQUIREd by AM_INIT_AUTOMAKE.
52
+ AC_DEFUN([AM_SET_CURRENT_AUTOMAKE_VERSION],
53
+ [AM_AUTOMAKE_VERSION([1.11])dnl
54
+ m4_ifndef([AC_AUTOCONF_VERSION],
55
+ [m4_copy([m4_PACKAGE_VERSION], [AC_AUTOCONF_VERSION])])dnl
56
+ _AM_AUTOCONF_VERSION(m4_defn([AC_AUTOCONF_VERSION]))])
57
+
58
+ # AM_AUX_DIR_EXPAND -*- Autoconf -*-
59
+
60
+ # Copyright (C) 2001, 2003, 2005 Free Software Foundation, Inc.
61
+ #
62
+ # This file is free software; the Free Software Foundation
63
+ # gives unlimited permission to copy and/or distribute it,
64
+ # with or without modifications, as long as this notice is preserved.
65
+
66
+ # For projects using AC_CONFIG_AUX_DIR([foo]), Autoconf sets
67
+ # $ac_aux_dir to `$srcdir/foo'. In other projects, it is set to
68
+ # `$srcdir', `$srcdir/..', or `$srcdir/../..'.
69
+ #
70
+ # Of course, Automake must honor this variable whenever it calls a
71
+ # tool from the auxiliary directory. The problem is that $srcdir (and
72
+ # therefore $ac_aux_dir as well) can be either absolute or relative,
73
+ # depending on how configure is run. This is pretty annoying, since
74
+ # it makes $ac_aux_dir quite unusable in subdirectories: in the top
75
+ # source directory, any form will work fine, but in subdirectories a
76
+ # relative path needs to be adjusted first.
77
+ #
78
+ # $ac_aux_dir/missing
79
+ # fails when called from a subdirectory if $ac_aux_dir is relative
80
+ # $top_srcdir/$ac_aux_dir/missing
81
+ # fails if $ac_aux_dir is absolute,
82
+ # fails when called from a subdirectory in a VPATH build with
83
+ # a relative $ac_aux_dir
84
+ #
85
+ # The reason of the latter failure is that $top_srcdir and $ac_aux_dir
86
+ # are both prefixed by $srcdir. In an in-source build this is usually
87
+ # harmless because $srcdir is `.', but things will broke when you
88
+ # start a VPATH build or use an absolute $srcdir.
89
+ #
90
+ # So we could use something similar to $top_srcdir/$ac_aux_dir/missing,
91
+ # iff we strip the leading $srcdir from $ac_aux_dir. That would be:
92
+ # am_aux_dir='\$(top_srcdir)/'`expr "$ac_aux_dir" : "$srcdir//*\(.*\)"`
93
+ # and then we would define $MISSING as
94
+ # MISSING="\${SHELL} $am_aux_dir/missing"
95
+ # This will work as long as MISSING is not called from configure, because
96
+ # unfortunately $(top_srcdir) has no meaning in configure.
97
+ # However there are other variables, like CC, which are often used in
98
+ # configure, and could therefore not use this "fixed" $ac_aux_dir.
99
+ #
100
+ # Another solution, used here, is to always expand $ac_aux_dir to an
101
+ # absolute PATH. The drawback is that using absolute paths prevent a
102
+ # configured tree to be moved without reconfiguration.
103
+
104
+ AC_DEFUN([AM_AUX_DIR_EXPAND],
105
+ [dnl Rely on autoconf to set up CDPATH properly.
106
+ AC_PREREQ([2.50])dnl
107
+ # expand $ac_aux_dir to an absolute path
108
+ am_aux_dir=`cd $ac_aux_dir && pwd`
109
+ ])
110
+
111
+ # AM_CONDITIONAL -*- Autoconf -*-
112
+
113
+ # Copyright (C) 1997, 2000, 2001, 2003, 2004, 2005, 2006, 2008
114
+ # Free Software Foundation, Inc.
115
+ #
116
+ # This file is free software; the Free Software Foundation
117
+ # gives unlimited permission to copy and/or distribute it,
118
+ # with or without modifications, as long as this notice is preserved.
119
+
120
+ # serial 9
121
+
122
+ # AM_CONDITIONAL(NAME, SHELL-CONDITION)
123
+ # -------------------------------------
124
+ # Define a conditional.
125
+ AC_DEFUN([AM_CONDITIONAL],
126
+ [AC_PREREQ(2.52)dnl
127
+ ifelse([$1], [TRUE], [AC_FATAL([$0: invalid condition: $1])],
128
+ [$1], [FALSE], [AC_FATAL([$0: invalid condition: $1])])dnl
129
+ AC_SUBST([$1_TRUE])dnl
130
+ AC_SUBST([$1_FALSE])dnl
131
+ _AM_SUBST_NOTMAKE([$1_TRUE])dnl
132
+ _AM_SUBST_NOTMAKE([$1_FALSE])dnl
133
+ m4_define([_AM_COND_VALUE_$1], [$2])dnl
134
+ if $2; then
135
+ $1_TRUE=
136
+ $1_FALSE='#'
137
+ else
138
+ $1_TRUE='#'
139
+ $1_FALSE=
140
+ fi
141
+ AC_CONFIG_COMMANDS_PRE(
142
+ [if test -z "${$1_TRUE}" && test -z "${$1_FALSE}"; then
143
+ AC_MSG_ERROR([[conditional "$1" was never defined.
144
+ Usually this means the macro was only invoked conditionally.]])
145
+ fi])])
146
+
147
+ # Copyright (C) 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2009
148
+ # Free Software Foundation, Inc.
149
+ #
150
+ # This file is free software; the Free Software Foundation
151
+ # gives unlimited permission to copy and/or distribute it,
152
+ # with or without modifications, as long as this notice is preserved.
153
+
154
+ # serial 10
155
+
156
+ # There are a few dirty hacks below to avoid letting `AC_PROG_CC' be
157
+ # written in clear, in which case automake, when reading aclocal.m4,
158
+ # will think it sees a *use*, and therefore will trigger all it's
159
+ # C support machinery. Also note that it means that autoscan, seeing
160
+ # CC etc. in the Makefile, will ask for an AC_PROG_CC use...
161
+
162
+
163
+ # _AM_DEPENDENCIES(NAME)
164
+ # ----------------------
165
+ # See how the compiler implements dependency checking.
166
+ # NAME is "CC", "CXX", "GCJ", or "OBJC".
167
+ # We try a few techniques and use that to set a single cache variable.
168
+ #
169
+ # We don't AC_REQUIRE the corresponding AC_PROG_CC since the latter was
170
+ # modified to invoke _AM_DEPENDENCIES(CC); we would have a circular
171
+ # dependency, and given that the user is not expected to run this macro,
172
+ # just rely on AC_PROG_CC.
173
+ AC_DEFUN([_AM_DEPENDENCIES],
174
+ [AC_REQUIRE([AM_SET_DEPDIR])dnl
175
+ AC_REQUIRE([AM_OUTPUT_DEPENDENCY_COMMANDS])dnl
176
+ AC_REQUIRE([AM_MAKE_INCLUDE])dnl
177
+ AC_REQUIRE([AM_DEP_TRACK])dnl
178
+
179
+ ifelse([$1], CC, [depcc="$CC" am_compiler_list=],
180
+ [$1], CXX, [depcc="$CXX" am_compiler_list=],
181
+ [$1], OBJC, [depcc="$OBJC" am_compiler_list='gcc3 gcc'],
182
+ [$1], UPC, [depcc="$UPC" am_compiler_list=],
183
+ [$1], GCJ, [depcc="$GCJ" am_compiler_list='gcc3 gcc'],
184
+ [depcc="$$1" am_compiler_list=])
185
+
186
+ AC_CACHE_CHECK([dependency style of $depcc],
187
+ [am_cv_$1_dependencies_compiler_type],
188
+ [if test -z "$AMDEP_TRUE" && test -f "$am_depcomp"; then
189
+ # We make a subdir and do the tests there. Otherwise we can end up
190
+ # making bogus files that we don't know about and never remove. For
191
+ # instance it was reported that on HP-UX the gcc test will end up
192
+ # making a dummy file named `D' -- because `-MD' means `put the output
193
+ # in D'.
194
+ mkdir conftest.dir
195
+ # Copy depcomp to subdir because otherwise we won't find it if we're
196
+ # using a relative directory.
197
+ cp "$am_depcomp" conftest.dir
198
+ cd conftest.dir
199
+ # We will build objects and dependencies in a subdirectory because
200
+ # it helps to detect inapplicable dependency modes. For instance
201
+ # both Tru64's cc and ICC support -MD to output dependencies as a
202
+ # side effect of compilation, but ICC will put the dependencies in
203
+ # the current directory while Tru64 will put them in the object
204
+ # directory.
205
+ mkdir sub
206
+
207
+ am_cv_$1_dependencies_compiler_type=none
208
+ if test "$am_compiler_list" = ""; then
209
+ am_compiler_list=`sed -n ['s/^#*\([a-zA-Z0-9]*\))$/\1/p'] < ./depcomp`
210
+ fi
211
+ am__universal=false
212
+ m4_case([$1], [CC],
213
+ [case " $depcc " in #(
214
+ *\ -arch\ *\ -arch\ *) am__universal=true ;;
215
+ esac],
216
+ [CXX],
217
+ [case " $depcc " in #(
218
+ *\ -arch\ *\ -arch\ *) am__universal=true ;;
219
+ esac])
220
+
221
+ for depmode in $am_compiler_list; do
222
+ # Setup a source with many dependencies, because some compilers
223
+ # like to wrap large dependency lists on column 80 (with \), and
224
+ # we should not choose a depcomp mode which is confused by this.
225
+ #
226
+ # We need to recreate these files for each test, as the compiler may
227
+ # overwrite some of them when testing with obscure command lines.
228
+ # This happens at least with the AIX C compiler.
229
+ : > sub/conftest.c
230
+ for i in 1 2 3 4 5 6; do
231
+ echo '#include "conftst'$i'.h"' >> sub/conftest.c
232
+ # Using `: > sub/conftst$i.h' creates only sub/conftst1.h with
233
+ # Solaris 8's {/usr,}/bin/sh.
234
+ touch sub/conftst$i.h
235
+ done
236
+ echo "${am__include} ${am__quote}sub/conftest.Po${am__quote}" > confmf
237
+
238
+ # We check with `-c' and `-o' for the sake of the "dashmstdout"
239
+ # mode. It turns out that the SunPro C++ compiler does not properly
240
+ # handle `-M -o', and we need to detect this. Also, some Intel
241
+ # versions had trouble with output in subdirs
242
+ am__obj=sub/conftest.${OBJEXT-o}
243
+ am__minus_obj="-o $am__obj"
244
+ case $depmode in
245
+ gcc)
246
+ # This depmode causes a compiler race in universal mode.
247
+ test "$am__universal" = false || continue
248
+ ;;
249
+ nosideeffect)
250
+ # after this tag, mechanisms are not by side-effect, so they'll
251
+ # only be used when explicitly requested
252
+ if test "x$enable_dependency_tracking" = xyes; then
253
+ continue
254
+ else
255
+ break
256
+ fi
257
+ ;;
258
+ msvisualcpp | msvcmsys)
259
+ # This compiler won't grok `-c -o', but also, the minuso test has
260
+ # not run yet. These depmodes are late enough in the game, and
261
+ # so weak that their functioning should not be impacted.
262
+ am__obj=conftest.${OBJEXT-o}
263
+ am__minus_obj=
264
+ ;;
265
+ none) break ;;
266
+ esac
267
+ if depmode=$depmode \
268
+ source=sub/conftest.c object=$am__obj \
269
+ depfile=sub/conftest.Po tmpdepfile=sub/conftest.TPo \
270
+ $SHELL ./depcomp $depcc -c $am__minus_obj sub/conftest.c \
271
+ >/dev/null 2>conftest.err &&
272
+ grep sub/conftst1.h sub/conftest.Po > /dev/null 2>&1 &&
273
+ grep sub/conftst6.h sub/conftest.Po > /dev/null 2>&1 &&
274
+ grep $am__obj sub/conftest.Po > /dev/null 2>&1 &&
275
+ ${MAKE-make} -s -f confmf > /dev/null 2>&1; then
276
+ # icc doesn't choke on unknown options, it will just issue warnings
277
+ # or remarks (even with -Werror). So we grep stderr for any message
278
+ # that says an option was ignored or not supported.
279
+ # When given -MP, icc 7.0 and 7.1 complain thusly:
280
+ # icc: Command line warning: ignoring option '-M'; no argument required
281
+ # The diagnosis changed in icc 8.0:
282
+ # icc: Command line remark: option '-MP' not supported
283
+ if (grep 'ignoring option' conftest.err ||
284
+ grep 'not supported' conftest.err) >/dev/null 2>&1; then :; else
285
+ am_cv_$1_dependencies_compiler_type=$depmode
286
+ break
287
+ fi
288
+ fi
289
+ done
290
+
291
+ cd ..
292
+ rm -rf conftest.dir
293
+ else
294
+ am_cv_$1_dependencies_compiler_type=none
295
+ fi
296
+ ])
297
+ AC_SUBST([$1DEPMODE], [depmode=$am_cv_$1_dependencies_compiler_type])
298
+ AM_CONDITIONAL([am__fastdep$1], [
299
+ test "x$enable_dependency_tracking" != xno \
300
+ && test "$am_cv_$1_dependencies_compiler_type" = gcc3])
301
+ ])
302
+
303
+
304
+ # AM_SET_DEPDIR
305
+ # -------------
306
+ # Choose a directory name for dependency files.
307
+ # This macro is AC_REQUIREd in _AM_DEPENDENCIES
308
+ AC_DEFUN([AM_SET_DEPDIR],
309
+ [AC_REQUIRE([AM_SET_LEADING_DOT])dnl
310
+ AC_SUBST([DEPDIR], ["${am__leading_dot}deps"])dnl
311
+ ])
312
+
313
+
314
+ # AM_DEP_TRACK
315
+ # ------------
316
+ AC_DEFUN([AM_DEP_TRACK],
317
+ [AC_ARG_ENABLE(dependency-tracking,
318
+ [ --disable-dependency-tracking speeds up one-time build
319
+ --enable-dependency-tracking do not reject slow dependency extractors])
320
+ if test "x$enable_dependency_tracking" != xno; then
321
+ am_depcomp="$ac_aux_dir/depcomp"
322
+ AMDEPBACKSLASH='\'
323
+ fi
324
+ AM_CONDITIONAL([AMDEP], [test "x$enable_dependency_tracking" != xno])
325
+ AC_SUBST([AMDEPBACKSLASH])dnl
326
+ _AM_SUBST_NOTMAKE([AMDEPBACKSLASH])dnl
327
+ ])
328
+
329
+ # Generate code to set up dependency tracking. -*- Autoconf -*-
330
+
331
+ # Copyright (C) 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2008
332
+ # Free Software Foundation, Inc.
333
+ #
334
+ # This file is free software; the Free Software Foundation
335
+ # gives unlimited permission to copy and/or distribute it,
336
+ # with or without modifications, as long as this notice is preserved.
337
+
338
+ #serial 5
339
+
340
+ # _AM_OUTPUT_DEPENDENCY_COMMANDS
341
+ # ------------------------------
342
+ AC_DEFUN([_AM_OUTPUT_DEPENDENCY_COMMANDS],
343
+ [{
344
+ # Autoconf 2.62 quotes --file arguments for eval, but not when files
345
+ # are listed without --file. Let's play safe and only enable the eval
346
+ # if we detect the quoting.
347
+ case $CONFIG_FILES in
348
+ *\'*) eval set x "$CONFIG_FILES" ;;
349
+ *) set x $CONFIG_FILES ;;
350
+ esac
351
+ shift
352
+ for mf
353
+ do
354
+ # Strip MF so we end up with the name of the file.
355
+ mf=`echo "$mf" | sed -e 's/:.*$//'`
356
+ # Check whether this is an Automake generated Makefile or not.
357
+ # We used to match only the files named `Makefile.in', but
358
+ # some people rename them; so instead we look at the file content.
359
+ # Grep'ing the first line is not enough: some people post-process
360
+ # each Makefile.in and add a new line on top of each file to say so.
361
+ # Grep'ing the whole file is not good either: AIX grep has a line
362
+ # limit of 2048, but all sed's we know have understand at least 4000.
363
+ if sed -n 's,^#.*generated by automake.*,X,p' "$mf" | grep X >/dev/null 2>&1; then
364
+ dirpart=`AS_DIRNAME("$mf")`
365
+ else
366
+ continue
367
+ fi
368
+ # Extract the definition of DEPDIR, am__include, and am__quote
369
+ # from the Makefile without running `make'.
370
+ DEPDIR=`sed -n 's/^DEPDIR = //p' < "$mf"`
371
+ test -z "$DEPDIR" && continue
372
+ am__include=`sed -n 's/^am__include = //p' < "$mf"`
373
+ test -z "am__include" && continue
374
+ am__quote=`sed -n 's/^am__quote = //p' < "$mf"`
375
+ # When using ansi2knr, U may be empty or an underscore; expand it
376
+ U=`sed -n 's/^U = //p' < "$mf"`
377
+ # Find all dependency output files, they are included files with
378
+ # $(DEPDIR) in their names. We invoke sed twice because it is the
379
+ # simplest approach to changing $(DEPDIR) to its actual value in the
380
+ # expansion.
381
+ for file in `sed -n "
382
+ s/^$am__include $am__quote\(.*(DEPDIR).*\)$am__quote"'$/\1/p' <"$mf" | \
383
+ sed -e 's/\$(DEPDIR)/'"$DEPDIR"'/g' -e 's/\$U/'"$U"'/g'`; do
384
+ # Make sure the directory exists.
385
+ test -f "$dirpart/$file" && continue
386
+ fdir=`AS_DIRNAME(["$file"])`
387
+ AS_MKDIR_P([$dirpart/$fdir])
388
+ # echo "creating $dirpart/$file"
389
+ echo '# dummy' > "$dirpart/$file"
390
+ done
391
+ done
392
+ }
393
+ ])# _AM_OUTPUT_DEPENDENCY_COMMANDS
394
+
395
+
396
+ # AM_OUTPUT_DEPENDENCY_COMMANDS
397
+ # -----------------------------
398
+ # This macro should only be invoked once -- use via AC_REQUIRE.
399
+ #
400
+ # This code is only required when automatic dependency tracking
401
+ # is enabled. FIXME. This creates each `.P' file that we will
402
+ # need in order to bootstrap the dependency handling code.
403
+ AC_DEFUN([AM_OUTPUT_DEPENDENCY_COMMANDS],
404
+ [AC_CONFIG_COMMANDS([depfiles],
405
+ [test x"$AMDEP_TRUE" != x"" || _AM_OUTPUT_DEPENDENCY_COMMANDS],
406
+ [AMDEP_TRUE="$AMDEP_TRUE" ac_aux_dir="$ac_aux_dir"])
407
+ ])
408
+
409
+ # Do all the work for Automake. -*- Autoconf -*-
410
+
411
+ # Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004,
412
+ # 2005, 2006, 2008, 2009 Free Software Foundation, Inc.
413
+ #
414
+ # This file is free software; the Free Software Foundation
415
+ # gives unlimited permission to copy and/or distribute it,
416
+ # with or without modifications, as long as this notice is preserved.
417
+
418
+ # serial 16
419
+
420
+ # This macro actually does too much. Some checks are only needed if
421
+ # your package does certain things. But this isn't really a big deal.
422
+
423
+ # AM_INIT_AUTOMAKE(PACKAGE, VERSION, [NO-DEFINE])
424
+ # AM_INIT_AUTOMAKE([OPTIONS])
425
+ # -----------------------------------------------
426
+ # The call with PACKAGE and VERSION arguments is the old style
427
+ # call (pre autoconf-2.50), which is being phased out. PACKAGE
428
+ # and VERSION should now be passed to AC_INIT and removed from
429
+ # the call to AM_INIT_AUTOMAKE.
430
+ # We support both call styles for the transition. After
431
+ # the next Automake release, Autoconf can make the AC_INIT
432
+ # arguments mandatory, and then we can depend on a new Autoconf
433
+ # release and drop the old call support.
434
+ AC_DEFUN([AM_INIT_AUTOMAKE],
435
+ [AC_PREREQ([2.62])dnl
436
+ dnl Autoconf wants to disallow AM_ names. We explicitly allow
437
+ dnl the ones we care about.
438
+ m4_pattern_allow([^AM_[A-Z]+FLAGS$])dnl
439
+ AC_REQUIRE([AM_SET_CURRENT_AUTOMAKE_VERSION])dnl
440
+ AC_REQUIRE([AC_PROG_INSTALL])dnl
441
+ if test "`cd $srcdir && pwd`" != "`pwd`"; then
442
+ # Use -I$(srcdir) only when $(srcdir) != ., so that make's output
443
+ # is not polluted with repeated "-I."
444
+ AC_SUBST([am__isrc], [' -I$(srcdir)'])_AM_SUBST_NOTMAKE([am__isrc])dnl
445
+ # test to see if srcdir already configured
446
+ if test -f $srcdir/config.status; then
447
+ AC_MSG_ERROR([source directory already configured; run "make distclean" there first])
448
+ fi
449
+ fi
450
+
451
+ # test whether we have cygpath
452
+ if test -z "$CYGPATH_W"; then
453
+ if (cygpath --version) >/dev/null 2>/dev/null; then
454
+ CYGPATH_W='cygpath -w'
455
+ else
456
+ CYGPATH_W=echo
457
+ fi
458
+ fi
459
+ AC_SUBST([CYGPATH_W])
460
+
461
+ # Define the identity of the package.
462
+ dnl Distinguish between old-style and new-style calls.
463
+ m4_ifval([$2],
464
+ [m4_ifval([$3], [_AM_SET_OPTION([no-define])])dnl
465
+ AC_SUBST([PACKAGE], [$1])dnl
466
+ AC_SUBST([VERSION], [$2])],
467
+ [_AM_SET_OPTIONS([$1])dnl
468
+ dnl Diagnose old-style AC_INIT with new-style AM_AUTOMAKE_INIT.
469
+ m4_if(m4_ifdef([AC_PACKAGE_NAME], 1)m4_ifdef([AC_PACKAGE_VERSION], 1), 11,,
470
+ [m4_fatal([AC_INIT should be called with package and version arguments])])dnl
471
+ AC_SUBST([PACKAGE], ['AC_PACKAGE_TARNAME'])dnl
472
+ AC_SUBST([VERSION], ['AC_PACKAGE_VERSION'])])dnl
473
+
474
+ _AM_IF_OPTION([no-define],,
475
+ [AC_DEFINE_UNQUOTED(PACKAGE, "$PACKAGE", [Name of package])
476
+ AC_DEFINE_UNQUOTED(VERSION, "$VERSION", [Version number of package])])dnl
477
+
478
+ # Some tools Automake needs.
479
+ AC_REQUIRE([AM_SANITY_CHECK])dnl
480
+ AC_REQUIRE([AC_ARG_PROGRAM])dnl
481
+ AM_MISSING_PROG(ACLOCAL, aclocal-${am__api_version})
482
+ AM_MISSING_PROG(AUTOCONF, autoconf)
483
+ AM_MISSING_PROG(AUTOMAKE, automake-${am__api_version})
484
+ AM_MISSING_PROG(AUTOHEADER, autoheader)
485
+ AM_MISSING_PROG(MAKEINFO, makeinfo)
486
+ AC_REQUIRE([AM_PROG_INSTALL_SH])dnl
487
+ AC_REQUIRE([AM_PROG_INSTALL_STRIP])dnl
488
+ AC_REQUIRE([AM_PROG_MKDIR_P])dnl
489
+ # We need awk for the "check" target. The system "awk" is bad on
490
+ # some platforms.
491
+ AC_REQUIRE([AC_PROG_AWK])dnl
492
+ AC_REQUIRE([AC_PROG_MAKE_SET])dnl
493
+ AC_REQUIRE([AM_SET_LEADING_DOT])dnl
494
+ _AM_IF_OPTION([tar-ustar], [_AM_PROG_TAR([ustar])],
495
+ [_AM_IF_OPTION([tar-pax], [_AM_PROG_TAR([pax])],
496
+ [_AM_PROG_TAR([v7])])])
497
+ _AM_IF_OPTION([no-dependencies],,
498
+ [AC_PROVIDE_IFELSE([AC_PROG_CC],
499
+ [_AM_DEPENDENCIES(CC)],
500
+ [define([AC_PROG_CC],
501
+ defn([AC_PROG_CC])[_AM_DEPENDENCIES(CC)])])dnl
502
+ AC_PROVIDE_IFELSE([AC_PROG_CXX],
503
+ [_AM_DEPENDENCIES(CXX)],
504
+ [define([AC_PROG_CXX],
505
+ defn([AC_PROG_CXX])[_AM_DEPENDENCIES(CXX)])])dnl
506
+ AC_PROVIDE_IFELSE([AC_PROG_OBJC],
507
+ [_AM_DEPENDENCIES(OBJC)],
508
+ [define([AC_PROG_OBJC],
509
+ defn([AC_PROG_OBJC])[_AM_DEPENDENCIES(OBJC)])])dnl
510
+ ])
511
+ _AM_IF_OPTION([silent-rules], [AC_REQUIRE([AM_SILENT_RULES])])dnl
512
+ dnl The `parallel-tests' driver may need to know about EXEEXT, so add the
513
+ dnl `am__EXEEXT' conditional if _AM_COMPILER_EXEEXT was seen. This macro
514
+ dnl is hooked onto _AC_COMPILER_EXEEXT early, see below.
515
+ AC_CONFIG_COMMANDS_PRE(dnl
516
+ [m4_provide_if([_AM_COMPILER_EXEEXT],
517
+ [AM_CONDITIONAL([am__EXEEXT], [test -n "$EXEEXT"])])])dnl
518
+ ])
519
+
520
+ dnl Hook into `_AC_COMPILER_EXEEXT' early to learn its expansion. Do not
521
+ dnl add the conditional right here, as _AC_COMPILER_EXEEXT may be further
522
+ dnl mangled by Autoconf and run in a shell conditional statement.
523
+ m4_define([_AC_COMPILER_EXEEXT],
524
+ m4_defn([_AC_COMPILER_EXEEXT])[m4_provide([_AM_COMPILER_EXEEXT])])
525
+
526
+
527
+ # When config.status generates a header, we must update the stamp-h file.
528
+ # This file resides in the same directory as the config header
529
+ # that is generated. The stamp files are numbered to have different names.
530
+
531
+ # Autoconf calls _AC_AM_CONFIG_HEADER_HOOK (when defined) in the
532
+ # loop where config.status creates the headers, so we can generate
533
+ # our stamp files there.
534
+ AC_DEFUN([_AC_AM_CONFIG_HEADER_HOOK],
535
+ [# Compute $1's index in $config_headers.
536
+ _am_arg=$1
537
+ _am_stamp_count=1
538
+ for _am_header in $config_headers :; do
539
+ case $_am_header in
540
+ $_am_arg | $_am_arg:* )
541
+ break ;;
542
+ * )
543
+ _am_stamp_count=`expr $_am_stamp_count + 1` ;;
544
+ esac
545
+ done
546
+ echo "timestamp for $_am_arg" >`AS_DIRNAME(["$_am_arg"])`/stamp-h[]$_am_stamp_count])
547
+
548
+ # Copyright (C) 2001, 2003, 2005, 2008 Free Software Foundation, Inc.
549
+ #
550
+ # This file is free software; the Free Software Foundation
551
+ # gives unlimited permission to copy and/or distribute it,
552
+ # with or without modifications, as long as this notice is preserved.
553
+
554
+ # AM_PROG_INSTALL_SH
555
+ # ------------------
556
+ # Define $install_sh.
557
+ AC_DEFUN([AM_PROG_INSTALL_SH],
558
+ [AC_REQUIRE([AM_AUX_DIR_EXPAND])dnl
559
+ if test x"${install_sh}" != xset; then
560
+ case $am_aux_dir in
561
+ *\ * | *\ *)
562
+ install_sh="\${SHELL} '$am_aux_dir/install-sh'" ;;
563
+ *)
564
+ install_sh="\${SHELL} $am_aux_dir/install-sh"
565
+ esac
566
+ fi
567
+ AC_SUBST(install_sh)])
568
+
569
+ # Copyright (C) 2003, 2005 Free Software Foundation, Inc.
570
+ #
571
+ # This file is free software; the Free Software Foundation
572
+ # gives unlimited permission to copy and/or distribute it,
573
+ # with or without modifications, as long as this notice is preserved.
574
+
575
+ # serial 2
576
+
577
+ # Check whether the underlying file-system supports filenames
578
+ # with a leading dot. For instance MS-DOS doesn't.
579
+ AC_DEFUN([AM_SET_LEADING_DOT],
580
+ [rm -rf .tst 2>/dev/null
581
+ mkdir .tst 2>/dev/null
582
+ if test -d .tst; then
583
+ am__leading_dot=.
584
+ else
585
+ am__leading_dot=_
586
+ fi
587
+ rmdir .tst 2>/dev/null
588
+ AC_SUBST([am__leading_dot])])
589
+
590
+ # Check to see how 'make' treats includes. -*- Autoconf -*-
591
+
592
+ # Copyright (C) 2001, 2002, 2003, 2005, 2009 Free Software Foundation, Inc.
593
+ #
594
+ # This file is free software; the Free Software Foundation
595
+ # gives unlimited permission to copy and/or distribute it,
596
+ # with or without modifications, as long as this notice is preserved.
597
+
598
+ # serial 4
599
+
600
+ # AM_MAKE_INCLUDE()
601
+ # -----------------
602
+ # Check to see how make treats includes.
603
+ AC_DEFUN([AM_MAKE_INCLUDE],
604
+ [am_make=${MAKE-make}
605
+ cat > confinc << 'END'
606
+ am__doit:
607
+ @echo this is the am__doit target
608
+ .PHONY: am__doit
609
+ END
610
+ # If we don't find an include directive, just comment out the code.
611
+ AC_MSG_CHECKING([for style of include used by $am_make])
612
+ am__include="#"
613
+ am__quote=
614
+ _am_result=none
615
+ # First try GNU make style include.
616
+ echo "include confinc" > confmf
617
+ # Ignore all kinds of additional output from `make'.
618
+ case `$am_make -s -f confmf 2> /dev/null` in #(
619
+ *the\ am__doit\ target*)
620
+ am__include=include
621
+ am__quote=
622
+ _am_result=GNU
623
+ ;;
624
+ esac
625
+ # Now try BSD make style include.
626
+ if test "$am__include" = "#"; then
627
+ echo '.include "confinc"' > confmf
628
+ case `$am_make -s -f confmf 2> /dev/null` in #(
629
+ *the\ am__doit\ target*)
630
+ am__include=.include
631
+ am__quote="\""
632
+ _am_result=BSD
633
+ ;;
634
+ esac
635
+ fi
636
+ AC_SUBST([am__include])
637
+ AC_SUBST([am__quote])
638
+ AC_MSG_RESULT([$_am_result])
639
+ rm -f confinc confmf
640
+ ])
641
+
642
+ # Fake the existence of programs that GNU maintainers use. -*- Autoconf -*-
643
+
644
+ # Copyright (C) 1997, 1999, 2000, 2001, 2003, 2004, 2005, 2008
645
+ # Free Software Foundation, Inc.
646
+ #
647
+ # This file is free software; the Free Software Foundation
648
+ # gives unlimited permission to copy and/or distribute it,
649
+ # with or without modifications, as long as this notice is preserved.
650
+
651
+ # serial 6
652
+
653
+ # AM_MISSING_PROG(NAME, PROGRAM)
654
+ # ------------------------------
655
+ AC_DEFUN([AM_MISSING_PROG],
656
+ [AC_REQUIRE([AM_MISSING_HAS_RUN])
657
+ $1=${$1-"${am_missing_run}$2"}
658
+ AC_SUBST($1)])
659
+
660
+
661
+ # AM_MISSING_HAS_RUN
662
+ # ------------------
663
+ # Define MISSING if not defined so far and test if it supports --run.
664
+ # If it does, set am_missing_run to use it, otherwise, to nothing.
665
+ AC_DEFUN([AM_MISSING_HAS_RUN],
666
+ [AC_REQUIRE([AM_AUX_DIR_EXPAND])dnl
667
+ AC_REQUIRE_AUX_FILE([missing])dnl
668
+ if test x"${MISSING+set}" != xset; then
669
+ case $am_aux_dir in
670
+ *\ * | *\ *)
671
+ MISSING="\${SHELL} \"$am_aux_dir/missing\"" ;;
672
+ *)
673
+ MISSING="\${SHELL} $am_aux_dir/missing" ;;
674
+ esac
675
+ fi
676
+ # Use eval to expand $SHELL
677
+ if eval "$MISSING --run true"; then
678
+ am_missing_run="$MISSING --run "
679
+ else
680
+ am_missing_run=
681
+ AC_MSG_WARN([`missing' script is too old or missing])
682
+ fi
683
+ ])
684
+
685
+ # Copyright (C) 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
686
+ #
687
+ # This file is free software; the Free Software Foundation
688
+ # gives unlimited permission to copy and/or distribute it,
689
+ # with or without modifications, as long as this notice is preserved.
690
+
691
+ # AM_PROG_MKDIR_P
692
+ # ---------------
693
+ # Check for `mkdir -p'.
694
+ AC_DEFUN([AM_PROG_MKDIR_P],
695
+ [AC_PREREQ([2.60])dnl
696
+ AC_REQUIRE([AC_PROG_MKDIR_P])dnl
697
+ dnl Automake 1.8 to 1.9.6 used to define mkdir_p. We now use MKDIR_P,
698
+ dnl while keeping a definition of mkdir_p for backward compatibility.
699
+ dnl @MKDIR_P@ is magic: AC_OUTPUT adjusts its value for each Makefile.
700
+ dnl However we cannot define mkdir_p as $(MKDIR_P) for the sake of
701
+ dnl Makefile.ins that do not define MKDIR_P, so we do our own
702
+ dnl adjustment using top_builddir (which is defined more often than
703
+ dnl MKDIR_P).
704
+ AC_SUBST([mkdir_p], ["$MKDIR_P"])dnl
705
+ case $mkdir_p in
706
+ [[\\/$]]* | ?:[[\\/]]*) ;;
707
+ */*) mkdir_p="\$(top_builddir)/$mkdir_p" ;;
708
+ esac
709
+ ])
710
+
711
+ # Helper functions for option handling. -*- Autoconf -*-
712
+
713
+ # Copyright (C) 2001, 2002, 2003, 2005, 2008 Free Software Foundation, Inc.
714
+ #
715
+ # This file is free software; the Free Software Foundation
716
+ # gives unlimited permission to copy and/or distribute it,
717
+ # with or without modifications, as long as this notice is preserved.
718
+
719
+ # serial 4
720
+
721
+ # _AM_MANGLE_OPTION(NAME)
722
+ # -----------------------
723
+ AC_DEFUN([_AM_MANGLE_OPTION],
724
+ [[_AM_OPTION_]m4_bpatsubst($1, [[^a-zA-Z0-9_]], [_])])
725
+
726
+ # _AM_SET_OPTION(NAME)
727
+ # ------------------------------
728
+ # Set option NAME. Presently that only means defining a flag for this option.
729
+ AC_DEFUN([_AM_SET_OPTION],
730
+ [m4_define(_AM_MANGLE_OPTION([$1]), 1)])
731
+
732
+ # _AM_SET_OPTIONS(OPTIONS)
733
+ # ----------------------------------
734
+ # OPTIONS is a space-separated list of Automake options.
735
+ AC_DEFUN([_AM_SET_OPTIONS],
736
+ [m4_foreach_w([_AM_Option], [$1], [_AM_SET_OPTION(_AM_Option)])])
737
+
738
+ # _AM_IF_OPTION(OPTION, IF-SET, [IF-NOT-SET])
739
+ # -------------------------------------------
740
+ # Execute IF-SET if OPTION is set, IF-NOT-SET otherwise.
741
+ AC_DEFUN([_AM_IF_OPTION],
742
+ [m4_ifset(_AM_MANGLE_OPTION([$1]), [$2], [$3])])
743
+
744
+ # Check to make sure that the build environment is sane. -*- Autoconf -*-
745
+
746
+ # Copyright (C) 1996, 1997, 2000, 2001, 2003, 2005, 2008
747
+ # Free Software Foundation, Inc.
748
+ #
749
+ # This file is free software; the Free Software Foundation
750
+ # gives unlimited permission to copy and/or distribute it,
751
+ # with or without modifications, as long as this notice is preserved.
752
+
753
+ # serial 5
754
+
755
+ # AM_SANITY_CHECK
756
+ # ---------------
757
+ AC_DEFUN([AM_SANITY_CHECK],
758
+ [AC_MSG_CHECKING([whether build environment is sane])
759
+ # Just in case
760
+ sleep 1
761
+ echo timestamp > conftest.file
762
+ # Reject unsafe characters in $srcdir or the absolute working directory
763
+ # name. Accept space and tab only in the latter.
764
+ am_lf='
765
+ '
766
+ case `pwd` in
767
+ *[[\\\"\#\$\&\'\`$am_lf]]*)
768
+ AC_MSG_ERROR([unsafe absolute working directory name]);;
769
+ esac
770
+ case $srcdir in
771
+ *[[\\\"\#\$\&\'\`$am_lf\ \ ]]*)
772
+ AC_MSG_ERROR([unsafe srcdir value: `$srcdir']);;
773
+ esac
774
+
775
+ # Do `set' in a subshell so we don't clobber the current shell's
776
+ # arguments. Must try -L first in case configure is actually a
777
+ # symlink; some systems play weird games with the mod time of symlinks
778
+ # (eg FreeBSD returns the mod time of the symlink's containing
779
+ # directory).
780
+ if (
781
+ set X `ls -Lt "$srcdir/configure" conftest.file 2> /dev/null`
782
+ if test "$[*]" = "X"; then
783
+ # -L didn't work.
784
+ set X `ls -t "$srcdir/configure" conftest.file`
785
+ fi
786
+ rm -f conftest.file
787
+ if test "$[*]" != "X $srcdir/configure conftest.file" \
788
+ && test "$[*]" != "X conftest.file $srcdir/configure"; then
789
+
790
+ # If neither matched, then we have a broken ls. This can happen
791
+ # if, for instance, CONFIG_SHELL is bash and it inherits a
792
+ # broken ls alias from the environment. This has actually
793
+ # happened. Such a system could not be considered "sane".
794
+ AC_MSG_ERROR([ls -t appears to fail. Make sure there is not a broken
795
+ alias in your environment])
796
+ fi
797
+
798
+ test "$[2]" = conftest.file
799
+ )
800
+ then
801
+ # Ok.
802
+ :
803
+ else
804
+ AC_MSG_ERROR([newly created file is older than distributed files!
805
+ Check your system clock])
806
+ fi
807
+ AC_MSG_RESULT(yes)])
808
+
809
+ # Copyright (C) 2001, 2003, 2005 Free Software Foundation, Inc.
810
+ #
811
+ # This file is free software; the Free Software Foundation
812
+ # gives unlimited permission to copy and/or distribute it,
813
+ # with or without modifications, as long as this notice is preserved.
814
+
815
+ # AM_PROG_INSTALL_STRIP
816
+ # ---------------------
817
+ # One issue with vendor `install' (even GNU) is that you can't
818
+ # specify the program used to strip binaries. This is especially
819
+ # annoying in cross-compiling environments, where the build's strip
820
+ # is unlikely to handle the host's binaries.
821
+ # Fortunately install-sh will honor a STRIPPROG variable, so we
822
+ # always use install-sh in `make install-strip', and initialize
823
+ # STRIPPROG with the value of the STRIP variable (set by the user).
824
+ AC_DEFUN([AM_PROG_INSTALL_STRIP],
825
+ [AC_REQUIRE([AM_PROG_INSTALL_SH])dnl
826
+ # Installed binaries are usually stripped using `strip' when the user
827
+ # run `make install-strip'. However `strip' might not be the right
828
+ # tool to use in cross-compilation environments, therefore Automake
829
+ # will honor the `STRIP' environment variable to overrule this program.
830
+ dnl Don't test for $cross_compiling = yes, because it might be `maybe'.
831
+ if test "$cross_compiling" != no; then
832
+ AC_CHECK_TOOL([STRIP], [strip], :)
833
+ fi
834
+ INSTALL_STRIP_PROGRAM="\$(install_sh) -c -s"
835
+ AC_SUBST([INSTALL_STRIP_PROGRAM])])
836
+
837
+ # Copyright (C) 2006, 2008 Free Software Foundation, Inc.
838
+ #
839
+ # This file is free software; the Free Software Foundation
840
+ # gives unlimited permission to copy and/or distribute it,
841
+ # with or without modifications, as long as this notice is preserved.
842
+
843
+ # serial 2
844
+
845
+ # _AM_SUBST_NOTMAKE(VARIABLE)
846
+ # ---------------------------
847
+ # Prevent Automake from outputting VARIABLE = @VARIABLE@ in Makefile.in.
848
+ # This macro is traced by Automake.
849
+ AC_DEFUN([_AM_SUBST_NOTMAKE])
850
+
851
+ # AM_SUBST_NOTMAKE(VARIABLE)
852
+ # ---------------------------
853
+ # Public sister of _AM_SUBST_NOTMAKE.
854
+ AC_DEFUN([AM_SUBST_NOTMAKE], [_AM_SUBST_NOTMAKE($@)])
855
+
856
+ # Check how to create a tarball. -*- Autoconf -*-
857
+
858
+ # Copyright (C) 2004, 2005 Free Software Foundation, Inc.
859
+ #
860
+ # This file is free software; the Free Software Foundation
861
+ # gives unlimited permission to copy and/or distribute it,
862
+ # with or without modifications, as long as this notice is preserved.
863
+
864
+ # serial 2
865
+
866
+ # _AM_PROG_TAR(FORMAT)
867
+ # --------------------
868
+ # Check how to create a tarball in format FORMAT.
869
+ # FORMAT should be one of `v7', `ustar', or `pax'.
870
+ #
871
+ # Substitute a variable $(am__tar) that is a command
872
+ # writing to stdout a FORMAT-tarball containing the directory
873
+ # $tardir.
874
+ # tardir=directory && $(am__tar) > result.tar
875
+ #
876
+ # Substitute a variable $(am__untar) that extract such
877
+ # a tarball read from stdin.
878
+ # $(am__untar) < result.tar
879
+ AC_DEFUN([_AM_PROG_TAR],
880
+ [# Always define AMTAR for backward compatibility.
881
+ AM_MISSING_PROG([AMTAR], [tar])
882
+ m4_if([$1], [v7],
883
+ [am__tar='${AMTAR} chof - "$$tardir"'; am__untar='${AMTAR} xf -'],
884
+ [m4_case([$1], [ustar],, [pax],,
885
+ [m4_fatal([Unknown tar format])])
886
+ AC_MSG_CHECKING([how to create a $1 tar archive])
887
+ # Loop over all known methods to create a tar archive until one works.
888
+ _am_tools='gnutar m4_if([$1], [ustar], [plaintar]) pax cpio none'
889
+ _am_tools=${am_cv_prog_tar_$1-$_am_tools}
890
+ # Do not fold the above two line into one, because Tru64 sh and
891
+ # Solaris sh will not grok spaces in the rhs of `-'.
892
+ for _am_tool in $_am_tools
893
+ do
894
+ case $_am_tool in
895
+ gnutar)
896
+ for _am_tar in tar gnutar gtar;
897
+ do
898
+ AM_RUN_LOG([$_am_tar --version]) && break
899
+ done
900
+ am__tar="$_am_tar --format=m4_if([$1], [pax], [posix], [$1]) -chf - "'"$$tardir"'
901
+ am__tar_="$_am_tar --format=m4_if([$1], [pax], [posix], [$1]) -chf - "'"$tardir"'
902
+ am__untar="$_am_tar -xf -"
903
+ ;;
904
+ plaintar)
905
+ # Must skip GNU tar: if it does not support --format= it doesn't create
906
+ # ustar tarball either.
907
+ (tar --version) >/dev/null 2>&1 && continue
908
+ am__tar='tar chf - "$$tardir"'
909
+ am__tar_='tar chf - "$tardir"'
910
+ am__untar='tar xf -'
911
+ ;;
912
+ pax)
913
+ am__tar='pax -L -x $1 -w "$$tardir"'
914
+ am__tar_='pax -L -x $1 -w "$tardir"'
915
+ am__untar='pax -r'
916
+ ;;
917
+ cpio)
918
+ am__tar='find "$$tardir" -print | cpio -o -H $1 -L'
919
+ am__tar_='find "$tardir" -print | cpio -o -H $1 -L'
920
+ am__untar='cpio -i -H $1 -d'
921
+ ;;
922
+ none)
923
+ am__tar=false
924
+ am__tar_=false
925
+ am__untar=false
926
+ ;;
927
+ esac
928
+
929
+ # If the value was cached, stop now. We just wanted to have am__tar
930
+ # and am__untar set.
931
+ test -n "${am_cv_prog_tar_$1}" && break
932
+
933
+ # tar/untar a dummy directory, and stop if the command works
934
+ rm -rf conftest.dir
935
+ mkdir conftest.dir
936
+ echo GrepMe > conftest.dir/file
937
+ AM_RUN_LOG([tardir=conftest.dir && eval $am__tar_ >conftest.tar])
938
+ rm -rf conftest.dir
939
+ if test -s conftest.tar; then
940
+ AM_RUN_LOG([$am__untar <conftest.tar])
941
+ grep GrepMe conftest.dir/file >/dev/null 2>&1 && break
942
+ fi
943
+ done
944
+ rm -rf conftest.dir
945
+
946
+ AC_CACHE_VAL([am_cv_prog_tar_$1], [am_cv_prog_tar_$1=$_am_tool])
947
+ AC_MSG_RESULT([$am_cv_prog_tar_$1])])
948
+ AC_SUBST([am__tar])
949
+ AC_SUBST([am__untar])
950
+ ]) # _AM_PROG_TAR
951
+
952
+ m4_include([m4/libtool.m4])
953
+ m4_include([m4/ltoptions.m4])
954
+ m4_include([m4/ltsugar.m4])
955
+ m4_include([m4/ltversion.m4])
956
+ m4_include([m4/lt~obsolete.m4])