about summary refs log tree commit diff
diff options
context:
space:
mode:
authorLeah Neukirchen <leah@vuxu.org>2017-10-20 16:05:47 +0200
committerLeah Neukirchen <leah@vuxu.org>2017-10-20 16:05:47 +0200
commit732c5f08eaaf288ded6807f07e9cd6733fec6919 (patch)
treea540e82d562ec6a325f9dc4cd2e83abf151233b5
parent52efa37b37f8e7c6a90eac0f0bfd939f34b4d6c9 (diff)
downloadnecho-732c5f08eaaf288ded6807f07e9cd6733fec6919.tar.gz
necho-732c5f08eaaf288ded6807f07e9cd6733fec6919.tar.xz
necho-732c5f08eaaf288ded6807f07e9cd6733fec6919.zip
add caveat about Linux proc(5)
-rw-r--r--necho.121
1 files changed, 21 insertions, 0 deletions
diff --git a/necho.1 b/necho.1
index 567e436..681c7e1 100644
--- a/necho.1
+++ b/necho.1
@@ -55,6 +55,27 @@ These utilities exit 0 on success, and >0 if an error occurs.
 .Nm secho
 is a POSIX-conforming, but not XSI-conforming implementation of
 .Xr echo 1 .
+.Sh CAVEATS
+These tools use
+.Xr writev 2
+syscalls for efficient output.
+This generally works fine,
+but there is a problem with using this function when writing to
+the Linux
+.Xr proc 5
+filesystem:
+only the first buffer will be regarded as a write.
+.Pp
+Therefore,
+.Pp
+.Dl jecho 60 >/proc/sys/kernel/panic
+.Pp
+will work, but
+.Pp
+.Dl jecho 6 0 >/proc/sys/kernel/panic
+.Pp
+will just be regarded as a write of
+.Sq Li 6 .
 .Sh AUTHORS
 .An Leah Neukirchen Aq Mt leah@vuxu.org
 .Sh LICENSE