:orphan:

.. index:: pair: struct; tapi_memcached_opt
.. _doxid-structtapi__memcached__opt:

struct tapi_memcached_opt
=========================

.. toctree::
	:hidden:

Overview
~~~~~~~~

Specific memcached options. :ref:`More...<details-structtapi__memcached__opt>`


.. ref-code-block:: cpp
	:class: doxyrest-overview-code-block

	#include <tapi_memcached.h>
	
	struct tapi_memcached_opt {
		// fields
	
		bool :ref:`maxconns_fast<doxid-structtapi__memcached__opt_1aed02ee0aafe22206833497755ab3c006>`;
		bool :ref:`no_maxconns_fast<doxid-structtapi__memcached__opt_1a82cfc1f3272490435a5bc21c226ad13c>`;
		:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` :ref:`hashpower<doxid-structtapi__memcached__opt_1aa48c76c3bd8020e287f038f5fdfe532d>`;
		:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` :ref:`tail_repair_time<doxid-structtapi__memcached__opt_1a31b50d7cb5a15a36a3f28593f87010b5>`;
		bool :ref:`no_lru_crawler<doxid-structtapi__memcached__opt_1a6d75d38a09199feed555feae752ddf66>`;
		:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` :ref:`lru_crawler_sleep<doxid-structtapi__memcached__opt_1a7c2984f0f91ff5d1a3f0c1455b135c31>`;
		:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` :ref:`lru_crawler_tocrawl<doxid-structtapi__memcached__opt_1ab77b380c29f84e61434685e1cd5546b5>`;
		bool :ref:`no_lru_maintainer<doxid-structtapi__memcached__opt_1ab9ee4df57ec4acaaaa671d1d58ad2c6f>`;
		:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` :ref:`hot_lru_pct<doxid-structtapi__memcached__opt_1a3f372c999ed4b233fb718bd282139126>`;
		:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` :ref:`warm_lru_pct<doxid-structtapi__memcached__opt_1ac85191e3ca2793c4c352bd325638d9ec>`;
		:ref:`tapi_job_opt_double_t<doxid-group__tapi__job__opt_1gaee9f6ff157633a98216ac591fec50609>` :ref:`hot_max_factor<doxid-structtapi__memcached__opt_1a04276c5131c9d0c41ee6deccdcfd485b>`;
		:ref:`tapi_job_opt_double_t<doxid-group__tapi__job__opt_1gaee9f6ff157633a98216ac591fec50609>` :ref:`warm_max_factor<doxid-structtapi__memcached__opt_1a88e6459029541bbbd69fc63d8c21e72c>`;
		:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` :ref:`temporary_ttl<doxid-structtapi__memcached__opt_1a5ae39c670ff847ae003554dfc2b9d3ac>`;
		:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` :ref:`idle_timeout<doxid-structtapi__memcached__opt_1ae286b58b134be635c298d689cf346e27>`;
		:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` :ref:`watcher_logbuf_size<doxid-structtapi__memcached__opt_1a26b1e3fa3bf0837357838d8c3886cde2>`;
		:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` :ref:`worker_logbuf_size<doxid-structtapi__memcached__opt_1afbf9225e441b1e348149c917b3a10421>`;
		bool :ref:`track_sizes<doxid-structtapi__memcached__opt_1a8b4db532f7c95904fbf1846562e0ecc8>`;
		bool :ref:`no_hashexpand<doxid-structtapi__memcached__opt_1a2a9315f9b70670232aa24490f9d7a5e0>`;
		struct tapi_memcached_opt::@85 :ref:`ext_path<doxid-structtapi__memcached__opt_1a7071eccb99483ad27f432a18484cc043>`;
		:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` :ref:`ext_page_size<doxid-structtapi__memcached__opt_1a957141b5116e79fcfb6cebb32a3abd90>`;
		:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` :ref:`ext_wbuf_size<doxid-structtapi__memcached__opt_1a27a0c52b8a2dae566e442515617d0aeb>`;
		:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` :ref:`ext_threads<doxid-structtapi__memcached__opt_1a0d824fd9170a66c7874f197757990bd5>`;
		:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` :ref:`ext_item_size<doxid-structtapi__memcached__opt_1a0bc4f1934e14a815942e1050a477b0cc>`;
		:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` :ref:`ext_item_age<doxid-structtapi__memcached__opt_1a0f571c1976492dc14b100fabb9c07909>`;
		:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` :ref:`ext_low_ttl<doxid-structtapi__memcached__opt_1a99b55395702ef17d026d0239b617a381>`;
		bool :ref:`ext_drop_unread<doxid-structtapi__memcached__opt_1a8b246bef41071d10c86d784881fa6945>`;
		:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` :ref:`ext_recache_rate<doxid-structtapi__memcached__opt_1a2bc87f8abb4f08704c7348a0f0e1e2cd>`;
		:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` :ref:`ext_compact_under<doxid-structtapi__memcached__opt_1a363f35ba3b9b650e123b347a3bfa8027>`;
		:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` :ref:`ext_drop_under<doxid-structtapi__memcached__opt_1a6ddfca74f2f6b91a43d6ec94992817a3>`;
		:ref:`tapi_job_opt_double_t<doxid-group__tapi__job__opt_1gaee9f6ff157633a98216ac591fec50609>` :ref:`ext_max_frag<doxid-structtapi__memcached__opt_1add6ed33252a9c29b5a442828f42df06b>`;
		:ref:`tapi_job_opt_double_t<doxid-group__tapi__job__opt_1gaee9f6ff157633a98216ac591fec50609>` :ref:`slab_automove_freeratio<doxid-structtapi__memcached__opt_1a5c6697fa224774822a09d758582ca1a3>`;
		const char* :ref:`unix_socket<doxid-structtapi__memcached__opt_1a81168c9e8a014437769b01cd33f811f8>`;
		bool :ref:`enable_ascii_shutdown<doxid-structtapi__memcached__opt_1ae414839711937773bd0f077fca982740>`;
		:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` :ref:`unix_mask<doxid-structtapi__memcached__opt_1a185fe332482b0ca95288749c52fe3717>`;
		const struct sockaddr* :ref:`listen_ipaddr<doxid-structtapi__memcached__opt_1a32127e04149ac6f293aab625ed045dd5>`;
		const char* :ref:`username<doxid-structtapi__memcached__opt_1a0ab6cc1a52d5d9b51e6f93c09a43b689>`;
		:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` :ref:`memory_limit<doxid-structtapi__memcached__opt_1a54621283c00b6e6cbec1126511e30117>`;
		:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` :ref:`conn_limit<doxid-structtapi__memcached__opt_1a4eb3df531167a8cde92f5539b2b44762>`;
		:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` :ref:`max_reqs_per_event<doxid-structtapi__memcached__opt_1af472269597a207a64603e65c7777f30f>`;
		bool :ref:`lock_memory<doxid-structtapi__memcached__opt_1a6864e222592034830855402452de7547>`;
		const struct sockaddr* :ref:`tcp_port<doxid-structtapi__memcached__opt_1a1959dc3369e7441fc5d29d3086c1dcf0>`;
		const struct sockaddr* :ref:`udp_port<doxid-structtapi__memcached__opt_1a8dafc6602de327b81e492b07a6a01b20>`;
		bool :ref:`disable_evictions<doxid-structtapi__memcached__opt_1a8584ac33ebb0d20fe26339eabbe4ba46>`;
		bool :ref:`enable_coredumps<doxid-structtapi__memcached__opt_1afa85a241836173d66defe8e3ac6625c4>`;
		:ref:`tapi_job_opt_double_t<doxid-group__tapi__job__opt_1gaee9f6ff157633a98216ac591fec50609>` :ref:`slab_growth_factor<doxid-structtapi__memcached__opt_1a18093e41d83b01248b14d9c34a523338>`;
		:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` :ref:`slab_min_size<doxid-structtapi__memcached__opt_1a839b09ccd56e119e3312a9bdf6d4da46>`;
		bool :ref:`disable_cas<doxid-structtapi__memcached__opt_1af877f8581303cbdbf1f760373a7c8295>`;
		:ref:`tapi_mamcached_verbose_t<doxid-group__tapi__memcached_1ga2293656d27dd40f0931feb09f8714ee2>` :ref:`verbose<doxid-structtapi__memcached__opt_1accf10954156639c54593bc9eb6ce7570>`;
		:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` :ref:`threads<doxid-structtapi__memcached__opt_1a731b9ac8d5c113d38136fcfccfdeeac1>`;
		:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` :ref:`napi_ids<doxid-structtapi__memcached__opt_1aa8d2efbd532bd7d65cd9a5a974a3044e>`;
		const char* :ref:`delimiter<doxid-structtapi__memcached__opt_1a71f1bb1161f7405c256029e06277c213>`;
		bool :ref:`enable_largepages<doxid-structtapi__memcached__opt_1a0f27377e8bf750fd1373fbabca29e78e>`;
		:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` :ref:`listen_backlog<doxid-structtapi__memcached__opt_1a2b03903a58a4bea913c178145b37b829>`;
		:ref:`tapi_mamcached_proto_t<doxid-group__tapi__memcached_1gac61bd08b0d0f5345ca14e293087eea9b>` :ref:`protocol<doxid-structtapi__memcached__opt_1a1155e58c4e7cf65aae574fdf5cd5fd39>`;
		:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` :ref:`max_item_size<doxid-structtapi__memcached__opt_1a7aafdcb733b2ea7e623e8df0cca0e620>`;
		bool :ref:`enable_sasl<doxid-structtapi__memcached__opt_1a96b843c03a6fb4ce41c27be113b1b2d4>`;
		bool :ref:`disable_flush_all<doxid-structtapi__memcached__opt_1a184f735fecf1faaf40ff2b9cafdb54eb>`;
		bool :ref:`disable_dumping<doxid-structtapi__memcached__opt_1afb87e277a9870cab0db9fbff2649b499>`;
		bool :ref:`disable_watch<doxid-structtapi__memcached__opt_1a6a5d2fe89042821f938ae9a29496c08b>`;
		const char* :target:`path<doxid-structtapi__memcached__opt_1a3d712ff8ba97e422a6e764bc17af1412>`;
		:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` :target:`size<doxid-structtapi__memcached__opt_1abf7e83dd0051324639f504dde3824a14>`;
		const char* :ref:`memcached_path<doxid-structtapi__memcached__opt_1a1508644f2b90d350f9ec9208497f91e7>`;
	};
.. _details-structtapi__memcached__opt:

Detailed Documentation
~~~~~~~~~~~~~~~~~~~~~~

Specific memcached options.

Fields
------

.. index:: pair: variable; maxconns_fast
.. _doxid-structtapi__memcached__opt_1aed02ee0aafe22206833497755ab3c006:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	bool maxconns_fast

Immediately close new connections after limit.

.. index:: pair: variable; no_maxconns_fast
.. _doxid-structtapi__memcached__opt_1a82cfc1f3272490435a5bc21c226ad13c:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	bool no_maxconns_fast

Cancel maxconns_fast option.

.. index:: pair: variable; hashpower
.. _doxid-structtapi__memcached__opt_1aa48c76c3bd8020e287f038f5fdfe532d:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` hashpower

An integer multiplier for how large the hash table should be. Normally grows at runtime. Set based on "STAT hash_power_level".

.. index:: pair: variable; tail_repair_time
.. _doxid-structtapi__memcached__opt_1a31b50d7cb5a15a36a3f28593f87010b5:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` tail_repair_time

Time in seconds for how long to wait before forcefully killing LRU tail item. Very dangerous option!

.. index:: pair: variable; no_lru_crawler
.. _doxid-structtapi__memcached__opt_1a6d75d38a09199feed555feae752ddf66:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	bool no_lru_crawler

Disable LRU Crawler background thread.

.. index:: pair: variable; lru_crawler_sleep
.. _doxid-structtapi__memcached__opt_1a7c2984f0f91ff5d1a3f0c1455b135c31:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` lru_crawler_sleep

Microseconds to sleep between items.

.. index:: pair: variable; lru_crawler_tocrawl
.. _doxid-structtapi__memcached__opt_1ab77b380c29f84e61434685e1cd5546b5:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` lru_crawler_tocrawl

Max items to crawl per slab per run (if 0 then unlimited).

.. index:: pair: variable; no_lru_maintainer
.. _doxid-structtapi__memcached__opt_1ab9ee4df57ec4acaaaa671d1d58ad2c6f:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	bool no_lru_maintainer

Disable new LRU system + background thread.

.. index:: pair: variable; hot_lru_pct
.. _doxid-structtapi__memcached__opt_1a3f372c999ed4b233fb718bd282139126:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` hot_lru_pct

pct of slab memory to reserve for hot lru. Requires lru_maintainer.

.. index:: pair: variable; warm_lru_pct
.. _doxid-structtapi__memcached__opt_1ac85191e3ca2793c4c352bd325638d9ec:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` warm_lru_pct

pct of slab memory to reserve for warm lru. Requires lru_maintainer.

.. index:: pair: variable; hot_max_factor
.. _doxid-structtapi__memcached__opt_1a04276c5131c9d0c41ee6deccdcfd485b:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`tapi_job_opt_double_t<doxid-group__tapi__job__opt_1gaee9f6ff157633a98216ac591fec50609>` hot_max_factor

Items idle > cold lru age \* drop from hot lru.

.. index:: pair: variable; warm_max_factor
.. _doxid-structtapi__memcached__opt_1a88e6459029541bbbd69fc63d8c21e72c:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`tapi_job_opt_double_t<doxid-group__tapi__job__opt_1gaee9f6ff157633a98216ac591fec50609>` warm_max_factor

Items idle > cold lru age \* this drop from warm.

.. index:: pair: variable; temporary_ttl
.. _doxid-structtapi__memcached__opt_1a5ae39c670ff847ae003554dfc2b9d3ac:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` temporary_ttl

TTL's below get separate LRU, can't be evicted. Requires lru_maintainer.

.. index:: pair: variable; idle_timeout
.. _doxid-structtapi__memcached__opt_1ae286b58b134be635c298d689cf346e27:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` idle_timeout

Timeout for idle connections (if 0 then no timeout).

.. index:: pair: variable; watcher_logbuf_size
.. _doxid-structtapi__memcached__opt_1a26b1e3fa3bf0837357838d8c3886cde2:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` watcher_logbuf_size

Size in kilobytes of per-watcher write buffer.

.. index:: pair: variable; worker_logbuf_size
.. _doxid-structtapi__memcached__opt_1afbf9225e441b1e348149c917b3a10421:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` worker_logbuf_size

Size in kilobytes of per-worker-thread buffer read by background thread, then written to watchers.

.. index:: pair: variable; track_sizes
.. _doxid-structtapi__memcached__opt_1a8b4db532f7c95904fbf1846562e0ecc8:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	bool track_sizes

Enable dynamic reports for 'stats sizes' command.

.. index:: pair: variable; no_hashexpand
.. _doxid-structtapi__memcached__opt_1a2a9315f9b70670232aa24490f9d7a5e0:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	bool no_hashexpand

Disables hash table expansion. Dangerous!

.. index:: pair: variable; ext_path
.. _doxid-structtapi__memcached__opt_1a7071eccb99483ad27f432a18484cc043:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	unnamed-struct ext_path

File to write to for external storage.

Example: ``"ext_path=/mnt/d1/extstore:1G"``. This initializes extstore with up to 5 gigabytes of storage. Storage is split internally into pages size of ``ext_page_size``.

.. index:: pair: variable; ext_page_size
.. _doxid-structtapi__memcached__opt_1a957141b5116e79fcfb6cebb32a3abd90:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` ext_page_size

Size of storage pages, in megabytes.

.. index:: pair: variable; ext_wbuf_size
.. _doxid-structtapi__memcached__opt_1a27a0c52b8a2dae566e442515617d0aeb:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` ext_wbuf_size

Size of page write buffers, in megabytes.

.. index:: pair: variable; ext_threads
.. _doxid-structtapi__memcached__opt_1a0d824fd9170a66c7874f197757990bd5:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` ext_threads

Number of IO threads to run.

If you have a high read latency but the drive is idle, you can increase this number. Stick to low values; no more than 8 threads.

.. index:: pair: variable; ext_item_size
.. _doxid-structtapi__memcached__opt_1a0bc4f1934e14a815942e1050a477b0cc:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` ext_item_size

Store items larger than this, in bytes.

Items larger than this can be flushed. You can lower this value if you want to save a little extra RAM and your keys are short. You can also raise this value if you only wish to flush very large objects, which is a good place to start.

.. index:: pair: variable; ext_item_age
.. _doxid-structtapi__memcached__opt_1a0f571c1976492dc14b100fabb9c07909:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` ext_item_age

Store items idle at least this long, in seconds. If not used then no age limit.

.. index:: pair: variable; ext_low_ttl
.. _doxid-structtapi__memcached__opt_1a99b55395702ef17d026d0239b617a381:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` ext_low_ttl

Consider TTLs lower than this specially.

.. index:: pair: variable; ext_drop_unread
.. _doxid-structtapi__memcached__opt_1a8b246bef41071d10c86d784881fa6945:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	bool ext_drop_unread

Don't re-write unread values during compaction.

.. index:: pair: variable; ext_recache_rate
.. _doxid-structtapi__memcached__opt_1a2bc87f8abb4f08704c7348a0f0e1e2cd:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` ext_recache_rate

Recache an item every N accesses.

If an item stored on flash has been accessed more than once in the last minute, it has a one in N chance of being recached into RAM and removed from flash. It's good to keep this value high; recaches into RAM cause fragmentation on disk, and it's rare for objects in flash to become frequently accessed. If they do, they will eventually be recached.

.. index:: pair: variable; ext_compact_under
.. _doxid-structtapi__memcached__opt_1a363f35ba3b9b650e123b347a3bfa8027:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` ext_compact_under

Compact when fewer than this many free pages.

.. index:: pair: variable; ext_drop_under
.. _doxid-structtapi__memcached__opt_1a6ddfca74f2f6b91a43d6ec94992817a3:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` ext_drop_under

Drop COLD items when fewer than this many free pages.

.. index:: pair: variable; ext_max_frag
.. _doxid-structtapi__memcached__opt_1add6ed33252a9c29b5a442828f42df06b:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`tapi_job_opt_double_t<doxid-group__tapi__job__opt_1gaee9f6ff157633a98216ac591fec50609>` ext_max_frag

Max page fragmentation to tolerate.

Example: "ext_max_frag=0.5" This will rewrite pages which are at least half empty. If no pages are half empty, the oldest page will be evicted.

.. index:: pair: variable; slab_automove_freeratio
.. _doxid-structtapi__memcached__opt_1a5c6697fa224774822a09d758582ca1a3:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`tapi_job_opt_double_t<doxid-group__tapi__job__opt_1gaee9f6ff157633a98216ac591fec50609>` slab_automove_freeratio

Ratio of memory to hold free as buffer.

.. index:: pair: variable; unix_socket
.. _doxid-structtapi__memcached__opt_1a81168c9e8a014437769b01cd33f811f8:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	const char* unix_socket

Unix socket path to listen on (disables network support).

.. index:: pair: variable; enable_ascii_shutdown
.. _doxid-structtapi__memcached__opt_1ae414839711937773bd0f077fca982740:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	bool enable_ascii_shutdown

Enable ascii "shutdown" command.

.. index:: pair: variable; unix_mask
.. _doxid-structtapi__memcached__opt_1a185fe332482b0ca95288749c52fe3717:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` unix_mask

Permissions (in octal form) for Unix socket created with -s option.

.. index:: pair: variable; listen_ipaddr
.. _doxid-structtapi__memcached__opt_1a32127e04149ac6f293aab625ed045dd5:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	const struct sockaddr* listen_ipaddr

Listen on ``ip_addr``.

.. index:: pair: variable; username
.. _doxid-structtapi__memcached__opt_1a0ab6cc1a52d5d9b51e6f93c09a43b689:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	const char* username

Assume the identity of ``username``.

.. index:: pair: variable; memory_limit
.. _doxid-structtapi__memcached__opt_1a54621283c00b6e6cbec1126511e30117:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` memory_limit

Memory usage in MB.

.. index:: pair: variable; conn_limit
.. _doxid-structtapi__memcached__opt_1a4eb3df531167a8cde92f5539b2b44762:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` conn_limit

Max simultaneous connections.

.. index:: pair: variable; max_reqs_per_event
.. _doxid-structtapi__memcached__opt_1af472269597a207a64603e65c7777f30f:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` max_reqs_per_event

Once a connection exceeds this number of consecutive requests, the server will try to process I/O on other connections before processing any further requests from that connection.

.. index:: pair: variable; lock_memory
.. _doxid-structtapi__memcached__opt_1a6864e222592034830855402452de7547:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	bool lock_memory

Lock down all paged memory. This is a somewhat dangerous option with large caches.

.. index:: pair: variable; tcp_port
.. _doxid-structtapi__memcached__opt_1a1959dc3369e7441fc5d29d3086c1dcf0:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	const struct sockaddr* tcp_port

TCP port to listen on (0 by default, 0 to turn off).

To set 0 use ``zero_sockaddr``.

.. index:: pair: variable; udp_port
.. _doxid-structtapi__memcached__opt_1a8dafc6602de327b81e492b07a6a01b20:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	const struct sockaddr* udp_port

UDP port to listen on (0 by default, 0 to turn off).

To set 0 use ``zero_sockaddr``.

.. index:: pair: variable; disable_evictions
.. _doxid-structtapi__memcached__opt_1a8584ac33ebb0d20fe26339eabbe4ba46:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	bool disable_evictions

Disable automatic removal of items from the cache when out of memory. Additions will not be possible until adequate space is freed up.

.. index:: pair: variable; enable_coredumps
.. _doxid-structtapi__memcached__opt_1afa85a241836173d66defe8e3ac6625c4:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	bool enable_coredumps

Raise the core file size limit to the maximum allowable.

.. index:: pair: variable; slab_growth_factor
.. _doxid-structtapi__memcached__opt_1a18093e41d83b01248b14d9c34a523338:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`tapi_job_opt_double_t<doxid-group__tapi__job__opt_1gaee9f6ff157633a98216ac591fec50609>` slab_growth_factor

A lower value may result in less wasted memory depending on the total amount of memory available and the distribution of item sizes.

.. index:: pair: variable; slab_min_size
.. _doxid-structtapi__memcached__opt_1a839b09ccd56e119e3312a9bdf6d4da46:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` slab_min_size

Allocate a minimum of ``size`` bytes for the item key, value, and flags.

.. index:: pair: variable; disable_cas
.. _doxid-structtapi__memcached__opt_1af877f8581303cbdbf1f760373a7c8295:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	bool disable_cas

Disable the use of CAS (and reduce the per-item size by 8 bytes).

.. index:: pair: variable; verbose
.. _doxid-structtapi__memcached__opt_1accf10954156639c54593bc9eb6ce7570:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`tapi_mamcached_verbose_t<doxid-group__tapi__memcached_1ga2293656d27dd40f0931feb09f8714ee2>` verbose

Be verbose during the event loop. Print out errors and warnings (none by default).

.. index:: pair: variable; threads
.. _doxid-structtapi__memcached__opt_1a731b9ac8d5c113d38136fcfccfdeeac1:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` threads

Number of threads to use to process incoming requests.

.. index:: pair: variable; napi_ids
.. _doxid-structtapi__memcached__opt_1aa8d2efbd532bd7d65cd9a5a974a3044e:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` napi_ids

Number of NAPI ids (see napi_ids.txt in memcached docs for details)

.. index:: pair: variable; delimiter
.. _doxid-structtapi__memcached__opt_1a71f1bb1161f7405c256029e06277c213:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	const char* delimiter

One char delimiter between key prefixes and IDs. This is used for per-prefix stats reporting.

.. index:: pair: variable; enable_largepages
.. _doxid-structtapi__memcached__opt_1a0f27377e8bf750fd1373fbabca29e78e:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	bool enable_largepages

Try to use large memory pages (if available). Increasing the memory page size could reduce the number of TLB misses and improve the performance.

.. index:: pair: variable; listen_backlog
.. _doxid-structtapi__memcached__opt_1a2b03903a58a4bea913c178145b37b829:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` listen_backlog

Set the backlog queue limit to number of connections.

.. index:: pair: variable; protocol
.. _doxid-structtapi__memcached__opt_1a1155e58c4e7cf65aae574fdf5cd5fd39:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`tapi_mamcached_proto_t<doxid-group__tapi__memcached_1gac61bd08b0d0f5345ca14e293087eea9b>` protocol

Specify the binding protocol to use ("auto" by default).

.. index:: pair: variable; max_item_size
.. _doxid-structtapi__memcached__opt_1a7aafdcb733b2ea7e623e8df0cca0e620:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`tapi_job_opt_uint_t<doxid-group__tapi__job__opt_1ga6029f81fe926f3cb1d5a63c02b06d8b9>` max_item_size

Override the default size of each slab page in Kilobytes.

.. index:: pair: variable; enable_sasl
.. _doxid-structtapi__memcached__opt_1a96b843c03a6fb4ce41c27be113b1b2d4:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	bool enable_sasl

Turn on SASL authentication. This option is only meaningful if memcached was compiled with SASL support enabled.

.. index:: pair: variable; disable_flush_all
.. _doxid-structtapi__memcached__opt_1a184f735fecf1faaf40ff2b9cafdb54eb:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	bool disable_flush_all

Disable the "flush_all" command. The cmd_flush counter will increment, but clients will receive an error message and the flush will not occur.

.. index:: pair: variable; disable_dumping
.. _doxid-structtapi__memcached__opt_1afb87e277a9870cab0db9fbff2649b499:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	bool disable_dumping

Disable the "stats cachedump" and "lru_crawler metadump" commands.

.. index:: pair: variable; disable_watch
.. _doxid-structtapi__memcached__opt_1a6a5d2fe89042821f938ae9a29496c08b:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	bool disable_watch

Disable watch commands (live logging).

.. index:: pair: variable; memcached_path
.. _doxid-structtapi__memcached__opt_1a1508644f2b90d350f9ec9208497f91e7:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	const char* memcached_path

Path to memcached exec (if ``NULL`` then "memcached").