summaryrefslogtreecommitdiff
path: root/doc/sane-pnm.man
diff options
context:
space:
mode:
Diffstat (limited to 'doc/sane-pnm.man')
-rw-r--r--doc/sane-pnm.man37
1 files changed, 29 insertions, 8 deletions
diff --git a/doc/sane-pnm.man b/doc/sane-pnm.man
index bd68667..80c81fe 100644
--- a/doc/sane-pnm.man
+++ b/doc/sane-pnm.man
@@ -2,6 +2,7 @@
.IX sane\-pnm
.SH NAME
sane\-pnm \- SANE PNM image reader pseudo-backend
+
.SH DESCRIPTION
The
.B sane\-pnm
@@ -15,6 +16,7 @@ This backend provides two devices called
.B 0
and
.BR 1.
+
.SH CONFIGURATION
No configuration required.
.SH FILES
@@ -25,6 +27,7 @@ The static library implementing this backend.
.I @LIBDIR@/libsane\-pnm.so
The shared library implementing this backend (present on systems that
support dynamic loading).
+
.SH ENVIRONMENT
.TP
.B SANE_DEBUG_PNM
@@ -32,15 +35,33 @@ If the library was compiled with debug support enabled, this
environment variable controls the debug level for this backend. E.g.,
a value of 128 requests all debug output to be printed. Smaller
levels reduce verbosity.
+
.SH BUGS
-If the pnm backend is installed and saned is used to allow users on remote
-computers to scan on the local machine, pnm files can be read by the remote
-user. This is limited to the files saned can access (usually it's running as
-user "sane"). All pnm files can be read if saned runs as root which isn't
-recommended anyway. The pnm backend is disabled by default. If you want to use
-it, enable it with configure (see configure \-\-help for details). Be sure that
-only trusted users can access the pnm backend over saned.
+If the
+.B sane\-pnm
+backend is installed and
+.BR saned (8)
+is used to allow users on remote
+computers to scan on the local machine, PNM files can be read by the remote
+user. This is limited to the files
+.BR saned (8)
+can access (usually it's running as
+user "sane"). All PNM files can be read if
+.BR saned (8)
+runs as root which isn't
+recommended anyway. The
+.B sane\-pnm
+backend is disabled by default. If you want to use it, enable it with configure (see
+.I configure \-\-help
+for details). Be sure that
+only trusted users can access the
+.B sane\-pnm
+backend over
+.BR saned (8).
+
.SH AUTHOR
Andreas Beck, Gordon Matzigkeit, and David Mosberger
+
.SH SEE ALSO
-sane(7)
+.BR sane (7),
+.BR saned (8)