git: 13cf806828e2 - stable/14 - atf-c(3): fill in prototypes for functions

The branch stable/14 has been updated by des:

URL: https://cgit.FreeBSD.org/src/commit/?id=13cf806828e27753c76479337ef138762ae8ae89

commit 13cf806828e27753c76479337ef138762ae8ae89
Author:     Enji Cooper <ngie@FreeBSD.org>
AuthorDate: 2025-06-07 03:13:31 +0000
Commit:     Dag-Erling Smørgrav <des@FreeBSD.org>
CommitDate: 2025-09-23 12:57:35 +0000

    atf-c(3): fill in prototypes for functions
    
    This change fills in prototypes for functions exposed by atf-c(3) to aid
    the programmer with using the APIs with the library.
    
    MFC after:      2 weeks
    Differential Revision: https://reviews.freebsd.org/D50734
    
    (cherry picked from commit a14573de29deda5b86b4458901aa5a0a9bf84375)
---
 contrib/atf/atf-c/atf-c.3 | 111 ++++++++++++++++++++++++++++++++++++++--------
 1 file changed, 92 insertions(+), 19 deletions(-)

diff --git a/contrib/atf/atf-c/atf-c.3 b/contrib/atf/atf-c/atf-c.3
index 6369cb5697f8..287ebd41a033 100644
--- a/contrib/atf/atf-c/atf-c.3
+++ b/contrib/atf/atf-c/atf-c.3
@@ -131,25 +131,98 @@
 .Fn ATF_TC_WITHOUT_HEAD "name"
 .Fn ATF_TP_ADD_TC "tp_name" "tc_name"
 .Fn ATF_TP_ADD_TCS "tp_name"
-.Fn atf_tc_get_config_var "tc" "varname"
-.Fn atf_tc_get_config_var_wd "tc" "variable_name" "default_value"
-.Fn atf_tc_get_config_var_as_bool "tc" "variable_name"
-.Fn atf_tc_get_config_var_as_bool_wd "tc" "variable_name" "default_value"
-.Fn atf_tc_get_config_var_as_long "tc" "variable_name"
-.Fn atf_tc_get_config_var_as_long_wd "tc" "variable_name" "default_value"
-.Fn atf_no_error
-.Fn atf_tc_expect_death "reason" "..."
-.Fn atf_tc_expect_exit "exitcode" "reason" "..."
-.Fn atf_tc_expect_fail "reason" "..."
-.Fn atf_tc_expect_pass
-.Fn atf_tc_expect_signal "signo" "reason" "..."
-.Fn atf_tc_expect_timeout "reason" "..."
-.Fn atf_tc_fail "reason"
-.Fn atf_tc_fail_nonfatal "reason"
-.Fn atf_tc_pass
-.Fn atf_tc_require_kmod "kmod"
-.Fn atf_tc_require_prog "prog"
-.Fn atf_tc_skip "reason"
+.Ft const char*
+.Fo atf_tc_get_config_var
+.Fa "const atf_tc_t *tc"
+.Fa "const char *name"
+.Fc
+.Ft const char*
+.Fo atf_tc_get_config_var_wd
+.Fa "const atf_tc_t *tc"
+.Fa "const char *name"
+.Fa "const char *defval"
+.Fc
+.Ft bool
+.Fo atf_tc_get_config_var_as_bool
+.Fa "const atf_tc_t *tc"
+.Fa "const char *name"
+.Fc
+.Ft bool
+.Fo atf_tc_get_config_var_as_bool_wd
+.Fa "const atf_tc_t *tc"
+.Fa "const char *name"
+.Fa "const bool defval"
+.Fc
+.Ft long
+.Fo atf_tc_get_config_var_as_long
+.Fa "const atf_tc_t *tc"
+.Fa "const char *name"
+.Fc
+.Ft long
+.Fo atf_tc_get_config_var_as_long_wd
+.Fa "const atf_tc_t *tc"
+.Fa "const char *name"
+.Fa "const long defval"
+.Fc
+.Ft void
+.Fo atf_no_error
+.Fa "void"
+.Fc
+.Ft void
+.Fo atf_tc_expect_death
+.Fa "const char *reason"
+.Fa "..."
+.Fc
+.Ft void
+.Fo atf_tc_expect_exit
+.Fa "const int exitcode"
+.Fa "const char *reason"
+.Fa "..."
+.Fc
+.Ft void
+.Fo atf_tc_expect_fail
+.Fa "const char *reason"
+.Fa "..."
+.Fc
+.Ft void
+.Fo atf_tc_expect_pass
+.Fa "void"
+.Fc
+.Ft void
+.Fo atf_tc_expect_signal
+.Fa "const int signo"
+.Fa "const char *reason"
+.Fa "..."
+.Fc
+.Ft void
+.Fo atf_tc_expect_timeout
+.Fa "const char *reason"
+.Fa "..."
+.Fc
+.Ft void
+.Fo atf_tc_fail
+.Fa "const char *reason"
+.Fc
+.Ft void
+.Fo atf_tc_fail_nonfatal
+.Fa "const char *reason"
+.Fc
+.Ft void
+.Fo atf_tc_pass
+.Fa "void"
+.Fc
+.Ft void
+.Fo atf_tc_require_kmod
+.Fa "const char *kmod"
+.Fc
+.Ft void
+.Fo atf_tc_require_prog
+.Fa "const char *prog"
+.Fc
+.Ft void
+.Fo atf_tc_skip
+.Fa "const char *reason"
+.Fc
 .Ft void
 .Fo atf_utils_cat_file
 .Fa "const char *file"