util: In passing the code, fix a space vs. tab in set_close_on_exec().
[amitay/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         /* now is this a ipv4 or ipv6 address ?*/
471         p = index(addr, ':');
472         if (p == NULL) {
473                 ret = parse_ipv4(addr, port, &saddr->ip);
474         } else {
475                 ret = parse_ipv6(addr, ifaces, port, saddr);
476         }
477
478         return ret;
479 }
480
481 /*
482   parse a ip/mask pair
483  */
484 bool parse_ip_mask(const char *str, const char *ifaces, ctdb_sock_addr *addr, unsigned *mask)
485 {
486         TALLOC_CTX *tmp_ctx = talloc_new(NULL);
487         char *s, *p;
488         char *endp = NULL;
489         bool ret;
490
491         ZERO_STRUCT(*addr);
492         s = talloc_strdup(tmp_ctx, str);
493         if (s == NULL) {
494                 DEBUG(DEBUG_ERR, (__location__ " Failed strdup()\n"));
495                 talloc_free(tmp_ctx);
496                 return false;
497         }
498
499         p = rindex(s, '/');
500         if (p == NULL) {
501                 DEBUG(DEBUG_ERR, (__location__ " This addr: %s does not contain a mask\n", s));
502                 talloc_free(tmp_ctx);
503                 return false;
504         }
505
506         *mask = strtoul(p+1, &endp, 10);
507         if (endp == NULL || *endp != 0) {
508                 /* trailing garbage */
509                 DEBUG(DEBUG_ERR, (__location__ " Trailing garbage after the mask in %s\n", s));
510                 talloc_free(tmp_ctx);
511                 return false;
512         }
513         *p = 0;
514
515
516         /* now is this a ipv4 or ipv6 address ?*/
517         ret = parse_ip(s, ifaces, 0, addr);
518
519         talloc_free(tmp_ctx);
520         return ret;
521 }
522
523 /*
524    This is used to canonicalize a ctdb_sock_addr structure.
525 */
526 void ctdb_canonicalize_ip(const ctdb_sock_addr *ip, ctdb_sock_addr *cip)
527 {
528         char prefix[12] = { 0,0,0,0,0,0,0,0,0,0,0xff,0xff };
529
530         memcpy(cip, ip, sizeof (*cip));
531
532         if ( (ip->sa.sa_family == AF_INET6)
533         && !memcmp(&ip->ip6.sin6_addr, prefix, 12)) {
534                 memset(cip, 0, sizeof(*cip));
535 #ifdef HAVE_SOCK_SIN_LEN
536                 cip->ip.sin_len = sizeof(*cip);
537 #endif
538                 cip->ip.sin_family = AF_INET;
539                 cip->ip.sin_port   = ip->ip6.sin6_port;
540                 memcpy(&cip->ip.sin_addr, &ip->ip6.sin6_addr.s6_addr[12], 4);
541         }
542 }
543
544 bool ctdb_same_ip(const ctdb_sock_addr *tip1, const ctdb_sock_addr *tip2)
545 {
546         ctdb_sock_addr ip1, ip2;
547
548         ctdb_canonicalize_ip(tip1, &ip1);
549         ctdb_canonicalize_ip(tip2, &ip2);
550         
551         if (ip1.sa.sa_family != ip2.sa.sa_family) {
552                 return false;
553         }
554
555         switch (ip1.sa.sa_family) {
556         case AF_INET:
557                 return ip1.ip.sin_addr.s_addr == ip2.ip.sin_addr.s_addr;
558         case AF_INET6:
559                 return !memcmp(&ip1.ip6.sin6_addr.s6_addr[0],
560                                 &ip2.ip6.sin6_addr.s6_addr[0],
561                                 16);
562         default:
563                 DEBUG(DEBUG_ERR, (__location__ " CRITICAL Can not compare sockaddr structures of type %u\n", ip1.sa.sa_family));
564                 return false;
565         }
566
567         return true;
568 }
569
570 /*
571   compare two ctdb_sock_addr structures
572  */
573 bool ctdb_same_sockaddr(const ctdb_sock_addr *ip1, const ctdb_sock_addr *ip2)
574 {
575         return ctdb_same_ip(ip1, ip2) && ip1->ip.sin_port == ip2->ip.sin_port;
576 }
577
578 char *ctdb_addr_to_str(ctdb_sock_addr *addr)
579 {
580         static char cip[128] = "";
581
582         switch (addr->sa.sa_family) {
583         case AF_INET:
584                 inet_ntop(addr->ip.sin_family, &addr->ip.sin_addr, cip, sizeof(cip));
585                 break;
586         case AF_INET6:
587                 inet_ntop(addr->ip6.sin6_family, &addr->ip6.sin6_addr, cip, sizeof(cip));
588                 break;
589         default:
590                 DEBUG(DEBUG_ERR, (__location__ " ERROR, unknown family %u\n", addr->sa.sa_family));
591                 ctdb_external_trace();
592         }
593
594         return cip;
595 }
596
597 unsigned ctdb_addr_to_port(ctdb_sock_addr *addr)
598 {
599         switch (addr->sa.sa_family) {
600         case AF_INET:
601                 return ntohs(addr->ip.sin_port);
602                 break;
603         case AF_INET6:
604                 return ntohs(addr->ip6.sin6_port);
605                 break;
606         default:
607                 DEBUG(DEBUG_ERR, (__location__ " ERROR, unknown family %u\n", addr->sa.sa_family));
608         }
609
610         return 0;
611 }
612
613 void ctdb_block_signal(int signum)
614 {
615         sigset_t set;
616         sigemptyset(&set);
617         sigaddset(&set,signum);
618         sigprocmask(SIG_BLOCK,&set,NULL);
619 }
620
621 void ctdb_unblock_signal(int signum)
622 {
623         sigset_t set;
624         sigemptyset(&set);
625         sigaddset(&set,signum);
626         sigprocmask(SIG_UNBLOCK,&set,NULL);
627 }
628
629 struct debug_levels debug_levels[] = {
630         {DEBUG_EMERG,   "EMERG"},
631         {DEBUG_ALERT,   "ALERT"},
632         {DEBUG_CRIT,    "CRIT"},
633         {DEBUG_ERR,     "ERR"},
634         {DEBUG_WARNING, "WARNING"},
635         {DEBUG_NOTICE,  "NOTICE"},
636         {DEBUG_INFO,    "INFO"},
637         {DEBUG_DEBUG,   "DEBUG"},
638         {0, NULL}
639 };
640
641 const char *get_debug_by_level(int32_t level)
642 {
643         int i;
644
645         for (i=0; debug_levels[i].description != NULL; i++) {
646                 if (debug_levels[i].level == level) {
647                         return debug_levels[i].description;
648                 }
649         }
650         return "Unknown";
651 }
652
653 int32_t get_debug_by_desc(const char *desc)
654 {
655         int i;
656
657         for (i=0; debug_levels[i].description != NULL; i++) {
658                 if (!strcmp(debug_levels[i].description, desc)) {
659                         return debug_levels[i].level;
660                 }
661         }
662
663         return DEBUG_ERR;
664 }
665
666 /* we don't lock future pages here; it would increase the chance that
667  * we'd fail to mmap later on. */
668 void ctdb_lockdown_memory(struct ctdb_context *ctdb)
669 {
670 #ifdef HAVE_MLOCKALL
671         /* Extra stack, please! */
672         char dummy[10000];
673         memset(dummy, 0, sizeof(dummy));
674
675         if (ctdb->valgrinding) {
676                 return;
677         }
678
679         /* TODO: Add a command line option to disable memory lockdown.
680          *       This can be a performance issue on AIX since fork() copies
681          *       all locked memory pages. 
682          */
683
684         /* Ignore when running in local daemons mode */
685         if (getuid() != 0) {
686                 return;
687         }
688
689         /* Avoid compiler optimizing out dummy. */
690         mlock(dummy, sizeof(dummy));
691         if (mlockall(MCL_CURRENT) != 0) {
692                 DEBUG(DEBUG_WARNING,("Failed to lockdown memory: %s'\n",
693                                      strerror(errno)));
694         }
695 #endif
696 }
697
698 const char *ctdb_eventscript_call_names[] = {
699         "init",
700         "setup",
701         "startup",
702         "startrecovery",
703         "recovered",
704         "takeip",
705         "releaseip",
706         "stopped",
707         "monitor",
708         "status",
709         "shutdown",
710         "reload",
711         "updateip",
712         "ipreallocated"
713 };
714
715 /* Runstate handling */
716 static struct {
717         enum ctdb_runstate runstate;
718         const char * label;
719 } runstate_map[] = {
720         { CTDB_RUNSTATE_UNKNOWN, "UNKNOWN" },
721         { CTDB_RUNSTATE_INIT, "INIT" },
722         { CTDB_RUNSTATE_SETUP, "SETUP" },
723         { CTDB_RUNSTATE_FIRST_RECOVERY, "FIRST_RECOVERY" },
724         { CTDB_RUNSTATE_STARTUP, "STARTUP" },
725         { CTDB_RUNSTATE_RUNNING, "RUNNING" },
726         { CTDB_RUNSTATE_SHUTDOWN, "SHUTDOWN" },
727         { -1, NULL },
728 };
729
730 const char *runstate_to_string(enum ctdb_runstate runstate)
731 {
732         int i;
733         for (i=0; runstate_map[i].label != NULL ; i++) {
734                 if (runstate_map[i].runstate == runstate) {
735                         return runstate_map[i].label;
736                 }
737         }
738
739         return runstate_map[0].label;
740 }
741
742 enum ctdb_runstate runstate_from_string(const char *label)
743 {
744         int i;
745         for (i=0; runstate_map[i].label != NULL; i++) {
746                 if (strcasecmp(runstate_map[i].label, label) == 0) {
747                         return runstate_map[i].runstate;
748                 }
749         }
750
751         return CTDB_RUNSTATE_UNKNOWN;
752 }
753
754 void ctdb_set_runstate(struct ctdb_context *ctdb, enum ctdb_runstate runstate)
755 {
756         if (runstate <= ctdb->runstate) {
757                 ctdb_fatal(ctdb, "runstate must always increase");
758         }
759
760         DEBUG(DEBUG_NOTICE,("Set runstate to %s (%d)\n",
761                             runstate_to_string(runstate), runstate));
762         ctdb->runstate = runstate;
763 }