ctdbd: Remove transaction code related to TRANS2 commits
[ctdb.git] / common / ctdb_util.c
1 /* 
2    ctdb utility code
3
4    Copyright (C) Andrew Tridgell  2006
5
6    This program is free software; you can redistribute it and/or modify
7    it under the terms of the GNU General Public License as published by
8    the Free Software Foundation; either version 3 of the License, or
9    (at your option) any later version.
10    
11    This program is distributed in the hope that it will be useful,
12    but WITHOUT ANY WARRANTY; without even the implied warranty of
13    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14    GNU General Public License for more details.
15    
16    You should have received a copy of the GNU General Public License
17    along with this program; if not, see <http://www.gnu.org/licenses/>.
18 */
19
20 #include "includes.h"
21 #include "tdb.h"
22 #include "system/network.h"
23 #include "system/filesys.h"
24 #include "system/wait.h"
25 #include "system/shmem.h"
26 #include "../include/ctdb_private.h"
27
28 int LogLevel = DEBUG_NOTICE;
29 int this_log_level = 0;
30
31 /*
32   return error string for last error
33 */
34 const char *ctdb_errstr(struct ctdb_context *ctdb)
35 {
36         return ctdb->err_msg;
37 }
38
39
40 /*
41   remember an error message
42 */
43 void ctdb_set_error(struct ctdb_context *ctdb, const char *fmt, ...)
44 {
45         va_list ap;
46         talloc_free(ctdb->err_msg);
47         va_start(ap, fmt);
48         ctdb->err_msg = talloc_vasprintf(ctdb, fmt, ap);
49         DEBUG(DEBUG_ERR,("ctdb error: %s\n", ctdb->err_msg));
50         va_end(ap);
51 }
52
53 /*
54   a fatal internal error occurred - no hope for recovery
55 */
56 void ctdb_fatal(struct ctdb_context *ctdb, const char *msg)
57 {
58         DEBUG(DEBUG_ALERT,("ctdb fatal error: %s\n", msg));
59         abort();
60 }
61
62 /*
63   like ctdb_fatal() but a core/backtrace would not be useful
64 */
65 void ctdb_die(struct ctdb_context *ctdb, const char *msg)
66 {
67         DEBUG(DEBUG_ALERT,("ctdb exiting with error: %s\n", msg));
68         exit(1);
69 }
70
71 /* Invoke an external program to do some sort of tracing on the CTDB
72  * process.  This might block for a little while.  The external
73  * program is specified by the environment variable
74  * CTDB_EXTERNAL_TRACE.  This program should take one argument: the
75  * pid of the process to trace.  Commonly, the program would be a
76  * wrapper script around gcore.
77  */
78 void ctdb_external_trace(void)
79 {
80
81         const char * t = getenv("CTDB_EXTERNAL_TRACE");
82         char * cmd;
83
84         if (t == NULL) {
85                 return;
86         }
87
88         cmd = talloc_asprintf(NULL, "%s %lu", t, (unsigned long) getpid());
89         DEBUG(DEBUG_WARNING,("begin external trace: %s\n", cmd));
90         system(cmd);
91         DEBUG(DEBUG_WARNING,("end external trace: %s\n", cmd));
92         talloc_free(cmd);
93 }
94
95 /*
96   parse a IP:port pair
97 */
98 int ctdb_parse_address(struct ctdb_context *ctdb,
99                        TALLOC_CTX *mem_ctx, const char *str,
100                        struct ctdb_address *address)
101 {
102         struct servent *se;
103
104         setservent(0);
105         se = getservbyname("ctdb", "tcp");
106         endservent();
107         
108         address->address = talloc_strdup(mem_ctx, str);
109         CTDB_NO_MEMORY(ctdb, address->address);
110
111         if (se == NULL) {
112                 address->port = CTDB_PORT;
113         } else {
114                 address->port = ntohs(se->s_port);
115         }
116         return 0;
117 }
118
119
120 /*
121   check if two addresses are the same
122 */
123 bool ctdb_same_address(struct ctdb_address *a1, struct ctdb_address *a2)
124 {
125         return strcmp(a1->address, a2->address) == 0 && a1->port == a2->port;
126 }
127
128
129 /*
130   hash function for mapping data to a VNN - taken from tdb
131 */
132 uint32_t ctdb_hash(const TDB_DATA *key)
133 {
134         return tdb_jenkins_hash(discard_const(key));
135 }
136
137 /*
138   a type checking varient of idr_find
139  */
140 static void *_idr_find_type(struct idr_context *idp, int id, const char *type, const char *location)
141 {
142         void *p = idr_find(idp, id);
143         if (p && talloc_check_name(p, type) == NULL) {
144                 DEBUG(DEBUG_ERR,("%s idr_find_type expected type %s  but got %s\n",
145                          location, type, talloc_get_name(p)));
146                 return NULL;
147         }
148         return p;
149 }
150
151 uint32_t ctdb_reqid_new(struct ctdb_context *ctdb, void *state)
152 {
153         int id = idr_get_new_above(ctdb->idr, state, ctdb->lastid+1, INT_MAX);
154         if (id < 0) {
155                 DEBUG(DEBUG_DEBUG, ("Reqid wrap!\n"));
156                 id = idr_get_new(ctdb->idr, state, INT_MAX);
157         }
158         ctdb->lastid = id;
159         return id;
160 }
161
162 void *_ctdb_reqid_find(struct ctdb_context *ctdb, uint32_t reqid, const char *type, const char *location)
163 {
164         void *p;
165
166         p = _idr_find_type(ctdb->idr, reqid, type, location);
167         if (p == NULL) {
168                 DEBUG(DEBUG_WARNING, ("Could not find idr:%u\n",reqid));
169         }
170
171         return p;
172 }
173
174
175 void ctdb_reqid_remove(struct ctdb_context *ctdb, uint32_t reqid)
176 {
177         int ret;
178
179         ret = idr_remove(ctdb->idr, reqid);
180         if (ret != 0) {
181                 DEBUG(DEBUG_ERR, ("Removing idr that does not exist\n"));
182         }
183 }
184
185
186 /*
187   form a ctdb_rec_data record from a key/data pair
188   
189   note that header may be NULL. If not NULL then it is included in the data portion
190   of the record
191  */
192 struct ctdb_rec_data *ctdb_marshall_record(TALLOC_CTX *mem_ctx, uint32_t reqid, 
193                                            TDB_DATA key, 
194                                            struct ctdb_ltdb_header *header,
195                                            TDB_DATA data)
196 {
197         size_t length;
198         struct ctdb_rec_data *d;
199
200         length = offsetof(struct ctdb_rec_data, data) + key.dsize + 
201                 data.dsize + (header?sizeof(*header):0);
202         d = (struct ctdb_rec_data *)talloc_size(mem_ctx, length);
203         if (d == NULL) {
204                 return NULL;
205         }
206         d->length = length;
207         d->reqid = reqid;
208         d->keylen = key.dsize;
209         memcpy(&d->data[0], key.dptr, key.dsize);
210         if (header) {
211                 d->datalen = data.dsize + sizeof(*header);
212                 memcpy(&d->data[key.dsize], header, sizeof(*header));
213                 memcpy(&d->data[key.dsize+sizeof(*header)], data.dptr, data.dsize);
214         } else {
215                 d->datalen = data.dsize;
216                 memcpy(&d->data[key.dsize], data.dptr, data.dsize);
217         }
218         return d;
219 }
220
221
222 /* helper function for marshalling multiple records */
223 struct ctdb_marshall_buffer *ctdb_marshall_add(TALLOC_CTX *mem_ctx, 
224                                                struct ctdb_marshall_buffer *m,
225                                                uint64_t db_id,
226                                                uint32_t reqid,
227                                                TDB_DATA key,
228                                                struct ctdb_ltdb_header *header,
229                                                TDB_DATA data)
230 {
231         struct ctdb_rec_data *r;
232         size_t m_size, r_size;
233         struct ctdb_marshall_buffer *m2;
234
235         r = ctdb_marshall_record(mem_ctx, reqid, key, header, data);
236         if (r == NULL) {
237                 talloc_free(m);
238                 return NULL;
239         }
240
241         if (m == NULL) {
242                 m = talloc_zero_size(mem_ctx, offsetof(struct ctdb_marshall_buffer, data));
243                 if (m == NULL) {
244                         return NULL;
245                 }
246                 m->db_id = db_id;
247         }
248
249         m_size = talloc_get_size(m);
250         r_size = talloc_get_size(r);
251
252         m2 = talloc_realloc_size(mem_ctx, m,  m_size + r_size);
253         if (m2 == NULL) {
254                 talloc_free(m);
255                 return NULL;
256         }
257
258         memcpy(m_size + (uint8_t *)m2, r, r_size);
259
260         talloc_free(r);
261
262         m2->count++;
263
264         return m2;
265 }
266
267 /* we've finished marshalling, return a data blob with the marshalled records */
268 TDB_DATA ctdb_marshall_finish(struct ctdb_marshall_buffer *m)
269 {
270         TDB_DATA data;
271         data.dptr = (uint8_t *)m;
272         data.dsize = talloc_get_size(m);
273         return data;
274 }
275
276 /* 
277    loop over a marshalling buffer 
278    
279      - pass r==NULL to start
280      - loop the number of times indicated by m->count
281 */
282 struct ctdb_rec_data *ctdb_marshall_loop_next(struct ctdb_marshall_buffer *m, struct ctdb_rec_data *r,
283                                               uint32_t *reqid,
284                                               struct ctdb_ltdb_header *header,
285                                               TDB_DATA *key, TDB_DATA *data)
286 {
287         if (r == NULL) {
288                 r = (struct ctdb_rec_data *)&m->data[0];
289         } else {
290                 r = (struct ctdb_rec_data *)(r->length + (uint8_t *)r);
291         }
292
293         if (reqid != NULL) {
294                 *reqid = r->reqid;
295         }
296         
297         if (key != NULL) {
298                 key->dptr   = &r->data[0];
299                 key->dsize  = r->keylen;
300         }
301         if (data != NULL) {
302                 data->dptr  = &r->data[r->keylen];
303                 data->dsize = r->datalen;
304                 if (header != NULL) {
305                         data->dptr += sizeof(*header);
306                         data->dsize -= sizeof(*header);
307                 }
308         }
309
310         if (header != NULL) {
311                 if (r->datalen < sizeof(*header)) {
312                         return NULL;
313                 }
314                 *header = *(struct ctdb_ltdb_header *)&r->data[r->keylen];
315         }
316
317         return r;
318 }
319
320
321 #if HAVE_SCHED_H
322 #include <sched.h>
323 #endif
324
325 /*
326   if possible, make this task real time
327  */
328 void ctdb_set_scheduler(struct ctdb_context *ctdb)
329 {
330 #if HAVE_SCHED_SETSCHEDULER     
331         struct sched_param p;
332         if (ctdb->saved_scheduler_param == NULL) {
333                 ctdb->saved_scheduler_param = talloc_size(ctdb, sizeof(p));
334         }
335         
336         if (sched_getparam(0, (struct sched_param *)ctdb->saved_scheduler_param) == -1) {
337                 DEBUG(DEBUG_ERR,("Unable to get old scheduler params\n"));
338                 return;
339         }
340
341         p = *(struct sched_param *)ctdb->saved_scheduler_param;
342         p.sched_priority = 1;
343
344         if (sched_setscheduler(0, SCHED_FIFO, &p) == -1) {
345                 DEBUG(DEBUG_CRIT,("Unable to set scheduler to SCHED_FIFO (%s)\n", 
346                          strerror(errno)));
347         } else {
348                 DEBUG(DEBUG_NOTICE,("Set scheduler to SCHED_FIFO\n"));
349         }
350 #endif
351 }
352
353 /*
354   restore previous scheduler parameters
355  */
356 void ctdb_restore_scheduler(struct ctdb_context *ctdb)
357 {
358 #if HAVE_SCHED_SETSCHEDULER     
359         if (ctdb->saved_scheduler_param == NULL) {
360                 ctdb_fatal(ctdb, "No saved scheduler parameters\n");
361         }
362         if (sched_setscheduler(0, SCHED_OTHER, (struct sched_param *)ctdb->saved_scheduler_param) == -1) {
363                 ctdb_fatal(ctdb, "Unable to restore old scheduler parameters\n");
364         }
365 #endif
366 }
367
368 void set_nonblocking(int fd)
369 {
370         unsigned v;
371         v = fcntl(fd, F_GETFL, 0);
372         fcntl(fd, F_SETFL, v | O_NONBLOCK);
373 }
374
375 void set_close_on_exec(int fd)
376 {
377         unsigned v;
378         v = fcntl(fd, F_GETFD, 0);
379         fcntl(fd, F_SETFD, v | FD_CLOEXEC);
380 }
381
382
383 bool parse_ipv4(const char *s, unsigned port, struct sockaddr_in *sin)
384 {
385         sin->sin_family = AF_INET;
386         sin->sin_port   = htons(port);
387
388         if (inet_pton(AF_INET, s, &sin->sin_addr) != 1) {
389                 DEBUG(DEBUG_ERR, (__location__ " Failed to translate %s into sin_addr\n", s));
390                 return false;
391         }
392
393         return true;
394 }
395
396 static bool parse_ipv6(const char *s, const char *ifaces, unsigned port, ctdb_sock_addr *saddr)
397 {
398         saddr->ip6.sin6_family   = AF_INET6;
399         saddr->ip6.sin6_port     = htons(port);
400         saddr->ip6.sin6_flowinfo = 0;
401         saddr->ip6.sin6_scope_id = 0;
402
403         if (inet_pton(AF_INET6, s, &saddr->ip6.sin6_addr) != 1) {
404                 DEBUG(DEBUG_ERR, (__location__ " Failed to translate %s into sin6_addr\n", s));
405                 return false;
406         }
407
408         if (ifaces && IN6_IS_ADDR_LINKLOCAL(&saddr->ip6.sin6_addr)) {
409                 if (strchr(ifaces, ',')) {
410                         DEBUG(DEBUG_ERR, (__location__ " Link local address %s "
411                                           "is specified for multiple ifaces %s\n",
412                                           s, ifaces));
413                         return false;
414                 }
415                 saddr->ip6.sin6_scope_id = if_nametoindex(ifaces);
416         }
417
418         return true;
419 }
420 /*
421   parse a ip:port pair
422  */
423 bool parse_ip_port(const char *addr, ctdb_sock_addr *saddr)
424 {
425         TALLOC_CTX *tmp_ctx = talloc_new(NULL);
426         char *s, *p;
427         unsigned port;
428         char *endp = NULL;
429         bool ret;
430
431         s = talloc_strdup(tmp_ctx, addr);
432         if (s == NULL) {
433                 DEBUG(DEBUG_ERR, (__location__ " Failed strdup()\n"));
434                 talloc_free(tmp_ctx);
435                 return false;
436         }
437
438         p = rindex(s, ':');
439         if (p == NULL) {
440                 DEBUG(DEBUG_ERR, (__location__ " This addr: %s does not contain a port number\n", s));
441                 talloc_free(tmp_ctx);
442                 return false;
443         }
444
445         port = strtoul(p+1, &endp, 10);
446         if (endp == NULL || *endp != 0) {
447                 /* trailing garbage */
448                 DEBUG(DEBUG_ERR, (__location__ " Trailing garbage after the port in %s\n", s));
449                 talloc_free(tmp_ctx);
450                 return false;
451         }
452         *p = 0;
453
454
455         /* now is this a ipv4 or ipv6 address ?*/
456         ret = parse_ip(s, NULL, port, saddr);
457
458         talloc_free(tmp_ctx);
459         return ret;
460 }
461
462 /*
463   parse an ip
464  */
465 bool parse_ip(const char *addr, const char *ifaces, unsigned port, ctdb_sock_addr *saddr)
466 {
467         char *p;
468         bool ret;
469
470         ZERO_STRUCTP(saddr); /* valgrind :-) */
471
472         /* now is this a ipv4 or ipv6 address ?*/
473         p = index(addr, ':');
474         if (p == NULL) {
475                 ret = parse_ipv4(addr, port, &saddr->ip);
476         } else {
477                 ret = parse_ipv6(addr, ifaces, port, saddr);
478         }
479
480         return ret;
481 }
482
483 /*
484   parse a ip/mask pair
485  */
486 bool parse_ip_mask(const char *str, const char *ifaces, ctdb_sock_addr *addr, unsigned *mask)
487 {
488         TALLOC_CTX *tmp_ctx = talloc_new(NULL);
489         char *s, *p;
490         char *endp = NULL;
491         bool ret;
492
493         ZERO_STRUCT(*addr);
494         s = talloc_strdup(tmp_ctx, str);
495         if (s == NULL) {
496                 DEBUG(DEBUG_ERR, (__location__ " Failed strdup()\n"));
497                 talloc_free(tmp_ctx);
498                 return false;
499         }
500
501         p = rindex(s, '/');
502         if (p == NULL) {
503                 DEBUG(DEBUG_ERR, (__location__ " This addr: %s does not contain a mask\n", s));
504                 talloc_free(tmp_ctx);
505                 return false;
506         }
507
508         *mask = strtoul(p+1, &endp, 10);
509         if (endp == NULL || *endp != 0) {
510                 /* trailing garbage */
511                 DEBUG(DEBUG_ERR, (__location__ " Trailing garbage after the mask in %s\n", s));
512                 talloc_free(tmp_ctx);
513                 return false;
514         }
515         *p = 0;
516
517
518         /* now is this a ipv4 or ipv6 address ?*/
519         ret = parse_ip(s, ifaces, 0, addr);
520
521         talloc_free(tmp_ctx);
522         return ret;
523 }
524
525 /*
526    This is used to canonicalize a ctdb_sock_addr structure.
527 */
528 void ctdb_canonicalize_ip(const ctdb_sock_addr *ip, ctdb_sock_addr *cip)
529 {
530         char prefix[12] = { 0,0,0,0,0,0,0,0,0,0,0xff,0xff };
531
532         memcpy(cip, ip, sizeof (*cip));
533
534         if ( (ip->sa.sa_family == AF_INET6)
535         && !memcmp(&ip->ip6.sin6_addr, prefix, 12)) {
536                 memset(cip, 0, sizeof(*cip));
537 #ifdef HAVE_SOCK_SIN_LEN
538                 cip->ip.sin_len = sizeof(*cip);
539 #endif
540                 cip->ip.sin_family = AF_INET;
541                 cip->ip.sin_port   = ip->ip6.sin6_port;
542                 memcpy(&cip->ip.sin_addr, &ip->ip6.sin6_addr.s6_addr[12], 4);
543         }
544 }
545
546 bool ctdb_same_ip(const ctdb_sock_addr *tip1, const ctdb_sock_addr *tip2)
547 {
548         ctdb_sock_addr ip1, ip2;
549
550         ctdb_canonicalize_ip(tip1, &ip1);
551         ctdb_canonicalize_ip(tip2, &ip2);
552         
553         if (ip1.sa.sa_family != ip2.sa.sa_family) {
554                 return false;
555         }
556
557         switch (ip1.sa.sa_family) {
558         case AF_INET:
559                 return ip1.ip.sin_addr.s_addr == ip2.ip.sin_addr.s_addr;
560         case AF_INET6:
561                 return !memcmp(&ip1.ip6.sin6_addr.s6_addr[0],
562                                 &ip2.ip6.sin6_addr.s6_addr[0],
563                                 16);
564         default:
565                 DEBUG(DEBUG_ERR, (__location__ " CRITICAL Can not compare sockaddr structures of type %u\n", ip1.sa.sa_family));
566                 return false;
567         }
568
569         return true;
570 }
571
572 /*
573   compare two ctdb_sock_addr structures
574  */
575 bool ctdb_same_sockaddr(const ctdb_sock_addr *ip1, const ctdb_sock_addr *ip2)
576 {
577         return ctdb_same_ip(ip1, ip2) && ip1->ip.sin_port == ip2->ip.sin_port;
578 }
579
580 char *ctdb_addr_to_str(ctdb_sock_addr *addr)
581 {
582         static char cip[128] = "";
583
584         switch (addr->sa.sa_family) {
585         case AF_INET:
586                 inet_ntop(addr->ip.sin_family, &addr->ip.sin_addr, cip, sizeof(cip));
587                 break;
588         case AF_INET6:
589                 inet_ntop(addr->ip6.sin6_family, &addr->ip6.sin6_addr, cip, sizeof(cip));
590                 break;
591         default:
592                 DEBUG(DEBUG_ERR, (__location__ " ERROR, unknown family %u\n", addr->sa.sa_family));
593                 ctdb_external_trace();
594         }
595
596         return cip;
597 }
598
599 unsigned ctdb_addr_to_port(ctdb_sock_addr *addr)
600 {
601         switch (addr->sa.sa_family) {
602         case AF_INET:
603                 return ntohs(addr->ip.sin_port);
604                 break;
605         case AF_INET6:
606                 return ntohs(addr->ip6.sin6_port);
607                 break;
608         default:
609                 DEBUG(DEBUG_ERR, (__location__ " ERROR, unknown family %u\n", addr->sa.sa_family));
610         }
611
612         return 0;
613 }
614
615 void ctdb_block_signal(int signum)
616 {
617         sigset_t set;
618         sigemptyset(&set);
619         sigaddset(&set,signum);
620         sigprocmask(SIG_BLOCK,&set,NULL);
621 }
622
623 void ctdb_unblock_signal(int signum)
624 {
625         sigset_t set;
626         sigemptyset(&set);
627         sigaddset(&set,signum);
628         sigprocmask(SIG_UNBLOCK,&set,NULL);
629 }
630
631 struct debug_levels debug_levels[] = {
632         {DEBUG_EMERG,   "EMERG"},
633         {DEBUG_ALERT,   "ALERT"},
634         {DEBUG_CRIT,    "CRIT"},
635         {DEBUG_ERR,     "ERR"},
636         {DEBUG_WARNING, "WARNING"},
637         {DEBUG_NOTICE,  "NOTICE"},
638         {DEBUG_INFO,    "INFO"},
639         {DEBUG_DEBUG,   "DEBUG"},
640         {0, NULL}
641 };
642
643 const char *get_debug_by_level(int32_t level)
644 {
645         int i;
646
647         for (i=0; debug_levels[i].description != NULL; i++) {
648                 if (debug_levels[i].level == level) {
649                         return debug_levels[i].description;
650                 }
651         }
652         return "Unknown";
653 }
654
655 int32_t get_debug_by_desc(const char *desc)
656 {
657         int i;
658
659         for (i=0; debug_levels[i].description != NULL; i++) {
660                 if (!strcasecmp(debug_levels[i].description, desc)) {
661                         return debug_levels[i].level;
662                 }
663         }
664
665         return DEBUG_ERR;
666 }
667
668 /* we don't lock future pages here; it would increase the chance that
669  * we'd fail to mmap later on. */
670 void ctdb_lockdown_memory(struct ctdb_context *ctdb)
671 {
672 #ifdef HAVE_MLOCKALL
673         /* Extra stack, please! */
674         char dummy[10000];
675         memset(dummy, 0, sizeof(dummy));
676
677         if (ctdb->valgrinding) {
678                 return;
679         }
680
681         /* TODO: Add a command line option to disable memory lockdown.
682          *       This can be a performance issue on AIX since fork() copies
683          *       all locked memory pages. 
684          */
685
686         /* Ignore when running in local daemons mode */
687         if (getuid() != 0) {
688                 return;
689         }
690
691         /* Avoid compiler optimizing out dummy. */
692         mlock(dummy, sizeof(dummy));
693         if (mlockall(MCL_CURRENT) != 0) {
694                 DEBUG(DEBUG_WARNING,("Failed to lockdown memory: %s'\n",
695                                      strerror(errno)));
696         }
697 #endif
698 }
699
700 const char *ctdb_eventscript_call_names[] = {
701         "init",
702         "setup",
703         "startup",
704         "startrecovery",
705         "recovered",
706         "takeip",
707         "releaseip",
708         "stopped",
709         "monitor",
710         "status",
711         "shutdown",
712         "reload",
713         "updateip",
714         "ipreallocated"
715 };
716
717 /* Runstate handling */
718 static struct {
719         enum ctdb_runstate runstate;
720         const char * label;
721 } runstate_map[] = {
722         { CTDB_RUNSTATE_UNKNOWN, "UNKNOWN" },
723         { CTDB_RUNSTATE_INIT, "INIT" },
724         { CTDB_RUNSTATE_SETUP, "SETUP" },
725         { CTDB_RUNSTATE_FIRST_RECOVERY, "FIRST_RECOVERY" },
726         { CTDB_RUNSTATE_STARTUP, "STARTUP" },
727         { CTDB_RUNSTATE_RUNNING, "RUNNING" },
728         { CTDB_RUNSTATE_SHUTDOWN, "SHUTDOWN" },
729         { -1, NULL },
730 };
731
732 const char *runstate_to_string(enum ctdb_runstate runstate)
733 {
734         int i;
735         for (i=0; runstate_map[i].label != NULL ; i++) {
736                 if (runstate_map[i].runstate == runstate) {
737                         return runstate_map[i].label;
738                 }
739         }
740
741         return runstate_map[0].label;
742 }
743
744 enum ctdb_runstate runstate_from_string(const char *label)
745 {
746         int i;
747         for (i=0; runstate_map[i].label != NULL; i++) {
748                 if (strcasecmp(runstate_map[i].label, label) == 0) {
749                         return runstate_map[i].runstate;
750                 }
751         }
752
753         return CTDB_RUNSTATE_UNKNOWN;
754 }
755
756 void ctdb_set_runstate(struct ctdb_context *ctdb, enum ctdb_runstate runstate)
757 {
758         if (runstate <= ctdb->runstate) {
759                 ctdb_fatal(ctdb, "runstate must always increase");
760         }
761
762         DEBUG(DEBUG_NOTICE,("Set runstate to %s (%d)\n",
763                             runstate_to_string(runstate), runstate));
764         ctdb->runstate = runstate;
765 }