From 6f01c8ed267b08254ca8c6e692510f6c7fa2ed22 Mon Sep 17 00:00:00 2001
From: Christos Zoulas <christos@zoulas.com>
Date: Tue, 14 Oct 2003 19:33:31 +0000
Subject: [PATCH] Explain magic_errno and magic_error.

---
 doc/libmagic.man | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/doc/libmagic.man b/doc/libmagic.man
index 2c6a0798..11d4163f 100644
--- a/doc/libmagic.man
+++ b/doc/libmagic.man
@@ -50,6 +50,8 @@
 .Fn magic_close "magic_t cookie"
 .Ft const char *
 .Fn magic_error "magic_t cookie"
+.Ft int
+.Fn magic_errno "magic_t cookie"
 .Ft const char *
 .Fn magic_file "magic_t cookie, const char *filename"
 .Ft const char *
@@ -101,6 +103,9 @@ or
 attempt to preserve the access time of files analyzed.
 .It Dv MAGIC_RAW
 Don't translate unprintable characters to a \eooo octal representation.
+.It Dv MAGIC_ERROR
+Treat operating system errors while trying to open files and follow symlinks
+as real errors, instead of printing them in the magic buffer.
 .El
 .Pp
 The
@@ -115,6 +120,12 @@ function returns a textual explanation of the last error, or NULL if there was
 no error.
 .Pp
 The
+.Fn magic_errno
+function returns the last operating system error number (
+.Xr errno 3 )
+that was encountered by a system call.
+.Pp
+The
 .Fn magic_file
 function returns a textual description of the contents of the
 .Ar filename
-- 
2.50.1