all lists on lists.proxmox.com
 help / color / mirror / Atom feed
* [pve-devel] [PATCH mini-journalreader 1/2] fix #6410: properly close json output on error
@ 2025-06-02 14:24 Dominik Csapak
  2025-06-02 14:24 ` [pve-devel] [RFC PATCH mini-journalreader 2/2] include error in json output Dominik Csapak
  2025-06-02 14:32 ` [pve-devel] [PATCH mini-journalreader 1/2] fix #6410: properly close json output on error Dominik Csapak
  0 siblings, 2 replies; 3+ messages in thread
From: Dominik Csapak @ 2025-06-02 14:24 UTC (permalink / raw)
  To: pve-devel

when encountering an error (e.g. there was no curser at the wanted
position), the program would close with exitcode 1, but would not
properly finish the json output if in json mode.

To fix that, introduce a `print_error_and_exit` helper that tries to
finish the json output. We set `success` to 0 to indicate an error.

Ideally we would insert the error message into the json output, but
since that can be anything, and json expects utf8 and properly escaped
strings we'd either have to do a lot of things manually here, or use a
json library for escaping. So for now simply don't write the error in
the output.

Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>
---
 src/mini-journalreader.c | 32 ++++++++++++++++++++++----------
 1 file changed, 22 insertions(+), 10 deletions(-)

diff --git a/src/mini-journalreader.c b/src/mini-journalreader.c
index 98bcaac..d934d43 100644
--- a/src/mini-journalreader.c
+++ b/src/mini-journalreader.c
@@ -30,6 +30,21 @@ static char BUF[BUFSIZE];
 bool json = false;
 bool first_line = true;
 
+// helper to print errors on stderr
+// if we're in json mode, print closing json body if possible
+static void print_error_and_exit(const char *fmt, ...) {
+    va_list args;
+    fprintf(stderr, fmt, args);
+    if (json) {
+        size_t r = fwrite_unlocked("],\"success\":0}", 1, 14, stdout);
+        if (r < 14) {
+            fprintf(stderr, "Failed to write closing json\n");
+        }
+        fflush_unlocked(stdout);
+    }
+    exit(1);
+}
+
 static uint64_t get_timestamp(sd_journal *j) {
     uint64_t timestamp;
     int r = sd_journal_get_realtime_usec(j, &timestamp);
@@ -47,6 +62,7 @@ static void print_to_buf(const char * string, size_t length) {
 
     size_t r = fwrite_unlocked(string, 1, length, stdout);
     if (r < length) {
+        // don't use error helper here as we can't write to stdout anyway
         fprintf(stderr, "Failed to write\n");
         exit(1);
     }
@@ -57,8 +73,7 @@ static void print_cursor(sd_journal *j) {
     char *cursor = NULL;
     r = sd_journal_get_cursor(j, &cursor);
     if (r < 0) {
-        fprintf(stderr, "Failed to get cursor: %s\n", strerror(-r));
-        exit(1);
+        print_error_and_exit("Failed to get cursor: %s\n", strerror(-r));
     }
     if (json) {
         if (!first_line) {
@@ -242,6 +257,7 @@ static uint64_t arg_to_uint64(const char *argument) {
     uint64_t value = strtoull(argument, &end, 10);
     if (errno != 0 || *end != '\0') {
         fprintf(stderr, "%s is not a valid integer number\n", argument);
+        // don't use error helper here, as we did not start outputting json yet
         exit(1);
     }
 
@@ -348,15 +364,13 @@ int main(int argc, char *argv[]) {
         }
 
         if (r < 0) {
-            fprintf(stderr, "Failed to seek to end/cursor: %s\n", strerror(-r));
-            exit(1);
+            print_error_and_exit( "Failed to seek to end/cursor: %s\n", strerror(-r));
         }
 
         // seek back number entries and print cursor
         r = sd_journal_previous_skip(j, number + 1);
         if (r < 0) {
-            fprintf(stderr, "Failed to seek back: %s\n", strerror(-r));
-            exit(1);
+            print_error_and_exit("Failed to seek back: %s\n", strerror(-r));
         }
     } else {
         if (begin) {
@@ -368,16 +382,14 @@ int main(int argc, char *argv[]) {
         }
 
         if (r < 0) {
-            fprintf(stderr, "Failed to seek to begin/cursor: %s\n", strerror(-r));
-            exit(1);
+            print_error_and_exit("Failed to seek to begin/cursor: %s\n", strerror(-r));
         }
 
         // if we have a start cursor, we want to skip the first entry
         if (startcursor) {
             r = sd_journal_next(j);
             if (r < 0) {
-                fprintf(stderr, "Failed to seek to begin/cursor: %s\n", strerror(-r));
-                exit(1);
+                print_error_and_exit("Failed to seek to begin/cursor: %s\n", strerror(-r));
             }
             print_first_cursor(j);
         }
-- 
2.39.5



_______________________________________________
pve-devel mailing list
pve-devel@lists.proxmox.com
https://lists.proxmox.com/cgi-bin/mailman/listinfo/pve-devel


^ permalink raw reply	[flat|nested] 3+ messages in thread

* [pve-devel] [RFC PATCH mini-journalreader 2/2] include error in json output
  2025-06-02 14:24 [pve-devel] [PATCH mini-journalreader 1/2] fix #6410: properly close json output on error Dominik Csapak
@ 2025-06-02 14:24 ` Dominik Csapak
  2025-06-02 14:32 ` [pve-devel] [PATCH mini-journalreader 1/2] fix #6410: properly close json output on error Dominik Csapak
  1 sibling, 0 replies; 3+ messages in thread
From: Dominik Csapak @ 2025-06-02 14:24 UTC (permalink / raw)
  To: pve-devel

by using json-c and printing the string into a variable via `vasprintf`.
we use a json library to correctly escape and format the error string we
get, since we cannot be sure about the content.

Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>
---
not sure if it's worth to include json-c here just for the error message...

 debian/control           |  2 +-
 src/Makefile             |  2 +-
 src/mini-journalreader.c | 33 +++++++++++++++++++++++++++------
 3 files changed, 29 insertions(+), 8 deletions(-)

diff --git a/debian/control b/debian/control
index 8280f6d..d03772e 100644
--- a/debian/control
+++ b/debian/control
@@ -2,7 +2,7 @@ Source: proxmox-mini-journalreader
 Section: admin
 Priority: optional
 Maintainer: Proxmox Support Team <support@proxmox.com>
-Build-Depends: debhelper-compat (= 13), libsystemd-dev, pkg-config, scdoc,
+Build-Depends: debhelper-compat (= 13), libsystemd-dev, pkg-config, scdoc, libjson-c-dev
 Standards-Version: 4.6.2
 
 Package: proxmox-mini-journalreader
diff --git a/src/Makefile b/src/Makefile
index 449004f..adb2782 100644
--- a/src/Makefile
+++ b/src/Makefile
@@ -4,7 +4,7 @@ SOURCES=mini-journalreader.c
 BIN_DIR ?= $(DESTDIR)/usr/bin
 MAN1_DIR ?= $(DESTDIR)/usr/share/man/man1
 
-LIBS := libsystemd
+LIBS := libsystemd json-c
 CFLAGS += -Werror -Wall -Wextra -Wl,-z,relro -g -O2 --std=gnu11
 CFLAGS += -fstack-protector-strong -D_FORTIFY_SOURCE=2
 CFLAGS += $(shell pkg-config --cflags $(LIBS))
diff --git a/src/mini-journalreader.c b/src/mini-journalreader.c
index d934d43..62d8850 100644
--- a/src/mini-journalreader.c
+++ b/src/mini-journalreader.c
@@ -15,6 +15,10 @@
  * If not, see <https://www.gnu.org/licenses/>.
  */
 
+#ifndef _GNU_SOURCE
+#define _GNU_SOURCE
+#endif
+
 #include <errno.h>
 #include <stdbool.h>
 #include <stdio.h>
@@ -23,6 +27,7 @@
 #include <systemd/sd-journal.h>
 #include <time.h>
 #include <unistd.h>
+#include <json.h>
 
 #define BUFSIZE 4096
 
@@ -33,15 +38,31 @@ bool first_line = true;
 // helper to print errors on stderr
 // if we're in json mode, print closing json body if possible
 static void print_error_and_exit(const char *fmt, ...) {
+    fflush_unlocked(stdout);
+
     va_list args;
-    fprintf(stderr, fmt, args);
-    if (json) {
-        size_t r = fwrite_unlocked("],\"success\":0}", 1, 14, stdout);
-        if (r < 14) {
-            fprintf(stderr, "Failed to write closing json\n");
+    char *message;
+    va_start(args, fmt);
+    int r = vasprintf(&message, fmt, args);
+    if (r < 0) {
+        // could not allocate the string, so write it directly and don't
+        // include the error in the json output
+        fprintf(stderr, fmt, args);
+        if (json) {
+            fprintf(stdout, "],\"success\":0}");
         }
-        fflush_unlocked(stdout);
+        exit(1);
+    }
+    fprintf(stderr, "%s", message);
+    va_end(args);
+
+    if (json) {
+        struct json_object *obj = json_object_new_string(message);
+        const char *json_message = json_object_to_json_string(obj);
+        fprintf(stdout, "], \"error\":%s,\"success\":0}", json_message);
+        json_object_put(obj);
     }
+    free(message);
     exit(1);
 }
 
-- 
2.39.5



_______________________________________________
pve-devel mailing list
pve-devel@lists.proxmox.com
https://lists.proxmox.com/cgi-bin/mailman/listinfo/pve-devel


^ permalink raw reply	[flat|nested] 3+ messages in thread

* Re: [pve-devel] [PATCH mini-journalreader 1/2] fix #6410: properly close json output on error
  2025-06-02 14:24 [pve-devel] [PATCH mini-journalreader 1/2] fix #6410: properly close json output on error Dominik Csapak
  2025-06-02 14:24 ` [pve-devel] [RFC PATCH mini-journalreader 2/2] include error in json output Dominik Csapak
@ 2025-06-02 14:32 ` Dominik Csapak
  1 sibling, 0 replies; 3+ messages in thread
From: Dominik Csapak @ 2025-06-02 14:32 UTC (permalink / raw)
  To: pve-devel

superseeded by v2, i forgot to include some changes in v1:

https://lore.proxmox.com/pve-devel/20250602143050.3732346-1-d.csapak@proxmox.com/


_______________________________________________
pve-devel mailing list
pve-devel@lists.proxmox.com
https://lists.proxmox.com/cgi-bin/mailman/listinfo/pve-devel


^ permalink raw reply	[flat|nested] 3+ messages in thread

end of thread, other threads:[~2025-06-02 14:31 UTC | newest]

Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2025-06-02 14:24 [pve-devel] [PATCH mini-journalreader 1/2] fix #6410: properly close json output on error Dominik Csapak
2025-06-02 14:24 ` [pve-devel] [RFC PATCH mini-journalreader 2/2] include error in json output Dominik Csapak
2025-06-02 14:32 ` [pve-devel] [PATCH mini-journalreader 1/2] fix #6410: properly close json output on error Dominik Csapak

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.
Service provided by Proxmox Server Solutions GmbH | Privacy | Legal