ref: a585e2020387d895c9d185db7a81c76e31031184
author: sirjofri <sirjofri@sirjofri.de>
date: Fri Mar 28 08:43:05 EDT 2025
adds script with first functions
--- /dev/null
+++ b/README
@@ -1,0 +1,27 @@
+esig - extended sig
+
+USAGE
+
+This script calls sig(1) and then prints additional common information from a tabel database.
+
+Did you ever forget the access() returns 0 on success? Then you can read the man page to get the info...
+
+... or you call 'esig access':
+
+ int access(char *name, int mode)
+
+ DIAG: errstr
+ RET: 0=success, -1=fail
+
+
+
+ESIG LIB FORMAT
+
+Each record begins with a single record line with tab separated values.
+
+Fields:
+- function name (this is used for matching)
+- diagnostics (e. g. errstr)
+- return value (short summary with necessary info)
+
+The following lines that start with a tab character will also be printed. Use them to provide additional notes.
--- /dev/null
+++ b/esig
@@ -1,0 +1,35 @@
+#!/bin/rc
+
+rfork en
+
+fn doesig{+ awk -F ' ' '
+
+/^'^$1^'/ {+ current = $1
+ print ""
+ print "\tDIAG: ", $2
+ print "\tRET: ", $3
+}
+/^[^\t]/ {+ current = $1
+}
+/^\t/ && current == "'^$1^'" {+ print $0
+}
+
+' $libfile
+}
+
+fn dosig{+ sig $1
+ doesig $1
+ echo
+}
+
+libfile=/lib/esiglib
+if (test -r esiglib)
+ libfile=esiglib
+
+for (arg in $*)
+ dosig $arg
--- /dev/null
+++ b/esiglib
@@ -1,0 +1,10 @@
+access errstr 0=success, -1=fail
+print errstr number bytes transmitted (no 0)
+Brdline errstr pointer to line in buffer, 0=EOF/error
+ The line is not altered in the buffer, use Blinelen to get the
+ length of the line.
+Blinelen errstr length of line, including delimiter
+Brdstr errstr malloc'd buffer, null terminated
+open errstr fd, <0 on fail
+create errstr fd, <0 on fail
+close errstr ??? (not described in man page)
\ No newline at end of file
--- /dev/null
+++ b/mkfile
@@ -1,0 +1,3 @@
+install:V:
+ cp esig /rc/bin/esig
+ cp esiglib /lib/esiglib