tools/crm_resource.h

/* */
   1 /*
   2  * Copyright 2004-2024 the Pacemaker project contributors
   3  *
   4  * The version control history for this file may have further details.
   5  *
   6  * This source code is licensed under the GNU Lesser General Public License
   7  * version 2.1 or later (LGPLv2.1+) WITHOUT ANY WARRANTY.
   8  */
   9 
  10 #include <crm_internal.h>
  11 
  12 #include <stdint.h>
  13 #include <stdbool.h>
  14 
  15 #include <crm/crm.h>
  16 
  17 #include <crm/services.h>
  18 #include <crm/common/xml.h>
  19 #include <crm/common/mainloop.h>
  20 #include <crm/common/output_internal.h>
  21 #include <crm/common/scheduler_internal.h>
  22 
  23 #include <crm/cib.h>
  24 #include <crm/common/attrs_internal.h>
  25 #include <crm/pengine/rules.h>
  26 #include <crm/pengine/status.h>
  27 #include <crm/pengine/internal.h>
  28 #include <pacemaker-internal.h>
  29 
  30 #define ATTR_SET_ELEMENT "attr_set_element"
  31 
  32 typedef struct node_info_s {
  33     const char *node_name;
  34     bool promoted;
  35 } node_info_t;
  36 
  37 typedef struct {
  38     char *attr_set_type;
  39     char *attr_set_id;
  40     char *attr_name;
  41     char *attr_value;
  42     char *given_rsc_id;
  43     char *found_attr_id;
  44     pcmk_resource_t *rsc;
  45 } attr_update_data_t;
  46 
  47 enum resource_check_flags {
  48     rsc_remain_stopped  = (1 << 0),
  49     rsc_unpromotable    = (1 << 1),
  50     rsc_unmanaged       = (1 << 2),
  51     rsc_locked          = (1 << 3),
  52     rsc_node_health     = (1 << 4),
  53 };
  54 
  55 typedef struct resource_checks_s {
  56     pcmk_resource_t *rsc;   // Resource being checked
  57     uint32_t flags;         // Group of enum resource_check_flags
  58     const char *lock_node;  // Node that resource is shutdown-locked to, if any
  59 } resource_checks_t;
  60 
  61 resource_checks_t *cli_check_resource(pcmk_resource_t *rsc, char *role_s,
  62                                       char *managed);
  63 
  64 /* ban */
  65 int cli_resource_prefer(pcmk__output_t *out, const char *rsc_id, const char *host,
  66                         const char *move_lifetime, cib_t *cib_conn,
  67                         gboolean promoted_role_only, const char *promoted_role);
  68 int cli_resource_ban(pcmk__output_t *out, const char *rsc_id, const char *host,
  69                      const char *move_lifetime, cib_t *cib_conn,
  70                      gboolean promoted_role_only, const char *promoted_role);
  71 int cli_resource_clear(const char *rsc_id, const char *host, GList *allnodes,
  72                        cib_t *cib_conn, bool clear_ban_constraints,
  73                        gboolean force);
  74 int cli_resource_clear_all_expired(xmlNode *root, cib_t *cib_conn,
  75                                    const char *rsc, const char *node, gboolean promoted_role_only);
  76 
  77 /* print */
  78 void cli_resource_print_cts(pcmk_resource_t *rsc, pcmk__output_t *out);
  79 void cli_resource_print_cts_constraints(pcmk_scheduler_t *scheduler);
  80 
  81 int cli_resource_print(pcmk_resource_t *rsc, pcmk_scheduler_t *scheduler,
  82                        bool expanded);
  83 int cli_resource_print_operations(const char *rsc_id, const char *host_uname,
  84                                   bool active, pcmk_scheduler_t *scheduler);
  85 
  86 /* runtime */
  87 int cli_resource_check(pcmk__output_t *out, pcmk_resource_t *rsc,
  88                        pcmk_node_t *node);
  89 int cli_resource_fail(pcmk_ipc_api_t *controld_api, const char *host_uname,
  90                       const char *rsc_id, pcmk_scheduler_t *scheduler);
  91 GList *cli_resource_search(pcmk_resource_t *rsc, const char *requested_name,
  92                              pcmk_scheduler_t *scheduler);
  93 int cli_resource_delete(pcmk_ipc_api_t *controld_api, const char *host_uname,
  94                         const pcmk_resource_t *rsc, const char *operation,
  95                         const char *interval_spec, bool just_failures,
  96                         pcmk_scheduler_t *scheduler, gboolean force);
  97 int cli_cleanup_all(pcmk_ipc_api_t *controld_api, const char *node_name,
  98                     const char *operation, const char *interval_spec,
  99                     pcmk_scheduler_t *scheduler);
 100 int cli_resource_restart(pcmk__output_t *out, pcmk_resource_t *rsc,
 101                          const pcmk_node_t *node, const char *move_lifetime,
 102                          guint timeout_ms, cib_t *cib,
 103                          gboolean promoted_role_only, gboolean force);
 104 int cli_resource_move(const pcmk_resource_t *rsc, const char *rsc_id,
 105                       const char *host_name, const char *move_lifetime,
 106                       cib_t *cib, pcmk_scheduler_t *scheduler,
 107                       gboolean promoted_role_only, gboolean force);
 108 crm_exit_t cli_resource_execute_from_params(pcmk__output_t *out, const char *rsc_name,
 109                                             const char *rsc_class, const char *rsc_prov,
 110                                             const char *rsc_type, const char *rsc_action,
 111                                             GHashTable *params, GHashTable *override_hash,
 112                                             guint timeout_ms,
 113                                             int resource_verbose,
 114                                             gboolean force, int check_level);
 115 crm_exit_t cli_resource_execute(pcmk_resource_t *rsc,
 116                                 const char *requested_name,
 117                                 const char *rsc_action, GHashTable *override_hash,
 118                                 guint timeout_ms, cib_t *cib,
 119                                 pcmk_scheduler_t *scheduler,
 120                                 int resource_verbose, gboolean force, int check_level);
 121 
 122 int cli_resource_update_attribute(pcmk_resource_t *rsc,
 123                                   const char *requested_name,
 124                                   const char *attr_set, const char *attr_set_type,
 125                                   const char *attr_id, const char *attr_name,
 126                                   const char *attr_value, gboolean recursive,
 127                                   cib_t *cib, xmlNode *cib_xml_orig,
 128                                   gboolean force);
 129 int cli_resource_delete_attribute(pcmk_resource_t *rsc,
 130                                   const char *requested_name,
 131                                   const char *attr_set, const char *attr_set_type,
 132                                   const char *attr_id, const char *attr_name,
 133                                   cib_t *cib, xmlNode *cib_xml_orig,
 134                                   gboolean force);
 135 
 136 int update_scheduler_input(pcmk__output_t *out, pcmk_scheduler_t *scheduler,
 137                            cib_t *cib, xmlNode **cib_xml_orig);
 138 int wait_till_stable(pcmk__output_t *out, guint timeout_ms, cib_t * cib);
 139 
 140 bool resource_is_running_on(pcmk_resource_t *rsc, const char *host);
 141 
 142 void crm_resource_register_messages(pcmk__output_t *out);
/* */
root/tools/crm_resource.h

INCLUDED FROM
