]> git.saurik.com Git - redis.git/blame - src/redis.h
modified a bit addReply() to play better with copy on write now that we have a static...
[redis.git] / src / redis.h
CommitLineData
e2641e09 1#ifndef __REDIS_H
2#define __REDIS_H
3
4#include "fmacros.h"
5#include "config.h"
6
7#if defined(__sun)
8#include "solarisfixes.h"
9#endif
10
11#include <stdio.h>
12#include <stdlib.h>
13#include <string.h>
14#include <time.h>
15#include <limits.h>
16#include <unistd.h>
17#include <errno.h>
3688d7f3 18#include <inttypes.h>
d06a5b23 19#include <pthread.h>
e2641e09 20
21#include "ae.h" /* Event driven programming library */
22#include "sds.h" /* Dynamic safe strings */
23#include "dict.h" /* Hash tables */
24#include "adlist.h" /* Linked lists */
25#include "zmalloc.h" /* total memory usage aware version of malloc/free */
26#include "anet.h" /* Networking the easy way */
27#include "zipmap.h" /* Compact string -> string data structure */
28#include "ziplist.h" /* Compact list data structure */
96ffb2fe 29#include "intset.h" /* Compact integer set structure */
e2641e09 30#include "version.h"
31
32/* Error codes */
33#define REDIS_OK 0
34#define REDIS_ERR -1
35
36/* Static server configuration */
37#define REDIS_SERVERPORT 6379 /* TCP port */
38#define REDIS_MAXIDLETIME (60*5) /* default client timeout */
39#define REDIS_IOBUF_LEN 1024
40#define REDIS_LOADBUF_LEN 1024
41#define REDIS_STATIC_ARGS 8
42#define REDIS_DEFAULT_DBNUM 16
43#define REDIS_CONFIGLINE_MAX 1024
44#define REDIS_OBJFREELIST_MAX 1000000 /* Max number of objects to cache */
45#define REDIS_MAX_SYNC_TIME 60 /* Slave can't take more to sync */
46#define REDIS_EXPIRELOOKUPS_PER_CRON 10 /* lookup 10 expires per loop */
47#define REDIS_MAX_WRITE_PER_EVENT (1024*64)
48#define REDIS_REQUEST_MAX_SIZE (1024*1024*256) /* max bytes in inline command */
49#define REDIS_SHARED_INTEGERS 10000
36c19d03 50#define REDIS_REPLY_CHUNK_BYTES (5*1500) /* 5 TCP packets with default MTU */
834ef78e 51
e2641e09 52/* If more then REDIS_WRITEV_THRESHOLD write packets are pending use writev */
53#define REDIS_WRITEV_THRESHOLD 3
54/* Max number of iovecs used for each writev call */
55#define REDIS_WRITEV_IOVEC_COUNT 256
56
57/* Hash table parameters */
58#define REDIS_HT_MINFILL 10 /* Minimal hash table fill 10% */
59
60/* Command flags */
61#define REDIS_CMD_BULK 1 /* Bulk write command */
62#define REDIS_CMD_INLINE 2 /* Inline command */
63/* REDIS_CMD_DENYOOM reserves a longer comment: all the commands marked with
64 this flags will return an error when the 'maxmemory' option is set in the
65 config file and the server is using more than maxmemory bytes of memory.
66 In short this commands are denied on low memory conditions. */
67#define REDIS_CMD_DENYOOM 4
68#define REDIS_CMD_FORCE_REPLICATION 8 /* Force replication even if dirty is 0 */
69
70/* Object types */
71#define REDIS_STRING 0
72#define REDIS_LIST 1
73#define REDIS_SET 2
74#define REDIS_ZSET 3
75#define REDIS_HASH 4
76#define REDIS_VMPOINTER 8
77
78/* Objects encoding. Some kind of objects like Strings and Hashes can be
79 * internally represented in multiple ways. The 'encoding' field of the object
80 * is set to one of this fields for this object. */
81#define REDIS_ENCODING_RAW 0 /* Raw representation */
82#define REDIS_ENCODING_INT 1 /* Encoded as integer */
83#define REDIS_ENCODING_HT 2 /* Encoded as hash table */
84#define REDIS_ENCODING_ZIPMAP 3 /* Encoded as zipmap */
85#define REDIS_ENCODING_LINKEDLIST 4 /* Encoded as regular linked list */
86#define REDIS_ENCODING_ZIPLIST 5 /* Encoded as ziplist */
96ffb2fe 87#define REDIS_ENCODING_INTSET 6 /* Encoded as intset */
e2641e09 88
89/* Object types only used for dumping to disk */
90#define REDIS_EXPIRETIME 253
91#define REDIS_SELECTDB 254
92#define REDIS_EOF 255
93
94/* Defines related to the dump file format. To store 32 bits lengths for short
95 * keys requires a lot of space, so we check the most significant 2 bits of
96 * the first byte to interpreter the length:
97 *
98 * 00|000000 => if the two MSB are 00 the len is the 6 bits of this byte
99 * 01|000000 00000000 => 01, the len is 14 byes, 6 bits + 8 bits of next byte
100 * 10|000000 [32 bit integer] => if it's 01, a full 32 bit len will follow
101 * 11|000000 this means: specially encoded object will follow. The six bits
102 * number specify the kind of object that follows.
103 * See the REDIS_RDB_ENC_* defines.
104 *
105 * Lenghts up to 63 are stored using a single byte, most DB keys, and may
106 * values, will fit inside. */
107#define REDIS_RDB_6BITLEN 0
108#define REDIS_RDB_14BITLEN 1
109#define REDIS_RDB_32BITLEN 2
110#define REDIS_RDB_ENCVAL 3
111#define REDIS_RDB_LENERR UINT_MAX
112
113/* When a length of a string object stored on disk has the first two bits
114 * set, the remaining two bits specify a special encoding for the object
115 * accordingly to the following defines: */
116#define REDIS_RDB_ENC_INT8 0 /* 8 bit signed integer */
117#define REDIS_RDB_ENC_INT16 1 /* 16 bit signed integer */
118#define REDIS_RDB_ENC_INT32 2 /* 32 bit signed integer */
119#define REDIS_RDB_ENC_LZF 3 /* string compressed with FASTLZ */
120
121/* Virtual memory object->where field. */
122#define REDIS_VM_MEMORY 0 /* The object is on memory */
123#define REDIS_VM_SWAPPED 1 /* The object is on disk */
124#define REDIS_VM_SWAPPING 2 /* Redis is swapping this object on disk */
125#define REDIS_VM_LOADING 3 /* Redis is loading this object from disk */
126
127/* Virtual memory static configuration stuff.
128 * Check vmFindContiguousPages() to know more about this magic numbers. */
129#define REDIS_VM_MAX_NEAR_PAGES 65536
130#define REDIS_VM_MAX_RANDOM_JUMP 4096
131#define REDIS_VM_MAX_THREADS 32
132#define REDIS_THREAD_STACK_SIZE (1024*1024*4)
133/* The following is the *percentage* of completed I/O jobs to process when the
134 * handelr is called. While Virtual Memory I/O operations are performed by
135 * threads, this operations must be processed by the main thread when completed
136 * in order to take effect. */
137#define REDIS_MAX_COMPLETED_JOBS_PROCESSED 1
138
139/* Client flags */
140#define REDIS_SLAVE 1 /* This client is a slave server */
141#define REDIS_MASTER 2 /* This client is a master server */
142#define REDIS_MONITOR 4 /* This client is a slave monitor, see MONITOR */
143#define REDIS_MULTI 8 /* This client is in a MULTI context */
144#define REDIS_BLOCKED 16 /* The client is waiting in a blocking operation */
145#define REDIS_IO_WAIT 32 /* The client is waiting for Virtual Memory I/O */
146#define REDIS_DIRTY_CAS 64 /* Watched keys modified. EXEC will fail. */
147
148/* Slave replication state - slave side */
149#define REDIS_REPL_NONE 0 /* No active replication */
150#define REDIS_REPL_CONNECT 1 /* Must connect to master */
151#define REDIS_REPL_CONNECTED 2 /* Connected to master */
152
153/* Slave replication state - from the point of view of master
154 * Note that in SEND_BULK and ONLINE state the slave receives new updates
155 * in its output queue. In the WAIT_BGSAVE state instead the server is waiting
156 * to start the next background saving in order to send updates to it. */
157#define REDIS_REPL_WAIT_BGSAVE_START 3 /* master waits bgsave to start feeding it */
158#define REDIS_REPL_WAIT_BGSAVE_END 4 /* master waits bgsave to start bulk DB transmission */
159#define REDIS_REPL_SEND_BULK 5 /* master is sending the bulk DB */
160#define REDIS_REPL_ONLINE 6 /* bulk DB already transmitted, receive updates */
161
162/* List related stuff */
163#define REDIS_HEAD 0
164#define REDIS_TAIL 1
165
166/* Sort operations */
167#define REDIS_SORT_GET 0
168#define REDIS_SORT_ASC 1
169#define REDIS_SORT_DESC 2
170#define REDIS_SORTKEY_MAX 1024
171
172/* Log levels */
173#define REDIS_DEBUG 0
174#define REDIS_VERBOSE 1
175#define REDIS_NOTICE 2
176#define REDIS_WARNING 3
177
178/* Anti-warning macro... */
179#define REDIS_NOTUSED(V) ((void) V)
180
181#define ZSKIPLIST_MAXLEVEL 32 /* Should be enough for 2^32 elements */
182#define ZSKIPLIST_P 0.25 /* Skiplist P = 1/4 */
183
184/* Append only defines */
185#define APPENDFSYNC_NO 0
186#define APPENDFSYNC_ALWAYS 1
187#define APPENDFSYNC_EVERYSEC 2
188
189/* Zip structure related defaults */
190#define REDIS_HASH_MAX_ZIPMAP_ENTRIES 64
191#define REDIS_HASH_MAX_ZIPMAP_VALUE 512
192#define REDIS_LIST_MAX_ZIPLIST_ENTRIES 1024
193#define REDIS_LIST_MAX_ZIPLIST_VALUE 32
96ffb2fe 194#define REDIS_SET_MAX_INTSET_ENTRIES 4096
e2641e09 195
196/* Sets operations codes */
197#define REDIS_OP_UNION 0
198#define REDIS_OP_DIFF 1
199#define REDIS_OP_INTER 2
200
201/* We can print the stacktrace, so our assert is defined this way: */
202#define redisAssert(_e) ((_e)?(void)0 : (_redisAssert(#_e,__FILE__,__LINE__),_exit(1)))
203#define redisPanic(_e) _redisPanic(#_e,__FILE__,__LINE__),_exit(1)
204void _redisAssert(char *estr, char *file, int line);
205void _redisPanic(char *msg, char *file, int line);
206
207/*-----------------------------------------------------------------------------
208 * Data types
209 *----------------------------------------------------------------------------*/
210
211/* A redis object, that is a type able to hold a string / list / set */
212
213/* The actual Redis Object */
214typedef struct redisObject {
215 unsigned type:4;
216 unsigned storage:2; /* REDIS_VM_MEMORY or REDIS_VM_SWAPPING */
217 unsigned encoding:4;
218 unsigned lru:22; /* lru time (relative to server.lruclock) */
219 int refcount;
220 void *ptr;
221 /* VM fields are only allocated if VM is active, otherwise the
222 * object allocation function will just allocate
223 * sizeof(redisObjct) minus sizeof(redisObjectVM), so using
224 * Redis without VM active will not have any overhead. */
225} robj;
226
227/* The VM pointer structure - identifies an object in the swap file.
228 *
229 * This object is stored in place of the value
230 * object in the main key->value hash table representing a database.
231 * Note that the first fields (type, storage) are the same as the redisObject
232 * structure so that vmPointer strucuters can be accessed even when casted
233 * as redisObject structures.
234 *
235 * This is useful as we don't know if a value object is or not on disk, but we
236 * are always able to read obj->storage to check this. For vmPointer
237 * structures "type" is set to REDIS_VMPOINTER (even if without this field
238 * is still possible to check the kind of object from the value of 'storage').*/
239typedef struct vmPointer {
240 unsigned type:4;
241 unsigned storage:2; /* REDIS_VM_SWAPPED or REDIS_VM_LOADING */
242 unsigned notused:26;
243 unsigned int vtype; /* type of the object stored in the swap file */
244 off_t page; /* the page at witch the object is stored on disk */
245 off_t usedpages; /* number of pages used on disk */
246} vmpointer;
247
248/* Macro used to initalize a Redis object allocated on the stack.
249 * Note that this macro is taken near the structure definition to make sure
250 * we'll update it when the structure is changed, to avoid bugs like
251 * bug #85 introduced exactly in this way. */
252#define initStaticStringObject(_var,_ptr) do { \
253 _var.refcount = 1; \
254 _var.type = REDIS_STRING; \
255 _var.encoding = REDIS_ENCODING_RAW; \
256 _var.ptr = _ptr; \
257 _var.storage = REDIS_VM_MEMORY; \
258} while(0);
259
260typedef struct redisDb {
261 dict *dict; /* The keyspace for this DB */
262 dict *expires; /* Timeout of keys with a timeout set */
263 dict *blocking_keys; /* Keys with clients waiting for data (BLPOP) */
264 dict *io_keys; /* Keys with clients waiting for VM I/O */
265 dict *watched_keys; /* WATCHED keys for MULTI/EXEC CAS */
266 int id;
267} redisDb;
268
269/* Client MULTI/EXEC state */
270typedef struct multiCmd {
271 robj **argv;
272 int argc;
273 struct redisCommand *cmd;
274} multiCmd;
275
276typedef struct multiState {
277 multiCmd *commands; /* Array of MULTI commands */
278 int count; /* Total number of MULTI commands */
279} multiState;
280
281/* With multiplexing we need to take per-clinet state.
282 * Clients are taken in a liked list. */
283typedef struct redisClient {
284 int fd;
285 redisDb *db;
286 int dictid;
287 sds querybuf;
288 robj **argv, **mbargv;
289 int argc, mbargc;
a679185a 290 long bulklen; /* bulk read len. -1 if not in bulk read mode */
e2641e09 291 int multibulk; /* multi bulk command format active */
292 list *reply;
293 int sentlen;
294 time_t lastinteraction; /* time of the last interaction, used for timeout */
295 int flags; /* REDIS_SLAVE | REDIS_MONITOR | REDIS_MULTI ... */
296 int slaveseldb; /* slave selected db, if this client is a slave */
297 int authenticated; /* when requirepass is non-NULL */
298 int replstate; /* replication state if this is a slave */
299 int repldbfd; /* replication DB file descriptor */
300 long repldboff; /* replication DB file offset */
301 off_t repldbsize; /* replication DB file size */
302 multiState mstate; /* MULTI/EXEC state */
303 robj **blocking_keys; /* The key we are waiting to terminate a blocking
304 * operation such as BLPOP. Otherwise NULL. */
305 int blocking_keys_num; /* Number of blocking keys */
306 time_t blockingto; /* Blocking operation timeout. If UNIX current time
307 * is >= blockingto then the operation timed out. */
308 list *io_keys; /* Keys this client is waiting to be loaded from the
309 * swap file in order to continue. */
310 list *watched_keys; /* Keys WATCHED for MULTI/EXEC CAS */
311 dict *pubsub_channels; /* channels a client is interested in (SUBSCRIBE) */
312 list *pubsub_patterns; /* patterns a client is interested in (SUBSCRIBE) */
834ef78e
PN
313
314 /* Response buffer */
315 int bufpos;
f3357792 316 char buf[REDIS_REPLY_CHUNK_BYTES];
e2641e09 317} redisClient;
318
319struct saveparam {
320 time_t seconds;
321 int changes;
322};
323
324struct sharedObjectsStruct {
325 robj *crlf, *ok, *err, *emptybulk, *czero, *cone, *cnegone, *pong, *space,
326 *colon, *nullbulk, *nullmultibulk, *queued,
327 *emptymultibulk, *wrongtypeerr, *nokeyerr, *syntaxerr, *sameobjecterr,
328 *outofrangeerr, *plus,
329 *select0, *select1, *select2, *select3, *select4,
330 *select5, *select6, *select7, *select8, *select9,
331 *messagebulk, *pmessagebulk, *subscribebulk, *unsubscribebulk, *mbulk3,
332 *mbulk4, *psubscribebulk, *punsubscribebulk,
333 *integers[REDIS_SHARED_INTEGERS];
334};
335
336/* Global server state structure */
337struct redisServer {
0e5441d8 338 pthread_t mainthread;
e2641e09 339 int port;
340 int fd;
341 redisDb *db;
342 long long dirty; /* changes to DB from the last save */
2f6b31c3 343 long long dirty_before_bgsave; /* used to restore dirty on failed BGSAVE */
e2641e09 344 list *clients;
345 list *slaves, *monitors;
346 char neterr[ANET_ERR_LEN];
347 aeEventLoop *el;
348 int cronloops; /* number of times the cron function run */
349 list *objfreelist; /* A list of freed objects to avoid malloc() */
350 time_t lastsave; /* Unix time of last save succeeede */
351 /* Fields used only for stats */
352 time_t stat_starttime; /* server start time */
353 long long stat_numcommands; /* number of processed commands */
354 long long stat_numconnections; /* number of connections received */
355 long long stat_expiredkeys; /* number of expired keys */
356 /* Configuration */
357 int verbosity;
358 int glueoutputbuf;
359 int maxidletime;
360 int dbnum;
361 int daemonize;
362 int appendonly;
363 int appendfsync;
364 int no_appendfsync_on_rewrite;
365 int shutdown_asap;
366 time_t lastfsync;
367 int appendfd;
368 int appendseldb;
369 char *pidfile;
370 pid_t bgsavechildpid;
371 pid_t bgrewritechildpid;
372 sds bgrewritebuf; /* buffer taken by parent during oppend only rewrite */
373 sds aofbuf; /* AOF buffer, written before entering the event loop */
374 struct saveparam *saveparams;
375 int saveparamslen;
376 char *logfile;
377 char *bindaddr;
378 char *dbfilename;
379 char *appendfilename;
380 char *requirepass;
381 int rdbcompression;
382 int activerehashing;
383 /* Replication related */
384 int isslave;
385 char *masterauth;
386 char *masterhost;
387 int masterport;
388 redisClient *master; /* client that is master for this slave */
389 int replstate;
390 unsigned int maxclients;
391 unsigned long long maxmemory;
392 unsigned int blpop_blocked_clients;
393 unsigned int vm_blocked_clients;
394 /* Sort parameters - qsort_r() is only available under BSD so we
395 * have to take this state global, in order to pass it to sortCompare() */
396 int sort_desc;
397 int sort_alpha;
398 int sort_bypattern;
399 /* Virtual memory configuration */
400 int vm_enabled;
401 char *vm_swap_file;
402 off_t vm_page_size;
403 off_t vm_pages;
404 unsigned long long vm_max_memory;
405 /* Zip structure config */
406 size_t hash_max_zipmap_entries;
407 size_t hash_max_zipmap_value;
408 size_t list_max_ziplist_entries;
409 size_t list_max_ziplist_value;
96ffb2fe 410 size_t set_max_intset_entries;
e2641e09 411 /* Virtual memory state */
412 FILE *vm_fp;
413 int vm_fd;
414 off_t vm_next_page; /* Next probably empty page */
415 off_t vm_near_pages; /* Number of pages allocated sequentially */
416 unsigned char *vm_bitmap; /* Bitmap of free/used pages */
417 time_t unixtime; /* Unix time sampled every second. */
418 /* Virtual memory I/O threads stuff */
419 /* An I/O thread process an element taken from the io_jobs queue and
420 * put the result of the operation in the io_done list. While the
421 * job is being processed, it's put on io_processing queue. */
422 list *io_newjobs; /* List of VM I/O jobs yet to be processed */
423 list *io_processing; /* List of VM I/O jobs being processed */
424 list *io_processed; /* List of VM I/O jobs already processed */
425 list *io_ready_clients; /* Clients ready to be unblocked. All keys loaded */
426 pthread_mutex_t io_mutex; /* lock to access io_jobs/io_done/io_thread_job */
427 pthread_mutex_t obj_freelist_mutex; /* safe redis objects creation/free */
428 pthread_mutex_t io_swapfile_mutex; /* So we can lseek + write */
429 pthread_attr_t io_threads_attr; /* attributes for threads creation */
430 int io_active_threads; /* Number of running I/O threads */
431 int vm_max_threads; /* Max number of I/O threads running at the same time */
432 /* Our main thread is blocked on the event loop, locking for sockets ready
433 * to be read or written, so when a threaded I/O operation is ready to be
434 * processed by the main thread, the I/O thread will use a unix pipe to
435 * awake the main thread. The followings are the two pipe FDs. */
436 int io_ready_pipe_read;
437 int io_ready_pipe_write;
438 /* Virtual memory stats */
439 unsigned long long vm_stats_used_pages;
440 unsigned long long vm_stats_swapped_objects;
441 unsigned long long vm_stats_swapouts;
442 unsigned long long vm_stats_swapins;
443 /* Pubsub */
444 dict *pubsub_channels; /* Map channels to list of subscribed clients */
445 list *pubsub_patterns; /* A list of pubsub_patterns */
446 /* Misc */
447 FILE *devnull;
448 unsigned lruclock:22; /* clock incrementing every minute, for LRU */
449 unsigned lruclock_padding:10;
450};
451
452typedef struct pubsubPattern {
453 redisClient *client;
454 robj *pattern;
455} pubsubPattern;
456
457typedef void redisCommandProc(redisClient *c);
458typedef void redisVmPreloadProc(redisClient *c, struct redisCommand *cmd, int argc, robj **argv);
459struct redisCommand {
460 char *name;
461 redisCommandProc *proc;
462 int arity;
463 int flags;
464 /* Use a function to determine which keys need to be loaded
465 * in the background prior to executing this command. Takes precedence
466 * over vm_firstkey and others, ignored when NULL */
467 redisVmPreloadProc *vm_preload_proc;
468 /* What keys should be loaded in background when calling this command? */
469 int vm_firstkey; /* The first argument that's a key (0 = no keys) */
470 int vm_lastkey; /* THe last argument that's a key */
471 int vm_keystep; /* The step between first and last key */
472};
473
474struct redisFunctionSym {
475 char *name;
476 unsigned long pointer;
477};
478
479typedef struct _redisSortObject {
480 robj *obj;
481 union {
482 double score;
483 robj *cmpobj;
484 } u;
485} redisSortObject;
486
487typedef struct _redisSortOperation {
488 int type;
489 robj *pattern;
490} redisSortOperation;
491
492/* ZSETs use a specialized version of Skiplists */
493
494typedef struct zskiplistNode {
495 struct zskiplistNode **forward;
496 struct zskiplistNode *backward;
497 unsigned int *span;
498 double score;
499 robj *obj;
500} zskiplistNode;
501
502typedef struct zskiplist {
503 struct zskiplistNode *header, *tail;
504 unsigned long length;
505 int level;
506} zskiplist;
507
508typedef struct zset {
509 dict *dict;
510 zskiplist *zsl;
511} zset;
512
513/* VM threaded I/O request message */
514#define REDIS_IOJOB_LOAD 0 /* Load from disk to memory */
515#define REDIS_IOJOB_PREPARE_SWAP 1 /* Compute needed pages */
516#define REDIS_IOJOB_DO_SWAP 2 /* Swap from memory to disk */
517typedef struct iojob {
518 int type; /* Request type, REDIS_IOJOB_* */
519 redisDb *db;/* Redis database */
520 robj *key; /* This I/O request is about swapping this key */
521 robj *id; /* Unique identifier of this job:
522 this is the object to swap for REDIS_IOREQ_*_SWAP, or the
523 vmpointer objct for REDIS_IOREQ_LOAD. */
524 robj *val; /* the value to swap for REDIS_IOREQ_*_SWAP, otherwise this
525 * field is populated by the I/O thread for REDIS_IOREQ_LOAD. */
526 off_t page; /* Swap page where to read/write the object */
527 off_t pages; /* Swap pages needed to save object. PREPARE_SWAP return val */
528 int canceled; /* True if this command was canceled by blocking side of VM */
529 pthread_t thread; /* ID of the thread processing this entry */
530} iojob;
531
532/* Structure to hold list iteration abstraction. */
533typedef struct {
534 robj *subject;
535 unsigned char encoding;
536 unsigned char direction; /* Iteration direction */
537 unsigned char *zi;
538 listNode *ln;
539} listTypeIterator;
540
541/* Structure for an entry while iterating over a list. */
542typedef struct {
543 listTypeIterator *li;
544 unsigned char *zi; /* Entry in ziplist */
545 listNode *ln; /* Entry in linked list */
546} listTypeEntry;
547
96ffb2fe
PN
548/* Structure to hold set iteration abstraction. */
549typedef struct {
550 robj *subject;
551 int encoding;
552 int ii; /* intset iterator */
553 dictIterator *di;
cb72d0f1 554} setTypeIterator;
96ffb2fe 555
e2641e09 556/* Structure to hold hash iteration abstration. Note that iteration over
557 * hashes involves both fields and values. Because it is possible that
558 * not both are required, store pointers in the iterator to avoid
559 * unnecessary memory allocation for fields/values. */
560typedef struct {
561 int encoding;
562 unsigned char *zi;
563 unsigned char *zk, *zv;
564 unsigned int zklen, zvlen;
565
566 dictIterator *di;
567 dictEntry *de;
568} hashTypeIterator;
569
570#define REDIS_HASH_KEY 1
571#define REDIS_HASH_VALUE 2
572
573/*-----------------------------------------------------------------------------
574 * Extern declarations
575 *----------------------------------------------------------------------------*/
576
577extern struct redisServer server;
578extern struct sharedObjectsStruct shared;
579extern dictType setDictType;
580extern dictType zsetDictType;
581extern double R_Zero, R_PosInf, R_NegInf, R_Nan;
582dictType hashDictType;
583
584/*-----------------------------------------------------------------------------
585 * Functions prototypes
586 *----------------------------------------------------------------------------*/
587
588/* networking.c -- Networking and Client related operations */
589redisClient *createClient(int fd);
590void closeTimedoutClients(void);
591void freeClient(redisClient *c);
592void resetClient(redisClient *c);
593void sendReplyToClient(aeEventLoop *el, int fd, void *privdata, int mask);
594void sendReplyToClientWritev(aeEventLoop *el, int fd, void *privdata, int mask);
595void addReply(redisClient *c, robj *obj);
b301c1fc
PN
596void *addDeferredMultiBulkLength(redisClient *c);
597void setDeferredMultiBulkLength(redisClient *c, void *node, long length);
e2641e09 598void addReplySds(redisClient *c, sds s);
599void processInputBuffer(redisClient *c);
600void acceptHandler(aeEventLoop *el, int fd, void *privdata, int mask);
601void readQueryFromClient(aeEventLoop *el, int fd, void *privdata, int mask);
602void addReplyBulk(redisClient *c, robj *obj);
603void addReplyBulkCString(redisClient *c, char *s);
604void acceptHandler(aeEventLoop *el, int fd, void *privdata, int mask);
605void addReply(redisClient *c, robj *obj);
606void addReplySds(redisClient *c, sds s);
3ab20376
PN
607void addReplyError(redisClient *c, char *err);
608void addReplyStatus(redisClient *c, char *status);
e2641e09 609void addReplyDouble(redisClient *c, double d);
610void addReplyLongLong(redisClient *c, long long ll);
0537e7bf 611void addReplyMultiBulkLen(redisClient *c, long length);
e2641e09 612void *dupClientReplyValue(void *o);
613
3ab20376
PN
614#ifdef __GNUC__
615void addReplyErrorFormat(redisClient *c, const char *fmt, ...)
616 __attribute__((format(printf, 2, 3)));
617void addReplyStatusFormat(redisClient *c, const char *fmt, ...)
618 __attribute__((format(printf, 2, 3)));
619#else
620void addReplyErrorFormat(redisClient *c, const char *fmt, ...);
621void addReplyStatusFormat(redisClient *c, const char *fmt, ...);
622#endif
623
e2641e09 624/* List data type */
625void listTypeTryConversion(robj *subject, robj *value);
626void listTypePush(robj *subject, robj *value, int where);
627robj *listTypePop(robj *subject, int where);
628unsigned long listTypeLength(robj *subject);
629listTypeIterator *listTypeInitIterator(robj *subject, int index, unsigned char direction);
630void listTypeReleaseIterator(listTypeIterator *li);
631int listTypeNext(listTypeIterator *li, listTypeEntry *entry);
632robj *listTypeGet(listTypeEntry *entry);
633void listTypeInsert(listTypeEntry *entry, robj *value, int where);
634int listTypeEqual(listTypeEntry *entry, robj *o);
635void listTypeDelete(listTypeEntry *entry);
636void listTypeConvert(robj *subject, int enc);
637void unblockClientWaitingData(redisClient *c);
638int handleClientsWaitingListPush(redisClient *c, robj *key, robj *ele);
639void popGenericCommand(redisClient *c, int where);
640
641/* MULTI/EXEC/WATCH... */
642void unwatchAllKeys(redisClient *c);
643void initClientMultiState(redisClient *c);
644void freeClientMultiState(redisClient *c);
645void queueMultiCommand(redisClient *c, struct redisCommand *cmd);
646void touchWatchedKey(redisDb *db, robj *key);
647void touchWatchedKeysOnFlush(int dbid);
648
649/* Redis object implementation */
650void decrRefCount(void *o);
651void incrRefCount(robj *o);
652void freeStringObject(robj *o);
653void freeListObject(robj *o);
654void freeSetObject(robj *o);
655void freeZsetObject(robj *o);
656void freeHashObject(robj *o);
657robj *createObject(int type, void *ptr);
658robj *createStringObject(char *ptr, size_t len);
659robj *dupStringObject(robj *o);
660robj *tryObjectEncoding(robj *o);
661robj *getDecodedObject(robj *o);
662size_t stringObjectLen(robj *o);
663int tryFreeOneObjectFromFreelist(void);
664robj *createStringObjectFromLongLong(long long value);
665robj *createListObject(void);
666robj *createZiplistObject(void);
667robj *createSetObject(void);
96ffb2fe 668robj *createIntsetObject(void);
e2641e09 669robj *createHashObject(void);
670robj *createZsetObject(void);
671int getLongFromObjectOrReply(redisClient *c, robj *o, long *target, const char *msg);
672int checkType(redisClient *c, robj *o, int type);
673int getLongLongFromObjectOrReply(redisClient *c, robj *o, long long *target, const char *msg);
674int getDoubleFromObjectOrReply(redisClient *c, robj *o, double *target, const char *msg);
675int getLongLongFromObject(robj *o, long long *target);
676char *strEncoding(int encoding);
677int compareStringObjects(robj *a, robj *b);
678int equalStringObjects(robj *a, robj *b);
679
680/* Replication */
681void replicationFeedSlaves(list *slaves, int dictid, robj **argv, int argc);
682void replicationFeedMonitors(list *monitors, int dictid, robj **argv, int argc);
683int syncWithMaster(void);
684void updateSlavesWaitingBgsave(int bgsaveerr);
685
686/* RDB persistence */
687int rdbLoad(char *filename);
688int rdbSaveBackground(char *filename);
689void rdbRemoveTempFile(pid_t childpid);
690int rdbSave(char *filename);
691int rdbSaveObject(FILE *fp, robj *o);
692off_t rdbSavedObjectPages(robj *o, FILE *fp);
693off_t rdbSavedObjectLen(robj *o, FILE *fp);
694robj *rdbLoadObject(int type, FILE *fp);
695void backgroundSaveDoneHandler(int statloc);
696
697/* AOF persistence */
698void flushAppendOnlyFile(void);
699void feedAppendOnlyFile(struct redisCommand *cmd, int dictid, robj **argv, int argc);
700void aofRemoveTempFile(pid_t childpid);
701int rewriteAppendOnlyFileBackground(void);
702int loadAppendOnlyFile(char *filename);
703void stopAppendOnly(void);
704int startAppendOnly(void);
705void backgroundRewriteDoneHandler(int statloc);
706
707/* Sorted sets data type */
708zskiplist *zslCreate(void);
709void zslFree(zskiplist *zsl);
710void zslInsert(zskiplist *zsl, double score, robj *obj);
711
712/* Core functions */
713void freeMemoryIfNeeded(void);
714int processCommand(redisClient *c);
715void setupSigSegvAction(void);
716struct redisCommand *lookupCommand(char *name);
717void call(redisClient *c, struct redisCommand *cmd);
718int prepareForShutdown();
719void redisLog(int level, const char *fmt, ...);
720void usage();
721void updateDictResizePolicy(void);
722int htNeedsResize(dict *dict);
723void oom(const char *msg);
724
725/* Virtual Memory */
726void vmInit(void);
727void vmMarkPagesFree(off_t page, off_t count);
728robj *vmLoadObject(robj *o);
729robj *vmPreviewObject(robj *o);
730int vmSwapOneObjectBlocking(void);
731int vmSwapOneObjectThreaded(void);
732int vmCanSwapOut(void);
733void vmThreadedIOCompletedJob(aeEventLoop *el, int fd, void *privdata, int mask);
734void vmCancelThreadedIOJob(robj *o);
735void lockThreadedIO(void);
736void unlockThreadedIO(void);
737int vmSwapObjectThreaded(robj *key, robj *val, redisDb *db);
738void freeIOJob(iojob *j);
739void queueIOJob(iojob *j);
740int vmWriteObjectOnSwap(robj *o, off_t page);
741robj *vmReadObjectFromSwap(off_t page, int type);
742void waitEmptyIOJobsQueue(void);
743void vmReopenSwapFile(void);
744int vmFreePage(off_t page);
745void zunionInterBlockClientOnSwappedKeys(redisClient *c, struct redisCommand *cmd, int argc, robj **argv);
746void execBlockClientOnSwappedKeys(redisClient *c, struct redisCommand *cmd, int argc, robj **argv);
747int blockClientOnSwappedKeys(redisClient *c, struct redisCommand *cmd);
748int dontWaitForSwappedKey(redisClient *c, robj *key);
749void handleClientsBlockedOnSwappedKey(redisDb *db, robj *key);
750vmpointer *vmSwapObjectBlocking(robj *val);
751
96ffb2fe
PN
752/* Set data type */
753robj *setTypeCreate(robj *value);
754int setTypeAdd(robj *subject, robj *value);
755int setTypeRemove(robj *subject, robj *value);
756int setTypeIsMember(robj *subject, robj *value);
cb72d0f1
PN
757setTypeIterator *setTypeInitIterator(robj *subject);
758void setTypeReleaseIterator(setTypeIterator *si);
759robj *setTypeNext(setTypeIterator *si);
96ffb2fe
PN
760robj *setTypeRandomElement(robj *subject);
761unsigned long setTypeSize(robj *subject);
762void setTypeConvert(robj *subject, int enc);
763
e2641e09 764/* Hash data type */
765void convertToRealHash(robj *o);
766void hashTypeTryConversion(robj *subject, robj **argv, int start, int end);
767void hashTypeTryObjectEncoding(robj *subject, robj **o1, robj **o2);
768robj *hashTypeGet(robj *o, robj *key);
769int hashTypeExists(robj *o, robj *key);
770int hashTypeSet(robj *o, robj *key, robj *value);
771int hashTypeDelete(robj *o, robj *key);
772unsigned long hashTypeLength(robj *o);
773hashTypeIterator *hashTypeInitIterator(robj *subject);
774void hashTypeReleaseIterator(hashTypeIterator *hi);
775int hashTypeNext(hashTypeIterator *hi);
776robj *hashTypeCurrent(hashTypeIterator *hi, int what);
777robj *hashTypeLookupWriteOrCreate(redisClient *c, robj *key);
778
779/* Pub / Sub */
780int pubsubUnsubscribeAllChannels(redisClient *c, int notify);
781int pubsubUnsubscribeAllPatterns(redisClient *c, int notify);
782void freePubsubPattern(void *p);
783int listMatchPubsubPattern(void *a, void *b);
784
785/* Utility functions */
786int stringmatchlen(const char *pattern, int patternLen,
787 const char *string, int stringLen, int nocase);
788int stringmatch(const char *pattern, const char *string, int nocase);
789long long memtoll(const char *p, int *err);
790int ll2string(char *s, size_t len, long long value);
791int isStringRepresentableAsLong(sds s, long *longval);
ec7e1389 792int isStringRepresentableAsLongLong(sds s, long long *longval);
793int isObjectRepresentableAsLongLong(robj *o, long long *llongval);
e2641e09 794
795/* Configuration */
796void loadServerConfig(char *filename);
797void appendServerSaveParams(time_t seconds, int changes);
798void resetServerSaveParams();
799
800/* db.c -- Keyspace access API */
801int removeExpire(redisDb *db, robj *key);
bcf2995c 802void propagateExpire(redisDb *db, robj *key);
e2641e09 803int expireIfNeeded(redisDb *db, robj *key);
e2641e09 804time_t getExpire(redisDb *db, robj *key);
0cf5b7b5 805void setExpire(redisDb *db, robj *key, time_t when);
e2641e09 806robj *lookupKey(redisDb *db, robj *key);
807robj *lookupKeyRead(redisDb *db, robj *key);
808robj *lookupKeyWrite(redisDb *db, robj *key);
809robj *lookupKeyReadOrReply(redisClient *c, robj *key, robj *reply);
810robj *lookupKeyWriteOrReply(redisClient *c, robj *key, robj *reply);
811int dbAdd(redisDb *db, robj *key, robj *val);
812int dbReplace(redisDb *db, robj *key, robj *val);
813int dbExists(redisDb *db, robj *key);
814robj *dbRandomKey(redisDb *db);
815int dbDelete(redisDb *db, robj *key);
816long long emptyDb();
817int selectDb(redisClient *c, int id);
818
819/* Git SHA1 */
820char *redisGitSHA1(void);
821char *redisGitDirty(void);
822
823/* Commands prototypes */
824void authCommand(redisClient *c);
825void pingCommand(redisClient *c);
826void echoCommand(redisClient *c);
827void setCommand(redisClient *c);
828void setnxCommand(redisClient *c);
829void setexCommand(redisClient *c);
830void getCommand(redisClient *c);
831void delCommand(redisClient *c);
832void existsCommand(redisClient *c);
833void incrCommand(redisClient *c);
834void decrCommand(redisClient *c);
835void incrbyCommand(redisClient *c);
836void decrbyCommand(redisClient *c);
837void selectCommand(redisClient *c);
838void randomkeyCommand(redisClient *c);
839void keysCommand(redisClient *c);
840void dbsizeCommand(redisClient *c);
841void lastsaveCommand(redisClient *c);
842void saveCommand(redisClient *c);
843void bgsaveCommand(redisClient *c);
844void bgrewriteaofCommand(redisClient *c);
845void shutdownCommand(redisClient *c);
846void moveCommand(redisClient *c);
847void renameCommand(redisClient *c);
848void renamenxCommand(redisClient *c);
849void lpushCommand(redisClient *c);
850void rpushCommand(redisClient *c);
851void lpushxCommand(redisClient *c);
852void rpushxCommand(redisClient *c);
853void linsertCommand(redisClient *c);
854void lpopCommand(redisClient *c);
855void rpopCommand(redisClient *c);
856void llenCommand(redisClient *c);
857void lindexCommand(redisClient *c);
858void lrangeCommand(redisClient *c);
859void ltrimCommand(redisClient *c);
860void typeCommand(redisClient *c);
861void lsetCommand(redisClient *c);
862void saddCommand(redisClient *c);
863void sremCommand(redisClient *c);
864void smoveCommand(redisClient *c);
865void sismemberCommand(redisClient *c);
866void scardCommand(redisClient *c);
867void spopCommand(redisClient *c);
868void srandmemberCommand(redisClient *c);
869void sinterCommand(redisClient *c);
870void sinterstoreCommand(redisClient *c);
871void sunionCommand(redisClient *c);
872void sunionstoreCommand(redisClient *c);
873void sdiffCommand(redisClient *c);
874void sdiffstoreCommand(redisClient *c);
875void syncCommand(redisClient *c);
876void flushdbCommand(redisClient *c);
877void flushallCommand(redisClient *c);
878void sortCommand(redisClient *c);
879void lremCommand(redisClient *c);
880void rpoplpushcommand(redisClient *c);
881void infoCommand(redisClient *c);
882void mgetCommand(redisClient *c);
883void monitorCommand(redisClient *c);
884void expireCommand(redisClient *c);
885void expireatCommand(redisClient *c);
886void getsetCommand(redisClient *c);
887void ttlCommand(redisClient *c);
a539d29a 888void persistCommand(redisClient *c);
e2641e09 889void slaveofCommand(redisClient *c);
890void debugCommand(redisClient *c);
891void msetCommand(redisClient *c);
892void msetnxCommand(redisClient *c);
893void zaddCommand(redisClient *c);
894void zincrbyCommand(redisClient *c);
895void zrangeCommand(redisClient *c);
896void zrangebyscoreCommand(redisClient *c);
897void zcountCommand(redisClient *c);
898void zrevrangeCommand(redisClient *c);
899void zcardCommand(redisClient *c);
900void zremCommand(redisClient *c);
901void zscoreCommand(redisClient *c);
902void zremrangebyscoreCommand(redisClient *c);
903void multiCommand(redisClient *c);
904void execCommand(redisClient *c);
905void discardCommand(redisClient *c);
906void blpopCommand(redisClient *c);
907void brpopCommand(redisClient *c);
908void appendCommand(redisClient *c);
909void substrCommand(redisClient *c);
80091bba 910void strlenCommand(redisClient *c);
e2641e09 911void zrankCommand(redisClient *c);
912void zrevrankCommand(redisClient *c);
913void hsetCommand(redisClient *c);
914void hsetnxCommand(redisClient *c);
915void hgetCommand(redisClient *c);
916void hmsetCommand(redisClient *c);
917void hmgetCommand(redisClient *c);
918void hdelCommand(redisClient *c);
919void hlenCommand(redisClient *c);
920void zremrangebyrankCommand(redisClient *c);
921void zunionstoreCommand(redisClient *c);
922void zinterstoreCommand(redisClient *c);
923void hkeysCommand(redisClient *c);
924void hvalsCommand(redisClient *c);
925void hgetallCommand(redisClient *c);
926void hexistsCommand(redisClient *c);
927void configCommand(redisClient *c);
928void hincrbyCommand(redisClient *c);
929void subscribeCommand(redisClient *c);
930void unsubscribeCommand(redisClient *c);
931void psubscribeCommand(redisClient *c);
932void punsubscribeCommand(redisClient *c);
933void publishCommand(redisClient *c);
934void watchCommand(redisClient *c);
935void unwatchCommand(redisClient *c);
936
b3aa6d71 937#if defined(__GNUC__)
b3aa6d71 938void *calloc(size_t count, size_t size) __attribute__ ((deprecated));
939void free(void *ptr) __attribute__ ((deprecated));
940void *malloc(size_t size) __attribute__ ((deprecated));
941void *realloc(void *ptr, size_t size) __attribute__ ((deprecated));
942#endif
943
e2641e09 944#endif