1 /* 2 * CDDL HEADER START 3 * 4 * The contents of this file are subject to the terms of the 5 * Common Development and Distribution License (the "License"). 6 * You may not use this file except in compliance with the License. 7 * 8 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE 9 * or http://www.opensolaris.org/os/licensing. 10 * See the License for the specific language governing permissions 11 * and limitations under the License. 12 * 13 * When distributing Covered Code, include this CDDL HEADER in each 14 * file and include the License file at usr/src/OPENSOLARIS.LICENSE. 15 * If applicable, add the following below this CDDL HEADER, with the 16 * fields enclosed by brackets "[]" replaced with your own identifying 17 * information: Portions Copyright [yyyy] [name of copyright owner] 18 * 19 * CDDL HEADER END 20 */ 21 22 /* 23 * Copyright (c) 2004, 2010, Oracle and/or its affiliates. All rights reserved. 24 * Copyright (c) 2013, Joyent, Inc. All rights reserved. 25 */ 26 27 /* 28 * restarter.c - service manipulation 29 * 30 * This component manages services whose restarter is svc.startd, the standard 31 * restarter. It translates restarter protocol events from the graph engine 32 * into actions on processes, as a delegated restarter would do. 33 * 34 * The master restarter manages a number of always-running threads: 35 * - restarter event thread: events from the graph engine 36 * - timeout thread: thread to fire queued timeouts 37 * - contract thread: thread to handle contract events 38 * - wait thread: thread to handle wait-based services 39 * 40 * The other threads are created as-needed: 41 * - per-instance method threads 42 * - per-instance event processing threads 43 * 44 * The interaction of all threads must result in the following conditions 45 * being satisfied (on a per-instance basis): 46 * - restarter events must be processed in order 47 * - method execution must be serialized 48 * - instance delete must be held until outstanding methods are complete 49 * - contract events shouldn't be processed while a method is running 50 * - timeouts should fire even when a method is running 51 * 52 * Service instances are represented by restarter_inst_t's and are kept in the 53 * instance_list list. 54 * 55 * Service States 56 * The current state of a service instance is kept in 57 * restarter_inst_t->ri_i.i_state. If transition to a new state could take 58 * some time, then before we effect the transition we set 59 * restarter_inst_t->ri_i.i_next_state to the target state, and afterwards we 60 * rotate i_next_state to i_state and set i_next_state to 61 * RESTARTER_STATE_NONE. So usually i_next_state is _NONE when ri_lock is not 62 * held. The exception is when we launch methods, which are done with 63 * a separate thread. To keep any other threads from grabbing ri_lock before 64 * method_thread() does, we set ri_method_thread to the thread id of the 65 * method thread, and when it is nonzero any thread with a different thread id 66 * waits on ri_method_cv. 67 * 68 * Method execution is serialized by blocking on ri_method_cv in 69 * inst_lookup_by_id() and waiting for a 0 value of ri_method_thread. This 70 * also prevents the instance structure from being deleted until all 71 * outstanding operations such as method_thread() have finished. 72 * 73 * Lock ordering: 74 * 75 * dgraph_lock [can be held when taking:] 76 * utmpx_lock 77 * dictionary->dict_lock 78 * st->st_load_lock 79 * wait_info_lock 80 * ru->restarter_update_lock 81 * restarter_queue->rpeq_lock 82 * instance_list.ril_lock 83 * inst->ri_lock 84 * st->st_configd_live_lock 85 * 86 * instance_list.ril_lock 87 * graph_queue->gpeq_lock 88 * gu->gu_lock 89 * st->st_configd_live_lock 90 * dictionary->dict_lock 91 * inst->ri_lock 92 * graph_queue->gpeq_lock 93 * gu->gu_lock 94 * tu->tu_lock 95 * tq->tq_lock 96 * inst->ri_queue_lock 97 * wait_info_lock 98 * bp->cb_lock 99 * utmpx_lock 100 * 101 * single_user_thread_lock 102 * wait_info_lock 103 * utmpx_lock 104 * 105 * gu_freeze_lock 106 * 107 * logbuf_mutex nests inside pretty much everything. 108 */ 109 110 #include <sys/contract/process.h> 111 #include <sys/ctfs.h> 112 #include <sys/stat.h> 113 #include <sys/time.h> 114 #include <sys/types.h> 115 #include <sys/uio.h> 116 #include <sys/wait.h> 117 #include <assert.h> 118 #include <errno.h> 119 #include <fcntl.h> 120 #include <libcontract.h> 121 #include <libcontract_priv.h> 122 #include <libintl.h> 123 #include <librestart.h> 124 #include <librestart_priv.h> 125 #include <libuutil.h> 126 #include <limits.h> 127 #include <poll.h> 128 #include <port.h> 129 #include <pthread.h> 130 #include <stdarg.h> 131 #include <stdio.h> 132 #include <strings.h> 133 #include <unistd.h> 134 135 #include "startd.h" 136 #include "protocol.h" 137 138 static uu_list_pool_t *restarter_instance_pool; 139 static restarter_instance_list_t instance_list; 140 141 static uu_list_pool_t *restarter_queue_pool; 142 143 #define WT_SVC_ERR_THROTTLE 1 /* 1 sec delay for erroring wait svc */ 144 145 /* 146 * Function used to reset the restart times for an instance, when 147 * an administrative task comes along and essentially makes the times 148 * in this array ineffective. 149 */ 150 static void 151 reset_start_times(restarter_inst_t *inst) 152 { 153 inst->ri_start_index = 0; 154 bzero(inst->ri_start_time, sizeof (inst->ri_start_time)); 155 } 156 157 /*ARGSUSED*/ 158 static int 159 restarter_instance_compare(const void *lc_arg, const void *rc_arg, 160 void *private) 161 { 162 int lc_id = ((const restarter_inst_t *)lc_arg)->ri_id; 163 int rc_id = *(int *)rc_arg; 164 165 if (lc_id > rc_id) 166 return (1); 167 if (lc_id < rc_id) 168 return (-1); 169 return (0); 170 } 171 172 static restarter_inst_t * 173 inst_lookup_by_name(const char *name) 174 { 175 int id; 176 177 id = dict_lookup_byname(name); 178 if (id == -1) 179 return (NULL); 180 181 return (inst_lookup_by_id(id)); 182 } 183 184 restarter_inst_t * 185 inst_lookup_by_id(int id) 186 { 187 restarter_inst_t *inst; 188 189 MUTEX_LOCK(&instance_list.ril_lock); 190 inst = uu_list_find(instance_list.ril_instance_list, &id, NULL, NULL); 191 if (inst != NULL) 192 MUTEX_LOCK(&inst->ri_lock); 193 MUTEX_UNLOCK(&instance_list.ril_lock); 194 195 if (inst != NULL) { 196 while (inst->ri_method_thread != 0 && 197 !pthread_equal(inst->ri_method_thread, pthread_self())) { 198 ++inst->ri_method_waiters; 199 (void) pthread_cond_wait(&inst->ri_method_cv, 200 &inst->ri_lock); 201 assert(inst->ri_method_waiters > 0); 202 --inst->ri_method_waiters; 203 } 204 } 205 206 return (inst); 207 } 208 209 static restarter_inst_t * 210 inst_lookup_queue(const char *name) 211 { 212 int id; 213 restarter_inst_t *inst; 214 215 id = dict_lookup_byname(name); 216 if (id == -1) 217 return (NULL); 218 219 MUTEX_LOCK(&instance_list.ril_lock); 220 inst = uu_list_find(instance_list.ril_instance_list, &id, NULL, NULL); 221 if (inst != NULL) 222 MUTEX_LOCK(&inst->ri_queue_lock); 223 MUTEX_UNLOCK(&instance_list.ril_lock); 224 225 return (inst); 226 } 227 228 const char * 229 service_style(int flags) 230 { 231 switch (flags & RINST_STYLE_MASK) { 232 case RINST_CONTRACT: return ("contract"); 233 case RINST_TRANSIENT: return ("transient"); 234 case RINST_WAIT: return ("wait"); 235 236 default: 237 #ifndef NDEBUG 238 uu_warn("%s:%d: Bad flags 0x%x.\n", __FILE__, __LINE__, flags); 239 #endif 240 abort(); 241 /* NOTREACHED */ 242 } 243 } 244 245 /* 246 * Fails with ECONNABORTED or ECANCELED. 247 */ 248 static int 249 check_contract(restarter_inst_t *inst, boolean_t primary, 250 scf_instance_t *scf_inst) 251 { 252 ctid_t *ctidp; 253 int fd, r; 254 255 ctidp = primary ? &inst->ri_i.i_primary_ctid : 256 &inst->ri_i.i_transient_ctid; 257 258 assert(*ctidp >= 1); 259 260 fd = contract_open(*ctidp, NULL, "status", O_RDONLY); 261 if (fd >= 0) { 262 r = close(fd); 263 assert(r == 0); 264 return (0); 265 } 266 267 r = restarter_remove_contract(scf_inst, *ctidp, primary ? 268 RESTARTER_CONTRACT_PRIMARY : RESTARTER_CONTRACT_TRANSIENT); 269 switch (r) { 270 case 0: 271 case ECONNABORTED: 272 case ECANCELED: 273 *ctidp = 0; 274 return (r); 275 276 case ENOMEM: 277 uu_die("Out of memory\n"); 278 /* NOTREACHED */ 279 280 case EPERM: 281 uu_die("Insufficient privilege.\n"); 282 /* NOTREACHED */ 283 284 case EACCES: 285 uu_die("Repository backend access denied.\n"); 286 /* NOTREACHED */ 287 288 case EROFS: 289 log_error(LOG_INFO, "Could not remove unusable contract id %ld " 290 "for %s from repository.\n", *ctidp, inst->ri_i.i_fmri); 291 return (0); 292 293 case EINVAL: 294 case EBADF: 295 default: 296 assert(0); 297 abort(); 298 /* NOTREACHED */ 299 } 300 } 301 302 static int stop_instance(scf_handle_t *, restarter_inst_t *, stop_cause_t); 303 304 /* 305 * int restarter_insert_inst(scf_handle_t *, char *) 306 * If the inst is already in the restarter list, return its id. If the inst 307 * is not in the restarter list, initialize a restarter_inst_t, initialize its 308 * states, insert it into the list, and return 0. 309 * 310 * Fails with 311 * ENOENT - name is not in the repository 312 */ 313 static int 314 restarter_insert_inst(scf_handle_t *h, const char *name) 315 { 316 int id, r; 317 restarter_inst_t *inst; 318 uu_list_index_t idx; 319 scf_service_t *scf_svc; 320 scf_instance_t *scf_inst; 321 scf_snapshot_t *snap = NULL; 322 scf_propertygroup_t *pg; 323 char *svc_name, *inst_name; 324 char logfilebuf[PATH_MAX]; 325 char *c; 326 boolean_t do_commit_states; 327 restarter_instance_state_t state, next_state; 328 protocol_states_t *ps; 329 pid_t start_pid; 330 restarter_str_t reason = restarter_str_insert_in_graph; 331 332 MUTEX_LOCK(&instance_list.ril_lock); 333 334 /* 335 * We don't use inst_lookup_by_name() here because we want the lookup 336 * & insert to be atomic. 337 */ 338 id = dict_lookup_byname(name); 339 if (id != -1) { 340 inst = uu_list_find(instance_list.ril_instance_list, &id, NULL, 341 &idx); 342 if (inst != NULL) { 343 MUTEX_UNLOCK(&instance_list.ril_lock); 344 return (0); 345 } 346 } 347 348 /* Allocate an instance */ 349 inst = startd_zalloc(sizeof (restarter_inst_t)); 350 inst->ri_utmpx_prefix = startd_alloc(max_scf_value_size); 351 inst->ri_utmpx_prefix[0] = '\0'; 352 353 inst->ri_i.i_fmri = startd_alloc(strlen(name) + 1); 354 (void) strcpy((char *)inst->ri_i.i_fmri, name); 355 356 inst->ri_queue = startd_list_create(restarter_queue_pool, inst, 0); 357 358 /* 359 * id shouldn't be -1 since we use the same dictionary as graph.c, but 360 * just in case. 361 */ 362 inst->ri_id = (id != -1 ? id : dict_insert(name)); 363 364 special_online_hooks_get(name, &inst->ri_pre_online_hook, 365 &inst->ri_post_online_hook, &inst->ri_post_offline_hook); 366 367 scf_svc = safe_scf_service_create(h); 368 scf_inst = safe_scf_instance_create(h); 369 pg = safe_scf_pg_create(h); 370 svc_name = startd_alloc(max_scf_name_size); 371 inst_name = startd_alloc(max_scf_name_size); 372 373 rep_retry: 374 if (snap != NULL) 375 scf_snapshot_destroy(snap); 376 if (inst->ri_logstem != NULL) 377 startd_free(inst->ri_logstem, PATH_MAX); 378 if (inst->ri_common_name != NULL) 379 free(inst->ri_common_name); 380 if (inst->ri_C_common_name != NULL) 381 free(inst->ri_C_common_name); 382 snap = NULL; 383 inst->ri_logstem = NULL; 384 inst->ri_common_name = NULL; 385 inst->ri_C_common_name = NULL; 386 387 if (scf_handle_decode_fmri(h, name, NULL, scf_svc, scf_inst, NULL, 388 NULL, SCF_DECODE_FMRI_EXACT) != 0) { 389 switch (scf_error()) { 390 case SCF_ERROR_CONNECTION_BROKEN: 391 libscf_handle_rebind(h); 392 goto rep_retry; 393 394 case SCF_ERROR_NOT_FOUND: 395 goto deleted; 396 } 397 398 uu_die("Can't decode FMRI %s: %s\n", name, 399 scf_strerror(scf_error())); 400 } 401 402 /* 403 * If there's no running snapshot, then we execute using the editing 404 * snapshot. Pending snapshots will be taken later. 405 */ 406 snap = libscf_get_running_snapshot(scf_inst); 407 408 if ((scf_service_get_name(scf_svc, svc_name, max_scf_name_size) < 0) || 409 (scf_instance_get_name(scf_inst, inst_name, max_scf_name_size) < 410 0)) { 411 switch (scf_error()) { 412 case SCF_ERROR_NOT_SET: 413 break; 414 415 case SCF_ERROR_CONNECTION_BROKEN: 416 libscf_handle_rebind(h); 417 goto rep_retry; 418 419 default: 420 assert(0); 421 abort(); 422 } 423 424 goto deleted; 425 } 426 427 (void) snprintf(logfilebuf, PATH_MAX, "%s:%s", svc_name, inst_name); 428 for (c = logfilebuf; *c != '\0'; c++) 429 if (*c == '/') 430 *c = '-'; 431 432 inst->ri_logstem = startd_alloc(PATH_MAX); 433 (void) snprintf(inst->ri_logstem, PATH_MAX, "%s%s", logfilebuf, 434 LOG_SUFFIX); 435 436 /* 437 * If the restarter group is missing, use uninit/none. Otherwise, 438 * we're probably being restarted & don't want to mess up the states 439 * that are there. 440 */ 441 state = RESTARTER_STATE_UNINIT; 442 next_state = RESTARTER_STATE_NONE; 443 444 r = scf_instance_get_pg(scf_inst, SCF_PG_RESTARTER, pg); 445 if (r != 0) { 446 switch (scf_error()) { 447 case SCF_ERROR_CONNECTION_BROKEN: 448 libscf_handle_rebind(h); 449 goto rep_retry; 450 451 case SCF_ERROR_NOT_SET: 452 goto deleted; 453 454 case SCF_ERROR_NOT_FOUND: 455 /* 456 * This shouldn't happen since the graph engine should 457 * have initialized the state to uninitialized/none if 458 * there was no restarter pg. In case somebody 459 * deleted it, though.... 460 */ 461 do_commit_states = B_TRUE; 462 break; 463 464 default: 465 assert(0); 466 abort(); 467 } 468 } else { 469 r = libscf_read_states(pg, &state, &next_state); 470 if (r != 0) { 471 do_commit_states = B_TRUE; 472 } else { 473 if (next_state != RESTARTER_STATE_NONE) { 474 /* 475 * Force next_state to _NONE since we 476 * don't look for method processes. 477 */ 478 next_state = RESTARTER_STATE_NONE; 479 do_commit_states = B_TRUE; 480 } else { 481 /* 482 * The reason for transition will depend on 483 * state. 484 */ 485 if (st->st_initial == 0) 486 reason = restarter_str_startd_restart; 487 else if (state == RESTARTER_STATE_MAINT) 488 reason = restarter_str_bad_repo_state; 489 /* 490 * Inform the restarter of our state without 491 * changing the STIME in the repository. 492 */ 493 ps = startd_alloc(sizeof (*ps)); 494 inst->ri_i.i_state = ps->ps_state = state; 495 inst->ri_i.i_next_state = ps->ps_state_next = 496 next_state; 497 ps->ps_reason = reason; 498 499 graph_protocol_send_event(inst->ri_i.i_fmri, 500 GRAPH_UPDATE_STATE_CHANGE, ps); 501 502 do_commit_states = B_FALSE; 503 } 504 } 505 } 506 507 switch (libscf_get_startd_properties(scf_inst, snap, &inst->ri_flags, 508 &inst->ri_utmpx_prefix)) { 509 case 0: 510 break; 511 512 case ECONNABORTED: 513 libscf_handle_rebind(h); 514 goto rep_retry; 515 516 case ECANCELED: 517 goto deleted; 518 519 case ENOENT: 520 /* 521 * This is odd, because the graph engine should have required 522 * the general property group. So we'll just use default 523 * flags in anticipation of the graph engine sending us 524 * REMOVE_INSTANCE when it finds out that the general property 525 * group has been deleted. 526 */ 527 inst->ri_flags = RINST_CONTRACT; 528 break; 529 530 default: 531 assert(0); 532 abort(); 533 } 534 535 r = libscf_get_template_values(scf_inst, snap, 536 &inst->ri_common_name, &inst->ri_C_common_name); 537 538 /* 539 * Copy our names to smaller buffers to reduce our memory footprint. 540 */ 541 if (inst->ri_common_name != NULL) { 542 char *tmp = safe_strdup(inst->ri_common_name); 543 startd_free(inst->ri_common_name, max_scf_value_size); 544 inst->ri_common_name = tmp; 545 } 546 547 if (inst->ri_C_common_name != NULL) { 548 char *tmp = safe_strdup(inst->ri_C_common_name); 549 startd_free(inst->ri_C_common_name, max_scf_value_size); 550 inst->ri_C_common_name = tmp; 551 } 552 553 switch (r) { 554 case 0: 555 break; 556 557 case ECONNABORTED: 558 libscf_handle_rebind(h); 559 goto rep_retry; 560 561 case ECANCELED: 562 goto deleted; 563 564 case ECHILD: 565 case ENOENT: 566 break; 567 568 default: 569 assert(0); 570 abort(); 571 } 572 573 switch (libscf_read_method_ids(h, scf_inst, inst->ri_i.i_fmri, 574 &inst->ri_i.i_primary_ctid, &inst->ri_i.i_transient_ctid, 575 &start_pid)) { 576 case 0: 577 break; 578 579 case ECONNABORTED: 580 libscf_handle_rebind(h); 581 goto rep_retry; 582 583 case ECANCELED: 584 goto deleted; 585 586 default: 587 assert(0); 588 abort(); 589 } 590 591 if (inst->ri_i.i_primary_ctid >= 1) { 592 contract_hash_store(inst->ri_i.i_primary_ctid, inst->ri_id); 593 594 switch (check_contract(inst, B_TRUE, scf_inst)) { 595 case 0: 596 break; 597 598 case ECONNABORTED: 599 libscf_handle_rebind(h); 600 goto rep_retry; 601 602 case ECANCELED: 603 goto deleted; 604 605 default: 606 assert(0); 607 abort(); 608 } 609 } 610 611 if (inst->ri_i.i_transient_ctid >= 1) { 612 switch (check_contract(inst, B_FALSE, scf_inst)) { 613 case 0: 614 break; 615 616 case ECONNABORTED: 617 libscf_handle_rebind(h); 618 goto rep_retry; 619 620 case ECANCELED: 621 goto deleted; 622 623 default: 624 assert(0); 625 abort(); 626 } 627 } 628 629 /* No more failures we live through, so add it to the list. */ 630 (void) pthread_mutex_init(&inst->ri_lock, &mutex_attrs); 631 (void) pthread_mutex_init(&inst->ri_queue_lock, &mutex_attrs); 632 MUTEX_LOCK(&inst->ri_lock); 633 MUTEX_LOCK(&inst->ri_queue_lock); 634 635 (void) pthread_cond_init(&inst->ri_method_cv, NULL); 636 637 uu_list_node_init(inst, &inst->ri_link, restarter_instance_pool); 638 uu_list_insert(instance_list.ril_instance_list, inst, idx); 639 MUTEX_UNLOCK(&instance_list.ril_lock); 640 641 if (start_pid != -1 && 642 (inst->ri_flags & RINST_STYLE_MASK) == RINST_WAIT) { 643 int ret; 644 ret = wait_register(start_pid, inst->ri_i.i_fmri, 0, 1); 645 if (ret == -1) { 646 /* 647 * Implication: if we can't reregister the 648 * instance, we will start another one. Two 649 * instances may or may not result in a resource 650 * conflict. 651 */ 652 log_error(LOG_WARNING, 653 "%s: couldn't reregister %ld for wait\n", 654 inst->ri_i.i_fmri, start_pid); 655 } else if (ret == 1) { 656 /* 657 * Leading PID has exited. 658 */ 659 (void) stop_instance(h, inst, RSTOP_EXIT); 660 } 661 } 662 663 664 scf_pg_destroy(pg); 665 666 if (do_commit_states) 667 (void) restarter_instance_update_states(h, inst, state, 668 next_state, RERR_NONE, reason); 669 670 log_framework(LOG_DEBUG, "%s is a %s-style service\n", name, 671 service_style(inst->ri_flags)); 672 673 MUTEX_UNLOCK(&inst->ri_queue_lock); 674 MUTEX_UNLOCK(&inst->ri_lock); 675 676 startd_free(svc_name, max_scf_name_size); 677 startd_free(inst_name, max_scf_name_size); 678 scf_snapshot_destroy(snap); 679 scf_instance_destroy(scf_inst); 680 scf_service_destroy(scf_svc); 681 682 log_framework(LOG_DEBUG, "%s: inserted instance into restarter list\n", 683 name); 684 685 return (0); 686 687 deleted: 688 MUTEX_UNLOCK(&instance_list.ril_lock); 689 startd_free(inst_name, max_scf_name_size); 690 startd_free(svc_name, max_scf_name_size); 691 if (snap != NULL) 692 scf_snapshot_destroy(snap); 693 scf_pg_destroy(pg); 694 scf_instance_destroy(scf_inst); 695 scf_service_destroy(scf_svc); 696 startd_free((void *)inst->ri_i.i_fmri, strlen(inst->ri_i.i_fmri) + 1); 697 uu_list_destroy(inst->ri_queue); 698 if (inst->ri_logstem != NULL) 699 startd_free(inst->ri_logstem, PATH_MAX); 700 if (inst->ri_common_name != NULL) 701 free(inst->ri_common_name); 702 if (inst->ri_C_common_name != NULL) 703 free(inst->ri_C_common_name); 704 startd_free(inst->ri_utmpx_prefix, max_scf_value_size); 705 startd_free(inst, sizeof (restarter_inst_t)); 706 return (ENOENT); 707 } 708 709 static void 710 restarter_delete_inst(restarter_inst_t *ri) 711 { 712 int id; 713 restarter_inst_t *rip; 714 void *cookie = NULL; 715 restarter_instance_qentry_t *e; 716 717 assert(MUTEX_HELD(&ri->ri_lock)); 718 719 /* 720 * Must drop the instance lock so we can pick up the instance_list 721 * lock & remove the instance. 722 */ 723 id = ri->ri_id; 724 MUTEX_UNLOCK(&ri->ri_lock); 725 726 MUTEX_LOCK(&instance_list.ril_lock); 727 728 rip = uu_list_find(instance_list.ril_instance_list, &id, NULL, NULL); 729 if (rip == NULL) { 730 MUTEX_UNLOCK(&instance_list.ril_lock); 731 return; 732 } 733 734 assert(ri == rip); 735 736 uu_list_remove(instance_list.ril_instance_list, ri); 737 738 log_framework(LOG_DEBUG, "%s: deleted instance from restarter list\n", 739 ri->ri_i.i_fmri); 740 741 MUTEX_UNLOCK(&instance_list.ril_lock); 742 743 /* 744 * We can lock the instance without holding the instance_list lock 745 * since we removed the instance from the list. 746 */ 747 MUTEX_LOCK(&ri->ri_lock); 748 MUTEX_LOCK(&ri->ri_queue_lock); 749 750 if (ri->ri_i.i_primary_ctid >= 1) 751 contract_hash_remove(ri->ri_i.i_primary_ctid); 752 753 while (ri->ri_method_thread != 0 || ri->ri_method_waiters > 0) 754 (void) pthread_cond_wait(&ri->ri_method_cv, &ri->ri_lock); 755 756 while ((e = uu_list_teardown(ri->ri_queue, &cookie)) != NULL) 757 startd_free(e, sizeof (*e)); 758 uu_list_destroy(ri->ri_queue); 759 760 startd_free((void *)ri->ri_i.i_fmri, strlen(ri->ri_i.i_fmri) + 1); 761 startd_free(ri->ri_logstem, PATH_MAX); 762 if (ri->ri_common_name != NULL) 763 free(ri->ri_common_name); 764 if (ri->ri_C_common_name != NULL) 765 free(ri->ri_C_common_name); 766 startd_free(ri->ri_utmpx_prefix, max_scf_value_size); 767 (void) pthread_mutex_destroy(&ri->ri_lock); 768 (void) pthread_mutex_destroy(&ri->ri_queue_lock); 769 startd_free(ri, sizeof (restarter_inst_t)); 770 } 771 772 /* 773 * instance_is_wait_style() 774 * 775 * Returns 1 if the given instance is a "wait-style" service instance. 776 */ 777 int 778 instance_is_wait_style(restarter_inst_t *inst) 779 { 780 assert(MUTEX_HELD(&inst->ri_lock)); 781 return ((inst->ri_flags & RINST_STYLE_MASK) == RINST_WAIT); 782 } 783 784 /* 785 * instance_is_transient_style() 786 * 787 * Returns 1 if the given instance is a transient service instance. 788 */ 789 int 790 instance_is_transient_style(restarter_inst_t *inst) 791 { 792 assert(MUTEX_HELD(&inst->ri_lock)); 793 return ((inst->ri_flags & RINST_STYLE_MASK) == RINST_TRANSIENT); 794 } 795 796 /* 797 * instance_in_transition() 798 * Returns 1 if instance is in transition, 0 if not 799 */ 800 int 801 instance_in_transition(restarter_inst_t *inst) 802 { 803 assert(MUTEX_HELD(&inst->ri_lock)); 804 if (inst->ri_i.i_next_state == RESTARTER_STATE_NONE) 805 return (0); 806 return (1); 807 } 808 809 /* 810 * returns 1 if instance is already started, 0 if not 811 */ 812 static int 813 instance_started(restarter_inst_t *inst) 814 { 815 int ret; 816 817 assert(MUTEX_HELD(&inst->ri_lock)); 818 819 if (inst->ri_i.i_state == RESTARTER_STATE_ONLINE || 820 inst->ri_i.i_state == RESTARTER_STATE_DEGRADED) 821 ret = 1; 822 else 823 ret = 0; 824 825 return (ret); 826 } 827 828 /* 829 * Returns 830 * 0 - success 831 * ECONNRESET - success, but h was rebound 832 */ 833 int 834 restarter_instance_update_states(scf_handle_t *h, restarter_inst_t *ri, 835 restarter_instance_state_t new_state, 836 restarter_instance_state_t new_state_next, restarter_error_t err, 837 restarter_str_t reason) 838 { 839 protocol_states_t *states; 840 int e; 841 uint_t retry_count = 0, msecs = ALLOC_DELAY; 842 boolean_t rebound = B_FALSE; 843 int prev_state_online; 844 int state_online; 845 846 assert(MUTEX_HELD(&ri->ri_lock)); 847 848 prev_state_online = instance_started(ri); 849 850 retry: 851 e = _restarter_commit_states(h, &ri->ri_i, new_state, new_state_next, 852 restarter_get_str_short(reason)); 853 switch (e) { 854 case 0: 855 break; 856 857 case ENOMEM: 858 ++retry_count; 859 if (retry_count < ALLOC_RETRY) { 860 (void) poll(NULL, 0, msecs); 861 msecs *= ALLOC_DELAY_MULT; 862 goto retry; 863 } 864 865 /* Like startd_alloc(). */ 866 uu_die("Insufficient memory.\n"); 867 /* NOTREACHED */ 868 869 case ECONNABORTED: 870 libscf_handle_rebind(h); 871 rebound = B_TRUE; 872 goto retry; 873 874 case EPERM: 875 case EACCES: 876 case EROFS: 877 log_error(LOG_NOTICE, "Could not commit state change for %s " 878 "to repository: %s.\n", ri->ri_i.i_fmri, strerror(e)); 879 /* FALLTHROUGH */ 880 881 case ENOENT: 882 ri->ri_i.i_state = new_state; 883 ri->ri_i.i_next_state = new_state_next; 884 break; 885 886 case EINVAL: 887 default: 888 bad_error("_restarter_commit_states", e); 889 } 890 891 states = startd_alloc(sizeof (protocol_states_t)); 892 states->ps_state = new_state; 893 states->ps_state_next = new_state_next; 894 states->ps_err = err; 895 states->ps_reason = reason; 896 graph_protocol_send_event(ri->ri_i.i_fmri, GRAPH_UPDATE_STATE_CHANGE, 897 (void *)states); 898 899 state_online = instance_started(ri); 900 901 if (prev_state_online && !state_online) 902 ri->ri_post_offline_hook(); 903 else if (!prev_state_online && state_online) 904 ri->ri_post_online_hook(); 905 906 return (rebound ? ECONNRESET : 0); 907 } 908 909 void 910 restarter_mark_pending_snapshot(const char *fmri, uint_t flag) 911 { 912 restarter_inst_t *inst; 913 914 assert(flag == RINST_RETAKE_RUNNING || flag == RINST_RETAKE_START); 915 916 inst = inst_lookup_by_name(fmri); 917 if (inst == NULL) 918 return; 919 920 inst->ri_flags |= flag; 921 922 MUTEX_UNLOCK(&inst->ri_lock); 923 } 924 925 static void 926 restarter_take_pending_snapshots(scf_handle_t *h) 927 { 928 restarter_inst_t *inst; 929 int r; 930 931 MUTEX_LOCK(&instance_list.ril_lock); 932 933 for (inst = uu_list_first(instance_list.ril_instance_list); 934 inst != NULL; 935 inst = uu_list_next(instance_list.ril_instance_list, inst)) { 936 const char *fmri; 937 scf_instance_t *sinst = NULL; 938 939 MUTEX_LOCK(&inst->ri_lock); 940 941 /* 942 * This is where we'd check inst->ri_method_thread and if it 943 * were nonzero we'd wait in anticipation of another thread 944 * executing a method for inst. Doing so with the instance_list 945 * locked, though, leads to deadlock. Since taking a snapshot 946 * during that window won't hurt anything, we'll just continue. 947 */ 948 949 fmri = inst->ri_i.i_fmri; 950 951 if (inst->ri_flags & RINST_RETAKE_RUNNING) { 952 scf_snapshot_t *rsnap; 953 954 (void) libscf_fmri_get_instance(h, fmri, &sinst); 955 956 rsnap = libscf_get_or_make_running_snapshot(sinst, 957 fmri, B_FALSE); 958 959 scf_instance_destroy(sinst); 960 961 if (rsnap != NULL) 962 inst->ri_flags &= ~RINST_RETAKE_RUNNING; 963 964 scf_snapshot_destroy(rsnap); 965 } 966 967 if (inst->ri_flags & RINST_RETAKE_START) { 968 switch (r = libscf_snapshots_poststart(h, fmri, 969 B_FALSE)) { 970 case 0: 971 case ENOENT: 972 inst->ri_flags &= ~RINST_RETAKE_START; 973 break; 974 975 case ECONNABORTED: 976 break; 977 978 case EACCES: 979 default: 980 bad_error("libscf_snapshots_poststart", r); 981 } 982 } 983 984 MUTEX_UNLOCK(&inst->ri_lock); 985 } 986 987 MUTEX_UNLOCK(&instance_list.ril_lock); 988 } 989 990 /* ARGSUSED */ 991 void * 992 restarter_post_fsminimal_thread(void *unused) 993 { 994 scf_handle_t *h; 995 int r; 996 997 h = libscf_handle_create_bound_loop(); 998 999 for (;;) { 1000 r = libscf_create_self(h); 1001 if (r == 0) 1002 break; 1003 1004 assert(r == ECONNABORTED); 1005 libscf_handle_rebind(h); 1006 } 1007 1008 restarter_take_pending_snapshots(h); 1009 1010 (void) scf_handle_unbind(h); 1011 scf_handle_destroy(h); 1012 1013 return (NULL); 1014 } 1015 1016 /* 1017 * int stop_instance() 1018 * 1019 * Stop the instance identified by the instance given as the second argument, 1020 * for the cause stated. 1021 * 1022 * Returns 1023 * 0 - success 1024 * -1 - inst is in transition 1025 */ 1026 static int 1027 stop_instance(scf_handle_t *local_handle, restarter_inst_t *inst, 1028 stop_cause_t cause) 1029 { 1030 fork_info_t *info; 1031 const char *cp; 1032 int err; 1033 restarter_error_t re; 1034 restarter_str_t reason; 1035 restarter_instance_state_t new_state; 1036 1037 assert(MUTEX_HELD(&inst->ri_lock)); 1038 assert(inst->ri_method_thread == 0); 1039 1040 switch (cause) { 1041 case RSTOP_EXIT: 1042 re = RERR_RESTART; 1043 reason = restarter_str_ct_ev_exit; 1044 cp = "all processes in service exited"; 1045 break; 1046 case RSTOP_ERR_CFG: 1047 re = RERR_FAULT; 1048 reason = restarter_str_method_failed; 1049 cp = "service exited with a configuration error"; 1050 break; 1051 case RSTOP_ERR_EXIT: 1052 re = RERR_RESTART; 1053 reason = restarter_str_ct_ev_exit; 1054 cp = "service exited with an error"; 1055 break; 1056 case RSTOP_CORE: 1057 re = RERR_FAULT; 1058 reason = restarter_str_ct_ev_core; 1059 cp = "process dumped core"; 1060 break; 1061 case RSTOP_SIGNAL: 1062 re = RERR_FAULT; 1063 reason = restarter_str_ct_ev_signal; 1064 cp = "process received fatal signal from outside the service"; 1065 break; 1066 case RSTOP_HWERR: 1067 re = RERR_FAULT; 1068 reason = restarter_str_ct_ev_hwerr; 1069 cp = "process killed due to uncorrectable hardware error"; 1070 break; 1071 case RSTOP_DEPENDENCY: 1072 re = RERR_RESTART; 1073 reason = restarter_str_dependency_activity; 1074 cp = "dependency activity requires stop"; 1075 break; 1076 case RSTOP_DISABLE: 1077 re = RERR_RESTART; 1078 reason = restarter_str_disable_request; 1079 cp = "service disabled"; 1080 break; 1081 case RSTOP_RESTART: 1082 re = RERR_RESTART; 1083 reason = restarter_str_restart_request; 1084 cp = "service restarting"; 1085 break; 1086 default: 1087 #ifndef NDEBUG 1088 (void) fprintf(stderr, "Unknown cause %d at %s:%d.\n", 1089 cause, __FILE__, __LINE__); 1090 #endif 1091 abort(); 1092 } 1093 1094 /* Services in the disabled and maintenance state are ignored */ 1095 if (inst->ri_i.i_state == RESTARTER_STATE_MAINT || 1096 inst->ri_i.i_state == RESTARTER_STATE_DISABLED) { 1097 log_framework(LOG_DEBUG, 1098 "%s: stop_instance -> is maint/disabled\n", 1099 inst->ri_i.i_fmri); 1100 return (0); 1101 } 1102 1103 /* Already stopped instances are left alone */ 1104 if (instance_started(inst) == 0) { 1105 log_framework(LOG_DEBUG, "Restarter: %s is already stopped.\n", 1106 inst->ri_i.i_fmri); 1107 return (0); 1108 } 1109 1110 if (instance_in_transition(inst)) { 1111 /* requeue event by returning -1 */ 1112 log_framework(LOG_DEBUG, 1113 "Restarter: Not stopping %s, in transition.\n", 1114 inst->ri_i.i_fmri); 1115 return (-1); 1116 } 1117 1118 log_instance(inst, B_TRUE, "Stopping because %s.", cp); 1119 1120 log_framework(re == RERR_FAULT ? LOG_INFO : LOG_DEBUG, 1121 "%s: Instance stopping because %s.\n", inst->ri_i.i_fmri, cp); 1122 1123 if (instance_is_wait_style(inst) && 1124 (cause == RSTOP_EXIT || 1125 cause == RSTOP_ERR_CFG || 1126 cause == RSTOP_ERR_EXIT)) { 1127 /* 1128 * No need to stop instance, as child has exited; remove 1129 * contract and move the instance to the offline state. 1130 */ 1131 switch (err = restarter_instance_update_states(local_handle, 1132 inst, inst->ri_i.i_state, RESTARTER_STATE_OFFLINE, re, 1133 reason)) { 1134 case 0: 1135 case ECONNRESET: 1136 break; 1137 1138 default: 1139 bad_error("restarter_instance_update_states", err); 1140 } 1141 1142 if (cause == RSTOP_ERR_EXIT) { 1143 /* 1144 * The RSTOP_ERR_EXIT cause is set via the 1145 * wait_thread -> wait_remove code path when we have 1146 * a "wait" style svc that exited with an error. If 1147 * the svc is failing too quickly, we throttle it so 1148 * that we don't restart it more than once/second. 1149 * Since we know we're running in the wait thread its 1150 * ok to throttle it right here. 1151 */ 1152 (void) update_fault_count(inst, FAULT_COUNT_INCR); 1153 if (method_rate_critical(inst)) { 1154 log_instance(inst, B_TRUE, "Failing too " 1155 "quickly, throttling."); 1156 (void) sleep(WT_SVC_ERR_THROTTLE); 1157 } 1158 } else { 1159 (void) update_fault_count(inst, FAULT_COUNT_RESET); 1160 reset_start_times(inst); 1161 } 1162 1163 if (inst->ri_i.i_primary_ctid != 0) { 1164 inst->ri_m_inst = 1165 safe_scf_instance_create(local_handle); 1166 inst->ri_mi_deleted = B_FALSE; 1167 1168 libscf_reget_instance(inst); 1169 method_remove_contract(inst, B_TRUE, B_TRUE); 1170 1171 scf_instance_destroy(inst->ri_m_inst); 1172 inst->ri_m_inst = NULL; 1173 } 1174 1175 switch (err = restarter_instance_update_states(local_handle, 1176 inst, inst->ri_i.i_next_state, RESTARTER_STATE_NONE, re, 1177 reason)) { 1178 case 0: 1179 case ECONNRESET: 1180 break; 1181 1182 default: 1183 bad_error("restarter_instance_update_states", err); 1184 } 1185 1186 if (cause != RSTOP_ERR_CFG) 1187 return (0); 1188 } else if (instance_is_wait_style(inst) && re == RERR_RESTART) { 1189 /* 1190 * Stopping a wait service through means other than the pid 1191 * exiting should keep wait_thread() from restarting the 1192 * service, by removing it from the wait list. 1193 * We cannot remove it right now otherwise the process will 1194 * end up <defunct> so mark it to be ignored. 1195 */ 1196 wait_ignore_by_fmri(inst->ri_i.i_fmri); 1197 } 1198 1199 /* 1200 * There are some configuration errors which we cannot detect until we 1201 * try to run the method. For example, see exec_method() where the 1202 * restarter_set_method_context() call can return SMF_EXIT_ERR_CONFIG 1203 * in several cases. If this happens for a "wait-style" svc, 1204 * wait_remove() sets the cause as RSTOP_ERR_CFG so that we can detect 1205 * the configuration error and go into maintenance, even though it is 1206 * a "wait-style" svc. 1207 */ 1208 if (cause == RSTOP_ERR_CFG) 1209 new_state = RESTARTER_STATE_MAINT; 1210 else 1211 new_state = inst->ri_i.i_enabled ? 1212 RESTARTER_STATE_OFFLINE : RESTARTER_STATE_DISABLED; 1213 1214 switch (err = restarter_instance_update_states(local_handle, inst, 1215 inst->ri_i.i_state, new_state, RERR_NONE, reason)) { 1216 case 0: 1217 case ECONNRESET: 1218 break; 1219 1220 default: 1221 bad_error("restarter_instance_update_states", err); 1222 } 1223 1224 info = startd_zalloc(sizeof (fork_info_t)); 1225 1226 info->sf_id = inst->ri_id; 1227 info->sf_method_type = METHOD_STOP; 1228 info->sf_event_type = re; 1229 info->sf_reason = reason; 1230 inst->ri_method_thread = startd_thread_create(method_thread, info); 1231 1232 return (0); 1233 } 1234 1235 /* 1236 * Returns 1237 * ENOENT - fmri is not in instance_list 1238 * 0 - success 1239 * ECONNRESET - success, though handle was rebound 1240 * -1 - instance is in transition 1241 */ 1242 int 1243 stop_instance_fmri(scf_handle_t *h, const char *fmri, uint_t flags) 1244 { 1245 restarter_inst_t *rip; 1246 int r; 1247 1248 rip = inst_lookup_by_name(fmri); 1249 if (rip == NULL) 1250 return (ENOENT); 1251 1252 r = stop_instance(h, rip, flags); 1253 1254 MUTEX_UNLOCK(&rip->ri_lock); 1255 1256 return (r); 1257 } 1258 1259 static void 1260 unmaintain_instance(scf_handle_t *h, restarter_inst_t *rip, 1261 unmaint_cause_t cause) 1262 { 1263 ctid_t ctid; 1264 scf_instance_t *inst; 1265 int r; 1266 uint_t tries = 0, msecs = ALLOC_DELAY; 1267 const char *cp; 1268 restarter_str_t reason; 1269 1270 assert(MUTEX_HELD(&rip->ri_lock)); 1271 1272 if (rip->ri_i.i_state != RESTARTER_STATE_MAINT) { 1273 log_error(LOG_DEBUG, "Restarter: " 1274 "Ignoring maintenance off command because %s is not in the " 1275 "maintenance state.\n", rip->ri_i.i_fmri); 1276 return; 1277 } 1278 1279 switch (cause) { 1280 case RUNMAINT_CLEAR: 1281 cp = "clear requested"; 1282 reason = restarter_str_clear_request; 1283 break; 1284 case RUNMAINT_DISABLE: 1285 cp = "disable requested"; 1286 reason = restarter_str_disable_request; 1287 break; 1288 default: 1289 #ifndef NDEBUG 1290 (void) fprintf(stderr, "Uncaught case for %d at %s:%d.\n", 1291 cause, __FILE__, __LINE__); 1292 #endif 1293 abort(); 1294 } 1295 1296 log_instance(rip, B_TRUE, "Leaving maintenance because %s.", 1297 cp); 1298 log_framework(LOG_DEBUG, "%s: Instance leaving maintenance because " 1299 "%s.\n", rip->ri_i.i_fmri, cp); 1300 1301 (void) restarter_instance_update_states(h, rip, RESTARTER_STATE_UNINIT, 1302 RESTARTER_STATE_NONE, RERR_RESTART, reason); 1303 1304 /* 1305 * If we did ADMIN_MAINT_ON_IMMEDIATE, then there might still be 1306 * a primary contract. 1307 */ 1308 if (rip->ri_i.i_primary_ctid == 0) 1309 return; 1310 1311 ctid = rip->ri_i.i_primary_ctid; 1312 contract_abandon(ctid); 1313 rip->ri_i.i_primary_ctid = 0; 1314 1315 rep_retry: 1316 switch (r = libscf_fmri_get_instance(h, rip->ri_i.i_fmri, &inst)) { 1317 case 0: 1318 break; 1319 1320 case ECONNABORTED: 1321 libscf_handle_rebind(h); 1322 goto rep_retry; 1323 1324 case ENOENT: 1325 /* Must have been deleted. */ 1326 return; 1327 1328 case EINVAL: 1329 case ENOTSUP: 1330 default: 1331 bad_error("libscf_handle_rebind", r); 1332 } 1333 1334 again: 1335 r = restarter_remove_contract(inst, ctid, RESTARTER_CONTRACT_PRIMARY); 1336 switch (r) { 1337 case 0: 1338 break; 1339 1340 case ENOMEM: 1341 ++tries; 1342 if (tries < ALLOC_RETRY) { 1343 (void) poll(NULL, 0, msecs); 1344 msecs *= ALLOC_DELAY_MULT; 1345 goto again; 1346 } 1347 1348 uu_die("Insufficient memory.\n"); 1349 /* NOTREACHED */ 1350 1351 case ECONNABORTED: 1352 scf_instance_destroy(inst); 1353 libscf_handle_rebind(h); 1354 goto rep_retry; 1355 1356 case ECANCELED: 1357 break; 1358 1359 case EPERM: 1360 case EACCES: 1361 case EROFS: 1362 log_error(LOG_INFO, 1363 "Could not remove contract id %lu for %s (%s).\n", ctid, 1364 rip->ri_i.i_fmri, strerror(r)); 1365 break; 1366 1367 case EINVAL: 1368 case EBADF: 1369 default: 1370 bad_error("restarter_remove_contract", r); 1371 } 1372 1373 scf_instance_destroy(inst); 1374 } 1375 1376 /* 1377 * enable_inst() 1378 * Set inst->ri_i.i_enabled. Expects 'e' to be _ENABLE, _DISABLE, or 1379 * _ADMIN_DISABLE. If the event is _ENABLE and inst is uninitialized or 1380 * disabled, move it to offline. If the event is _DISABLE or 1381 * _ADMIN_DISABLE, make sure inst will move to disabled. 1382 * 1383 * Returns 1384 * 0 - success 1385 * ECONNRESET - h was rebound 1386 */ 1387 static int 1388 enable_inst(scf_handle_t *h, restarter_inst_t *inst, 1389 restarter_instance_qentry_t *riq) 1390 { 1391 restarter_instance_state_t state; 1392 restarter_event_type_t e = riq->riq_type; 1393 restarter_str_t reason = restarter_str_per_configuration; 1394 int r; 1395 1396 assert(MUTEX_HELD(&inst->ri_lock)); 1397 assert(e == RESTARTER_EVENT_TYPE_ADMIN_DISABLE || 1398 e == RESTARTER_EVENT_TYPE_DISABLE || 1399 e == RESTARTER_EVENT_TYPE_ENABLE); 1400 assert(instance_in_transition(inst) == 0); 1401 1402 state = inst->ri_i.i_state; 1403 1404 if (e == RESTARTER_EVENT_TYPE_ENABLE) { 1405 inst->ri_i.i_enabled = 1; 1406 1407 if (state == RESTARTER_STATE_UNINIT || 1408 state == RESTARTER_STATE_DISABLED) { 1409 /* 1410 * B_FALSE: Don't log an error if the log_instance() 1411 * fails because it will fail on the miniroot before 1412 * install-discovery runs. 1413 */ 1414 log_instance(inst, B_FALSE, "Enabled."); 1415 log_framework(LOG_DEBUG, "%s: Instance enabled.\n", 1416 inst->ri_i.i_fmri); 1417 1418 /* 1419 * If we are coming from DISABLED, it was obviously an 1420 * enable request. If we are coming from UNINIT, it may 1421 * have been a sevice in MAINT that was cleared. 1422 */ 1423 if (riq->riq_reason == restarter_str_clear_request) 1424 reason = restarter_str_clear_request; 1425 else if (state == RESTARTER_STATE_DISABLED) 1426 reason = restarter_str_enable_request; 1427 (void) restarter_instance_update_states(h, inst, 1428 RESTARTER_STATE_OFFLINE, RESTARTER_STATE_NONE, 1429 RERR_NONE, reason); 1430 } else { 1431 log_framework(LOG_DEBUG, "Restarter: " 1432 "Not changing state of %s for enable command.\n", 1433 inst->ri_i.i_fmri); 1434 } 1435 } else { 1436 inst->ri_i.i_enabled = 0; 1437 1438 switch (state) { 1439 case RESTARTER_STATE_ONLINE: 1440 case RESTARTER_STATE_DEGRADED: 1441 r = stop_instance(h, inst, RSTOP_DISABLE); 1442 return (r == ECONNRESET ? 0 : r); 1443 1444 case RESTARTER_STATE_OFFLINE: 1445 case RESTARTER_STATE_UNINIT: 1446 if (inst->ri_i.i_primary_ctid != 0) { 1447 inst->ri_m_inst = safe_scf_instance_create(h); 1448 inst->ri_mi_deleted = B_FALSE; 1449 1450 libscf_reget_instance(inst); 1451 method_remove_contract(inst, B_TRUE, B_TRUE); 1452 1453 scf_instance_destroy(inst->ri_m_inst); 1454 } 1455 /* B_FALSE: See log_instance(..., "Enabled."); above */ 1456 log_instance(inst, B_FALSE, "Disabled."); 1457 log_framework(LOG_DEBUG, "%s: Instance disabled.\n", 1458 inst->ri_i.i_fmri); 1459 1460 /* 1461 * If we are coming from OFFLINE, it was obviously a 1462 * disable request. But if we are coming from 1463 * UNINIT, it may have been a disable request for a 1464 * service in MAINT. 1465 */ 1466 if (riq->riq_reason == restarter_str_disable_request || 1467 state == RESTARTER_STATE_OFFLINE) 1468 reason = restarter_str_disable_request; 1469 (void) restarter_instance_update_states(h, inst, 1470 RESTARTER_STATE_DISABLED, RESTARTER_STATE_NONE, 1471 RERR_RESTART, reason); 1472 return (0); 1473 1474 case RESTARTER_STATE_DISABLED: 1475 break; 1476 1477 case RESTARTER_STATE_MAINT: 1478 /* 1479 * We only want to pull the instance out of maintenance 1480 * if the disable is on adminstrative request. The 1481 * graph engine sends _DISABLE events whenever a 1482 * service isn't in the disabled state, and we don't 1483 * want to pull the service out of maintenance if, 1484 * for example, it is there due to a dependency cycle. 1485 */ 1486 if (e == RESTARTER_EVENT_TYPE_ADMIN_DISABLE) 1487 unmaintain_instance(h, inst, RUNMAINT_DISABLE); 1488 break; 1489 1490 default: 1491 #ifndef NDEBUG 1492 (void) fprintf(stderr, "Restarter instance %s has " 1493 "unknown state %d.\n", inst->ri_i.i_fmri, state); 1494 #endif 1495 abort(); 1496 } 1497 } 1498 1499 return (0); 1500 } 1501 1502 static void 1503 start_instance(scf_handle_t *local_handle, restarter_inst_t *inst, 1504 int32_t reason) 1505 { 1506 fork_info_t *info; 1507 restarter_str_t new_reason; 1508 1509 assert(MUTEX_HELD(&inst->ri_lock)); 1510 assert(instance_in_transition(inst) == 0); 1511 assert(inst->ri_method_thread == 0); 1512 1513 log_framework(LOG_DEBUG, "%s: trying to start instance\n", 1514 inst->ri_i.i_fmri); 1515 1516 /* 1517 * We want to keep the original reason for restarts and clear actions 1518 */ 1519 switch (reason) { 1520 case restarter_str_restart_request: 1521 case restarter_str_clear_request: 1522 new_reason = reason; 1523 break; 1524 default: 1525 new_reason = restarter_str_dependencies_satisfied; 1526 } 1527 1528 /* Services in the disabled and maintenance state are ignored */ 1529 if (inst->ri_i.i_state == RESTARTER_STATE_MAINT || 1530 inst->ri_i.i_state == RESTARTER_STATE_DISABLED || 1531 inst->ri_i.i_enabled == 0) { 1532 log_framework(LOG_DEBUG, 1533 "%s: start_instance -> is maint/disabled\n", 1534 inst->ri_i.i_fmri); 1535 return; 1536 } 1537 1538 /* Already started instances are left alone */ 1539 if (instance_started(inst) == 1) { 1540 log_framework(LOG_DEBUG, 1541 "%s: start_instance -> is already started\n", 1542 inst->ri_i.i_fmri); 1543 return; 1544 } 1545 1546 log_framework(LOG_DEBUG, "%s: starting instance.\n", inst->ri_i.i_fmri); 1547 1548 (void) restarter_instance_update_states(local_handle, inst, 1549 inst->ri_i.i_state, RESTARTER_STATE_ONLINE, RERR_NONE, new_reason); 1550 1551 info = startd_zalloc(sizeof (fork_info_t)); 1552 1553 info->sf_id = inst->ri_id; 1554 info->sf_method_type = METHOD_START; 1555 info->sf_event_type = RERR_NONE; 1556 info->sf_reason = new_reason; 1557 inst->ri_method_thread = startd_thread_create(method_thread, info); 1558 } 1559 1560 static int 1561 event_from_tty(scf_handle_t *h, restarter_inst_t *rip) 1562 { 1563 scf_instance_t *inst; 1564 int ret = 0; 1565 1566 if (libscf_fmri_get_instance(h, rip->ri_i.i_fmri, &inst)) 1567 return (-1); 1568 1569 ret = restarter_inst_ractions_from_tty(inst); 1570 1571 scf_instance_destroy(inst); 1572 return (ret); 1573 } 1574 1575 static boolean_t 1576 restart_dump(scf_handle_t *h, restarter_inst_t *rip) 1577 { 1578 scf_instance_t *inst; 1579 boolean_t ret = B_FALSE; 1580 1581 if (libscf_fmri_get_instance(h, rip->ri_i.i_fmri, &inst)) 1582 return (-1); 1583 1584 if (restarter_inst_dump(inst) == 1) 1585 ret = B_TRUE; 1586 1587 scf_instance_destroy(inst); 1588 return (ret); 1589 } 1590 1591 static void 1592 maintain_instance(scf_handle_t *h, restarter_inst_t *rip, int immediate, 1593 restarter_str_t reason) 1594 { 1595 fork_info_t *info; 1596 scf_instance_t *scf_inst = NULL; 1597 1598 assert(MUTEX_HELD(&rip->ri_lock)); 1599 assert(reason != restarter_str_none); 1600 assert(rip->ri_method_thread == 0); 1601 1602 log_instance(rip, B_TRUE, "Stopping for maintenance due to %s.", 1603 restarter_get_str_short(reason)); 1604 log_framework(LOG_DEBUG, "%s: stopping for maintenance due to %s.\n", 1605 rip->ri_i.i_fmri, restarter_get_str_short(reason)); 1606 1607 /* Services in the maintenance state are ignored */ 1608 if (rip->ri_i.i_state == RESTARTER_STATE_MAINT) { 1609 log_framework(LOG_DEBUG, 1610 "%s: maintain_instance -> is already in maintenance\n", 1611 rip->ri_i.i_fmri); 1612 return; 1613 } 1614 1615 /* 1616 * If reason state is restarter_str_service_request and 1617 * restarter_actions/auxiliary_fmri property is set with a valid fmri, 1618 * copy the fmri to restarter/auxiliary_fmri so svcs -x can use. 1619 */ 1620 if (reason == restarter_str_service_request && 1621 libscf_fmri_get_instance(h, rip->ri_i.i_fmri, &scf_inst) == 0) { 1622 if (restarter_inst_validate_ractions_aux_fmri(scf_inst) == 0) { 1623 if (restarter_inst_set_aux_fmri(scf_inst)) 1624 log_framework(LOG_DEBUG, "%s: " 1625 "restarter_inst_set_aux_fmri failed: ", 1626 rip->ri_i.i_fmri); 1627 } else { 1628 log_framework(LOG_DEBUG, "%s: " 1629 "restarter_inst_validate_ractions_aux_fmri " 1630 "failed: ", rip->ri_i.i_fmri); 1631 1632 if (restarter_inst_reset_aux_fmri(scf_inst)) 1633 log_framework(LOG_DEBUG, "%s: " 1634 "restarter_inst_reset_aux_fmri failed: ", 1635 rip->ri_i.i_fmri); 1636 } 1637 scf_instance_destroy(scf_inst); 1638 } 1639 1640 if (immediate || !instance_started(rip)) { 1641 if (rip->ri_i.i_primary_ctid != 0) { 1642 rip->ri_m_inst = safe_scf_instance_create(h); 1643 rip->ri_mi_deleted = B_FALSE; 1644 1645 libscf_reget_instance(rip); 1646 method_remove_contract(rip, B_TRUE, B_TRUE); 1647 1648 scf_instance_destroy(rip->ri_m_inst); 1649 } 1650 1651 (void) restarter_instance_update_states(h, rip, 1652 RESTARTER_STATE_MAINT, RESTARTER_STATE_NONE, RERR_RESTART, 1653 reason); 1654 return; 1655 } 1656 1657 (void) restarter_instance_update_states(h, rip, rip->ri_i.i_state, 1658 RESTARTER_STATE_MAINT, RERR_NONE, reason); 1659 1660 log_transition(rip, MAINT_REQUESTED); 1661 1662 info = startd_zalloc(sizeof (*info)); 1663 info->sf_id = rip->ri_id; 1664 info->sf_method_type = METHOD_STOP; 1665 info->sf_event_type = RERR_RESTART; 1666 info->sf_reason = reason; 1667 rip->ri_method_thread = startd_thread_create(method_thread, info); 1668 } 1669 1670 static void 1671 refresh_instance(scf_handle_t *h, restarter_inst_t *rip) 1672 { 1673 scf_instance_t *inst; 1674 scf_snapshot_t *snap; 1675 fork_info_t *info; 1676 int r; 1677 1678 assert(MUTEX_HELD(&rip->ri_lock)); 1679 1680 log_instance(rip, B_TRUE, "Rereading configuration."); 1681 log_framework(LOG_DEBUG, "%s: rereading configuration.\n", 1682 rip->ri_i.i_fmri); 1683 1684 rep_retry: 1685 r = libscf_fmri_get_instance(h, rip->ri_i.i_fmri, &inst); 1686 switch (r) { 1687 case 0: 1688 break; 1689 1690 case ECONNABORTED: 1691 libscf_handle_rebind(h); 1692 goto rep_retry; 1693 1694 case ENOENT: 1695 /* Must have been deleted. */ 1696 return; 1697 1698 case EINVAL: 1699 case ENOTSUP: 1700 default: 1701 bad_error("libscf_fmri_get_instance", r); 1702 } 1703 1704 snap = libscf_get_running_snapshot(inst); 1705 1706 r = libscf_get_startd_properties(inst, snap, &rip->ri_flags, 1707 &rip->ri_utmpx_prefix); 1708 switch (r) { 1709 case 0: 1710 log_framework(LOG_DEBUG, "%s is a %s-style service\n", 1711 rip->ri_i.i_fmri, service_style(rip->ri_flags)); 1712 break; 1713 1714 case ECONNABORTED: 1715 scf_instance_destroy(inst); 1716 scf_snapshot_destroy(snap); 1717 libscf_handle_rebind(h); 1718 goto rep_retry; 1719 1720 case ECANCELED: 1721 case ENOENT: 1722 /* Succeed in anticipation of REMOVE_INSTANCE. */ 1723 break; 1724 1725 default: 1726 bad_error("libscf_get_startd_properties", r); 1727 } 1728 1729 if (instance_started(rip)) { 1730 /* Refresh does not change the state. */ 1731 (void) restarter_instance_update_states(h, rip, 1732 rip->ri_i.i_state, rip->ri_i.i_state, RERR_NONE, 1733 restarter_str_refresh); 1734 1735 info = startd_zalloc(sizeof (*info)); 1736 info->sf_id = rip->ri_id; 1737 info->sf_method_type = METHOD_REFRESH; 1738 info->sf_event_type = RERR_REFRESH; 1739 info->sf_reason = NULL; 1740 1741 assert(rip->ri_method_thread == 0); 1742 rip->ri_method_thread = 1743 startd_thread_create(method_thread, info); 1744 } 1745 1746 scf_snapshot_destroy(snap); 1747 scf_instance_destroy(inst); 1748 } 1749 1750 const char *event_names[] = { "INVALID", "ADD_INSTANCE", "REMOVE_INSTANCE", 1751 "ENABLE", "DISABLE", "ADMIN_DEGRADED", "ADMIN_REFRESH", 1752 "ADMIN_RESTART", "ADMIN_MAINT_OFF", "ADMIN_MAINT_ON", 1753 "ADMIN_MAINT_ON_IMMEDIATE", "STOP", "START", "DEPENDENCY_CYCLE", 1754 "INVALID_DEPENDENCY", "ADMIN_DISABLE", "STOP_RESET" 1755 }; 1756 1757 /* 1758 * void *restarter_process_events() 1759 * 1760 * Called in a separate thread to process the events on an instance's 1761 * queue. Empties the queue completely, and tries to keep the thread 1762 * around for a little while after the queue is empty to save on 1763 * startup costs. 1764 */ 1765 static void * 1766 restarter_process_events(void *arg) 1767 { 1768 scf_handle_t *h; 1769 restarter_instance_qentry_t *event; 1770 restarter_inst_t *rip; 1771 char *fmri = (char *)arg; 1772 struct timespec to; 1773 1774 assert(fmri != NULL); 1775 1776 h = libscf_handle_create_bound_loop(); 1777 1778 /* grab the queue lock */ 1779 rip = inst_lookup_queue(fmri); 1780 if (rip == NULL) 1781 goto out; 1782 1783 again: 1784 1785 while ((event = uu_list_first(rip->ri_queue)) != NULL) { 1786 restarter_inst_t *inst; 1787 1788 /* drop the queue lock */ 1789 MUTEX_UNLOCK(&rip->ri_queue_lock); 1790 1791 /* 1792 * Grab the inst lock -- this waits until any outstanding 1793 * method finishes running. 1794 */ 1795 inst = inst_lookup_by_name(fmri); 1796 if (inst == NULL) { 1797 /* Getting deleted in the middle isn't an error. */ 1798 goto cont; 1799 } 1800 1801 assert(instance_in_transition(inst) == 0); 1802 1803 /* process the event */ 1804 switch (event->riq_type) { 1805 case RESTARTER_EVENT_TYPE_ENABLE: 1806 case RESTARTER_EVENT_TYPE_DISABLE: 1807 (void) enable_inst(h, inst, event); 1808 break; 1809 1810 case RESTARTER_EVENT_TYPE_ADMIN_DISABLE: 1811 if (enable_inst(h, inst, event) == 0) 1812 reset_start_times(inst); 1813 break; 1814 1815 case RESTARTER_EVENT_TYPE_REMOVE_INSTANCE: 1816 restarter_delete_inst(inst); 1817 inst = NULL; 1818 goto cont; 1819 1820 case RESTARTER_EVENT_TYPE_STOP_RESET: 1821 reset_start_times(inst); 1822 /* FALLTHROUGH */ 1823 case RESTARTER_EVENT_TYPE_STOP: 1824 (void) stop_instance(h, inst, RSTOP_DEPENDENCY); 1825 break; 1826 1827 case RESTARTER_EVENT_TYPE_START: 1828 start_instance(h, inst, event->riq_reason); 1829 break; 1830 1831 case RESTARTER_EVENT_TYPE_DEPENDENCY_CYCLE: 1832 maintain_instance(h, inst, 0, 1833 restarter_str_dependency_cycle); 1834 break; 1835 1836 case RESTARTER_EVENT_TYPE_INVALID_DEPENDENCY: 1837 maintain_instance(h, inst, 0, 1838 restarter_str_invalid_dependency); 1839 break; 1840 1841 case RESTARTER_EVENT_TYPE_ADMIN_MAINT_ON: 1842 if (event_from_tty(h, inst) == 0) 1843 maintain_instance(h, inst, 0, 1844 restarter_str_service_request); 1845 else 1846 maintain_instance(h, inst, 0, 1847 restarter_str_administrative_request); 1848 break; 1849 1850 case RESTARTER_EVENT_TYPE_ADMIN_MAINT_ON_IMMEDIATE: 1851 if (event_from_tty(h, inst) == 0) 1852 maintain_instance(h, inst, 1, 1853 restarter_str_service_request); 1854 else 1855 maintain_instance(h, inst, 1, 1856 restarter_str_administrative_request); 1857 break; 1858 1859 case RESTARTER_EVENT_TYPE_ADMIN_MAINT_OFF: 1860 unmaintain_instance(h, inst, RUNMAINT_CLEAR); 1861 reset_start_times(inst); 1862 break; 1863 1864 case RESTARTER_EVENT_TYPE_ADMIN_REFRESH: 1865 refresh_instance(h, inst); 1866 break; 1867 1868 case RESTARTER_EVENT_TYPE_ADMIN_DEGRADED: 1869 log_framework(LOG_WARNING, "Restarter: " 1870 "%s command (for %s) unimplemented.\n", 1871 event_names[event->riq_type], inst->ri_i.i_fmri); 1872 break; 1873 1874 case RESTARTER_EVENT_TYPE_ADMIN_RESTART: 1875 if (!instance_started(inst)) { 1876 log_framework(LOG_DEBUG, "Restarter: " 1877 "Not restarting %s; not running.\n", 1878 inst->ri_i.i_fmri); 1879 } else { 1880 /* 1881 * Stop the instance. If it can be restarted, 1882 * the graph engine will send a new event. 1883 */ 1884 if (restart_dump(h, inst)) { 1885 (void) contract_kill( 1886 inst->ri_i.i_primary_ctid, SIGABRT, 1887 inst->ri_i.i_fmri); 1888 } else if (stop_instance(h, inst, 1889 RSTOP_RESTART) == 0) { 1890 reset_start_times(inst); 1891 } 1892 } 1893 break; 1894 1895 case RESTARTER_EVENT_TYPE_ADD_INSTANCE: 1896 default: 1897 #ifndef NDEBUG 1898 uu_warn("%s:%d: Bad restarter event %d. " 1899 "Aborting.\n", __FILE__, __LINE__, event->riq_type); 1900 #endif 1901 abort(); 1902 } 1903 1904 assert(inst != NULL); 1905 MUTEX_UNLOCK(&inst->ri_lock); 1906 1907 cont: 1908 /* grab the queue lock */ 1909 rip = inst_lookup_queue(fmri); 1910 if (rip == NULL) 1911 goto out; 1912 1913 /* delete the event */ 1914 uu_list_remove(rip->ri_queue, event); 1915 startd_free(event, sizeof (restarter_instance_qentry_t)); 1916 } 1917 1918 assert(rip != NULL); 1919 1920 /* 1921 * Try to preserve the thread for a little while for future use. 1922 */ 1923 to.tv_sec = 3; 1924 to.tv_nsec = 0; 1925 (void) pthread_cond_reltimedwait_np(&rip->ri_queue_cv, 1926 &rip->ri_queue_lock, &to); 1927 1928 if (uu_list_first(rip->ri_queue) != NULL) 1929 goto again; 1930 1931 rip->ri_queue_thread = 0; 1932 MUTEX_UNLOCK(&rip->ri_queue_lock); 1933 1934 out: 1935 (void) scf_handle_unbind(h); 1936 scf_handle_destroy(h); 1937 free(fmri); 1938 return (NULL); 1939 } 1940 1941 static int 1942 is_admin_event(restarter_event_type_t t) { 1943 1944 switch (t) { 1945 case RESTARTER_EVENT_TYPE_ADMIN_MAINT_ON: 1946 case RESTARTER_EVENT_TYPE_ADMIN_MAINT_ON_IMMEDIATE: 1947 case RESTARTER_EVENT_TYPE_ADMIN_MAINT_OFF: 1948 case RESTARTER_EVENT_TYPE_ADMIN_REFRESH: 1949 case RESTARTER_EVENT_TYPE_ADMIN_DEGRADED: 1950 case RESTARTER_EVENT_TYPE_ADMIN_RESTART: 1951 return (1); 1952 default: 1953 return (0); 1954 } 1955 } 1956 1957 static void 1958 restarter_queue_event(restarter_inst_t *ri, restarter_protocol_event_t *e) 1959 { 1960 restarter_instance_qentry_t *qe; 1961 int r; 1962 1963 assert(MUTEX_HELD(&ri->ri_queue_lock)); 1964 assert(!MUTEX_HELD(&ri->ri_lock)); 1965 1966 qe = startd_zalloc(sizeof (restarter_instance_qentry_t)); 1967 qe->riq_type = e->rpe_type; 1968 qe->riq_reason = e->rpe_reason; 1969 1970 uu_list_node_init(qe, &qe->riq_link, restarter_queue_pool); 1971 r = uu_list_insert_before(ri->ri_queue, NULL, qe); 1972 assert(r == 0); 1973 } 1974 1975 /* 1976 * void *restarter_event_thread() 1977 * 1978 * Handle incoming graph events by placing them on a per-instance 1979 * queue. We can't lock the main part of the instance structure, so 1980 * just modify the seprarately locked event queue portion. 1981 */ 1982 /*ARGSUSED*/ 1983 static void * 1984 restarter_event_thread(void *unused) 1985 { 1986 scf_handle_t *h; 1987 1988 /* 1989 * This is a new thread, and thus, gets its own handle 1990 * to the repository. 1991 */ 1992 h = libscf_handle_create_bound_loop(); 1993 1994 MUTEX_LOCK(&ru->restarter_update_lock); 1995 1996 /*CONSTCOND*/ 1997 while (1) { 1998 restarter_protocol_event_t *e; 1999 2000 while (ru->restarter_update_wakeup == 0) 2001 (void) pthread_cond_wait(&ru->restarter_update_cv, 2002 &ru->restarter_update_lock); 2003 2004 ru->restarter_update_wakeup = 0; 2005 2006 while ((e = restarter_event_dequeue()) != NULL) { 2007 restarter_inst_t *rip; 2008 char *fmri; 2009 2010 MUTEX_UNLOCK(&ru->restarter_update_lock); 2011 2012 /* 2013 * ADD_INSTANCE is special: there's likely no 2014 * instance structure yet, so we need to handle the 2015 * addition synchronously. 2016 */ 2017 switch (e->rpe_type) { 2018 case RESTARTER_EVENT_TYPE_ADD_INSTANCE: 2019 if (restarter_insert_inst(h, e->rpe_inst) != 0) 2020 log_error(LOG_INFO, "Restarter: " 2021 "Could not add %s.\n", e->rpe_inst); 2022 2023 MUTEX_LOCK(&st->st_load_lock); 2024 if (--st->st_load_instances == 0) 2025 (void) pthread_cond_broadcast( 2026 &st->st_load_cv); 2027 MUTEX_UNLOCK(&st->st_load_lock); 2028 2029 goto nolookup; 2030 } 2031 2032 /* 2033 * Lookup the instance, locking only the event queue. 2034 * Can't grab ri_lock here because it might be held 2035 * by a long-running method. 2036 */ 2037 rip = inst_lookup_queue(e->rpe_inst); 2038 if (rip == NULL) { 2039 log_error(LOG_INFO, "Restarter: " 2040 "Ignoring %s command for unknown service " 2041 "%s.\n", event_names[e->rpe_type], 2042 e->rpe_inst); 2043 goto nolookup; 2044 } 2045 2046 /* Keep ADMIN events from filling up the queue. */ 2047 if (is_admin_event(e->rpe_type) && 2048 uu_list_numnodes(rip->ri_queue) > 2049 RINST_QUEUE_THRESHOLD) { 2050 MUTEX_UNLOCK(&rip->ri_queue_lock); 2051 log_instance(rip, B_TRUE, "Instance event " 2052 "queue overflow. Dropping administrative " 2053 "request."); 2054 log_framework(LOG_DEBUG, "%s: Instance event " 2055 "queue overflow. Dropping administrative " 2056 "request.\n", rip->ri_i.i_fmri); 2057 goto nolookup; 2058 } 2059 2060 /* Now add the event to the instance queue. */ 2061 restarter_queue_event(rip, e); 2062 2063 if (rip->ri_queue_thread == 0) { 2064 /* 2065 * Start a thread if one isn't already 2066 * running. 2067 */ 2068 fmri = safe_strdup(e->rpe_inst); 2069 rip->ri_queue_thread = startd_thread_create( 2070 restarter_process_events, (void *)fmri); 2071 } else { 2072 /* 2073 * Signal the existing thread that there's 2074 * a new event. 2075 */ 2076 (void) pthread_cond_broadcast( 2077 &rip->ri_queue_cv); 2078 } 2079 2080 MUTEX_UNLOCK(&rip->ri_queue_lock); 2081 nolookup: 2082 restarter_event_release(e); 2083 2084 MUTEX_LOCK(&ru->restarter_update_lock); 2085 } 2086 } 2087 2088 /* 2089 * Unreachable for now -- there's currently no graceful cleanup 2090 * called on exit(). 2091 */ 2092 (void) scf_handle_unbind(h); 2093 scf_handle_destroy(h); 2094 return (NULL); 2095 } 2096 2097 static restarter_inst_t * 2098 contract_to_inst(ctid_t ctid) 2099 { 2100 restarter_inst_t *inst; 2101 int id; 2102 2103 id = lookup_inst_by_contract(ctid); 2104 if (id == -1) 2105 return (NULL); 2106 2107 inst = inst_lookup_by_id(id); 2108 if (inst != NULL) { 2109 /* 2110 * Since ri_lock isn't held by the contract id lookup, this 2111 * instance may have been restarted and now be in a new 2112 * contract, making the old contract no longer valid for this 2113 * instance. 2114 */ 2115 if (ctid != inst->ri_i.i_primary_ctid) { 2116 MUTEX_UNLOCK(&inst->ri_lock); 2117 inst = NULL; 2118 } 2119 } 2120 return (inst); 2121 } 2122 2123 /* 2124 * void contract_action() 2125 * Take action on contract events. 2126 */ 2127 static void 2128 contract_action(scf_handle_t *h, restarter_inst_t *inst, ctid_t id, 2129 uint32_t type) 2130 { 2131 const char *fmri = inst->ri_i.i_fmri; 2132 2133 assert(MUTEX_HELD(&inst->ri_lock)); 2134 2135 /* 2136 * If startd has stopped this contract, there is no need to 2137 * stop it again. 2138 */ 2139 if (inst->ri_i.i_primary_ctid > 0 && 2140 inst->ri_i.i_primary_ctid_stopped) 2141 return; 2142 2143 if ((type & (CT_PR_EV_EMPTY | CT_PR_EV_CORE | CT_PR_EV_SIGNAL 2144 | CT_PR_EV_HWERR)) == 0) { 2145 /* 2146 * There shouldn't be other events, since that's not how we set 2147 * the terms. Thus, just log an error and drive on. 2148 */ 2149 log_framework(LOG_NOTICE, 2150 "%s: contract %ld received unexpected critical event " 2151 "(%d)\n", fmri, id, type); 2152 return; 2153 } 2154 2155 assert(instance_in_transition(inst) == 0); 2156 2157 if (instance_is_wait_style(inst)) { 2158 /* 2159 * We ignore all events; if they impact the 2160 * process we're monitoring, then the 2161 * wait_thread will stop the instance. 2162 */ 2163 log_framework(LOG_DEBUG, 2164 "%s: ignoring contract event on wait-style service\n", 2165 fmri); 2166 } else { 2167 /* 2168 * A CT_PR_EV_EMPTY event is an RSTOP_EXIT request. 2169 */ 2170 switch (type) { 2171 case CT_PR_EV_EMPTY: 2172 (void) stop_instance(h, inst, RSTOP_EXIT); 2173 break; 2174 case CT_PR_EV_CORE: 2175 (void) stop_instance(h, inst, RSTOP_CORE); 2176 break; 2177 case CT_PR_EV_SIGNAL: 2178 (void) stop_instance(h, inst, RSTOP_SIGNAL); 2179 break; 2180 case CT_PR_EV_HWERR: 2181 (void) stop_instance(h, inst, RSTOP_HWERR); 2182 break; 2183 } 2184 } 2185 } 2186 2187 /* 2188 * void *restarter_contract_event_thread(void *) 2189 * Listens to the process contract bundle for critical events, taking action 2190 * on events from contracts we know we are responsible for. 2191 */ 2192 /*ARGSUSED*/ 2193 static void * 2194 restarter_contracts_event_thread(void *unused) 2195 { 2196 int fd, err; 2197 scf_handle_t *local_handle; 2198 2199 /* 2200 * Await graph load completion. That is, stop here, until we've scanned 2201 * the repository for contract - instance associations. 2202 */ 2203 MUTEX_LOCK(&st->st_load_lock); 2204 while (!(st->st_load_complete && st->st_load_instances == 0)) 2205 (void) pthread_cond_wait(&st->st_load_cv, &st->st_load_lock); 2206 MUTEX_UNLOCK(&st->st_load_lock); 2207 2208 /* 2209 * This is a new thread, and thus, gets its own handle 2210 * to the repository. 2211 */ 2212 if ((local_handle = libscf_handle_create_bound(SCF_VERSION)) == NULL) 2213 uu_die("Unable to bind a new repository handle: %s\n", 2214 scf_strerror(scf_error())); 2215 2216 fd = open64(CTFS_ROOT "/process/pbundle", O_RDONLY); 2217 if (fd == -1) 2218 uu_die("process bundle open failed"); 2219 2220 /* 2221 * Make sure we get all events (including those generated by configd 2222 * before this thread was started). 2223 */ 2224 err = ct_event_reset(fd); 2225 assert(err == 0); 2226 2227 for (;;) { 2228 int efd, sfd; 2229 ct_evthdl_t ev; 2230 uint32_t type; 2231 ctevid_t evid; 2232 ct_stathdl_t status; 2233 ctid_t ctid; 2234 restarter_inst_t *inst; 2235 uint64_t cookie; 2236 2237 if (err = ct_event_read_critical(fd, &ev)) { 2238 log_error(LOG_WARNING, 2239 "Error reading next contract event: %s", 2240 strerror(err)); 2241 continue; 2242 } 2243 2244 evid = ct_event_get_evid(ev); 2245 ctid = ct_event_get_ctid(ev); 2246 type = ct_event_get_type(ev); 2247 2248 /* Fetch cookie. */ 2249 if ((sfd = contract_open(ctid, "process", "status", O_RDONLY)) 2250 < 0) { 2251 ct_event_free(ev); 2252 continue; 2253 } 2254 2255 if (err = ct_status_read(sfd, CTD_COMMON, &status)) { 2256 log_framework(LOG_WARNING, "Could not get status for " 2257 "contract %ld: %s\n", ctid, strerror(err)); 2258 2259 startd_close(sfd); 2260 ct_event_free(ev); 2261 continue; 2262 } 2263 2264 cookie = ct_status_get_cookie(status); 2265 2266 log_framework(LOG_DEBUG, "Received event %d for ctid %ld " 2267 "cookie %lld\n", type, ctid, cookie); 2268 2269 ct_status_free(status); 2270 2271 startd_close(sfd); 2272 2273 /* 2274 * svc.configd(1M) restart handling performed by the 2275 * fork_configd_thread. We don't acknowledge, as that thread 2276 * will do so. 2277 */ 2278 if (cookie == CONFIGD_COOKIE) { 2279 ct_event_free(ev); 2280 continue; 2281 } 2282 2283 inst = NULL; 2284 if (storing_contract != 0 && 2285 (inst = contract_to_inst(ctid)) == NULL) { 2286 /* 2287 * This can happen for two reasons: 2288 * - method_run() has not yet stored the 2289 * the contract into the internal hash table. 2290 * - we receive an EMPTY event for an abandoned 2291 * contract. 2292 * If there is any contract in the process of 2293 * being stored into the hash table then re-read 2294 * the event later. 2295 */ 2296 log_framework(LOG_DEBUG, 2297 "Reset event %d for unknown " 2298 "contract id %ld\n", type, ctid); 2299 2300 /* don't go too fast */ 2301 (void) poll(NULL, 0, 100); 2302 2303 (void) ct_event_reset(fd); 2304 ct_event_free(ev); 2305 continue; 2306 } 2307 2308 /* 2309 * Do not call contract_to_inst() again if first 2310 * call succeeded. 2311 */ 2312 if (inst == NULL) 2313 inst = contract_to_inst(ctid); 2314 if (inst == NULL) { 2315 /* 2316 * This can happen if we receive an EMPTY 2317 * event for an abandoned contract. 2318 */ 2319 log_framework(LOG_DEBUG, 2320 "Received event %d for unknown contract id " 2321 "%ld\n", type, ctid); 2322 } else { 2323 log_framework(LOG_DEBUG, 2324 "Received event %d for contract id " 2325 "%ld (%s)\n", type, ctid, 2326 inst->ri_i.i_fmri); 2327 2328 contract_action(local_handle, inst, ctid, type); 2329 2330 MUTEX_UNLOCK(&inst->ri_lock); 2331 } 2332 2333 efd = contract_open(ct_event_get_ctid(ev), "process", "ctl", 2334 O_WRONLY); 2335 if (efd != -1) { 2336 (void) ct_ctl_ack(efd, evid); 2337 startd_close(efd); 2338 } 2339 2340 ct_event_free(ev); 2341 2342 } 2343 2344 /*NOTREACHED*/ 2345 return (NULL); 2346 } 2347 2348 /* 2349 * Timeout queue, processed by restarter_timeouts_event_thread(). 2350 */ 2351 timeout_queue_t *timeouts; 2352 static uu_list_pool_t *timeout_pool; 2353 2354 typedef struct timeout_update { 2355 pthread_mutex_t tu_lock; 2356 pthread_cond_t tu_cv; 2357 int tu_wakeup; 2358 } timeout_update_t; 2359 2360 timeout_update_t *tu; 2361 2362 static const char *timeout_ovr_svcs[] = { 2363 "svc:/system/manifest-import:default", 2364 "svc:/network/initial:default", 2365 "svc:/network/service:default", 2366 "svc:/system/rmtmpfiles:default", 2367 "svc:/network/loopback:default", 2368 "svc:/network/physical:default", 2369 "svc:/system/device/local:default", 2370 "svc:/system/metainit:default", 2371 "svc:/system/filesystem/usr:default", 2372 "svc:/system/filesystem/minimal:default", 2373 "svc:/system/filesystem/local:default", 2374 NULL 2375 }; 2376 2377 int 2378 is_timeout_ovr(restarter_inst_t *inst) 2379 { 2380 int i; 2381 2382 for (i = 0; timeout_ovr_svcs[i] != NULL; ++i) { 2383 if (strcmp(inst->ri_i.i_fmri, timeout_ovr_svcs[i]) == 0) { 2384 log_instance(inst, B_TRUE, "Timeout override by " 2385 "svc.startd. Using infinite timeout."); 2386 return (1); 2387 } 2388 } 2389 2390 return (0); 2391 } 2392 2393 /*ARGSUSED*/ 2394 static int 2395 timeout_compare(const void *lc_arg, const void *rc_arg, void *private) 2396 { 2397 hrtime_t t1 = ((const timeout_entry_t *)lc_arg)->te_timeout; 2398 hrtime_t t2 = ((const timeout_entry_t *)rc_arg)->te_timeout; 2399 2400 if (t1 > t2) 2401 return (1); 2402 else if (t1 < t2) 2403 return (-1); 2404 return (0); 2405 } 2406 2407 void 2408 timeout_init() 2409 { 2410 timeouts = startd_zalloc(sizeof (timeout_queue_t)); 2411 2412 (void) pthread_mutex_init(&timeouts->tq_lock, &mutex_attrs); 2413 2414 timeout_pool = startd_list_pool_create("timeouts", 2415 sizeof (timeout_entry_t), offsetof(timeout_entry_t, te_link), 2416 timeout_compare, UU_LIST_POOL_DEBUG); 2417 assert(timeout_pool != NULL); 2418 2419 timeouts->tq_list = startd_list_create(timeout_pool, 2420 timeouts, UU_LIST_SORTED); 2421 assert(timeouts->tq_list != NULL); 2422 2423 tu = startd_zalloc(sizeof (timeout_update_t)); 2424 (void) pthread_cond_init(&tu->tu_cv, NULL); 2425 (void) pthread_mutex_init(&tu->tu_lock, &mutex_attrs); 2426 } 2427 2428 void 2429 timeout_insert(restarter_inst_t *inst, ctid_t cid, uint64_t timeout_sec) 2430 { 2431 hrtime_t now, timeout; 2432 timeout_entry_t *entry; 2433 uu_list_index_t idx; 2434 2435 assert(MUTEX_HELD(&inst->ri_lock)); 2436 2437 now = gethrtime(); 2438 2439 /* 2440 * If we overflow LLONG_MAX, we're never timing out anyways, so 2441 * just return. 2442 */ 2443 if (timeout_sec >= (LLONG_MAX - now) / 1000000000LL) { 2444 log_instance(inst, B_TRUE, "timeout_seconds too large, " 2445 "treating as infinite."); 2446 return; 2447 } 2448 2449 /* hrtime is in nanoseconds. Convert timeout_sec. */ 2450 timeout = now + (timeout_sec * 1000000000LL); 2451 2452 entry = startd_alloc(sizeof (timeout_entry_t)); 2453 entry->te_timeout = timeout; 2454 entry->te_ctid = cid; 2455 entry->te_fmri = safe_strdup(inst->ri_i.i_fmri); 2456 entry->te_logstem = safe_strdup(inst->ri_logstem); 2457 entry->te_fired = 0; 2458 /* Insert the calculated timeout time onto the queue. */ 2459 MUTEX_LOCK(&timeouts->tq_lock); 2460 (void) uu_list_find(timeouts->tq_list, entry, NULL, &idx); 2461 uu_list_node_init(entry, &entry->te_link, timeout_pool); 2462 uu_list_insert(timeouts->tq_list, entry, idx); 2463 MUTEX_UNLOCK(&timeouts->tq_lock); 2464 2465 assert(inst->ri_timeout == NULL); 2466 inst->ri_timeout = entry; 2467 2468 MUTEX_LOCK(&tu->tu_lock); 2469 tu->tu_wakeup = 1; 2470 (void) pthread_cond_broadcast(&tu->tu_cv); 2471 MUTEX_UNLOCK(&tu->tu_lock); 2472 } 2473 2474 2475 void 2476 timeout_remove(restarter_inst_t *inst, ctid_t cid) 2477 { 2478 assert(MUTEX_HELD(&inst->ri_lock)); 2479 2480 if (inst->ri_timeout == NULL) 2481 return; 2482 2483 assert(inst->ri_timeout->te_ctid == cid); 2484 2485 MUTEX_LOCK(&timeouts->tq_lock); 2486 uu_list_remove(timeouts->tq_list, inst->ri_timeout); 2487 MUTEX_UNLOCK(&timeouts->tq_lock); 2488 2489 free(inst->ri_timeout->te_fmri); 2490 free(inst->ri_timeout->te_logstem); 2491 startd_free(inst->ri_timeout, sizeof (timeout_entry_t)); 2492 inst->ri_timeout = NULL; 2493 } 2494 2495 static int 2496 timeout_now() 2497 { 2498 timeout_entry_t *e; 2499 hrtime_t now; 2500 int ret; 2501 2502 now = gethrtime(); 2503 2504 /* 2505 * Walk through the (sorted) timeouts list. While the timeout 2506 * at the head of the list is <= the current time, kill the 2507 * method. 2508 */ 2509 MUTEX_LOCK(&timeouts->tq_lock); 2510 2511 for (e = uu_list_first(timeouts->tq_list); 2512 e != NULL && e->te_timeout <= now; 2513 e = uu_list_next(timeouts->tq_list, e)) { 2514 log_framework(LOG_WARNING, "%s: Method or service exit timed " 2515 "out. Killing contract %ld.\n", e->te_fmri, e->te_ctid); 2516 log_instance_fmri(e->te_fmri, e->te_logstem, B_TRUE, 2517 "Method or service exit timed out. Killing contract %ld.", 2518 e->te_ctid); 2519 e->te_fired = 1; 2520 (void) contract_kill(e->te_ctid, SIGKILL, e->te_fmri); 2521 } 2522 2523 if (uu_list_numnodes(timeouts->tq_list) > 0) 2524 ret = 0; 2525 else 2526 ret = -1; 2527 2528 MUTEX_UNLOCK(&timeouts->tq_lock); 2529 2530 return (ret); 2531 } 2532 2533 /* 2534 * void *restarter_timeouts_event_thread(void *) 2535 * Responsible for monitoring the method timeouts. This thread must 2536 * be started before any methods are called. 2537 */ 2538 /*ARGSUSED*/ 2539 static void * 2540 restarter_timeouts_event_thread(void *unused) 2541 { 2542 /* 2543 * Timeouts are entered on a priority queue, which is processed by 2544 * this thread. As timeouts are specified in seconds, we'll do 2545 * the necessary processing every second, as long as the queue 2546 * is not empty. 2547 */ 2548 2549 /*CONSTCOND*/ 2550 while (1) { 2551 /* 2552 * As long as the timeout list isn't empty, process it 2553 * every second. 2554 */ 2555 if (timeout_now() == 0) { 2556 (void) sleep(1); 2557 continue; 2558 } 2559 2560 /* The list is empty, wait until we have more timeouts. */ 2561 MUTEX_LOCK(&tu->tu_lock); 2562 2563 while (tu->tu_wakeup == 0) 2564 (void) pthread_cond_wait(&tu->tu_cv, &tu->tu_lock); 2565 2566 tu->tu_wakeup = 0; 2567 MUTEX_UNLOCK(&tu->tu_lock); 2568 } 2569 2570 return (NULL); 2571 } 2572 2573 void 2574 restarter_start() 2575 { 2576 (void) startd_thread_create(restarter_timeouts_event_thread, NULL); 2577 (void) startd_thread_create(restarter_event_thread, NULL); 2578 (void) startd_thread_create(restarter_contracts_event_thread, NULL); 2579 (void) startd_thread_create(wait_thread, NULL); 2580 } 2581 2582 2583 void 2584 restarter_init() 2585 { 2586 restarter_instance_pool = startd_list_pool_create("restarter_instances", 2587 sizeof (restarter_inst_t), offsetof(restarter_inst_t, 2588 ri_link), restarter_instance_compare, UU_LIST_POOL_DEBUG); 2589 (void) memset(&instance_list, 0, sizeof (instance_list)); 2590 2591 (void) pthread_mutex_init(&instance_list.ril_lock, &mutex_attrs); 2592 instance_list.ril_instance_list = startd_list_create( 2593 restarter_instance_pool, &instance_list, UU_LIST_SORTED); 2594 2595 restarter_queue_pool = startd_list_pool_create( 2596 "restarter_instance_queue", sizeof (restarter_instance_qentry_t), 2597 offsetof(restarter_instance_qentry_t, riq_link), NULL, 2598 UU_LIST_POOL_DEBUG); 2599 2600 contract_list_pool = startd_list_pool_create( 2601 "contract_list", sizeof (contract_entry_t), 2602 offsetof(contract_entry_t, ce_link), NULL, 2603 UU_LIST_POOL_DEBUG); 2604 contract_hash_init(); 2605 2606 log_framework(LOG_DEBUG, "Initialized restarter\n"); 2607 } 2608