.gitignore: add some more IDE / tools related file
[babeltrace.git] / include / babeltrace2 / trace-ir / clock-class.h
index 4fbbf53310a50693fc65d2b8053b04cb29240896..a54e8b8986ec35d8c81efc551762ba67c14b8c32 100644 (file)
@@ -1,28 +1,14 @@
-#ifndef BABELTRACE2_TRACE_IR_CLOCK_CLASS_H
-#define BABELTRACE2_TRACE_IR_CLOCK_CLASS_H
-
 /*
- * Copyright (c) 2010-2019 EfficiOS Inc. and Linux Foundation
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
+ * SPDX-License-Identifier: MIT
  *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
+ * Copyright (C) 2010-2019 EfficiOS Inc. and Linux Foundation
  */
 
+#ifndef BABELTRACE2_TRACE_IR_CLOCK_CLASS_H
+#define BABELTRACE2_TRACE_IR_CLOCK_CLASS_H
+
+/* IWYU pragma: private, include <babeltrace2/babeltrace.h> */
+
 #ifndef __BT_IN_BABELTRACE_H
 # error "Please include <babeltrace2/babeltrace.h> instead."
 #endif
@@ -70,7 +56,7 @@ In the illustration above, notice that:
   stream's default clock.
 
   In other words, a default clock snapshot contains the value of the
-  stream's default clock when this message occured.
+  stream's default clock when this message occurred.
 
 The default clock class property of a \bt_stream_cls is optional:
 if a stream class has no default clock class, then its instances
@@ -163,12 +149,12 @@ The clock class's "offset in seconds" property can be negative.
 For example, considering:
 
 - Frequency: 1000&nbsp;Hz.
-- Offset in seconds: -10&nbsp;seconds.
+- Offset in seconds: 10&nbsp;seconds.
 - Offset in cycles: 500&nbsp;cycles (that is, 0.5&nbsp;seconds).
 - Stream clock's value: 2000&nbsp;cycles (that is, 2&nbsp;seconds).
 
-Then the computed value is -7.5&nbsp;seconds from origin, or
--7,500,000,000&nbsp;nanoseconds from origin.
+Then the computed value is 7.5&nbsp;seconds from origin, or
+7,500,000,000&nbsp;nanoseconds from origin.
 
 <h1>Properties</h1>
 
@@ -340,7 +326,8 @@ On success, the returned clock class has the following property values:
 
 @bt_pre_not_null{self_component}
 */
-extern bt_clock_class *bt_clock_class_create(bt_self_component *self_component);
+extern bt_clock_class *bt_clock_class_create(bt_self_component *self_component)
+               __BT_NOEXCEPT;
 
 /*! @} */
 
@@ -375,7 +362,7 @@ See the \ref api-tir-clock-cls-prop-freq "frequency" property.
     Returns the frequency of a clock class.
 */
 extern void bt_clock_class_set_frequency(bt_clock_class *clock_class,
-               uint64_t frequency);
+               uint64_t frequency) __BT_NOEXCEPT;
 
 /*!
 @brief
@@ -395,7 +382,7 @@ See the \ref api-tir-clock-cls-prop-freq "frequency" property.
     Sets the frequency of a clock class.
 */
 extern uint64_t bt_clock_class_get_frequency(
-               const bt_clock_class *clock_class);
+               const bt_clock_class *clock_class) __BT_NOEXCEPT;
 
 /*!
 @brief
@@ -423,7 +410,7 @@ See the \ref api-tir-clock-cls-prop-offset "offset" property.
     Returns the offset of a clock class.
 */
 extern void bt_clock_class_set_offset(bt_clock_class *clock_class,
-               int64_t offset_seconds, uint64_t offset_cycles);
+               int64_t offset_seconds, uint64_t offset_cycles) __BT_NOEXCEPT;
 
 /*!
 @brief
@@ -450,7 +437,7 @@ See the \ref api-tir-clock-cls-prop-offset "offset" property.
     Sets the offset of a clock class.
 */
 extern void bt_clock_class_get_offset(const bt_clock_class *clock_class,
-               int64_t *offset_seconds, uint64_t *offset_cycles);
+               int64_t *offset_seconds, uint64_t *offset_cycles) __BT_NOEXCEPT;
 
 /*!
 @brief
@@ -471,7 +458,7 @@ See the \ref api-tir-clock-cls-prop-precision "precision" property.
     Returns the precision of a clock class.
 */
 extern void bt_clock_class_set_precision(bt_clock_class *clock_class,
-               uint64_t precision);
+               uint64_t precision) __BT_NOEXCEPT;
 
 /*!
 @brief
@@ -492,7 +479,7 @@ See the \ref api-tir-clock-cls-prop-precision "precision" property.
     Sets the precision of a clock class.
 */
 extern uint64_t bt_clock_class_get_precision(
-               const bt_clock_class *clock_class);
+               const bt_clock_class *clock_class) __BT_NOEXCEPT;
 
 /*!
 @brief
@@ -517,7 +504,7 @@ property.
     Unix epoch.
 */
 extern void bt_clock_class_set_origin_is_unix_epoch(bt_clock_class *clock_class,
-               bt_bool origin_is_unix_epoch);
+               bt_bool origin_is_unix_epoch) __BT_NOEXCEPT;
 
 /*!
 @brief
@@ -541,7 +528,7 @@ property.
     Sets whether or not the origin of a clock class is the Unix epoch.
 */
 extern bt_bool bt_clock_class_origin_is_unix_epoch(
-               const bt_clock_class *clock_class);
+               const bt_clock_class *clock_class) __BT_NOEXCEPT;
 
 /*!
 @brief
@@ -586,7 +573,7 @@ See the \ref api-tir-clock-cls-prop-name "name" property.
     Returns the name of a clock class.
 */
 extern bt_clock_class_set_name_status bt_clock_class_set_name(
-               bt_clock_class *clock_class, const char *name);
+               bt_clock_class *clock_class, const char *name) __BT_NOEXCEPT;
 
 /*!
 @brief
@@ -613,7 +600,7 @@ If \bt_p{clock_class} has no name, this function returns \c NULL.
     Sets the name of a clock class.
 */
 extern const char *bt_clock_class_get_name(
-               const bt_clock_class *clock_class);
+               const bt_clock_class *clock_class) __BT_NOEXCEPT;
 
 /*!
 @brief
@@ -658,7 +645,8 @@ See the \ref api-tir-clock-cls-prop-descr "description" property.
     Returns the description of a clock class.
 */
 extern bt_clock_class_set_description_status bt_clock_class_set_description(
-               bt_clock_class *clock_class, const char *description);
+               bt_clock_class *clock_class, const char *description)
+               __BT_NOEXCEPT;
 
 /*!
 @brief
@@ -685,7 +673,7 @@ If \bt_p{clock_class} has no description, this function returns \c NULL.
     Sets the description of a clock class.
 */
 extern const char *bt_clock_class_get_description(
-               const bt_clock_class *clock_class);
+               const bt_clock_class *clock_class) __BT_NOEXCEPT;
 
 /*!
 @brief
@@ -708,7 +696,7 @@ See the \ref api-tir-clock-cls-prop-uuid "UUID" property.
     Returns the UUID of a clock class.
 */
 extern void bt_clock_class_set_uuid(bt_clock_class *clock_class,
-               bt_uuid uuid);
+               bt_uuid uuid) __BT_NOEXCEPT;
 
 /*!
 @brief
@@ -735,7 +723,7 @@ If \bt_p{clock_class} has no UUID, this function returns \c NULL.
     Sets the UUID of a clock class.
 */
 extern bt_uuid bt_clock_class_get_uuid(
-               const bt_clock_class *clock_class);
+               const bt_clock_class *clock_class) __BT_NOEXCEPT;
 
 /*!
 @brief
@@ -767,7 +755,8 @@ property.
     Borrows the user attributes of a clock class.
 */
 extern void bt_clock_class_set_user_attributes(
-               bt_clock_class *clock_class, const bt_value *user_attributes);
+               bt_clock_class *clock_class, const bt_value *user_attributes)
+               __BT_NOEXCEPT;
 
 /*!
 @brief
@@ -794,7 +783,7 @@ property.
     \c const version of this function.
 */
 extern bt_value *bt_clock_class_borrow_user_attributes(
-               bt_clock_class *clock_class);
+               bt_clock_class *clock_class) __BT_NOEXCEPT;
 
 /*!
 @brief
@@ -804,7 +793,7 @@ extern bt_value *bt_clock_class_borrow_user_attributes(
 See bt_clock_class_borrow_user_attributes().
 */
 extern const bt_value *bt_clock_class_borrow_user_attributes_const(
-               const bt_clock_class *clock_class);
+               const bt_clock_class *clock_class) __BT_NOEXCEPT;
 
 /*! @} */
 
@@ -884,7 +873,7 @@ code if any step of the computation process causes an integer overflow.
 extern bt_clock_class_cycles_to_ns_from_origin_status
 bt_clock_class_cycles_to_ns_from_origin(
                const bt_clock_class *clock_class,
-               uint64_t value, int64_t *ns_from_origin);
+               uint64_t value, int64_t *ns_from_origin) __BT_NOEXCEPT;
 
 /*! @} */
 
@@ -908,7 +897,8 @@ bt_clock_class_cycles_to_ns_from_origin(
 @sa bt_clock_class_put_ref() &mdash;
     Decrements the reference count of a clock class.
 */
-extern void bt_clock_class_get_ref(const bt_clock_class *clock_class);
+extern void bt_clock_class_get_ref(
+               const bt_clock_class *clock_class) __BT_NOEXCEPT;
 
 /*!
 @brief
@@ -925,7 +915,8 @@ extern void bt_clock_class_get_ref(const bt_clock_class *clock_class);
 @sa bt_clock_class_get_ref() &mdash;
     Increments the reference count of a clock class.
 */
-extern void bt_clock_class_put_ref(const bt_clock_class *clock_class);
+extern void bt_clock_class_put_ref(
+               const bt_clock_class *clock_class) __BT_NOEXCEPT;
 
 /*!
 @brief
This page took 0.028251 seconds and 4 git commands to generate.