MEMCACHED_RETURN_T(3)

📦
version 1.1.4 · 12 versions
, in fedora 43

💖 MEMCACHED_RETURN_T 💖

okay bestie, welcome to MEMCACHED_RETURN_T(3) — this one's from libmemcached-awesome and it's literally just the encyclopedia of every return value the library can hand back to you. every success, every fail, every "girl what happened". it's giving receipts. 🧾✨

🌸 NAME 🌸

memcached_return_t — return type values. aka the whole mood ring of libmemcached. 💅

🦋 SYNOPSIS 🦋

first things first, include the header and link the lib, no skipping:

#include <libmemcached/memcached.h>
       Compile and link with -lmemcached

then you got your four vibe-checker functions, all taking a memcached_return_t rc and handing you back a bool:

bool memcached_success(memcached_return_t rc)

bool memcached_continue(memcached_return_t rc)

bool memcached_failed(memcached_return_t rc)

bool memcached_fatal(memcached_return_t rc)

and the type itself is just an enum wearing a lil typedef hat:

typedef enum memcached_return_t memcached_return_t

enum memcached_return_t

✨ the enumerators, aka the whole cast ✨

every single one, in order, no skips, no cuts. 👑

  • MEMCACHED_AUTH_CONTINUE — authentication has been paused. it's not over, it's just on hold bestie.
  • MEMCACHED_AUTH_FAILURE — the credentials you handed over are not valid for this server. wrong password energy fr.
  • MEMCACHED_AUTH_PROBLEM — something unknown went sideways during authentication. no idea what, just chaos. 😭
  • MEMCACHED_BAD_KEY_PROVIDED — the key you gave is not a valid key. not a key, bestie.
  • MEMCACHED_BUFFERED — the request has been buffered. it's chilling in the queue, it'll go. 🫶
  • MEMCACHED_CLIENT_ERROR — an unknown client error popped off internally. internally, mind you.
  • MEMCACHED_CONNECTION_BIND_FAILURE — deprecated since version <0.30. back in the day this meant we were not able to bind() to the socket. rip to her. 🪦
  • MEMCACHED_CONNECTION_FAILURE — an unknown error went down while trying to connect to a server. 💀
  • MEMCACHED_CONNECTION_SOCKET_CREATE_FAILURE — deprecated since version <0.30. an error happened while trying to connect to a server. it's likely that either the number of file descriptors need to be increased or you are out of memory. so like, either raise your fd limit or free some RAM.
  • MEMCACHED_DATA_DOES_NOT_EXIST — the data you asked for with that key was not found. it's simply not there. 🙈
  • MEMCACHED_DATA_EXISTS — the data requested with the key given was not found. yes bestie that is literally what it says, I am not editorializing, this is a real line in the real docs 💀
  • MEMCACHED_DELETED — the object requested by the key has been deleted. gone. bye. ✨
  • MEMCACHED_DEPRECATED — the method you requested has been deprecated. it's giving vintage.
  • MEMCACHED_E2BIG — item is too large for the server to store. too big, bestie, it does not fit.
  • MEMCACHED_END — the server has completed returning all of the objects requested. that's a wrap, that's the end of the list, slay. 🎀
  • MEMCACHED_ERRNO — an error happened in the driver, and the driver went and set errno. go check it. 🔍
  • MEMCACHED_FAIL_UNIX_SOCKET — a connection was not established with the server via a unix domain socket. no socket, no service.
  • MEMCACHED_FAILURE — deprecated since version <0.30. an unknown failure happened in the server. (grammar is "a unknown" in the source, we keep it, we love it 🫶)
  • MEMCACHED_FETCH_NOTFINISHED — a request has been made, but the server has not finished the fetch of the last request. hold on, she's still working.
  • MEMCACHED_HOST_LOOKUP_FAILURE — a DNS failure has occurred. the name did not resolve, the vibes did not resolve. 🌐
  • MEMCACHED_INVALID_ARGUMENTS — the arguments supplied to the given function were not valid. check your args bestie.
  • MEMCACHED_INVALID_HOST_PROTOCOL — the server you're connecting to has an invalid protocol. most likely you are connecting to an older server that does not speak the binary protocol. she's old, she doesn't speak the language.
  • MEMCACHED_ITEM — an item has been fetched (this is an internal error only).
  • MEMCACHED_KEY_TOO_BIG — the key you provided is too large for the given server. big key, small server.
  • MEMCACHED_MAXIMUM_RETURN — this in an internal only state. (yes, "this in an" — verbatim, keeping it 💅)
  • MEMCACHED_MEMORY_ALLOCATION_FAILURE — an error happened while trying to allocate memory. oom moment. 😭
  • MEMCACHED_NO_KEY_PROVIDED — deprecated since version <0.30: use MEMCACHED_BAD_KEY_PROVIDED instead. no key was provided. zero keys. none. nada.
  • MEMCACHED_NO_SERVERS — no servers have been added to the memcached_st object. you have an empty roster, bestie.
  • MEMCACHED_NOTFOUND — the object requested was not found. 🔎
  • MEMCACHED_NOTSTORED — the request to store an object failed. it did not go in the box. 📦
  • MEMCACHED_NOT_SUPPORTED — the given method is not supported in the server. not a thing here.
  • MEMCACHED_PARSE_ERROR — an error happened while trying to parse the configuration string. you should use memparse to determine what the error was. 🔧
  • MEMCACHED_PARSE_USER_ERROR — an error happened in parsing the configuration string. (that's "occurred in" with two spaces in the source — iconic, untouched ✨)
  • MEMCACHED_PARTIAL_READ — the read was only partially successful. half a read. not nothing, but not everything.
  • MEMCACHED_PROTOCOL_ERROR — an unknown error happened in the protocol. 🤷
  • MEMCACHED_READ_FAILURE — a read failure has occurred. 📖❌
  • MEMCACHED_SERVER_ERROR — an unknown error happened in the server. not your fault, it's the server's.
  • MEMCACHED_SERVER_MARKED_DEAD — the requested server has been marked dead. she's dead, bestie. marked and everything. 🪦
  • MEMCACHED_SOME_ERRORS — a multi request has been made, and some undetermined number of errors have occurred. how many? unclear. but there are some.
  • MEMCACHED_STAT — a "stat" command has been returned in the protocol. 📊
  • MEMCACHED_STORED — the requested object has been successfully stored on the server. ATE. 💅
  • MEMCACHED_SUCCESS — the request was successfully executed. the good one. the moment. we love to see it. 👑
  • MEMCACHED_TIMEOUT — operation has timed out. ⏰
  • MEMCACHED_UNKNOWN_READ_FAILURE — an unknown read failure only occurs when either there is a bug in the server, or in rare cases where an ethernet nic is reporting dubious information. dubious information. that's the phrase. take it in.
  • MEMCACHED_UNKNOWN_STAT_KEY — the server you're communicating with has a stat key which has not be defined in the protocol. ("has not be defined" — verbatim, we stan 🫶)
  • MEMCACHED_VALUE — a value has been returned from the server (this is an internal condition only).
  • MEMCACHED_WRITE_FAILURE — an error happened while trying to write to a server. ✍️❌

🔗 SEE ALSO 🔗

go read the rest of the fam, they're all right here:

quick lil reminder bestie: nothing here is made up and nothing here is left out — every enumerator, every deprecation, every typo, all of it is exactly as the original says. the vibes are mine, the facts are hers. 🫶

okay that's the whole page, you ate, go #include <libmemcached/memcached.h> and handle your return codes like the main character you are. 💖

— signed, sealed, and shipped with libmemcached-awesome, version 1.1, dated Jul 24, 2025 ✨🎀💅

📦 where this page comes from