Add process::print()

1 files changed, 14 insertions, 1 deletions

diff --git a/butl/process b/butl/process
index 96b161f..e1eea29 100644
--- a/butl/process
+++ b/butl/process
@@ -9,8 +9,9 @@
 #  include <sys/types.h> // pid_t
 #endif
 
+#include <iosfwd>
 #include <cassert>
-#include <cstdint> // uint32_t
+#include <cstdint>      // uint32_t
 #include <system_error>
 
 #include <butl/path>
@@ -260,6 +261,18 @@ namespace butl
     static process_path
     try_path_search (const path&, bool, const dir_path& = dir_path ());
 
+    // Print process commmand line. If the number of elements is specified,
+    // then it will print the piped multi-process command line, if present.
+    // In this case, the expected format is as follows:
+    //
+    // name1 arg arg ... nullptr
+    // name2 arg arg ... nullptr
+    // ...
+    // nameN arg arg ... nullptr nullptr
+    //
+    static void
+    print (std::ostream&, const char* const args[], size_t n = 0);
+
   public:
 #ifndef _WIN32
     using handle_type = pid_t;