about summary refs log tree commit diff
diff options
context:
space:
mode:
authorLeah Neukirchen <leah@vuxu.org>2017-10-22 14:14:00 +0200
committerLeah Neukirchen <leah@vuxu.org>2017-10-22 14:14:00 +0200
commitf3548eefc864a08cba06d963fd6266da26b3c205 (patch)
tree4cb09e6ef62d28946a29ac7392216114c113ded9
parentefc41ae44e6ad317883a26c0cca91f30b2835720 (diff)
downloadnecho-f3548eefc864a08cba06d963fd6266da26b3c205.tar.gz
necho-f3548eefc864a08cba06d963fd6266da26b3c205.tar.xz
necho-f3548eefc864a08cba06d963fd6266da26b3c205.zip
README: update
-rw-r--r--README20
1 files changed, 18 insertions, 2 deletions
diff --git a/README b/README
index cd2ab14..2114026 100644
--- a/README
+++ b/README
@@ -20,8 +20,8 @@ DESCRIPTION
      The qecho utility writes its arguments, surrounded by unicode quotation
      marks, to standard output.
 
-     The jecho utility writes its arguments joined together to standard
-     output.
+     The jecho utility writes its arguments joined together with no separators
+     to standard output.
 
      The secho utility writes its arguments, separated by spaces, to standard
      output, followed by a <newline>.  If there are no arguments, only the
@@ -41,6 +41,22 @@ STANDARDS
      secho is a POSIX-conforming, but not XSI-conforming implementation of
      echo(1).
 
+CAVEATS
+     These tools use writev(2) syscalls for efficient output.  This generally
+     works fine, but there is a problem with using this function when writing
+     to the Linux proc(5) filesystem: only the first buffer will be regarded
+     as a write.
+
+     Therefore,
+
+           jecho 60 >/proc/sys/kernel/panic
+
+     will work, but
+
+           jecho 6 0 >/proc/sys/kernel/panic
+
+     will just be regarded as a write of ‘6’.
+
 AUTHORS
      Leah Neukirchen <leah@vuxu.org>