From: Yu Watanabe <watanabe.yu+github@gmail.com>
Date: Sat, 4 Jan 2025 12:51:09 +0000 (+0900)
Subject: varlink: add comments for io.systemd.service interface
X-Git-Tag: v258-rc1~1714
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=8252b74f2dda823ac8d4ff9e9b49f9c981136375;p=thirdparty%2Fsystemd.git

varlink: add comments for io.systemd.service interface
---

diff --git a/src/shared/varlink-io.systemd.service.c b/src/shared/varlink-io.systemd.service.c
index 06e32f9bf61..f34d5cfead6 100644
--- a/src/shared/varlink-io.systemd.service.c
+++ b/src/shared/varlink-io.systemd.service.c
@@ -11,13 +11,18 @@ static SD_VARLINK_DEFINE_METHOD(Reload);
 
 static SD_VARLINK_DEFINE_METHOD(
                 SetLogLevel,
+                SD_VARLINK_FIELD_COMMENT("The maximum log level."),
                 SD_VARLINK_DEFINE_INPUT(level, SD_VARLINK_INT, 0));
 
 SD_VARLINK_DEFINE_INTERFACE(
                 io_systemd_service,
                 "io.systemd.service",
+                SD_VARLINK_INTERFACE_COMMENT("An interface to control basic properties of systemd services."),
+                SD_VARLINK_SYMBOL_COMMENT("Checks if the service is running."),
                 &vl_method_Ping,
+                SD_VARLINK_SYMBOL_COMMENT("Reloads configurations."),
                 &vl_method_Reload,
+                SD_VARLINK_SYMBOL_COMMENT("Sets the maximum log level."),
                 &vl_method_SetLogLevel);
 
 int varlink_method_ping(sd_varlink *link, sd_json_variant *parameters, sd_varlink_method_flags_t flags, void *userdata) {