ref: 27a696b145c85e7d892e97a5819565d298c8cd2b
parent: 357e58699e6ababa2f971461a4918f552bca1e9e
author: Ori Bernstein <ori@eigenstate.org>
date: Mon Sep 25 20:59:28 EDT 2023
manpages: we don't need to execute manpages
--- a/sys/man/5/error
+++ b/sys/man/5/error
@@ -20,6 +20,23 @@
that would accompany a successful call; its tag is that
of the failing request.
.PP
+Any error string may be returned, but by convention, there
+should be a prefix that describes the error in a way that
+may be checked by a machine, followed by any additional
+useful information.
+.PP
+There are a handful of common error prefixes that are used:
+.TP
+.B interrupted
+The operation that was in progress was cancelled before it
+could be completed.
+.TP
+.B file not found
+A walk was not able to match the requested name
+.TP
+.B i/o on hungup channel
+The channel that was being used was closed
+.PP
By convention, clients may truncate error messages after
.B ERRMAX-1
bytes;