journald: document Varlink interface

diff --git a/TODO b/TODO
index e4597084ea4bdb7920242c1dfc5f58ed3357f388..325a96333c35fd339e622a3061bd21d6858c891f 100644 (file)
--- a/TODO
+++ b/TODO
@@ -167,7 +167,6 @@ Features:
 * complete varlink introspection comments:
   - io.systemd.BootControl
   - io.systemd.Hostname
-  - io.systemd.Journal
   - io.systemd.ManagedOOM
   - io.systemd.Network
   - io.systemd.PCRExtend

diff --git a/src/shared/varlink-io.systemd.Journal.c b/src/shared/varlink-io.systemd.Journal.c
index 66514a9d572c632d0dfff1eccda7f7f518473ae0..ddc36370860ec03c868310715c9977f01287be82 100644 (file)
--- a/src/shared/varlink-io.systemd.Journal.c
+++ b/src/shared/varlink-io.systemd.Journal.c
@@ -12,8 +12,14 @@ static SD_VARLINK_DEFINE_ERROR(NotSupportedByNamespaces);
 SD_VARLINK_DEFINE_INTERFACE(
                 io_systemd_Journal,
                 "io.systemd.Journal",
+                SD_VARLINK_INTERFACE_COMMENT("Journal control APIs"),
+                SD_VARLINK_SYMBOL_COMMENT("Write out all pending log messages out to disk, and reply only after that's complete."),
                 &vl_method_Synchronize,
+                SD_VARLINK_SYMBOL_COMMENT("Rotate journal files, i.e. close existing files, start new ones."),
                 &vl_method_Rotate,
+                SD_VARLINK_SYMBOL_COMMENT("Flush runtime logs to persistent logs, i.e. flush log data from /run/ into /var/, and continue writing future log data to the latter location."),
                 &vl_method_FlushToVar,
+                SD_VARLINK_SYMBOL_COMMENT("Relinquish use of /var/ again, return to do runtime logging into /run/ only."),
                 &vl_method_RelinquishVar,
+                SD_VARLINK_SYMBOL_COMMENT("Journal service running as per-namespace instance, and requested operation is not supported for namespaced journal."),
                 &vl_error_NotSupportedByNamespaces);