Convert unit test assertion helpers into macros

daemons/attrd/pacemaker-attrd.c

@@ -112,7 +112,8 @@ main(int argc, char **argv)
         goto done;
     }
 
-    rc = pcmk__output_new(&out, args->output_ty, args->output_dest, argv);
+    rc = pcmk__output_new(&out, args->output_ty, args->output_dest,
+                          (const char *const *) argv);
     if ((rc != pcmk_rc_ok) || (out == NULL)) {
         attrd_exit_status = CRM_EX_ERROR;
         g_set_error(&error, PCMK__EXITC_ERROR, attrd_exit_status,

daemons/based/pacemaker-based.c

@@ -184,7 +184,8 @@ main(int argc, char **argv)
         goto done;
     }
 
-    rc = pcmk__output_new(&out, args->output_ty, args->output_dest, argv);
+    rc = pcmk__output_new(&out, args->output_ty, args->output_dest,
+                          (const char *const *) argv);
     if (rc != pcmk_rc_ok) {
         exit_code = CRM_EX_ERROR;
         g_set_error(&error, PCMK__EXITC_ERROR, exit_code,

daemons/controld/pacemaker-controld.c

@@ -90,7 +90,8 @@ main(int argc, char **argv)
         goto done;
     }
 
-    rc = pcmk__output_new(&out, args->output_ty, args->output_dest, argv);
+    rc = pcmk__output_new(&out, args->output_ty, args->output_dest,
+                          (const char *const *) argv);
     if (rc != pcmk_rc_ok) {
         exit_code = CRM_EX_ERROR;
         g_set_error(&error, PCMK__EXITC_ERROR, exit_code,

daemons/execd/pacemaker-execd.c

@@ -355,7 +355,8 @@ main(int argc, char **argv)
         goto done;
     }
 
-    rc = pcmk__output_new(&out, args->output_ty, args->output_dest, argv);
+    rc = pcmk__output_new(&out, args->output_ty, args->output_dest,
+                          (const char *const *) argv);
     if (rc != pcmk_rc_ok) {
         exit_code = CRM_EX_ERROR;
         g_set_error(&error, PCMK__EXITC_ERROR, exit_code,
@@ -371,7 +372,9 @@ main(int argc, char **argv)
 
     // Open additional log files
     if (options.log_files != NULL) {
-        for (gchar **fname = options.log_files; *fname != NULL; fname++) {
+        for (const char *const *fname = (const char *const *) options.log_files;
+             *fname != NULL; fname++) {
+
             rc = pcmk__add_logfile(*fname);
 
             if (rc != pcmk_rc_ok) {

daemons/fenced/fenced_commands.c

@@ -277,8 +277,8 @@ get_value_for_target(const char *target, const char *values)
 
     mappings = g_strsplit_set(values, "; \t", 0);
 
-    for (gchar **mapping = mappings; (*mapping != NULL) && (value == NULL);
-         mapping++) {
+    for (const char *const *mapping = (const char *const *) mappings;
+         (*mapping != NULL) && (value == NULL); mapping++) {
 
         value = get_value_if_matching(target, *mapping);
     }
@@ -961,7 +961,9 @@ build_port_aliases(const char *hostmap, GList **targets)
     stripped = g_strstrip(g_strdup(hostmap));
     mappings = g_strsplit_set(stripped, "; \t", 0);
 
-    for (gchar **mapping = mappings; *mapping != NULL; mapping++) {
+    for (const char *const *mapping = (const char *const *) mappings;
+         *mapping != NULL; mapping++) {
+
         gchar **nvpair = NULL;
 
         if (pcmk__str_empty(*mapping)) {
@@ -1881,7 +1883,9 @@ fenced_register_level(xmlNode *msg, pcmk__action_result_t *result)
          */
         gchar **devices = g_strsplit(value, ",", 0);
 
-        for (char **dev = devices; (dev != NULL) && (*dev != NULL); dev++) {
+        for (const char *const *dev = (const char *const *) devices;
+             (dev != NULL) && (*dev != NULL); dev++) {
+
             pcmk__trace("Adding device '%s' for %s[%d]", *dev, tp->target, id);
             tp->levels[id] = g_list_append(tp->levels[id],
                                            pcmk__str_copy(*dev));
@@ -2143,11 +2147,14 @@ localhost_is_eligible(const fenced_device_t *device, const char *action,
 {
     bool localhost_is_target = pcmk__str_eq(target, fenced_get_local_node(),
                                             pcmk__str_casei);
+    const gchar *const *on_target_actions = NULL;
+
+    CRM_CHECK((device != NULL) && (action != NULL), return true);
 
-    CRM_CHECK(action != NULL, return true);
+    on_target_actions = (const gchar *const *) device->on_target_actions;
 
-    if ((device != NULL) && (device->on_target_actions != NULL)
-        && pcmk__g_strv_contains(device->on_target_actions, action)) {
+    if ((on_target_actions != NULL)
+        && pcmk__g_strv_contains(on_target_actions, action)) {
 
         if (!localhost_is_target) {
             pcmk__trace("Operation '%s' using %s can only be executed for "

daemons/fenced/pacemaker-fenced.c

@@ -370,7 +370,8 @@ main(int argc, char **argv)
         goto done;
     }
 
-    rc = pcmk__output_new(&out, args->output_ty, args->output_dest, argv);
+    rc = pcmk__output_new(&out, args->output_ty, args->output_dest,
+                          (const char *const *) argv);
     if (rc != pcmk_rc_ok) {
         exit_code = CRM_EX_ERROR;
         g_set_error(&error, PCMK__EXITC_ERROR, exit_code,

daemons/pacemakerd/pacemakerd.c

@@ -75,7 +75,9 @@ pacemakerd_features_xml(pcmk__output_t *out, va_list args) {
                                    NULL);
     out->begin_list(out, NULL, NULL, PCMK_XE_FEATURES);
 
-    for (char **s = feature_list; *s != NULL; s++) {
+    for (const char *const *s = (const char *const *) feature_list; *s != NULL;
+         s++) {
+
         pcmk__output_create_xml_text_node(out, PCMK_XE_FEATURE, *s);
     }
 
@@ -363,7 +365,8 @@ main(int argc, char **argv)
         goto done;
     }
 
-    rc = pcmk__output_new(&out, args->output_ty, args->output_dest, argv);
+    rc = pcmk__output_new(&out, args->output_ty, args->output_dest,
+                          (const char *const *) argv);
     if ((rc != pcmk_rc_ok) || (out == NULL)) {
         exit_code = CRM_EX_ERROR;
         g_set_error(&error, PCMK__EXITC_ERROR, exit_code, "Error creating output format %s: %s",

daemons/schedulerd/pacemaker-schedulerd.c

@@ -98,7 +98,8 @@ main(int argc, char **argv)
         goto done;
     }
 
-    rc = pcmk__output_new(&out, args->output_ty, args->output_dest, argv);
+    rc = pcmk__output_new(&out, args->output_ty, args->output_dest,
+                          (const char *const *) argv);
     if ((rc != pcmk_rc_ok) || (out == NULL)) {
         exit_code = CRM_EX_FATAL;
         g_set_error(&error, PCMK__EXITC_ERROR, exit_code, "Error creating output format %s: %s",

include/crm/common/cmdline_internal.h

@@ -106,18 +106,7 @@ void pcmk__add_arg_group(GOptionContext *context, const char *name,
                          const char *header, const char *desc,
                          const GOptionEntry entries[]);
 
-/*!
- * \internal
- * \brief Prepare the command line for being added to a pcmk__output_t as the
- *        request
- *
- * This performs various transformations on the command line arguments, such
- * as surrounding arguments containing spaces with quotes and escaping any
- * single quotes in the string.
- *
- * \param[in,out] argv  Command line (typically from pcmk__cmdline_preproc())
- */
-gchar *pcmk__quote_cmdline(gchar **argv);
+gchar *pcmk__quote_cmdline(const char *const *argv);
 
 /*!
  * \internal

include/crm/common/output_internal.h

@@ -42,15 +42,15 @@ typedef struct pcmk__output_s pcmk__output_t;
 
 /*!
  * \internal
- * \brief The type of a function that creates a ::pcmk__output_t.
+ * \brief Function for format-specific setup of a \c pcmk__output_t
  *
- * Instances of this type are passed to pcmk__register_format(), stored in an
- * internal data structure, and later accessed by pcmk__output_new().  For 
- * examples, see pcmk__mk_xml_output() and pcmk__mk_text_output().
+ * Instances of this type are passed to \c pcmk__register_format(), stored in an
+ * internal data structure, and later accessed by \c pcmk__output_new(). For
+ * examples, see \c pcmk__output_setup_text() and \c pcmk__output_setup_xml().
  *
- * \param[in] argv The list of command line arguments.
+ * \param[in] out  Output object to set up
  */
-typedef pcmk__output_t * (*pcmk__output_factory_t)(char **argv);
+typedef void (*pcmk__output_setup_fn_t)(pcmk__output_t *out);
 
 /*!
  * \internal
@@ -131,9 +131,10 @@ typedef struct pcmk__supported_format_s {
     const char *name;
 
     /*!
-     * \brief A function that creates a ::pcmk__output_t.
+     * \internal
+     * \brief Function that does format-specific setup for a \c pcmk__output_t
      */
-    pcmk__output_factory_t create;
+    pcmk__output_setup_fn_t setup_fn;
 
     /*!
      * \brief Format-specific command line options.  This can be NULL if
@@ -148,17 +149,19 @@ typedef struct pcmk__supported_format_s {
 
 extern GOptionEntry pcmk__html_output_entries[];
 
-pcmk__output_t *pcmk__mk_html_output(char **argv);
-pcmk__output_t *pcmk__mk_log_output(char **argv);
-pcmk__output_t *pcmk__mk_none_output(char **argv);
-pcmk__output_t *pcmk__mk_text_output(char **argv);
-pcmk__output_t *pcmk__mk_xml_output(char **argv);
+void pcmk__output_setup_html(pcmk__output_t *out);
+void pcmk__output_setup_log(pcmk__output_t *out);
+void pcmk__output_setup_none(pcmk__output_t *out);
+void pcmk__output_setup_text(pcmk__output_t *out);
+void pcmk__output_setup_xml(pcmk__output_t *out);
 
-#define PCMK__SUPPORTED_FORMAT_HTML { "html", pcmk__mk_html_output, pcmk__html_output_entries }
-#define PCMK__SUPPORTED_FORMAT_LOG  { "log", pcmk__mk_log_output, NULL }
-#define PCMK__SUPPORTED_FORMAT_NONE { PCMK_VALUE_NONE, pcmk__mk_none_output, NULL }
-#define PCMK__SUPPORTED_FORMAT_TEXT { "text", pcmk__mk_text_output, NULL }
-#define PCMK__SUPPORTED_FORMAT_XML  { "xml", pcmk__mk_xml_output, NULL }
+#define PCMK__SUPPORTED_FORMAT_HTML \
+    { "html", pcmk__output_setup_html, pcmk__html_output_entries }
+#define PCMK__SUPPORTED_FORMAT_LOG  { "log", pcmk__output_setup_log, NULL }
+#define PCMK__SUPPORTED_FORMAT_NONE \
+    { PCMK_VALUE_NONE, pcmk__output_setup_none, NULL }
+#define PCMK__SUPPORTED_FORMAT_TEXT { "text", pcmk__output_setup_text, NULL }
+#define PCMK__SUPPORTED_FORMAT_XML  { "xml", pcmk__output_setup_xml, NULL }
 
 /*!
  * \brief This structure contains everything that makes up a single output
@@ -298,28 +301,14 @@ struct pcmk__output_s {
      */
     void (*reset) (pcmk__output_t *out);
 
-    /*!
-     * \internal
-     * \brief Register a custom message.
-     *
-     * \param[in,out] out        The output functions structure.
-     * \param[in]     message_id The name of the message to register.  This name
-     *                           will be used as the message_id parameter to the
-     *                           message function in order to call the custom
-     *                           format function.
-     * \param[in]     fn         The custom format function to call for message_id.
-     */
-    void (*register_message) (pcmk__output_t *out, const char *message_id,
-                              pcmk__message_fn_t fn);
-
     /*!
      * \internal
      * \brief Call a previously registered custom message.
      *
      * \param[in,out] out        The output functions structure.
      * \param[in]     message_id The name of the message to call.  This name must
      *                           be the same as the message_id parameter of some
-     *                           previous call to register_message.
+     *                           previous call to \c pcmk__register_message().
      * \param[in] ...            Arguments to be passed to the registered function.
      *
      * \return A standard Pacemaker return code.  Generally: 0 if a function was
@@ -532,21 +521,6 @@ struct pcmk__output_s {
     void (*prompt) (const char *prompt, bool echo, char **dest);
 };
 
-/*!
- * \internal
- * \brief Call a formatting function for a previously registered message.
- *
- * \note This function is for implementing custom formatters.  It should not
- *       be called directly.  Instead, call out->message.
- *
- * \param[in,out] out        The output functions structure.
- * \param[in]     message_id The message to be handled.  Unknown messages
- *                           will be ignored.
- * \param[in]     ...        Arguments to be passed to the registered function.
- */
-int
-pcmk__call_message(pcmk__output_t *out, const char *message_id, ...);
-
 /*!
  * \internal
  * \brief Free a ::pcmk__output_t structure that was previously created by
@@ -578,27 +552,28 @@ void pcmk__output_free(pcmk__output_t *out);
  * \return Standard Pacemaker return code
  */
 int pcmk__output_new(pcmk__output_t **out, const char *fmt_name,
-                     const char *filename, char **argv);
+                     const char *filename, const char *const *argv);
 
 /*!
  * \internal
  * \brief Register a new output formatter, making it available for use
  *        the same as a base formatter.
  *
- * \param[in,out] group   A ::GOptionGroup that formatted output related command
- *                        line arguments should be added to.  This can be NULL
- *                        for use outside of command line programs.
- * \param[in]     name    The name of the format.  This will be used to select a
- *                        format from command line options and for displaying help.
- * \param[in]     create  A function that creates a ::pcmk__output_t.
- * \param[in]     options Format-specific command line options.  These will be
- *                        added to the context.  This argument can also be NULL.
+ * \param[in,out] group     Option group that formatted output-related command
+ *                          line arguments should be added to. This can be
+ *                          \c NULL for use outside of command line programs.
+ * \param[in]     name      Format name. This will be used to select a format
+ *                          from command line options and for displaying help.
+ * \param[in]     setup_fn  Function that initializes a \c pcmk__output_t
+ * \param[in]     options   Format-specific command line options. These will be
+ *                          added to the context. This argument can also be
+ *                          \c NULL.
  *
  * \return Standard Pacemaker return code
  */
 int
 pcmk__register_format(GOptionGroup *group, const char *name,
-                      pcmk__output_factory_t create,
+                      pcmk__output_setup_fn_t setup,
                       const GOptionEntry *options);
 
 /*!
@@ -624,21 +599,6 @@ pcmk__register_formats(GOptionGroup *group,
 void
 pcmk__unregister_formats(void);
 
-/*!
- * \internal
- * \brief Register a function to handle a custom message.
- *
- * \note This function is for implementing custom formatters.  It should not
- *       be called directly.  Instead, call out->register_message.
- *
- * \param[in,out] out        The output functions structure.
- * \param[in]     message_id The message to be handled.
- * \param[in]     fn         The custom format function to call for message_id.
- */
-void
-pcmk__register_message(pcmk__output_t *out, const char *message_id,
-                       pcmk__message_fn_t fn);
-
 /*!
  * \internal
  * \brief Register an entire table of custom formatting functions at once.

include/crm/common/strings_internal.h

@@ -164,7 +164,7 @@ pcmk__intkey_table_remove(GHashTable *hash_table, int key)
 }
 
 bool pcmk__str_in_list(const char *str, const GList *list, uint32_t flags);
-bool pcmk__g_strv_contains(gchar **strv, const gchar *str);
+bool pcmk__g_strv_contains(const gchar *const *strv, const gchar *str);
 
 bool pcmk__strcase_any_of(const char *s, ...) G_GNUC_NULL_TERMINATED;
 bool pcmk__str_any_of(const char *s, ...) G_GNUC_NULL_TERMINATED;

include/crm/common/unittest_internal.h

@@ -138,16 +138,16 @@ void pcmk__cib_test_cleanup(char *out_path);
 
 void pcmk__test_init_logging(const char *name, const char *filename);
 
-pcmk__output_t *pcmk__mk_fake_text_output(char **argv);
+void pcmk__output_setup_fake_text(pcmk__output_t *out);
 int pcmk__output_test_setup_group(void **state);
 int pcmk__output_test_teardown_group(void **state);
 void pcmk__set_fake_text_init_succeeds(bool value);
 void pcmk__set_testing_output_free(bool value);
 void pcmk__set_testing_output_and_clear_error(bool value);
 void pcmk__expect_fake_text_free_priv(void);
 void pcmk__expect_fake_text_err(void);
-pcmk__output_t *pcmk__output_null_create1(char **argv);
-pcmk__output_t *pcmk__output_null_create2(char **argv);
+void pcmk__output_setup_dummy1(pcmk__output_t *out);
+void pcmk__output_setup_dummy2(pcmk__output_t *out);
 int pcmk__output_message_dummy1(pcmk__output_t *out, va_list args);
 int pcmk__output_message_dummy2(pcmk__output_t *out, va_list args);
 

include/pacemaker.h

@@ -296,6 +296,7 @@ int pcmk_list_nodes(xmlNode **xml, const char *types);
  */
 int pcmk_status(xmlNodePtr *xml);
 
+// @COMPAT Change rule_ids to type const char *const * at a compatibility break
 /*!
  * \brief Check whether each rule in a list is in effect
  *

include/pcmki/pcmki_rule.h

@@ -22,7 +22,7 @@ extern "C" {
 #endif
 
 int pcmk__check_rules(pcmk__output_t *out, xmlNodePtr input,
-                      const crm_time_t *date_time, const char **rule_ids);
+                      const crm_time_t *date_time, const char *const *rule_ids);
 
 /*!
  * \internal

lib/cib/cib_attrs.c

@@ -39,7 +39,7 @@ new_output_object(const char *ty)
     };
 
     pcmk__register_formats(NULL, formats);
-    rc = pcmk__output_new(&out, ty, NULL, (char**)argv);
+    rc = pcmk__output_new(&out, ty, NULL, argv);
     if ((rc != pcmk_rc_ok) || (out == NULL)) {
         pcmk__err("Can't out due to internal error: %s", pcmk_rc_str(rc));
         return NULL;