Tests: add trigger name/unnamed backwards compatibility test
[lttng-tools.git] / tests / regression / tools / trigger / name / trigger_name.c
diff --git a/tests/regression/tools/trigger/name/trigger_name.c b/tests/regression/tools/trigger/name/trigger_name.c
new file mode 100644 (file)
index 0000000..d0d82a8
--- /dev/null
@@ -0,0 +1,644 @@
+/*
+ * trigger_name.c
+ *
+ * Tests suite for anonymous, named, and automatic name triggers.
+ *
+ * Copyright (C) 2021 Jérémie Galarneau <jeremie.galarneau@efficios.com>
+ *
+ * SPDX-License-Identifier: MIT
+ *
+ */
+
+#include <stdio.h>
+#include <unistd.h>
+#include <assert.h>
+#include <tap/tap.h>
+#include <stdint.h>
+#include <string.h>
+#include <lttng/lttng.h>
+#include <common/macros.h>
+
+#define TEST_COUNT 70
+
+enum unregistration_trigger_instance {
+       UNREGISTRATION_TRIGGER_INSTANCE_USED_FOR_REGISTRATION,
+       UNREGISTRATION_TRIGGER_INSTANCE_FROM_LISTING,
+};
+
+typedef void (*test_function)(enum unregistration_trigger_instance);
+
+static
+const char *get_trigger_name(const struct lttng_trigger *trigger)
+{
+       const char *trigger_name;
+       enum lttng_trigger_status trigger_status;
+
+       trigger_status = lttng_trigger_get_name(trigger, &trigger_name);
+       switch (trigger_status) {
+       case LTTNG_TRIGGER_STATUS_OK:
+               break;
+       case LTTNG_TRIGGER_STATUS_UNSET:
+               trigger_name = "(anonymous)";
+               break;
+       default:
+               trigger_name = "(failed to get name)";
+               break;
+       }
+
+       return trigger_name;
+}
+
+static
+const char *unregistration_trigger_instance_name(
+               enum unregistration_trigger_instance unregistration_trigger)
+{
+       const char *name;
+
+       switch (unregistration_trigger) {
+       case UNREGISTRATION_TRIGGER_INSTANCE_FROM_LISTING:
+               name = "from listing";
+               break;
+       case UNREGISTRATION_TRIGGER_INSTANCE_USED_FOR_REGISTRATION:
+               name = "used for registration";
+               break;
+       default:
+               abort();
+       }
+
+       return name;
+}
+
+/*
+ * Returns a negative error code on error, else the number of unregistered
+ * triggers.
+ */
+static
+int unregister_all_triggers(void)
+{
+       int ret;
+       enum lttng_error_code ret_code;
+       enum lttng_trigger_status trigger_status;
+       struct lttng_triggers *triggers = NULL;
+       unsigned int trigger_count, i, unregistered_trigger_count = 0;
+
+       ret_code = lttng_list_triggers(&triggers);
+       if (ret_code != LTTNG_OK) {
+               fail("Failed to list triggers");
+               ret = -1;
+               goto end;
+       }
+
+       trigger_status = lttng_triggers_get_count(triggers, &trigger_count);
+       if (trigger_status != LTTNG_TRIGGER_STATUS_OK) {
+               fail("Failed to get count of triggers returned by listing");
+               ret = -1;
+               goto end;
+       }
+
+       for (i = 0; i < trigger_count; i++) {
+               const struct lttng_trigger *trigger;
+
+               trigger = lttng_triggers_get_at_index(triggers, i);
+               assert(trigger);
+
+               ret = lttng_unregister_trigger(trigger);
+               if (ret) {
+                       fail("Failed to unregister trigger: trigger name = '%s'");
+                       goto end;
+               }
+
+               unregistered_trigger_count++;
+       }
+
+       ret = (int) unregistered_trigger_count;
+
+end:
+       lttng_triggers_destroy(triggers);
+       return ret;
+}
+
+static
+int get_registered_triggers_count(void)
+{
+       int ret;
+       enum lttng_error_code ret_code;
+       enum lttng_trigger_status trigger_status;
+       struct lttng_triggers *triggers = NULL;
+       unsigned int trigger_count;
+
+       ret_code = lttng_list_triggers(&triggers);
+       if (ret_code != LTTNG_OK) {
+               fail("Failed to list triggers");
+               ret = -1;
+               goto end;
+       }
+
+       trigger_status = lttng_triggers_get_count(triggers, &trigger_count);
+       if (trigger_status != LTTNG_TRIGGER_STATUS_OK) {
+               fail("Failed to get count of triggers returned by listing");
+               ret = -1;
+               goto end;
+       }
+
+       ret = (int) trigger_count;
+
+end:
+       lttng_triggers_destroy(triggers);
+       return ret;
+}
+
+/*
+ * Create a generic trigger. The specifics of the condition and action are not
+ * important for the purposes of this test.
+ */
+static
+struct lttng_trigger *create_trigger(size_t threshold)
+{
+       struct lttng_condition *condition = NULL;
+       struct lttng_action *action = NULL;
+       struct lttng_trigger *trigger = NULL;
+       enum lttng_condition_status condition_status;
+       const char * const session_name = "test session";
+
+       condition = lttng_condition_session_consumed_size_create();
+       if (!condition) {
+               fail("Failed to create 'session consumed size' condition");
+               goto end;
+       }
+
+       condition_status = lttng_condition_session_consumed_size_set_session_name(condition, session_name);
+       if (condition_status != LTTNG_CONDITION_STATUS_OK) {
+               fail("Failed to set session name on 'session consumed size' condition");
+               goto end;
+       }
+
+       condition_status = lttng_condition_session_consumed_size_set_threshold(
+                       condition, threshold);
+       if (condition_status != LTTNG_CONDITION_STATUS_OK) {
+               fail("Failed to set threshold on 'session consumed size' condition");
+               goto end;
+       }
+
+       action = lttng_action_notify_create();
+       if (!action) {
+               fail("Failed to create 'notify' action");
+               goto end;
+       }
+
+       trigger = lttng_trigger_create(condition, action);
+       if (!trigger) {
+               fail("Failed to create trigger");
+               goto end;
+       }
+
+end:
+       lttng_condition_destroy(condition);
+       lttng_action_destroy(action);
+       return trigger;
+}
+
+static
+void register_anonymous_trigger(
+               enum unregistration_trigger_instance unregistration_trigger)
+{
+       int ret;
+       struct lttng_trigger *trigger = create_trigger(0xbadc0ffee);
+       enum lttng_trigger_status trigger_status;
+       const char *trigger_name;
+       struct lttng_triggers *triggers = NULL;
+       unsigned int trigger_count, i;
+       enum lttng_error_code ret_code;
+
+       diag("Register an anonymous trigger (Unregistration performed with the trigger instance %s)",
+                       unregistration_trigger_instance_name(
+                                       unregistration_trigger));
+
+       if (!trigger) {
+               fail("Failed to create trigger");
+               goto end;
+       }
+
+       ret = lttng_register_trigger(trigger);
+       ok(ret == 0, "Registered anonymous trigger");
+
+       trigger_status = lttng_trigger_get_name(trigger, &trigger_name);
+       ok(trigger_status == LTTNG_TRIGGER_STATUS_UNSET,
+                       "Anonymous trigger name remains unset after registration: trigger name = '%s'",
+                       get_trigger_name(trigger));
+
+       ret_code = lttng_list_triggers(&triggers);
+       if (ret_code != LTTNG_OK) {
+               fail("Failed to list triggers");
+               ret = -1;
+               goto end;
+       }
+
+       trigger_status = lttng_triggers_get_count(triggers, &trigger_count);
+       if (trigger_status != LTTNG_TRIGGER_STATUS_OK) {
+               fail("Failed to get count of triggers returned by listing");
+               ret = -1;
+               goto end;
+       }
+
+       ok(trigger_count == 1, "Trigger listing returns 1 trigger");
+
+       for (i = 0; i < trigger_count; i++) {
+               const struct lttng_trigger *trigger_from_listing;
+
+               trigger_from_listing = lttng_triggers_get_at_index(triggers, i);
+               assert(trigger_from_listing);
+
+               trigger_status = lttng_trigger_get_name(trigger_from_listing, &trigger_name);
+               ok(trigger_status == LTTNG_TRIGGER_STATUS_UNSET,
+                               "Anonymous trigger returned by listing has an unset name: trigger name = '%s'",
+                               get_trigger_name(trigger_from_listing));
+
+               if (unregistration_trigger == UNREGISTRATION_TRIGGER_INSTANCE_FROM_LISTING) {
+                       ret = lttng_unregister_trigger(trigger_from_listing);
+                       ok(ret == 0, "Successfully unregistered anonymous trigger using the trigger instance returned by the listing");
+               }
+       }
+
+       if (unregistration_trigger == UNREGISTRATION_TRIGGER_INSTANCE_USED_FOR_REGISTRATION) {
+               ret = lttng_unregister_trigger(trigger);
+               ok(ret == 0, "Successfully unregistered anonymous trigger using the trigger instance used on registration");
+       }
+
+end:
+       lttng_triggers_destroy(triggers);
+       lttng_trigger_destroy(trigger);
+}
+
+static
+void register_named_trigger(
+               enum unregistration_trigger_instance unregistration_trigger)
+{
+       int ret;
+       struct lttng_trigger *trigger = create_trigger(0xbadc0ffee);
+       enum lttng_trigger_status trigger_status;
+       const char *returned_trigger_name;
+       struct lttng_triggers *triggers = NULL;
+       unsigned int trigger_count, i;
+       enum lttng_error_code ret_code;
+       const char * const trigger_name = "some name that is hopefully unique";
+
+       diag("Register a named trigger (Unregistration performed with the trigger instance %s)",
+                       unregistration_trigger_instance_name(
+                                       unregistration_trigger));
+
+       if (!trigger) {
+               fail("Failed to create trigger");
+               goto end;
+       }
+
+       ret_code = lttng_register_trigger_with_name(trigger, trigger_name);
+       ok(ret_code == LTTNG_OK, "Registered trigger with name: trigger name = '%s'",
+                       get_trigger_name(trigger));
+
+       trigger_status = lttng_trigger_get_name(trigger, &returned_trigger_name);
+       ok(trigger_status == LTTNG_TRIGGER_STATUS_OK,
+                       "Trigger name is set after registration: trigger name = '%s'",
+                       get_trigger_name(trigger));
+
+       ok(!strcmp(get_trigger_name(trigger), trigger_name),
+                       "Name set on trigger after registration is correct");
+
+       ret_code = lttng_list_triggers(&triggers);
+       if (ret_code != LTTNG_OK) {
+               fail("Failed to list triggers");
+               ret = -1;
+               goto end;
+       }
+
+       trigger_status = lttng_triggers_get_count(triggers, &trigger_count);
+       if (trigger_status != LTTNG_TRIGGER_STATUS_OK) {
+               fail("Failed to get count of triggers returned by listing");
+               ret = -1;
+               goto end;
+       }
+
+       ok(trigger_count == 1, "Trigger listing returns 1 trigger");
+
+       for (i = 0; i < trigger_count; i++) {
+               const struct lttng_trigger *trigger_from_listing;
+
+               trigger_from_listing = lttng_triggers_get_at_index(triggers, i);
+               assert(trigger_from_listing);
+
+               trigger_status = lttng_trigger_get_name(trigger_from_listing, &returned_trigger_name);
+               ok(trigger_status == LTTNG_TRIGGER_STATUS_OK,
+                               "Trigger returned by listing has a name: trigger name = '%s'",
+                               get_trigger_name(trigger_from_listing));
+
+               ok(!strcmp(get_trigger_name(trigger_from_listing),
+                               trigger_name),
+                               "Name set on trigger returned from listing is correct: name returned from listing = '%s', expected name = '%s'",
+                               get_trigger_name(trigger_from_listing),
+                               trigger_name);
+
+               if (unregistration_trigger == UNREGISTRATION_TRIGGER_INSTANCE_FROM_LISTING) {
+                       ret = lttng_unregister_trigger(trigger_from_listing);
+                       ok(ret == 0, "Successfully unregistered named trigger using the trigger instance returned by the listing");
+               }
+       }
+
+       if (unregistration_trigger == UNREGISTRATION_TRIGGER_INSTANCE_USED_FOR_REGISTRATION) {
+               ret = lttng_unregister_trigger(trigger);
+               ok(ret == 0, "Successfully unregistered named trigger using the trigger instance used on registration");
+       }
+
+end:
+       lttng_triggers_destroy(triggers);
+       lttng_trigger_destroy(trigger);
+}
+
+static
+void register_automatic_name_trigger(
+               enum unregistration_trigger_instance unregistration_trigger)
+{
+       int ret;
+       struct lttng_trigger *trigger = create_trigger(0xbadc0ffee);
+       enum lttng_trigger_status trigger_status;
+       const char *returned_trigger_name;
+       struct lttng_triggers *triggers = NULL;
+       unsigned int trigger_count, i;
+       enum lttng_error_code ret_code;
+
+       diag("Register an automatic name trigger (Unregistration performed with the trigger instance %s)",
+                       unregistration_trigger_instance_name(
+                                       unregistration_trigger));
+
+       if (!trigger) {
+               fail("Failed to create trigger");
+               goto end;
+       }
+
+       ret_code = lttng_register_trigger_with_automatic_name(trigger);
+       ok(ret_code == LTTNG_OK, "Registered trigger with automatic name");
+
+       trigger_status = lttng_trigger_get_name(trigger, &returned_trigger_name);
+       ok(trigger_status == LTTNG_TRIGGER_STATUS_OK,
+                       "Trigger name is set after registration: trigger name = '%s'",
+                       get_trigger_name(trigger));
+
+       ok(returned_trigger_name && strlen(returned_trigger_name) > 0,
+                       "Automatic name set on trigger after registration longer is not an empty string");
+
+       ret_code = lttng_list_triggers(&triggers);
+       if (ret_code != LTTNG_OK) {
+               fail("Failed to list triggers");
+               ret = -1;
+               goto end;
+       }
+
+       trigger_status = lttng_triggers_get_count(triggers, &trigger_count);
+       if (trigger_status != LTTNG_TRIGGER_STATUS_OK) {
+               fail("Failed to get count of triggers returned by listing");
+               ret = -1;
+               goto end;
+       }
+
+       ok(trigger_count == 1, "Trigger listing returns 1 trigger");
+
+       for (i = 0; i < trigger_count; i++) {
+               const struct lttng_trigger *trigger_from_listing;
+
+               trigger_from_listing = lttng_triggers_get_at_index(triggers, i);
+               assert(trigger_from_listing);
+
+               trigger_status = lttng_trigger_get_name(trigger_from_listing, &returned_trigger_name);
+               ok(trigger_status == LTTNG_TRIGGER_STATUS_OK,
+                               "Trigger returned by listing has a name: trigger name = '%s'",
+                               get_trigger_name(trigger_from_listing));
+
+               if (unregistration_trigger == UNREGISTRATION_TRIGGER_INSTANCE_FROM_LISTING) {
+                       ret = lttng_unregister_trigger(trigger_from_listing);
+                       ok(ret == 0, "Successfully unregistered automatic name trigger using the trigger instance returned by the listing");
+               }
+       }
+
+       if (unregistration_trigger == UNREGISTRATION_TRIGGER_INSTANCE_USED_FOR_REGISTRATION) {
+               ret = lttng_unregister_trigger(trigger);
+               ok(ret == 0, "Successfully unregistered automatic trigger using the trigger instance used on registration");
+       }
+
+end:
+       lttng_triggers_destroy(triggers);
+       lttng_trigger_destroy(trigger);
+}
+
+static
+void double_register_anonymous_trigger(
+               enum unregistration_trigger_instance unregistration_trigger)
+{
+       int ret;
+       struct lttng_trigger *trigger = create_trigger(0xbadc0ffee);
+       struct lttng_triggers *triggers = NULL;
+
+       diag("Register duplicate anonymous trigger (Unregistration performed with the trigger instance %s)",
+                       unregistration_trigger_instance_name(
+                                       unregistration_trigger));
+
+       if (!trigger) {
+               fail("Failed to create trigger");
+               goto end;
+       }
+
+       ret = lttng_register_trigger(trigger);
+       ok(ret == 0, "Registered anonymous trigger");
+
+       ret = lttng_register_trigger(trigger);
+       ok(ret == -LTTNG_ERR_TRIGGER_EXISTS,
+                       "Registering identical anonymous trigger fails with `LTTNG_ERR_TRIGGER_EXISTS`");
+
+
+       if (unregistration_trigger == UNREGISTRATION_TRIGGER_INSTANCE_USED_FOR_REGISTRATION) {
+               ret = lttng_unregister_trigger(trigger);
+               ok(ret == 0, "Successfully unregistered anonymous trigger using the trigger instance used on registration");
+       } else {
+               ok(get_registered_triggers_count() == 1,
+                               "Trigger listing returns 1 trigger");
+               ok(unregister_all_triggers() == 1,
+                               "Successfully unregistered anonymous trigger using the trigger instance returned by the listing");
+       }
+
+end:
+       lttng_triggers_destroy(triggers);
+       lttng_trigger_destroy(trigger);
+}
+
+static
+void double_register_named_trigger(
+               enum unregistration_trigger_instance unregistration_trigger)
+{
+       int ret;
+       struct lttng_trigger *trigger_a = create_trigger(0xbadc0ffee);
+       struct lttng_trigger *trigger_b = create_trigger(0xbadc0ffee);
+       struct lttng_triggers *triggers = NULL;
+       const char * const trigger_name = "a unique trigger name";
+       enum lttng_error_code ret_code;
+
+       diag("Register duplicate named trigger (Unregistration performed with the trigger instance %s)",
+                       unregistration_trigger_instance_name(
+                                       unregistration_trigger));
+
+       if (!trigger_a || !trigger_b) {
+               fail("Failed to create triggers");
+               goto end;
+       }
+
+       ret_code = lttng_register_trigger_with_name(trigger_a, trigger_name);
+       ok(ret_code == LTTNG_OK, "Registered named trigger");
+
+       ret = lttng_register_trigger(trigger_a);
+       ok(ret == -LTTNG_ERR_INVALID,
+                       "Registering a trigger instance already used for registration fails with `LTTNG_ERR_INVALID` (anonymous registration)");
+
+       ret_code = lttng_register_trigger_with_name(trigger_a, trigger_name);
+       ok(ret_code == LTTNG_ERR_INVALID,
+                       "Registering a trigger instance already used for registration fails with `LTTNG_ERR_INVALID` (register with name)");
+
+       ret_code = lttng_register_trigger_with_automatic_name(trigger_a);
+       ok(ret_code == LTTNG_ERR_INVALID,
+                       "Registering a trigger instance already used for registration fails with `LTTNG_ERR_INVALID` (register with automatic name)");
+
+       ret_code = lttng_register_trigger_with_name(trigger_b, trigger_name);
+       ok(ret_code == LTTNG_ERR_TRIGGER_EXISTS, "Registering trigger with an already used name fails with `LTTNG_ERR_TRIGGER_EXISTS`");
+
+       if (unregistration_trigger == UNREGISTRATION_TRIGGER_INSTANCE_USED_FOR_REGISTRATION) {
+               ret = lttng_unregister_trigger(trigger_a);
+               ok(ret == 0, "Successfully unregistered named trigger using the trigger instance used on registration");
+       } else {
+               ok(get_registered_triggers_count() == 1,
+                               "Trigger listing returns 1 trigger");
+               ok(unregister_all_triggers() == 1,
+                               "Successfully unregistered named trigger using the trigger instance returned by the listing");
+       }
+
+end:
+       lttng_triggers_destroy(triggers);
+       lttng_trigger_destroy(trigger_a);
+       lttng_trigger_destroy(trigger_b);
+}
+
+static
+void double_register_automatic_name_trigger(
+               enum unregistration_trigger_instance unregistration_trigger)
+{
+       int ret;
+       struct lttng_trigger *trigger_a = create_trigger(0xbadc0ffee);
+       struct lttng_trigger *trigger_b = create_trigger(0xbadc0ffee);
+       struct lttng_triggers *triggers = NULL;
+       enum lttng_error_code ret_code;
+
+       diag("Register duplicate automatic name trigger (Unregistration performed with the trigger instance %s)",
+                       unregistration_trigger_instance_name(
+                                       unregistration_trigger));
+
+       if (!trigger_a || !trigger_b) {
+               fail("Failed to create triggers");
+               goto end;
+       }
+
+       ret_code = lttng_register_trigger_with_automatic_name(trigger_a);
+       ok(ret_code == LTTNG_OK, "Registered automatic name trigger: trigger name = '%s'", get_trigger_name(trigger_a));
+
+       ret = lttng_register_trigger_with_automatic_name(trigger_b);
+       ok(ret_code == LTTNG_OK, "Registering an identical trigger instance with an automatic name succeeds: trigger name = '%s'", get_trigger_name(trigger_b));
+
+       ok(strcmp(get_trigger_name(trigger_a), get_trigger_name(trigger_b)),
+                       "Two identical triggers registered with an automatic name have different names");
+
+       if (unregistration_trigger == UNREGISTRATION_TRIGGER_INSTANCE_USED_FOR_REGISTRATION) {
+               ret = lttng_unregister_trigger(trigger_a);
+               ok(ret == 0, "Successfully unregistered automatic trigger A using the trigger instance used on registration");
+
+               ret = lttng_unregister_trigger(trigger_b);
+               ok(ret == 0, "Successfully unregistered automatic trigger B using the trigger instance used on registration");
+       } else {
+               ok(get_registered_triggers_count() == 2,
+                               "Trigger listing returns 2 trigger");
+               ok(unregister_all_triggers() == 2,
+                               "Successfully unregistered automatic name triggers using the trigger instance returned by the listing");
+       }
+
+end:
+       lttng_triggers_destroy(triggers);
+       lttng_trigger_destroy(trigger_a);
+       lttng_trigger_destroy(trigger_b);
+}
+
+static
+void register_multiple_anonymous_triggers(void)
+{
+       int ret;
+       struct lttng_trigger *trigger_a = create_trigger(0xbadc0ffee);
+       struct lttng_trigger *trigger_b = create_trigger(0xbadf00d);
+
+       diag("Register two different anonymous triggers");
+
+       if (!trigger_a || !trigger_b) {
+               fail("Failed to create triggers");
+               goto end;
+       }
+
+       ret = lttng_register_trigger(trigger_a);
+       ok(ret == 0, "Registered first anonymous trigger");
+
+       ret = lttng_register_trigger(trigger_b);
+       ok(ret == 0, "Registered second anonymous trigger");
+
+       ok(get_registered_triggers_count() == 2,
+                       "Trigger listing returns 2 trigger");
+       ok(unregister_all_triggers() == 2,
+                       "Successfully unregistered two anonymous triggers");
+
+end:
+       lttng_trigger_destroy(trigger_a);
+       lttng_trigger_destroy(trigger_b);
+}
+
+const test_function test_functions[] = {
+       register_anonymous_trigger,
+       register_named_trigger,
+       register_automatic_name_trigger,
+       double_register_anonymous_trigger,
+       double_register_named_trigger,
+       double_register_automatic_name_trigger,
+};
+
+int main(int argc, const char **argv)
+{
+       size_t i;
+
+       plan_tests(TEST_COUNT);
+
+       if (get_registered_triggers_count() != 0) {
+               fail("Session daemon already has registered triggers, bailing out");
+               goto end;
+       }
+
+       for (i = 0; i < ARRAY_SIZE(test_functions); i++) {
+               const test_function fn = test_functions[i];
+
+               fn(UNREGISTRATION_TRIGGER_INSTANCE_FROM_LISTING);
+               if (get_registered_triggers_count() != 0) {
+                       fail("Previous test left registered triggers, bailing out");
+                       goto end;
+               }
+       }
+
+       for (i = 0; i < ARRAY_SIZE(test_functions); i++) {
+               const test_function fn = test_functions[i];
+
+               fn(UNREGISTRATION_TRIGGER_INSTANCE_USED_FOR_REGISTRATION);
+               if (get_registered_triggers_count() != 0) {
+                       fail("Previous test left registered triggers, bailing out");
+                       goto end;
+               }
+       }
+
+       register_multiple_anonymous_triggers();
+end:
+       return exit_status();
+}
This page took 0.031191 seconds and 4 git commands to generate.